Pular para o conteúdo principal
POST
Verifica o DNI argentino no registro civil oficial do RENAPER, com correspondência facial biométrica com a foto cadastrada. Cobertura de 100% da população. A Didit oferece este serviço por meio de POST /v3/database-validation/ para que você verifique os dados enviados na fonte oficial e receba resultados de correspondência normalizados.

Cobertura

  • Cobertura: 100%
  • País: Argentina
  • ID do serviço: arg_renaper
  • Domínio de dados: Identidade
  • Categoria: NationalIDRegistry
O RENAPER é o registro que emite todos os DNIs argentinos, portanto todos os números de DNI constam no registro, incluindo os DNIs emitidos para residentes estrangeiros. A correspondência facial compara a selfie com a foto que o RENAPER mantém para aquele DNI.

Entradas

  • Entradas obrigatórias: document_number, selfie, gender
  • Entradas opcionais: first_name, last_name, date_of_birth, vendor_data
  • Consentimento: Não obrigatório
  • Disponibilidade no fluxo de trabalho: Disponível no fluxo de trabalho
  • Cobertura: 100%
  • Preço: $0.20 por consulta bem-sucedida

Parâmetros do corpo

string
padrão:"ARG"
obrigatório
Código de país ISO 3166-1 alfa-3 deste serviço de banco de dados.Exemplo: ARG
string
padrão:"arg_renaper"
obrigatório
Array que contém o ID deste serviço. Fixar o serviço mantém a requisição restrita a exatamente este banco de dados.Exemplo: arg_renaper
string
padrão:"11111111"
obrigatório
Número do documento extraído do documento ou informado pelo usuário.Exemplo: 11111111
file
obrigatório
Arquivo de imagem da selfie a ser enviado para a validação biométrica no banco de dados. Formatos aceitos: JPEG, PNG ou WebP.Exemplo: @./selfie.jpg
string
padrão:"M"
obrigatório
Valor de gênero, quando exigido pelo banco de dados.Valores permitidos: M (masculino), F (feminino), X (outro ou desconhecido).Exemplo: M
string
Primeiro nome a ser validado.Exemplo: John
string
Sobrenome a ser validado.Exemplo: Doe
string
Data de nascimento no formato YYYY-MM-DD.Exemplo: 1990-01-01
string
padrão:"user-1234"
Seu identificador de usuário estável para esta pessoa, como o seu ID interno de usuário. A Didit a usa para vincular verificações avulsas ao mesmo usuário final e reduzir o ruído na detecção de duplicados.Exemplo: user-1234

Regras de entrada e observações de validação

  • DNI argentino (7 a 8 dígitos, prefixo M/F opcional)
  • document_number deve ter de 7 a 9 caracteres.
  • document_number deve corresponder a [MFmf]?\d{7,8}.

Como chamar

Dados retornados

Os campos exatos exibidos em source_data dependem do que o registro retorna. O exemplo gerado para arg_renaper documenta atualmente esta estrutura normalizada:
  • date_of_birth
  • face_match_score
  • first_name
  • full_name
  • identification_number
  • last_name
  • tax_id
  • tax_id_type

Preços e SLAs

As consultas de verificação de DNI da Argentina (RENAPER) são cobradas somente quando a Didit recebe um resultado conclusivo da fonte de validação.
  • Preço por chamada: $0.20 USD.
  • Faturamento: por consulta bem-sucedida. Você não é cobrado quando o registro está inacessível, quando faltam campos obrigatórios ou quando a requisição é rejeitada antes de chegar à fonte.
  • Latência: p95 típico < 2 s.
  • Disponibilidade: 99.9% por trimestre do lado da Didit; a disponibilidade da fonte externa varia conforme o país e o conjunto de dados.

Pontuação de correspondência facial

face_match_score é a similaridade calculada pelo RENAPER entre a selfie e a foto registrada para o DNI, enviada como um número inteiro de 0 a 100 em uma string, por exemplo "92". Não é uma probabilidade entre 0 e 1. A verificação retorna BIOMETRIC_NO_MATCH quando o RENAPER informa que o rosto não corresponde ou quando a pontuação é inferior a 50. A partir de 50, o rosto é aceito, e o nome registrado e a data de nascimento são então comparados com os dados que você enviou. A foto registrada pode ter vários anos, então um usuário legítimo pode obter uma pontuação baixa após uma grande mudança de aparência. Considere encaminhar BIOMETRIC_NO_MATCH para revisão manual em vez de recusá-lo diretamente, usando as ações de Partial Match / No Match.

Quando o RENAPER não responde

Se o RENAPER não puder ser acessado ou responder com um erro, o resultado é REGISTRY_UNAVAILABLE: nada sobre a pessoa foi verificado, e a requisição não é cobrada. A mesma requisição pode ter sucesso quando você tentar novamente mais tarde. Consulte Códigos de resultado para saber como lidar com isso.

Documentos que um fluxo lê

Dentro de um fluxo de verificação (workflow), o número do DNI e o gênero vêm da etapa de Verificação de identidade, que lê o cartão DNI argentino e o DNI digital. Residentes estrangeiros possuem o mesmo cartão DNI e são verificados da mesma forma. O antigo DNI em formato de caderneta (libreta) não é um documento aceito pela Verificação de identidade, então um usuário que possui apenas esse documento não consegue concluir essa etapa. Você ainda pode verificar o número do DNI diretamente com POST /v3/database-validation/.

Uso em um fluxo

Adicione o serviço a uma etapa de Validação de banco de dados após a Verificação de identidade. Por exemplo, com POST /v3/workflows/:
Com uma etapa de Prova de vida antes dela, o RENAPER compara a selfie ao vivo. Sem ela, a Didit envia o retrato impresso no documento de identidade, o que confirma a foto do documento, mas não que a pessoa diante da câmera é a titular. Um ID de serviço que o fluxo não pode executar é rejeitado com um 400 que o identifica, de modo que a etapa nunca é salva sem a verificação que você solicitou. Consulte Configurações de recursos do fluxo para ver todas as configurações de Validação de banco de dados.

Continue a leitura

Última modificação em 1 de novembro de 2026