DOCUMENTAÇÃO CORPORATIVA
Efetuar Débito Síncrono em Conta
POST /api/debito/sincrono
Endpoint responsável por Efetuar um Débito em Conta, de maneira Síncrona, retornando os dados do mesmo em caso de sucesso. Para efetuar esse Débito o Parceiro precisa enviar o Token da Autorização (gerado previamente), assim como o NSU e o Valor referente a esse débito.
Headers
Content-Type | application/json |
Authorization | Bearer {token} |
Request Body application/json
Schema:
Campo | Tipo | Descrição | Tamanho Máximo | Obrigatório |
nsu | Long | Número sequencial único para identificar o Débito em Questão | - | Sim |
tokenAutorizacao | String | Token cadastrado na Solicitação de Permissão de Débito em Conta. Com tamanho máximo de 30 caracteres. | - | Sim |
valor | Decimal | Valor da Transação para Débito em Conta. | - | Sim |
autoConfirmado | Booleana | Indica de o Débito será Auto Confirmado, ou seja, se este já será considerado como Sucesso pela Câmara de Débito no momento em que é realizado. Necessitando de uma comunicação de Cancelamento pelo Parceiro caso ocorra algum problema. | - | Não |
JSON:
{
"nsu": 45654684654321,
"tokenAutorizacao": "39e857db-c18b-4b40-8fe1-7b7c9b473aeb",
"valor": 7.50,
"autoConfirmado": true
}
Response Body application/json
Schema:
Campo | Tipo | Descrição |
idDebito | Long | ID do Débito que foi Cadastrado. |
idDebitoAutorizacao | Long | ID da Autorização para Débito em Conta Cadastrado. |
idDebitoStatus | Int32 | ID do status do Débito em Conta. Para um Débito Síncrono o Status será sempre 2 que indica que o Débito foi Processado. |
descricaoStatus | String | Descrição do Status do Débito em Conta. Para um Débito Síncrono, o Status retornará sempre Processado, em caso de sucesso. |
nsu | Long | Número Sequencial Único Disponibilizado pelo Parceiro. |
valor | Decimal | Valor da Transação para Débito Automático. |
dataHoraProcessamento | DateTime | Data e Hora que o Débito foi processado. |
dataHoraInsercao | DateTime | Data e Hora que o Débito em Conta foi Registrado |
JSON:
{
"idDebito": 2,
"idDebitoAutorizacao": 7,
"idDebitoStatus": 2,
"descricaoStatus": "Processado",
"nsu": 45654684654321,
"valor": 7.50,
"dataHoraProcessamento": "2020-12-20T20:30:31",
"dataHoraInsercao": "2020-12-20T20:25:24"
}
Response Body em Exceções application/json
Schema:
Campo | Tipo | Descrição |
StatusCode | int | Retorna o Status Code do http response |
Type | String | Retorna o tipo da mensagem “Warning” ou “Error” |
Message | String | Retorna uma mensagem tratada de acordo com o problema encontrado |
ExceptionType | String | Retorna uma categoria para a exceção. Pode ser os seguintes valores: “Autorizacao”, “Validacao”, “Negocio”, “Aplicacao”, “SaldoInsuficiente” |
JSON:
{
"StatusCode": 500,
"Type": "Warning",
"Message": "Valor de débito não autorizado.",
"ExceptionType": "Autorizacao"
}
Possiveis Mensagens de Exceção:
Token de Autorização Inválido. |
Não Autorizado para o Parceiro informado. |
NSU Já Cadastrado. |
Token de Autorização Inválido. |
Token de Autorização Inativo. |
Esta autorização de débito não possui um produto do parceiro associado. |
Quantidade máxima de débitos por dia para esta conta foi atingida. |
Quantidade máxima de débitos por mês para esta conta foi atingida. |
Valor máximo de débitos por dia para esta conta foi atingido. |
Valor máximo de débitos por mês para esta conta foi atingido. |
Valor de débito não autorizado. |
Foi encontrada uma mesma solicitação de Transferência com o mesmo valor e o mesmo destino nos últimos 10 minutos. Por favor, tente novamente mais tarde. |
Ocorreu um erro não esperado no procedimento desejado. |