Códigos de resultado da Validação de base de dados

A API de Validação de base de dados da Didit consulta o registo civil oficial de cada país — RENAPER (Argentina, $0.20/verificação 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 mais 14 — com faturação por consulta bem-sucedida, sem consumos mínimos mensais. Ao executar uma Validação de base de dados, recebe duas camadas de resultados:

Um código de resultado padrão que funciona da mesma forma em todos os países suportados, para que possa escrever uma única lógica de tratamento que cubra todos eles.
Um código de detalhe específico do país opcional que lhe indica exatamente qual a condição devolvida pelo registo governamental — útil para suporte, análise e para decidir se deve pedir ao utilizador para tentar novamente.

Esta página lista todos os valores que pode encontrar 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. Desenvolva a sua lógica de revisão, recusa e nova tentativa com base nestes códigos — e não nos códigos de detalhe específicos de cada país.

Código de resultado	Significado	Pode tentar novamente?	Tratamento recomendado
`MATCH`	O registo confirmou a identidade e todos os campos verificados corresponderam.	—	Aprovar.
`PARTIAL_MATCH`	O registo encontrou um registo, mas um ou mais dos campos comparados pelo serviço não corresponderam totalmente (normalmente o nome ou a data de nascimento). Os campos que decidem o resultado variam consoante 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 registo não devolveu qualquer correspondência para os dados submetidos.	Não	Recusar, ou enviar para revisão dependendo da sua política.
`DOCUMENT_SUPERSEDED`	O registo confirmou a identidade da pessoa, mas a edição do documento apresentada não é a que consta nos seus arquivos — foi entretanto emitida uma edição mais recente, pelo que a credencial apresentada está desatualizada. A letra do ejemplar do DNI da Argentina é o caso canónico. Distingue-se de `NO_MATCH` (a pessoa não correspondeu) e de `DOCUMENT_NOT_FOUND` (nenhum registo encontrado): 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 aciona `DATABASE_VALIDATION_DOCUMENT_SUPERSEDED`.
`DOCUMENT_NOT_FOUND`	O número de identificação é sintaticamente válido, mas não existe no registo governamental.	Não	Recusar.
`INVALID_DOCUMENT_FORMAT`	O número de identificação submetido está malformado (comprimento incorreto, não numérico, soma de controlo incorreta).	Não	Pedir ao utilizador para introduzir novamente o número do documento.
`INVALID_INPUT`	Um campo de entrada obrigatório (selfie, género, data de nascimento, etc.) estava em falta ou malformado.	Não	Pedir ao utilizador para reenviar o campo em falta. A sessão será reprocessada automaticamente assim que os dados forem fornecidos — consulte `COULD_NOT_PERFORM_DATABASE_VALIDATION`.
`MINOR_BLOCKED`	O registo não disponibilizou o registo porque o titular é menor. Aplica-se em jurisdições com leis de proteção de dados para menores (LGPD no Brasil, Argentina).	Não	Recusar. Respeite o quadro legal local — não tente novamente.
`DECEASED`	O registo indica que o titular faleceu.	Não	Recusar.
`BIOMETRIC_NO_MATCH`	Para 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`	A selfie não pôde ser processada — a imagem estava vazia, não continha um rosto, tinha baixa qualidade ou o registo não conseguiu lê-la.	Sim	Pedir ao utilizador para tirar novamente a selfie.
`INCONCLUSIVE`	O registo não conseguiu determinar se a pessoa corresponde aos dados do registo — o resultado é genuinamente incerto (a pessoa pode ou não constar do registo). Distingue-se de `NO_MATCH` (definitivamente ausente) e de `BIOMETRIC_IMAGE_UNUSABLE` (um problema técnico de imagem): nada foi confirmado em nenhum dos sentidos, pelo que `match_type` é `null`.	Talvez	Enviar para revisão. Tentar novamente com uma selfie mais nítida ou dados adicionais pode resolver o problema.
`REGISTRY_UNAVAILABLE`	O registo governamental está temporariamente inacessível (tempo limite esgotado, erro de conectividade, erro 5xx a montante).	Sim	Tentar novamente após um breve intervalo. A Didit já tenta novamente os erros transitórios de forma automática; portanto, ver isto no relatório final significa que as tentativas se esgotaram. Quando um registo continua a falhar, a sua organização é notificada por e-mail assim que a interrupção se prolongar e novamente quando o acesso for restaurado — consulte Notificações de disponibilidade.
`REGISTRY_ERROR`	O registo devolveu uma falha inesperada que não se enquadra em nenhuma das categorias acima.	Talvez	Encaminhar para o suporte com o código de detalhe.

O outcome_code reside dentro de cada entrada da matriz validations no relatório de validação. Consulte Database Validation Report para ver onde se insere na resposta.

REGISTRY_UNAVAILABLE e REGISTRY_ERROR significam que o registo de origem nunca respondeu à consulta, pelo que estes dois resultados não são faturados - consulte os preços. Todos os outros códigos de resultado correspondem a respostas reais e pagas do registo, mesmo que não confirmem nada (INCONCLUSIVE, BIOMETRIC_IMAGE_UNUSABLE) e mesmo que rejeitem o que enviou (INVALID_DOCUMENT_FORMAT, INVALID_INPUT — enquanto códigos de resultado, estes significam que o próprio registo recusou os dados, após a consulta ter sido enviada).Os dados de entrada que nunca chegam ao registo não geram qualquer código de resultado: o endpoint POST /v3/database-validation/ devolve 400 quando um valor viola as regras de formato do país, e um serviço do fluxo com campos em falta ou malformados é ignorado com COULD_NOT_PERFORM_DATABASE_VALIDATION. Nenhum deles é faturado. Consulte a análise completa na página de preços da Validação de base de dados.

Códigos de detalhe específicos por país

O código de detalhe é retornado como outcome_detail juntamente com outcome_code. Apenas os países listados abaixo produzem códigos de detalhe além do resultado padrão — todos os outros países suportados retornam apenas os códigos padrão.

Argentina (RENAPER)

A Argentina utiliza uma validação biométrica 1×1 contra o registo 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–8 dígitos.
`301`	`DOCUMENT_NOT_FOUND`	O DNI submetido não corresponde a um registo válido.
`303`	`INVALID_INPUT`	O campo da selfie estava vazio.
`304`	`INVALID_INPUT`	O campo do género estava vazio ou não correspondia a um dos valores `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 ligar 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 registo pertence a uma pessoa menor de idade.
`400`	`REGISTRY_UNAVAILABLE`	Erro de ligação.
`401`	`NO_MATCH`	Nenhum resultado encontrado para os dados fornecidos.
`405`	`BIOMETRIC_IMAGE_UNUSABLE`	Conflito com a imagem; não é possível processá-la.
`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 contra o serviço oficial de CPF da Receita Federal, com tratamento explícito para menores segundo 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 de CPF não é válido.
`404`	`DOCUMENT_NOT_FOUND`	Não existe nenhum CPF com o número submetido.
`422`	`MINOR_BLOCKED`	Os dados de um menor de 18 anos foram retidos de acordo com a LGPD (Lei 13.709/2018). A resposta inclui `minor_under_18: true`.
`451`	`MINOR_BLOCKED`	Os dados de um menor de 16 anos foram retidos de acordo com 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 a montante.
`504`	`REGISTRY_UNAVAILABLE`	Tempo limite do gateway — o pedido não alcançou a API da Consulta CPF.

Para resultados MINOR_BLOCKED no Brasil, source_data continua a incluir os sinalizadores lgpd_minor, minor_under_18 e minor_under_16 para que possa aplicar fluxos adequados à idade sem tentar novamente.

Panamá (SIB — Tribunal Electoral)

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

Código de detalhe	Resultado padrão	O que significa
`601`	`REGISTRY_UNAVAILABLE`	O operador não existe na base 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 registo inválido.
`605`	`NO_MATCH`	Cidadão não reconhecido.
`606`	`INVALID_INPUT`	O campo do documento de identificação (cédula) está vazio.
`607`	`DOCUMENT_NOT_FOUND`	Cidadão não encontrado.
`608`	`REGISTRY_ERROR`	Sem acesso ao SIB para este cliente.
`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 detetado na imagem.
`615`	`BIOMETRIC_NO_MATCH`	Limiar de similaridade não atingido.

Outros países suportados

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

Bolívia, Colômbia, Costa Rica, El Salvador, Espanha, Guatemala, Honduras, Paraguai, Uruguai, Venezuela — consulta 1×1 contra o registo civil correspondente. Os resultados mapeiam diretamente para MATCH, NO_MATCH, DOCUMENT_NOT_FOUND, INVALID_DOCUMENT_FORMAT ou REGISTRY_UNAVAILABLE.
Chile (Registro Civil) — consulta de RUT. Mapeia para os resultados padrão mais MINOR_BLOCKED quando o registo sinaliza uma pessoa menor de idade.
República Dominicana (JCE) — consulta de cédula que retorna uma validade booleana; mapeia para MATCH ou NO_MATCH.
Equador (Registro Civil) — consulta de cédula.
México (RENAPO, mais INE para 2×2) — consulta de CURP através da RENAPO. Quando validation_type é two_by_two, é executado um cruzamento adicional com o INE; ambos alimentam os mesmos códigos de resultado padrão.
Peru (RENIEC) — consulta de DNI.

Procedimento de tratamento

O tratamento robusto mais simples é o seguinte:

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();
}

