Saltar al contenido principal
POST
Verifica los datos de entrada con la base de datos del sector bancario nigeriano. Requiere una selfie: el retrato de enrolamiento asociado al BVN se compara con ella mediante coincidencia facial, 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 con la fuente oficial y recibir resultados de coincidencia normalizados.

Cobertura

  • Cobertura: ~ 100%
  • País: Nigeria
  • ID del servicio: nga_bank_verification_number
  • Dominio de datos: Financiero
  • Categoría: Banca

Datos de entrada

  • Datos de entrada obligatorios: bvn, selfie
  • Datos de entrada opcionales: first_name, last_name, date_of_birth, vendor_data
  • Consentimiento: No se requiere
  • Disponibilidad en flujos de verificación (workflow): Disponible en el flujo con mapeo de campos
  • Cobertura: ~ 100%
  • Precio: $0.35 por consulta exitosa
En un flujo, bvn no figura impreso en un documento de identidad, así que ningún paso lo genera por sí solo. Obtenlo de la respuesta a un Cuestionario, de un campo de extracción de Document AI o de un valor que envíes al crear la sesión, y mapéalo en el paso de Validación de base de datos. Mientras no esté mapeado, el editor de flujos muestra este servicio desactivado e indica el dato de entrada que falta; en tiempo de ejecución, si falta un dato de entrada, la comprobación se omite antes de realizar cualquier consulta, por lo que nunca se te factura por una base de datos a la que no se pudo consultar.

Parámetros del cuerpo

string
predeterminado:"NGA"
requerido
Código de país ISO 3166-1 alfa-3 para este servicio de base de datos.Ejemplo: NGA
string
predeterminado:"nga_bank_verification_number"
requerido
Array que contiene el ID de este servicio. Fijar el servicio limita la solicitud a esta base de datos concreta.Ejemplo: nga_bank_verification_number
string
predeterminado:"11111111111"
requerido
Número de verificación bancaria (Bank Verification Number).Ejemplo: 11111111111
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
Nombre de pila que se va a validar.Ejemplo: John
string
Apellido que se va a validar.Ejemplo: Doe
string
predeterminado:"1990-01-01"
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

  • Número de verificación bancaria de Nigeria (exactamente 11 dígitos)
  • bvn solo debe contener dígitos; elimina espacios, guiones y signos de puntuación antes de enviar la solicitud.
  • bvn 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_bank_verification_number documenta actualmente esta estructura normalizada:
  • date_of_birth
  • first_name
  • last_name

Precios y SLA

Las consultas del Número de verificación bancaria (BVN) de Nigeria 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 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.

Seguir leyendo

Última modificación el 1 de noviembre de 2026