Erros e Troubleshooting
Erros e Troubleshooting
Em qualquer erro, guarde o CODIGORESPOSTA retornado na consulta — ele é a chave para o suporte da Credify rastrear a chamada com rapidez.
Recebi erro 401. O que fazer?
Seu token JWT expirou ou é inválido. Gere um novo token via /auth com suas credenciais e refaça a requisição.
Renove o token proativamente quando faltar menos de 1 hora para expirar, sem esperar o erro 401.
Recebi erro 403. O que fazer?
Sua conta não tem permissão para acessar o endpoint consultado. Verifique com o suporte da Credify se o endpoint está incluso no seu plano contratado.
Recebi erro 500. O que fazer?
Erro interno do servidor. Aguarde alguns instantes e tente novamente. Se o problema persistir, entre em contato com o suporte informando o CODIGORESPOSTA da consulta.
Não reenvie a mesma requisição em loop imediato. Implemente retry com backoff exponencial para não sobrecarregar a sua integração nem a API.
Códigos de Limite e Bloqueio do Logon (RESPOSTA.CODIGO)
Esses códigos podem aparecer em RESPOSTA.CODIGO de qualquer endpoint — não são específicos de uma consulta. Indicam uma restrição no nível do LOGON (limite de plano, saldo ou solicitação de exclusão LGPD), não um erro na requisição em si.
Código 14 — Quantidade de consultas permitidas para o logon excedida
O logon atingiu o limite de consultas simultâneas ou diárias contratado. Aguarde ou solicite um ajuste de plano ao suporte da Credify.
Código 15 — Quantidade de consultas permitidas para o logon no mês excedida
O logon atingiu o limite mensal de consultas contratado. O limite é restabelecido no próximo ciclo ou mediante ajuste de plano junto ao suporte.
Código 16 — Valor de consultas para o logon excedido
O logon atingiu o limite financeiro (valor em R$) de consultas configurado para o período. Verifique o consumo com o suporte da Credify.
Código 17 — Valor total de consultas para o logon no mês excedido
O logon atingiu o limite financeiro mensal (valor em R$) de consultas configurado. O limite é restabelecido no próximo ciclo ou mediante ajuste de plano.
Código 18 — Logon não possui saldo para realizar a consulta
O logon está sem saldo/crédito disponível para executar a consulta. Entre em contato com o suporte da Credify para regularizar o saldo.
Código 19 — Titular do CPF solicitou a exclusão em atendimento à LGPD
O titular do CPF consultado exerceu seu direito de exclusão de dados junto à Credify, em atendimento à LGPD. A consulta não retorna os dados do titular.