Não precisa de criar ramificações baseadas em outcome_detail para a lógica de negócio — use-o para análise, depuração e pedidos de suporte. O outcome_code padrão tem a garantia de se manter estável entre países e ao longo do tempo.

Ver também

Avisos de validação de base de dados — as etiquetas de aviso ao 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 de validação de base de dados — a estrutura completa da resposta e onde outcome_code / outcome_detail aparecem.
Países suportados pela validação de base de dados — a lista completa de países e métodos de correspondência.

Autenticação

Verificação

Monitorização

Plataforma

Códigos de resultado da Validação de base de dados

Códigos de resultado padrão

Códigos de detalhe específicos por país

Argentina (RENAPER)

Brasil (Receita Federal — Consulta CPF)

Panamá (SIB — Tribunal Electoral)

Outros países suportados

Procedimento de tratamento

Ver também

​Códigos de resultado padrão

​Códigos de detalhe específicos por país

​Argentina (RENAPER)

​Brasil (Receita Federal — Consulta CPF)

​Panamá (SIB — Tribunal Electoral)

​Outros países suportados

​Procedimento de tratamento

​Ver também

Códigos de resultado padrão

Códigos de detalhe específicos por país

Argentina (RENAPER)

Brasil (Receita Federal — Consulta CPF)

Panamá (SIB — Tribunal Electoral)

Outros países suportados

Procedimento de tratamento

Ver também