Validações

Esta página lista os principais códigos de erro retornados pelos recursos de validação da Lazy Data. As validações incluem recursos como comparação facial, validação cadastral e demais verificações configuradas na plataforma.

Estrutura do erro

{
  "code": 43007,
  "message": "Não foi possível consultar o provedor da validação.",
  "result": null
}

Acesso, plano e cobrança

Código	Mensagem	Quando ocorre
`43001`	Não foi possível identificar um plano válido para a conta.	A conta não possui um plano válido ou o plano não foi localizado.
`43002`	A funcionalidade de validação não está habilitada para a conta atual.	O plano atual não permite usar validações.
`43006`	Não foi possível reservar o valor da validação. Verifique saldo disponível ou limite mensal.	Saldo insuficiente, limite mensal atingido ou falha ao reservar o valor da validação.

Tipo de validação

Código	Mensagem	Quando ocorre
`43003`	A validação solicitada não foi encontrada.	O tipo de validação informado não existe.
`43004`	A validação solicitada está inativa.	O tipo de validação existe, mas está desabilitado.

Validação facial

Código	Mensagem	Quando ocorre
`43005`	Uma ou mais imagens informadas são inválidas.	A imagem está ausente, corrompida, fora do formato aceito ou excede as regras permitidas.
`43010`	Não foi possível detectar uma face humana nas imagens enviadas.	O provedor não identificou uma face válida em uma ou mais imagens.

Validação cadastral

Código	Mensagem	Quando ocorre
`43011`	Dados cadastrais inválidos.	Os dados enviados não atendem aos requisitos mínimos para validação.
`43012`	A validação cadastral de menores de idade não é permitida.	O CPF informado pertence a uma pessoa menor de idade.
`43013`	Os dados deste CPF não estão disponíveis por restrição de privacidade prevista na LGPD.	O CPF possui restrição de privacidade.

Provedor externo e histórico

Código	Mensagem	Quando ocorre
`43007`	Não foi possível consultar o provedor da validação.	Falha de comunicação, indisponibilidade, timeout ou erro temporário no provedor.
`43008`	Não foi possível registrar o histórico da validação.	A validação foi processada, mas o histórico não pôde ser salvo.

Tratamento recomendado

Valide os campos antes de enviar

Confira documentos, imagens obrigatórias e dados mínimos antes de iniciar a validação.

Trate erros de plano e saldo

Para códigos como 43002 e 43006, direcione o usuário para alterar o plano, adicionar saldo ou revisar limites da conta.

Oriente o usuário sobre imagens inválidas

Para códigos como 43005 e 43010, solicite uma nova imagem com rosto visível, boa qualidade e formato aceito.

Use retry apenas para falhas temporárias

O código 43007 pode representar falha temporária de provedor. Use retry com intervalo progressivo.

Primeiros passos

Utilidades

Funcionalidades

Webhook

Estrutura do erro

Acesso, plano e cobrança

Tipo de validação

Validação facial

Validação cadastral

Provedor externo e histórico

Tratamento recomendado

​Estrutura do erro

​Acesso, plano e cobrança

​Tipo de validação

​Validação facial

​Validação cadastral

​Provedor externo e histórico

​Tratamento recomendado

Estrutura do erro

Acesso, plano e cobrança

Tipo de validação

Validação facial

Validação cadastral

Provedor externo e histórico

Tratamento recomendado