Saltar al contenido principal
POST
Verifica un Número de Identificación Nacional (NIN) de Nigeria contra el registro de la National Identity Management Commission. Requiere una selfie: el retrato tomado durante el registro y asociado al NIN se compara facialmente con ella, y el registro solo se devuelve cuando ambos corresponden a la misma persona. Didit ofrece este servicio a través de POST /v3/database-validation/ para que puedas verificar los datos enviados contra la fuente oficial y recibir resultados de coincidencia normalizados.

Cobertura

  • Cobertura: ~ 100%
  • País: Nigeria
  • ID del servicio: nga_national_id_facial
  • Dominio de datos: Identidad
  • Categoría: NationalIDRegistry

Datos de entrada

  • Datos de entrada obligatorios: national_id, selfie
  • Datos de entrada opcionales: first_name, last_name, date_of_birth, vendor_data
  • Consentimiento: No requerido
  • Disponibilidad en flujos de verificación (workflow): Disponible en flujos
  • Cobertura: ~ 100%
  • Precio: $0.35 por consulta exitosa
No todos los documentos que acepta este servicio contienen el identificador con el que se realiza la consulta. Cuando el identificador no se extrae del documento, la comprobación se registra como no aplicable: no se consulta ninguna base de datos y no se te cobra, lo que en algunos países representa una gran proporción de los usuarios reales. Para cubrirlos, recoge también el identificador a partir de una respuesta de un Cuestionario, un campo de extracción de Document AI o un valor que envíes al crear la sesión, y asígnalo al paso de Validación de base de datos.

Parámetros del cuerpo

string
predeterminado:"NGA"
requerido
Código de país ISO 3166-1 alfa-3 de este servicio de base de datos.Ejemplo: NGA
string
predeterminado:"nga_national_id_facial"
requerido
Array que contiene el ID de este servicio. Fijar el servicio limita la solicitud a esta base de datos concreta.Ejemplo: nga_national_id_facial
string
predeterminado:"11111111111"
requerido
Número de identidad nacional para este servicio.Ejemplo: 11111111111
file
requerido
Archivo de imagen de la selfie que se sube para la validación en la base de datos biométrica. Formatos aceptados: JPEG, PNG o WebP.Ejemplo: @./selfie.jpg
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

  • first_name debe coincidir con [A-Za-zÀ-ÖØ-öø-ÿ .'-]+.
  • national_id solo debe contener dígitos; elimina los espacios, guiones y signos de puntuación antes de enviar la solicitud.
  • national_id debe tener exactamente 11 caracteres.

Cómo invocarlo

Datos devueltos

Los campos exactos que aparecen en source_data dependen de lo que devuelva el registro. El ejemplo generado para nga_national_id_facial documenta actualmente esta estructura normalizada:
  • address
  • birth_country
  • birth_lga
  • birth_state
  • date_of_birth
  • face_match_score
  • first_name
  • gender
  • identification_number
  • last_name
  • marital_status
  • middle_name
  • phone_number
  • photo_available
  • residence_lga
  • residence_state
  • residence_town

Precios y SLA

Las consultas de identificación nacional de Nigeria + selfie (NIMC) solo se facturan cuando Didit recibe un resultado concluyente de la fuente de validación.
  • Precio por llamada: $0.35 USD.
  • Facturación: por consulta exitosa. No se te cobra cuando no se puede acceder al registro, cuando faltan campos obligatorios o cuando la solicitud se rechaza antes de llegar a la fuente.
  • Latencia: p95 habitual < 2 s.
  • Disponibilidad: 99.9% por trimestre por parte de Didit; la disponibilidad de la fuente subyacente varía según el país y el conjunto de datos.

Selfie y coincidencia facial

El registro de la NIMC responde a un NIN válido con el expediente completo de su titular, así que conocer un número no demuestra ser su propietario. Por eso, cada consulta va vinculada a una selfie: se compara con la foto de inscripción que la NIMC tiene para ese NIN, y el expediente solo se devuelve cuando ambas corresponden a la misma persona.
  • Coincidencia: source_data contiene el expediente de la NIMC y face_match_score. Los nombres y la fecha de nacimiento que envíes se comparan con él y el resultado se indica en validation; envíalos para obtener un veredicto sobre el nombre y la fecha de nacimiento, u omítelos y lee los valores del registro en source_data.
  • Persona distinta: BIOMETRIC_NO_MATCH. Solo se devuelve face_match_score, sin datos personales.
  • Coincidencia imposible: INCONCLUSIVE cuando la NIMC no tiene ninguna foto para el NIN o no se pudo detectar ningún rostro. No se devuelve nada y la verificación se envía a revisión.
  • NIN desconocido: DOCUMENT_NOT_FOUND. La consulta se cobra.
En un flujo de verificación, la selfie se toma del paso de prueba de vida o de coincidencia facial, o del retrato del documento subido cuando el flujo no tiene ningún paso facial. Una solicitud sin selfie, o con un NIN que no tenga 11 dígitos, se rechaza antes de que se cobre nada.

Continúa leyendo

Última modificación el 1 de noviembre de 2026