Códigos de resultado da validação de banco de dados

A API de Validação de banco de dados da Didit consulta o registro civil oficial de cada país: RENAPER (Argentina, $0.20/consulta com correspondência facial biométrica), Receita Federal (Brasil, $0.20), Tribunal Electoral SIB (Panamá, $0.75 biométrica), Junta Central Electoral (República Dominicana, $0.05) e outros 14. A cobrança é feita por consulta bem-sucedida, sem mínimos mensais. Ao executar uma Validação de banco de dados, você recebe duas camadas de resultado:

Um código de resultado padrão, que funciona da mesma forma em todos os países compatíveis. Assim, você escreve uma única lógica de tratamento que cobre todos eles.
Um código de detalhe específico do país, opcional, que informa exatamente qual condição o registro governamental retornou. Ele é útil para suporte, análises e para decidir se o usuário deve ser orientado a tentar novamente.

Esta página lista todos os valores que você pode receber e explica como reagir a cada um deles.

Códigos de resultado padrão

Estes códigos são idênticos em todos os países. Construa sua lógica de revisão, recusa e nova tentativa com base neles, e não nos códigos de detalhe de cada país.

Código de resultado	Significado	Pode tentar novamente?	Tratamento recomendado
`MATCH`	O registro confirmou a identidade e todos os campos verificados corresponderam.	—	Aprovar.
`PARTIAL_MATCH`	O registro encontrou um cadastro, mas um ou mais dos campos comparados pelo serviço não corresponderam totalmente (geralmente o nome ou a data de nascimento). Os campos que determinam o resultado variam conforme o serviço. Consulte Métodos de correspondência.	—	Enviar para revisão ou configurar uma Partial Match Action para recusar automaticamente.
`NO_MATCH`	O registro não retornou nenhuma correspondência para os dados enviados.	Não	Recusar ou enviar para revisão, conforme sua política.
`DOCUMENT_SUPERSEDED`	O registro confirmou a identidade da pessoa, mas a edição do documento apresentada não é a que consta em seus arquivos: uma edição mais recente já foi emitida, portanto a credencial apresentada está desatualizada. A letra de ejemplar do DNI argentino é o caso típico. Este código é diferente de `NO_MATCH` (a pessoa não correspondeu) e de `DOCUMENT_NOT_FOUND` (não existe nenhum cadastro): apenas a credencial física está desatualizada.	Não	Enviar para revisão e solicitar a edição atual do documento. Segue a sua No Match Action e gera `DATABASE_VALIDATION_DOCUMENT_SUPERSEDED`.
`DOCUMENT_NOT_FOUND`	O número de identificação é sintaticamente válido, mas não existe no registro governamental.	Não	Recusar.
`INVALID_DOCUMENT_FORMAT`	O número de identificação enviado está malformado (comprimento incorreto, caracteres não numéricos, dígito verificador inválido).	Não	Pedir ao usuário que digite novamente o número do documento.
`INVALID_INPUT`	Um campo de entrada obrigatório (selfie, gênero, data de nascimento etc.) estava ausente ou malformado.	Não	Pedir ao usuário que reenvie o campo ausente. A sessão será reprocessada automaticamente assim que os dados forem fornecidos. Consulte `COULD_NOT_PERFORM_DATABASE_VALIDATION`.
`MINOR_BLOCKED`	O registro reteve o cadastro porque o titular é menor de idade. Aplica-se em jurisdições com leis de proteção de dados de menores (LGPD no Brasil, Argentina).	Não	Recusar. Respeite o marco legal local e não tente novamente.
`DECEASED`	O registro informa que o titular é falecido.	Não	Recusar.
`BIOMETRIC_NO_MATCH`	Em validações biométricas (Argentina, Panamá), a pontuação de correspondência facial ficou abaixo do limiar de aceitação.	Não	Recusar ou enviar para revisão.
`BIOMETRIC_IMAGE_UNUSABLE`	Não foi possível processar a selfie: a imagem estava vazia, não continha um rosto, tinha baixa qualidade ou o registro não conseguiu lê-la.	Sim	Pedir ao usuário que tire a selfie novamente.
`INCONCLUSIVE`	O registro não conseguiu determinar se a pessoa corresponde: o resultado é realmente incerto (ela pode ou não constar no registro). Este código é diferente de `NO_MATCH` (ausência definitiva) e de `BIOMETRIC_IMAGE_UNUSABLE` (um problema técnico na imagem): nada foi confirmado em nenhum sentido, por isso `match_type` é `null`.	Talvez	Enviar para revisão. Uma nova tentativa com uma selfie mais nítida ou com dados adicionais pode resolver.
`REGISTRY_UNAVAILABLE`	O registro governamental está temporariamente inacessível (tempo limite esgotado, erro de conectividade, erro 5xx na origem).	Sim	Tentar novamente após um breve intervalo. A Didit já tenta novamente automaticamente em caso de erros transitórios, então ver este código no relatório final significa que as tentativas se esgotaram. Quando um registro continua falhando, sua organização recebe um e-mail assim que a interrupção se prolonga e outro quando o acesso é restabelecido. Consulte Notificações de disponibilidade.
`REGISTRY_ERROR`	O registro retornou uma falha inesperada que não se encaixa em nenhuma das categorias acima.	Talvez	Encaminhar ao suporte com o código de detalhe.

