Saltar para o conteúdo principal
POST
Verifica o DNI argentino no registo civil oficial da RENAPER, com correspondência facial biométrica face à fotografia registada. Cobertura de 100% da população. A Didit disponibiliza este serviço através de POST /v3/database-validation/ para que possa validar os dados submetidos contra a fonte oficial e receber resultados de correspondência normalizados. Formato de entrada: document_number aceita o DNI argentino (7 a 8 dígitos, com prefixo opcional M/F).

Cobertura

  • Cobertura: 100%
  • País: Argentina
  • ID do serviço: arg_renaper
  • Domínio de dados: Identidade
  • Categoria: NationalIDRegistry
A RENAPER é o registo que emite todos os DNI argentinos, pelo que todos os números de DNI constam do registo, incluindo os emitidos a residentes estrangeiros. A correspondência facial compara a selfie com a fotografia que a RENAPER tem associada a esse DNI.

Campos de entrada

  • Campos obrigatórios: document_number, selfie, gender
  • Campos opcionais: first_name, last_name, date_of_birth, vendor_data
  • Consentimento: Não é necessário
  • Disponibilidade no fluxo: Disponível no fluxo
  • 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 alpha-3 para este serviço de base de dados.Exemplo: ARG
string
padrão:"arg_renaper"
obrigatório
Matriz que contém este ID de serviço. Fixar o serviço mantém o pedido limitado a esta base de dados exata.Exemplo: arg_renaper
string
padrão:"11111111"
obrigatório
Número do documento extraído ou fornecido pelo utilizador.Exemplo: 11111111
file
obrigatório
Ficheiro de imagem de selfie a carregar para a validação biométrica de base de dados. Formatos aceites: JPEG, PNG ou WebP.Exemplo: @./selfie.jpg
string
padrão:"M"
obrigatório
Valor do género, quando exigido pela base de dados.Valores permitidos: M (masculino), F (feminino), X (outro ou desconhecido).Exemplo: M
string
Nome próprio a validar.Exemplo: John
string
Apelido a validar.Exemplo: Doe
string
Data de nascimento no formato YYYY-MM-DD.Exemplo: 1990-01-01
string
padrão:"user-1234"
A sua referência estável de utilizador para esta pessoa, como o ID interno do utilizador. A Didit usa-a para associar verificações independentes ao mesmo utilizador final e reduzir o ruído da deteção de duplicados.Exemplo: user-1234

Regras de entrada e notas de validação

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

Como fazer a chamada

Dados devolvidos

Os campos exatos apresentados em source_data dependem do que o registo devolve. 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

Argentina - As consultas de verificação de DNI (RENAPER) são faturadas apenas quando a Didit recebe um resultado conclusivo da fonte de validação.
  • Preço por chamada: $0.20 USD.
  • Faturação: por consulta bem-sucedida. Não lhe é cobrado quando o registo não está acessível, quando faltam campos obrigatórios ou quando o pedido é rejeitado antes de chegar à fonte.
  • Latência: p95 típico < 2 s.
  • Disponibilidade: 99.9% por trimestre do lado da Didit; a disponibilidade da fonte a jusante varia consoante o país e o conjunto de dados.

Pontuação de correspondência facial

face_match_score é a semelhança calculada pela RENAPER entre o selfie e a fotografia registada para o DNI, enviada como número inteiro de 0 a 100 numa string, por exemplo "92". Não é uma probabilidade entre 0 e 1. A verificação devolve BIOMETRIC_NO_MATCH quando a RENAPER indica que o rosto não corresponde, ou quando a pontuação é inferior a 50. Com 50 ou mais, o rosto é aceite e o nome e a data de nascimento registados são então comparados com os dados enviados. A fotografia registada pode ter vários anos, pelo que um utilizador genuíno pode obter uma pontuação baixa após uma alteração grande da aparência. Considere enviar BIOMETRIC_NO_MATCH para revisão manual, em vez de o recusar de imediato, com as ações Partial Match / No Match.

Quando a RENAPER não responde

Se a RENAPER não puder ser contactada ou responder com um erro, o resultado é REGISTRY_UNAVAILABLE: nada sobre a pessoa foi verificado, e o pedido não é faturado. O mesmo pedido pode ser bem-sucedido se for repetido mais tarde. Consulte Códigos de resultado para saber como tratar este caso.

Documentos que um fluxo lê

Dentro de um fluxo, o número do DNI e o género são obtidos no passo de Verificação de identidade, que lê o cartão DNI argentino e o DNI digital. Os residentes estrangeiros têm o mesmo cartão DNI e são verificados da mesma forma. O antigo DNI em formato de livreto (libreta) não é um documento suportado pela Verificação de identidade, pelo que um utilizador que tenha apenas este documento não consegue concluir esse passo. Pode, ainda assim, verificar o número do DNI diretamente com POST /v3/database-validation/.

Utilizar num fluxo

Adicione o serviço a um passo de Validação de base de dados após a Verificação de identidade. Por exemplo, com POST /v3/workflows/:
Com um passo de Prova de vida antes dele, a RENAPER compara o selfie em direto. Sem esse passo, a Didit envia em seu lugar o retrato impresso no documento de identificação, o que confirma a fotografia do documento, mas não que a pessoa em frente à câmara é o seu titular. Um ID de serviço que o fluxo não consegue executar é rejeitado com um 400 que o indica, pelo que o passo nunca é guardado sem a verificação que pediu. Consulte Configurações de funcionalidades do fluxo para todas as definições de Validação de base de dados.

Continuar a ler

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