Saltar al contingut principal
POST
Verifica el DNI argentí amb el registre civil oficial de RENAPER, amb coincidència facial biomètrica amb la fotografia registrada. 100% de cobertura de la població. Didit ofereix aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font autoritativa i rebre resultats de coincidència normalitzats. Format d’entrada: document_number accepta el DNI argentí (7-8 dígits, amb prefix M/F opcional).

Cobertura

  • Cobertura: 100%
  • País: Argentina
  • ID del servei: arg_renaper
  • Àmbit de dades: Identitat
  • Categoria: NationalIDRegistry
RENAPER és el registre que emet tots els DNI argentins, de manera que tots els números de DNI consten en el registre, inclosos els DNI emesos a residents estrangers. La coincidència facial compara la selfie amb la fotografia que RENAPER té per a aquest DNI.

Entrades

  • Entrades obligatòries: document_number, selfie, gender
  • Entrades opcionals: first_name, last_name, date_of_birth, vendor_data
  • Consentiment: No cal
  • Disponibilitat al flux de treball: Disponible al flux de treball
  • Cobertura: 100%
  • Preu: $0.20 per consulta satisfactòria

Paràmetres del cos

string
predeterminat:"ARG"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.Exemple: ARG
string
predeterminat:"arg_renaper"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: arg_renaper
string
predeterminat:"11111111"
requerit
Número de document extret de l’usuari o proporcionat per l’usuari.Exemple: 11111111
file
requerit
Fitxer d’imatge de la selfie que cal pujar per a la validació biomètrica en bases de dades. Formats acceptats: JPEG, PNG o WebP.Exemple: @./selfie.jpg
string
predeterminat:"M"
requerit
Valor de gènere, quan la base de dades el requereix.Valors permesos: M (home), F (dona), X (altre o desconegut).Exemple: M
string
Nom de pila que cal validar.Exemple: John
string
Cognoms que cal validar.Exemple: Doe
string
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
string
predeterminat:"user-1234"
La teva referència estable d’usuari per a aquesta persona, com ara el teu ID intern d’usuari. Didit l’utilitza per enllaçar les comprovacions independents amb el mateix usuari final i reduir el soroll de detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • DNI argentí (7-8 dígits, amb prefix M/F opcional)
  • document_number ha de tenir entre 7 i 9 caràcters.
  • document_number ha de coincidir amb [MFmf]?\d{7,8}.

Com fer la crida

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a arg_renaper documenta actualment aquesta forma normalitzada:
  • date_of_birth
  • face_match_score
  • first_name
  • full_name
  • identification_number
  • last_name
  • tax_id
  • tax_id_type

Preus i SLA

Argentina: les consultes de verificació de DNI (RENAPER) es facturen només quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $0.20 USD.
  • Facturació: per consulta satisfactòria. No es cobra quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
  • Latència: p95 típic < 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font dependent varia segons el país i el conjunt de dades.

Puntuació de coincidència facial

face_match_score és la similitud que RENAPER calcula entre la selfie i la fotografia registrada del DNI. S’envia com a nombre enter de 0 a 100 dins d’una cadena de text, per exemple "92". No és una probabilitat entre 0 i 1. La verificació retorna BIOMETRIC_NO_MATCH quan RENAPER indica que la cara no coincideix, o quan la puntuació és inferior a 50. A partir de 50 la cara s’accepta i després es comparen el nom i la data de naixement registrats amb les dades que has enviat. La fotografia registrada pot tenir diversos anys, així que un usuari legítim pot obtenir una puntuació baixa si el seu aspecte ha canviat molt. Considera enviar BIOMETRIC_NO_MATCH a revisió manual en lloc de rebutjar-lo directament, amb les accions de coincidència parcial / sense coincidència.

Quan RENAPER no respon

Si no es pot connectar amb RENAPER o respon amb un error, el resultat és REGISTRY_UNAVAILABLE: no s’ha comprovat res sobre la persona i no se’t factura la crida. La mateixa sol·licitud pot reeixir si la reintentes més tard. Consulta Codis de resultat per saber com gestionar-ho.

Documents que llegeix un flux de treball

Dins d’un flux de treball, el número de DNI i el gènere provenen del pas de Verificació d’identitat, que llegeix la targeta DNI argentina i el DNI digital. Els residents estrangers tenen la mateixa targeta DNI i es verifiquen de la mateixa manera. El DNI antic en format llibreta (libreta) no és un document compatible amb la Verificació d’identitat, així que un usuari que només en tingui un no pot completar aquest pas. Tot i això, pots comprovar directament el número de DNI amb POST /v3/database-validation/.

Utilitza-ho en un flux de treball

Afegeix el servei a un pas de Validació en bases de dades després de la Verificació d’identitat. Per exemple, amb POST /v3/workflows/:
Si hi ha un pas de Prova de vida abans, RENAPER compara la selfie en directe. Si no n’hi ha, Didit envia en lloc de la selfie en directe el retrat imprès al document d’identitat, que confirma la fotografia del document però no que la persona davant la càmera sigui el seu titular. Un ID de servei que el flux de treball no pot executar es rebutja amb un 400 que l’esmenta, de manera que el pas mai no es desa sense la comprovació que has demanat. Consulta Configuració de funcionalitats del flux de treball per veure totes les opcions de Validació en bases de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026