API de verificación del Número de Verificación Bancaria (BVN) de Nigeria (ES)

Incorporar usuarios en Nigeria implica confirmar que son quienes dicen ser. Verifica los datos de entrada contra la base de datos de la industria bancaria nigeriana. Un documento o un detalle escrito solo prueba que los datos existen, no que sean genuinos o pertenezcan a la persona que tiene delante. La Verificación del Número de Verificación Bancaria (BVN) de Nigeria cierra esa brecha al cotejar los datos con el BVN. Esta guía explica qué hace la verificación, los detalles técnicos exactos y cómo integrarla en minutos.

Puntos clave:

• Qué verifica — La Verificación del Número de Verificación Bancaria (BVN) de Nigeria valida la cuenta bancaria contra el BVN.
• Qué obtiene de vuelta — un match_type normalizado más resultados a nivel de campo que puede dirigir directamente a la lógica de aprobación/revisión/rechazo.
• Por qué es importante — Confirmar la identidad del titular de la cuenta previene el fraude de pagos y apoya la incorporación de pagos y nóminas.
• Cómo usarlo — una solicitud POST al endpoint de validación de base de datos de Didit. $0.80 por consulta concluyente, resultados en segundos.

Qué valida la Verificación del Número de Verificación Bancaria (BVN) de Nigeria

Verifica los datos de entrada contra la base de datos de la industria bancaria nigeriana. Didit lo expone a través de un único endpoint para que pueda verificar los datos enviados contra la red nacional de banca/propiedad de cuentas y recibir un resultado estructurado y normalizado, no un volcado de registro en bruto que tenga que analizar usted mismo.

Una respuesta concluyente devuelve los source_data coincidentes y un bloque de validation por campo, para que su motor de riesgo obtenga un veredicto claro y legible por máquina.

Por qué es importante

Confirmar la identidad del titular de la cuenta previene el fraude de pagos y apoya la incorporación de pagos y nóminas.

Para las empresas reguladas en Nigeria — fintechs, plataformas de criptomonedas, prestamistas, mercados y operadores de juegos — la verificación contra una fuente autorizada produce un registro defendible y auditable de que la identidad fue confirmada en la fuente, no solo capturada de un formulario o una foto.

Detalles técnicos

Didit expone este servicio a través del endpoint unificado de validación de base de datos. Es un único POST, no se requiere SDK.

Endpoint

POST /v3/database-validation/

Parámetros de solicitud

Parámetro	Tipo	Requerido	Descripción
issuing_state	string	Sí	Código de país ISO 3166-1 alpha-3. Use NGA.
services	string	Sí	Identificador de servicio. Use nga_bank_verification_number.
first_name	string	Sí	Primer nombre.
last_name	string	Sí	Apellido.
bvn	string	Sí	Bvn.
date_of_birth	string	No	Fecha de nacimiento (verificación cruzada opcional).

Ejemplo de solicitud

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=NGA" \
  -F "services=nga_bank_verification_number" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "bvn=11111111111"

Ejemplo de respuesta (coincidencia concluyente)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "NGA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "nga_bank_verification_number",
      "service_name": "Nigeria Bank Verification Number (BVN)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match"
      }
    }
  ]
}

Rendimiento y facturación

• Latencia: típicamente un par de segundos.
• Costo: $0.80 por consulta concluyente. Solo se le factura por resultados concluyentes — no hay cargo por tiempo de inactividad de la fuente, campos faltantes o rechazos previos a la fuente.
• Fiabilidad: funciona en la infraestructura de Didit con un objetivo de tiempo de actividad trimestral del 99.9%.

Casos de uso

• Fintech y neobancos — confirme un titular de cuenta real y verificable antes de abrir una billetera o extender crédito en Nigeria.
• Cripto y Web3 — cumpla con los requisitos de incorporación de VASP con prueba de identidad de fuente autorizada.
• Préstamos — reduzca el fraude de identidad sintética y de primera parte con datos verificados en la fuente.
• Mercados y plataformas de empleo — verifique a los usuarios contra datos autorizados, no solo un formulario autoinformado.
• iGaming — satisfaga las verificaciones de identidad y elegibilidad para jugadores de Nigeria con un rastro auditable.

Cómo integrarse con Didit

Puede ejecutar la Verificación del Número de Verificación Bancaria (BVN) de Nigeria de dos maneras:

1. Solo API directa. Este servicio se ejecuta a través de la API en lugar del creador de flujo de trabajo sin código.
2. API directa. Llame al endpoint /v3/database-validation/ que se muestra arriba con services=nga_bank_verification_number. Lea match_type y el bloque de validation por campo para impulsar su lógica de aprobación/revisión/rechazo.

Cada cuenta de Didit incluye 500 verificaciones gratuitas por mes, para que pueda probar el flujo completo de principio a fin antes de pagar por una sola consulta.

Preguntas frecuentes

¿Qué confirma la verificación del Número de Verificación Bancaria (BVN) de Nigeria?

Valida los datos enviados contra el BVN y devuelve un resultado de coincidencia normalizado, para que sepa si la cuenta bancaria existe en la fuente autorizada y qué campos coincidieron.

¿Qué sucede si la fuente no está disponible temporalmente?

No se le cobra. La facturación solo se aplica a resultados concluyentes — el tiempo de inactividad de la fuente, los campos faltantes y los rechazos previos a la fuente son gratuitos.

¿Qué tan rápida es la verificación?

La validación de la base de datos generalmente se devuelve en un par de segundos, por lo que encaja en un flujo de incorporación en tiempo real.

¿Necesito un SDK?

No. La verificación es un único POST HTTPS a un solo endpoint.

¿Listo para empezar?

Valide su primera cuenta bancaria de Nigeria hoy mismo.

• Lea la referencia de la API: Verificación del Número de Verificación Bancaria (BVN) de Nigeria
• Vea todas las validaciones de base de datos: Precios y cobertura de la validación de bases de datos
• Empiece a construir: Cree una cuenta gratuita de Didit — 500 verificaciones al mes, gratis.