O outcome_code fica dentro de cada entrada do array validations no relatório de validação. Consulte Relatório de Validação de banco de dados para ver onde ele se encaixa na resposta.

REGISTRY_UNAVAILABLE e REGISTRY_ERROR significam que o registro de origem nunca respondeu à consulta, por isso esses dois resultados não são cobrados. Consulte os preços. Todos os demais códigos de resultado são respostas reais e pagas do registro, mesmo as que não confirmam nada (INCONCLUSIVE, BIOMETRIC_IMAGE_UNUSABLE) e mesmo as que rejeitam o que você enviou (INVALID_DOCUMENT_FORMAT, INVALID_INPUT: como códigos de resultado, eles significam que o próprio registro recusou os dados depois que a consulta foi enviada).Dados que nunca chegam a um registro não geram nenhum código de resultado: POST /v3/database-validation/ responde 400 quando um valor não atende às regras de formato do país, e um serviço do fluxo de trabalho com campos ausentes ou malformados é ignorado com COULD_NOT_PERFORM_DATABASE_VALIDATION. Nenhum dos dois casos é cobrado. O detalhamento completo está na página de preços da Validação de banco de dados.

Códigos de detalhe por país

O código de detalhe é retornado como outcome_detail junto com outcome_code. Somente os países listados abaixo produzem códigos de detalhe além do resultado padrão; todos os demais países compatíveis retornam apenas os códigos padrão.

Argentina (RENAPER)

A Argentina usa uma validação biométrica 1×1 contra o registro nacional de identidade RENAPER, combinando o DNI, uma selfie e o gênero declarado.

Código de detalhe	Resultado padrão	O que significa
`300`	`INVALID_DOCUMENT_FORMAT`	O campo DNI deve ser um número de 7 a 8 dígitos.
`301`	`DOCUMENT_NOT_FOUND`	O DNI enviado não corresponde a um registro válido.
`303`	`INVALID_INPUT`	O campo da selfie estava vazio.
`304`	`INVALID_INPUT`	O campo de gênero estava vazio ou não correspondia a `M`, `F`, `X`.
`305`	`NO_MATCH`	A combinação de DNI e gênero não foi encontrada.
`306`	`REGISTRY_UNAVAILABLE`	A consulta não pode ser realizada neste momento.
`307`	`REGISTRY_UNAVAILABLE`	Erro ao conectar ao sistema público de validação de identidade.
`311`	`REGISTRY_ERROR`	A integração não tem acesso a este produto.
`313`	`MINOR_BLOCKED`	O registro pertence a uma pessoa menor de idade.
`400`	`REGISTRY_UNAVAILABLE`	Erro de conexão.
`401`	`NO_MATCH`	Nenhum resultado encontrado para os dados fornecidos.
`405`	`BIOMETRIC_IMAGE_UNUSABLE`	Conflito com a imagem; ela não pode ser processada.
`406`	`BIOMETRIC_IMAGE_UNUSABLE`	Erro no processamento da imagem.
`NO.HIT`	`BIOMETRIC_NO_MATCH`	A pontuação de correspondência facial ficou abaixo do limiar de aceitação (< 50).
`INTERNAL_ERROR`	`REGISTRY_UNAVAILABLE`	Tempo limite excedido.

Brasil (Receita Federal, Consulta CPF)

O Brasil valida o CPF no serviço oficial de CPF da Receita Federal, com tratamento explícito para menores de idade conforme a LGPD (Lei Geral de Proteção de Dados) e o Estatuto Digital da Criança e do Adolescente.

Código de detalhe	Resultado padrão	O que significa
`200`	`MATCH`	CPF encontrado e dados retornados com sucesso.
`206`	`MATCH`	CPF encontrado, mas alguns campos não essenciais não foram retornados.
`400`	`INVALID_DOCUMENT_FORMAT`	O número do CPF não é válido.
`404`	`DOCUMENT_NOT_FOUND`	Não existe CPF com o número enviado.
`422`	`MINOR_BLOCKED`	Os dados de um menor de 18 anos são retidos conforme a LGPD (Lei 13.709/2018). A resposta inclui `minor_under_18: true`.
`451`	`MINOR_BLOCKED`	Os dados de um menor de 16 anos são retidos conforme a LGPD e o Estatuto Digital da Criança e do Adolescente (Lei 15.211/2025). A resposta inclui `minor_under_18: true` e `minor_under_16: true`.
`500`	`REGISTRY_UNAVAILABLE`	Erro no servidor de origem.
`504`	`REGISTRY_UNAVAILABLE`	Tempo limite do gateway: a requisição não chegou à API da Consulta CPF.

Para resultados MINOR_BLOCKED no Brasil, source_data ainda retorna os indicadores lgpd_minor, minor_under_18 e minor_under_16, para que você possa aplicar fluxos adequados à idade sem tentar novamente.

Panamá (SIB, Tribunal Electoral)

