Vai al contenuto principale
POST
Verifica il DNI argentino rispetto al registro anagrafico ufficiale RENAPER, con confronto facciale biometrico rispetto alla foto archiviata. Copertura del 100% della popolazione. Didit espone questo servizio tramite POST /v3/database-validation/, così puoi verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati. Formato di input: document_number accetta il DNI argentino (7-8 cifre, prefisso M/F facoltativo).

Copertura

  • Copertura: 100%
  • Paese: Argentina
  • ID servizio: arg_renaper
  • Dominio dati: Identità
  • Categoria: NationalIDRegistry
RENAPER è il registro che emette ogni DNI argentino, quindi ogni numero di DNI è presente negli archivi, compresi i DNI rilasciati a residenti stranieri. Il confronto facciale mette a confronto il selfie con la foto che RENAPER conserva per quel DNI.

Input

  • Input obbligatori: document_number, selfie, gender
  • Input facoltativi: first_name, last_name, date_of_birth, vendor_data
  • Consenso: Non richiesto
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: 100%
  • Prezzo: $0.20 per query riuscita

Parametri del body

string
predefinito:"ARG"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: ARG
string
predefinito:"arg_renaper"
obbligatorio
Array contenente l’ID di questo servizio. Specificare il servizio limita la richiesta a questo database specifico.Esempio: arg_renaper
string
predefinito:"11111111"
obbligatorio
Numero del documento estratto o fornito dall’utente.Esempio: 11111111
file
obbligatorio
File immagine del selfie da caricare per la validazione biometrica su database. Formati accettati: JPEG, PNG o WebP.Esempio: @./selfie.jpg
string
predefinito:"M"
obbligatorio
Valore del genere, quando richiesto dal database.Valori consentiti: M (maschio), F (femmina), X (altro o sconosciuto).Esempio: M
string
Nome da validare.Esempio: John
string
Cognome da validare.Esempio: Doe
string
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo utilizza per collegare le verifiche autonome allo stesso utente finale e ridurre i falsi rilevamenti di duplicati.Esempio: user-1234

Regole di input e note di validazione

  • DNI argentino (7-8 cifre, prefisso M/F facoltativo)
  • document_number deve essere lungo 7-9 caratteri.
  • document_number deve corrispondere a [MFmf]?\d{7,8}.

Come effettuare la chiamata

Dati restituiti

I campi esatti esposti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per arg_renaper documenta attualmente questa struttura normalizzata:
  • date_of_birth
  • face_match_score
  • first_name
  • full_name
  • identification_number
  • last_name
  • tax_id
  • tax_id_type

Prezzi e SLA

Argentina: le query di verifica del DNI (RENAPER) vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.20 USD.
  • Fatturazione: per query riuscita. Non viene addebitato alcun costo quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
  • Latenza: p95 tipico inferiore a 2 s.
  • Disponibilità: 99.9% per trimestre lato Didit; la disponibilità della fonte a valle varia in base al paese e al dataset.

Puntuación de coincidencia facial

face_match_score es la similitud que RENAPER calcula entre el selfie y la foto registrada del DNI, enviada como un número entero de 0 a 100 dentro de una cadena, por ejemplo "92". No es una probabilidad entre 0 y 1. La verificación devuelve BIOMETRIC_NO_MATCH cuando RENAPER indica que el rostro no coincide, o cuando la puntuación es inferior a 50. Con 50 o más, el rostro se acepta y luego se comparan el nombre y la fecha de nacimiento registrados con los datos que enviaste. La foto registrada puede tener varios años, así que un usuario legítimo puede obtener una puntuación baja tras un cambio importante de apariencia. Considera enviar BIOMETRIC_NO_MATCH a revisión manual en lugar de rechazarlo directamente, con las acciones de Partial Match / No Match.

Cuando RENAPER no responde

Si no se puede contactar con RENAPER o responde con un error, el resultado es REGISTRY_UNAVAILABLE: no se verificó nada sobre la persona y la llamada no se factura. La misma solicitud puede tener éxito si la reintentas más tarde. Consulta Códigos de resultado para saber cómo gestionarlo.

Documentos que lee un flujo de verificación

Dentro de un flujo de verificación, el número de DNI y el género provienen del paso de Verificación de identidad, que lee la tarjeta DNI argentina y el DNI digital. Los residentes extranjeros tienen la misma tarjeta DNI y se verifican de la misma manera. El DNI antiguo en formato libreta (libreta) no es un documento admitido por la Verificación de identidad, así que un usuario que solo tenga ese documento no puede completar ese paso. Aun así, puedes consultar directamente su número de DNI con POST /v3/database-validation/.

Uso en un flujo de verificación

Añade el servicio a un paso de Validación de base de datos después de la Verificación de identidad. Por ejemplo, con POST /v3/workflows/:
Si el flujo tiene un paso de Prueba de vida antes, RENAPER compara el selfie en vivo. Sin ese paso, Didit envía en su lugar el retrato impreso en el documento de identidad, lo que confirma la foto del documento pero no que la persona frente a la cámara sea su titular. Un ID de servicio que el flujo no puede ejecutar se rechaza con un 400 que lo nombra, de modo que el paso nunca se guarda sin la verificación que pediste. Consulta Configuración de funciones del flujo de verificación para ver todos los ajustes de Validación de base de datos.

Seguir leyendo

Ultima modifica il 7 novembre 2026