Referência de Erros
Esta página lista todos os códigos de erro possíveis da API de Validação de Contas Bancárias.
Erros Internos (IG)
Erros relacionados à validação dos dados enviados ou processamento interno.
IG01 - CPF/CNPJ inválido
Descrição: O CPF ou CNPJ informado não é válido.
Causas comuns: - Dígitos verificadores incorretos - Quantidade de dígitos incorreta - Formato inválido
Solução: Verifique se o CPF/CNPJ está correto e tente novamente.
IG02 - Dados de conta inválidos
Descrição: Os dados bancários informados são inválidos.
Causas comuns: - ISPB não existe no sistema PIX - Número da agência ou conta inexistente - Conta encerrada - Tipo de conta incorreto
Solução: Confirme os dados bancários com o titular da conta.
IG03 - CPF/CNPJ incompatível com a conta
Descrição: O CPF/CNPJ informado não corresponde ao titular da conta.
Causas comuns: - Documento pertence a outra pessoa - Erro de digitação no CPF/CNPJ
Solução: Verifique o documento do titular da conta.
IG04 - Erro ao efetivar transação
Descrição: Ocorreu um erro ao processar a transação de validação.
Causas comuns: - Tipo de transação não permitido para a conta - Limite excedido - Conta com restrições - Erro no processamento do pagamento
Solução: Entre em contato com o suporte técnico.
IG05 - Timeout ao efetivar transação
Descrição: A transação excedeu o tempo limite de processamento.
Causas comuns: - Lentidão na rede - Banco destinatário não respondeu a tempo
Solução: Tente novamente após alguns minutos.
IG21 - Erro de validação
Descrição: Dados obrigatórios não foram enviados ou estão em formato incorreto.
Causas comuns: - Campo obrigatório vazio - Formato de dado incorreto
Solução: Verifique se todos os campos obrigatórios foram preenchidos corretamente.
Erros PIX
Erros retornados pelo sistema PIX durante o processamento da validação.
CH11
Mapeado para: IG01
Descrição: CPF/CNPJ do usuário recebedor incorreto.
AC03
Mapeado para: IG02
Descrição: Número da agência e/ou conta transacional do usuário recebedor inexistente ou inválido.
AC07
Mapeado para: IG02
Descrição: Número da conta transacional encerrada no PSP do Recebedor.
AC14
Mapeado para: IG02
Descrição: Tipo incorreto para a conta transacional especificada.
BE01
Mapeado para: IG03
Descrição: CPF/CNPJ do usuário recebedor não é consistente com o titular da conta transacional especificada.
AG03
Mapeado para: IG04
Descrição: O tipo de transação não é suportado/autorizado na conta transacional especificada. Ex: transferência para conta salário.
AM02
Mapeado para: IG04
Descrição: Ordem de pagamento/devolução em valor superou o limite permitido para o tipo de conta transacional creditada.
AM09
Mapeado para: IG04
Descrição: Devolução de pagamento em valor superou o valor da ordem de pagamento instantâneo correspondente.
DS04
Mapeado para: IG04
Descrição: Ordem rejeitada pelo PSP do Recebedor.
DT05
Mapeado para: IG04
Descrição: A transação extrapolou o prazo máximo para devolução de pagamento instantâneo regulamentado pelo arranjo Pix.
RR04
Mapeado para: IG04
Descrição: Ordem de pagamento em que o usuário pagador é sancionado por resolução do Conselho de Segurança das Nações Unidas (CSNU).
ED05
Mapeado para: IG04
Descrição: Erro no processamento do pagamento.
DS24
Mapeado para: IG05
Descrição: Ordem rejeitada por extrapolação do tempo decorrido entre o envio e o recebimento da transação.
Erros de Sistema
Limite atingido
Status HTTP: 400 Bad Request
Resposta:
json
{
"error": "Limit reached"
}
Descrição: O limite de validações foi atingido.
Limites: - Global: 100.000 validações - Por workspace: 50.000 validações
Workspace inválido
Status HTTP: 400 Bad Request
Resposta:
json
{
"error": "Invalid workspace"
}
Descrição: O workspace_id informado é inválido ou está em formato incorreto.
Workspace ausente
Status HTTP: 400 Bad Request
Resposta:
json
{
"error": "Workspace_id required"
}
Descrição: O header workspace_id não foi enviado na requisição.
Validação não encontrada
Status HTTP: 404 Not Found
Resposta:
json
{
"error": "Account validation does not exist"
}
Descrição: O ID da validação informado não existe.
Próximos passos
- Guia do Usuário - Voltar ao guia de implementação
- Conceitos - Revisar conceitos técnicos