O Panamá usa validação biométrica contra o registro SIB (Servicio de Identificación Biométrica), operado pelo Tribunal Electoral. Se ocorrer um erro técnico no SIB, a sessão recorre automaticamente a uma consulta 1×1.

Código de detalhe	Resultado padrão	O que significa
`601`	`REGISTRY_UNAVAILABLE`	O operador não existe no banco de dados.
`602`	`MINOR_BLOCKED`	O cidadão tem menos de 12 anos.
`603`	`DECEASED`	O cidadão é falecido.
`604`	`NO_MATCH`	O cidadão tem um registro inválido.
`605`	`NO_MATCH`	Cidadão não reconhecido.
`606`	`INVALID_INPUT`	O campo Cédula está vazio.
`607`	`DOCUMENT_NOT_FOUND`	Cidadão não encontrado.
`608`	`REGISTRY_ERROR`	Este cliente não tem acesso ao SIB.
`610`	`BIOMETRIC_IMAGE_UNUSABLE`	Erro geral de validação facial.
`611`	`BIOMETRIC_IMAGE_UNUSABLE`	A imagem para comparação não foi enviada.
`612`	`BIOMETRIC_IMAGE_UNUSABLE`	A imagem não tem conteúdo.
`613`	`BIOMETRIC_IMAGE_UNUSABLE`	Formato de imagem inválido.
`614`	`BIOMETRIC_IMAGE_UNUSABLE`	Nenhum rosto detectado na imagem.
`615`	`BIOMETRIC_NO_MATCH`	Limiar de similaridade não atingido.

Outros países compatíveis

Os países abaixo retornam apenas os códigos de resultado padrão; não há códigos de detalhe específicos por país a tratar.

Bolívia, Colômbia, Costa Rica, El Salvador, Guatemala, Honduras, Paraguai, Espanha, Uruguai, Venezuela: consulta 1×1 no registro civil correspondente. Os resultados correspondem diretamente a MATCH, NO_MATCH, DOCUMENT_NOT_FOUND, INVALID_DOCUMENT_FORMAT ou REGISTRY_UNAVAILABLE.
Chile (Registro Civil): consulta de RUT. Corresponde aos resultados padrão, além de MINOR_BLOCKED quando o registro sinaliza que a pessoa é menor de idade.
República Dominicana (JCE): consulta de Cédula que retorna um valor booleano de validade; corresponde a MATCH ou NO_MATCH.
Equador (Registro Civil): consulta de Cédula.
México (RENAPO, mais INE para 2×2): consulta de CURP via RENAPO. Quando validation_type é two_by_two, é executada uma verificação cruzada adicional no INE; ambas são mapeadas para os mesmos códigos de resultado padrão.
Peru (RENIEC): consulta de DNI.

Padrão de tratamento

O tratamento robusto mais simples é assim:

switch (result.outcome_code) {
  case "MATCH":
    return approve();
  case "PARTIAL_MATCH":
    return review();
  case "NO_MATCH":
  case "DOCUMENT_NOT_FOUND":
  case "DECEASED":
  case "MINOR_BLOCKED":
  case "BIOMETRIC_NO_MATCH":
    return decline();
  case "INVALID_DOCUMENT_FORMAT":
  case "INVALID_INPUT":
    return askUserToFixInput(result.outcome_detail);
  case "BIOMETRIC_IMAGE_UNUSABLE":
    return askUserToRetakeSelfie();
  case "REGISTRY_UNAVAILABLE":
  case "REGISTRY_ERROR":
    return review();  // Didit already retried; a human can decide.
  default:
    return review();
}

Você não precisa ramificar a lógica de negócio com base em outcome_detail: use-o para análises, depuração e chamados de suporte. O outcome_code padrão tem garantia de permanecer estável entre países e ao longo do tempo.

Veja também

Avisos da Validação de banco de dados: as tags de aviso no nível da sessão (COULD_NOT_PERFORM_DATABASE_VALIDATION, DATABASE_VALIDATION_PARTIAL_MATCH, DATABASE_VALIDATION_NO_MATCH) e como configurar as ações de revisão/recusa da sua aplicação.
Relatório da Validação de banco de dados: a estrutura completa da resposta e onde outcome_code / outcome_detail aparecem.
Países compatíveis com a Validação de banco de dados: a lista completa de países e métodos de correspondência.

Autenticação

Verificação

Monitoramento

Plataforma

Códigos de resultado da validação de banco de dados

Códigos de resultado padrão

Códigos de detalhe por país

Argentina (RENAPER)

Brasil (Receita Federal, Consulta CPF)

Panamá (SIB, Tribunal Electoral)

Outros países compatíveis

Padrão de tratamento

Veja também

​Códigos de resultado padrão

​Códigos de detalhe por país

​Argentina (RENAPER)

​Brasil (Receita Federal, Consulta CPF)

​Panamá (SIB, Tribunal Electoral)

​Outros países compatíveis

​Padrão de tratamento

​Veja também

Códigos de resultado padrão

Códigos de detalhe por país

Argentina (RENAPER)

Brasil (Receita Federal, Consulta CPF)

Panamá (SIB, Tribunal Electoral)

Outros países compatíveis

Padrão de tratamento

Veja também