Versões comparadas
comparado com
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Tópicos:
Índice
URL base API
| Ambientes | URL |
|---|---|
| Homologação | https://ms3.tapcore.com.br/mssuite/ |
| Produção | https://ms3.tapcore.com.br/mssuite/ |
Como configurar a URL de Callback
Acesse o seu painel administrativo em: painel.tapcore.com.br e no menu lateral busque a funcionalidade:
Beneficiário -> Solicitações de Cartão -> Configuração
Preencha o campo: URL de Callback com a URL que receberá a requisição de callback após inserção de uma nova solicitação de cartão.
Endpoint
| Endpoint | Método | Descrição |
|---|---|---|
solicitacao/solicitacao_cartao | PUT | Responsável por inserir uma nova solicitação de segunda via de cartão para análise, o beneficiário informa os beneficiários que desejam novos cartões, motivo e forma de entrega, por fim os administradores autorizam ou não a segunda via. |
Parâmetros
O callback será feito através de uma requisição HTTP do tipo POST ao serviço cadastrado, os parâmetros serão enviados via RAW no formato JSON, conforme as especificações abaixo:
| Bloco de código | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"protocolo" : "xyz123",
"mshash" : "",
"id_solicitacao_cartao": 999,
"id_operadora": 99,
"id_aplicacao": 7,
"id_status_cartao": 1,
"id_motivo_solic_cartao": 6,
"id_forma_entrega_cartao": 3,
"nome_titular": "Nome de teste",
"cpf_titular": 12121166742,
"matricula_titular": "000100020003",
"telefone_titular": 27000666898,
"estado_civil_titular": "Solteiro",
"email_titular": "teste@gmail.com",
"patrocinadora_titular": null,
"descricao": null,
"protocolo": "3139042017080200355",
"data": "2017-08-02 13:34:38",
"forma_entrega": "Entregar ao Titular pelos correios",
"motivo": "Perda",
"arquivos": [{
"id_arquivo": 59,
"nome": "c094be33c587e163ee702662491cd1a55ca6f854f.pdf",
"diretorio": null,
"url": https://s3-sa-east-1.amazonaws.com/solicitacao-cartao-ms/teste.pdf,
"id_solicitacao_cartao": 117
}],
"beneficiarios": [{
"id_beneficiario_cartao": 133,
"nome": "Teste Romano Teste Rizzi",
"matricula": "000100020003",
"parentesco": "Titular",
"data_nascimento": "1991-02-23",
"id_solicitacao_cartao": 117
}],
"endereco_alternativo": null,
"status": "Solicitado"
} |
Retornos de sucesso Callback - Segunda Via de Cartão
| Bloco de código | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"protocolo" : "3139042017080113117" ,
"mshash" : "NjA1ZDhkNjkzN2RjMzE3NTg2ZjUyMzgyZTk5ZTkyMGU4MDA2ZGFiNg==" ,
"id_status_cartao" : "2"
} |
| Nota | ||
|---|---|---|
| ||
| Todo callback executado, que tenha como retorno status header 200 será considerado uma conexão de sucesso, independente do seu retorno. É possível também alterar o status de uma solicitação de atualização cadastral, basta que o serviço de integração retorne em seu body um json no padrão abaixo. |