Documentação para possíveis erros encontrados no pagamento de um boleto com cartão.
Respostas da requisição
Modelos de retorno existentes:
{
"statusCode": 400,
"message": "Este boleto já foi pago.",
"error": "Bad Request"
}
{
"statusCode": 400,
"message": [
"O id deve conter apenas números"
],
"error": "Bad Request"
}
{
"timestamp": 1677769620183,
"path": "...",
"status": 500,
"error": "Internal Server Error",
"message": "Horário indisponível para pagamento de boletos!",
"requestId": "8aa8a888-7"
}
{
"statusCode": 401,
"message": "Unauthorized"
}
Lista de erros
HTTP Status | Mensagem de erro | Cenário |
---|---|---|
400 | Este boleto já foi pago. | O boleto já está pago |
400 | O id deve conter apenas números | Id do boleto com caracteres não permitidos |
400 | O valor total deve conter apenas números | Campo totalValue com caracteres não permitidos |
400 | ID da sessão sem informações ou preenchido de forma incorreta | O sessionId não foi enviado ou possui caracteres não permitidos |
400 | As parcelas devem conter apenas números | Campo installments com caracteres não permitidos |
400 | CPF/CNPJ sem informações ou preenchido de forma incorreta | Campo legalDocument não foi enviado ou possui caracteres não permitidos |
400 | Endereço de IP sem informações ou preenchido de forma incorreta | Campo ipAddress não foi enviado ou possui caracteres não permitidos |
400 | Campo nome deve ser preenchido | Campo name não foi enviado |
400 | Campo nome sem informações ou preenchido de forma incorreta | Campo name possui caracteres não permitidos |
400 | O campo de telefone deve ser preenchido e não deve conter caracteres especiais | Campo phone não foi preenchido ou possui caracteres não permitidos |
400 | O número de telefone deve conter o DDD + número válido | Campo phone não foi preenchido corretamente |
400 | O número de telefone não deve conter o código do país ou exceder 11 dígitos | Campo phone possui mais caracteres que o permitido |
400 | Email sem informações ou preenchido de forma incorreta | Campo email não enviado ou possui caracteres não permitidos |
400 | CPF sem informações ou preenchido de forma incorreta | Um ou mais campos de cpf não foram enviados ou possuem caracteres não permitidos |
400 | Campo rua sem informações ou preenchido de forma incorreta | Um ou mais campos street não foram enviados ou possuem caracteres não permitidos |
400 | Campo número de residência sem informações ou preenchido de forma incorreta | Um ou mais campos number do endereço não foram enviados ou possuem caracteres não permitidos |
400 | Campo complemento de endereço sem informações ou preenchido de forma incorreta | Um ou mais campos de complement não foram enviados ou possuem caracteres não permitidos |
400 | Campo bairro sem informações ou preenchido de forma incorreta | Um ou mais campos district não foram enviados ou possuem caracteres não permitidos |
400 | Campo do código postal sem informações ou preenchido de forma incorreta | Um ou mais campos zipCode não foram enviados ou possuem caracteres não permitidos |
400 | Campo da cidade sem informações ou preenchido de forma incorreta | Um ou mais campos city não foram enviados ou possuem caracteres não permitidos |
400 | Campo do estado sem informações ou preenchido de forma incorreta | Um ou mais campos state não foram enviados ou possuem caracteres não permitidos |
400 | Campo do país sem informações ou preenchido de forma incorreta | Um ou mais campos country não foram enviados ou possuem caracteres não permitidos |
400 | Tipo de endereço sem informações ou preenchido de forma incorreta | Um ou mais campos type não foram enviados ou possuem caracteres não permitidos |
400 | Campo do número do cartão sem informações ou preenchido de forma incorreta | Campo number do cartão de crédito não foi enviado ou possui caracteres não permitidos |
400 | Campo da bandeira do cartão sem informações ou preenchido de forma incorreta | Campo brandName do cartão de crédito não foi enviado ou possui caracteres não permitidos |
400 | Mês de expiração do cartão sem informações ou preenchido de forma incorreta | Campo expirationMonth do cartão de crédito não foi enviado ou possui caracteres não permitidos |
400 | Ano da expiração do cartão sem informações ou preenchido de forma incorreta | Campo expirationYear do cartão de crédito não foi enviado ou possui caracteres não permitidos |
400 | Campo do código de segurança do cartão sem informações ou preenchido de forma incorreta | Campo securityCode do cartão de crédito não foi enviado ou possui caracteres não permitidos |
400 | Campo nome no cartão sem informações ou preenchido de forma incorreta | Campo holderName do cartão de crédito não foi enviado ou possui caracteres não permitidos |
400 | Serviço de pagamento de conta com cartão não habilitado. | Este serviço não encontra-se habilitado e não será possível finalizar o pagamento |
400 | Erro ao validar as taxas de pagamento | Houve um problema na validação das taxas do pagamento |
400 | Não foi possível checar o uso do limite. | Problema ao acessar os limites do cliente |
400 | Não foi possível registar o uso do limite. | Problema ao debitar o pagamento no limite do usuário |
400 | O valor da transação não pode ser menor que o valor do boleto. | Campo totalValue não possui um valor válido para esta transação |
400 | Boleto não encontrado. | O boleto informado não foi encontrado no nosso sistema |
401 | Unauthorized | Token de autorização não informado ou inválido |
500 | Horário indisponível para pagamento de boletos! | Tentativa de pagamento executada fora do horário permitido |