Saltar al contenido principal
POST
Verifica el DNI argentino contra el registro civil oficial de RENAPER, con coincidencia facial biométrica contra la foto registrada. Cobertura del 100% de la población. Didit ofrece este servicio a través de POST /v3/database-validation/ para que verifiques los datos enviados contra la fuente oficial y recibas resultados de coincidencia normalizados.

Cobertura

  • Cobertura: 100%
  • País: Argentina
  • ID de servicio: arg_renaper
  • Dominio de datos: Identidad
  • Categoría: NationalIDRegistry
RENAPER es el registro que emite todos los DNI argentinos, por lo que todos los números de DNI están registrados, incluidos los DNI emitidos a residentes extranjeros. La coincidencia facial compara la selfie con la foto que RENAPER tiene para ese DNI.

Datos de entrada

  • Datos obligatorios: document_number, selfie, gender
  • Datos opcionales: first_name, last_name, date_of_birth, vendor_data
  • Consentimiento: No requerido
  • Disponibilidad en flujos: Disponible en flujos de trabajo
  • Cobertura: 100%
  • Precio: $0.20 por consulta exitosa

Parámetros del cuerpo

string
predeterminado:"ARG"
requerido
Código de país ISO 3166-1 alfa-3 para este servicio de base de datos.Ejemplo: ARG
string
predeterminado:"arg_renaper"
requerido
Array que contiene este ID de servicio. Fijar el servicio limita la solicitud a esta base de datos concreta.Ejemplo: arg_renaper
string
predeterminado:"11111111"
requerido
Número de documento extraído o proporcionado por el usuario.Ejemplo: 11111111
file
requerido
Archivo de imagen de la selfie que se sube para la validación biométrica en la base de datos. Formatos aceptados: JPEG, PNG o WebP.Ejemplo: @./selfie.jpg
string
predeterminado:"M"
requerido
Valor de género, cuando la base de datos lo requiere.Valores permitidos: M (masculino), F (femenino), X (otro o desconocido).Ejemplo: M
string
Nombre de pila que se va a validar.Ejemplo: John
string
Apellido que se va a validar.Ejemplo: Doe
string
Fecha de nacimiento en formato YYYY-MM-DD.Ejemplo: 1990-01-01
string
predeterminado:"user-1234"
Tu referencia estable de usuario para esta persona, como tu ID de usuario interno. Didit la usa para vincular las comprobaciones independientes al mismo usuario final y reducir el ruido en la detección de duplicados.Ejemplo: user-1234

Reglas de entrada y notas de validación

  • DNI argentino (7-8 dígitos, prefijo M/F opcional)
  • document_number debe tener entre 7 y 9 caracteres.
  • document_number debe coincidir con [MFmf]?\d{7,8}.

Cómo invocarlo

Datos devueltos

Los campos exactos que aparecen en source_data dependen de lo que devuelva el registro. El ejemplo generado para arg_renaper documenta actualmente esta estructura normalizada:
  • date_of_birth
  • face_match_score
  • first_name
  • full_name
  • identification_number
  • last_name
  • tax_id
  • tax_id_type

Precios y SLA

Las consultas de Argentina - Verificación de DNI (RENAPER) solo se facturan cuando Didit recibe un resultado concluyente de la fuente de validación.
  • Precio por llamada: $0.20 USD.
  • Facturación: por consulta exitosa. No se te cobra cuando el registro no está disponible, cuando faltan campos obligatorios o cuando la solicitud se rechaza antes de llegar a la fuente.
  • Latencia: p95 típico < 2 s.
  • Disponibilidad: 99.9% por trimestre por parte de Didit; la disponibilidad de la fuente externa varía según el país y el conjunto de datos.

Puntuación de coincidencia facial

face_match_score es la similitud que calcula RENAPER entre la selfie y la foto registrada para el 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 comprobació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, a continuación, el nombre y la fecha de nacimiento registrados se comparan con los datos que enviaste. La foto registrada puede tener varios años, por lo 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, mediante las acciones de Partial Match / No Match.

Cuando RENAPER no responde

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

Documentos que lee un flujo

Dentro de un flujo de verificación (workflow), 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 forma. El antiguo DNI en formato libreta (libreta) no es un documento admitido en la Verificación de identidad, por lo que un usuario que solo tenga ese documento no puede completar ese paso. Aun así, puedes comprobar su número de DNI directamente con POST /v3/database-validation/.

Usarlo en un flujo

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 hay un paso de Prueba de vida antes, RENAPER compara la selfie tomada en vivo. Si no lo hay, 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 identifica, de modo que el paso nunca se guarda sin la comprobación que solicitaste. Consulta Configuración de funciones del flujo para ver todos los ajustes de Validación de base de datos.

Continúa leyendo

Última modificación el 1 de noviembre de 2026