API de Verificació del Número de Verificació Bancària (BVN) de Nigèria (CA)

L'onboarding d'usuaris a Nigèria implica confirmar que són qui diuen ser. Es verifiquen les dades d'entrada amb la base de dades de la indústria bancària nigeriana. Un document o una dada introduïda només demostra que la dada existeix, no que sigui genuïna o que pertanyi a la persona que teniu davant. La verificació del número de verificació bancària (BVN) de Nigèria tanca aquesta bretxa comprovant les dades amb el BVN. Aquesta guia explica què fa la comprovació, els detalls tècnics exactes i com integrar-la en minuts.

Punts clau:

• Què comprova — La verificació del número de verificació bancària (BVN) de Nigèria valida el compte bancari amb el BVN.
• Què obtens — un match_type normalitzat més resultats a nivell de camp que pots dirigir directament a la lògica d'aprovació / revisió / rebuig.
• Per què és important — Confirmar la identitat del titular del compte prevé el frau en pagaments i dona suport a l'onboarding de pagaments i nòmines.
• Com utilitzar-lo — un POST a l'endpoint de validació de bases de dades de Didit. 0,80 $ per consulta concloent, resultats en segons.

Què valida la verificació del número de verificació bancària (BVN) de Nigèria

Verifica les dades d'entrada amb la base de dades de la indústria bancària nigeriana. Didit l'exposa a través d'un únic endpoint perquè puguis verificar les dades enviades amb la xarxa bancària / de propietat de comptes nacional i rebre un resultat estructurat i normalitzat, no un abocament de registre brut que hagis d'analitzar tu mateix.

Una resposta concloent retorna les source_data coincident i un bloc de validation per camp, de manera que el teu motor de risc obté un veredicte clar i llegible per màquina.

Per què és important

Confirmar la identitat del titular del compte prevé el frau en pagaments i dona suport a l'onboarding de pagaments i nòmines.

Per a les empreses regulades a Nigèria — fintechs, plataformes de criptomonedes, prestadors, mercats i operadors de jocs — la comprovació contra una font autoritzada produeix un registre defensable i auditable que la identitat es va confirmar a la font, no només es va capturar d'un formulari o una foto.

Detalls tècnics

Didit exposa aquest servei a través de l'endpoint unificat de validació de bases de dades. És un únic POST — no es requereix SDK.

Endpoint

POST /v3/database-validation/

Paràmetres de la sol·licitud

Paràmetre	Tipus	Requerit	Descripció
issuing_state	string	Sí	Codi de país ISO 3166-1 alpha-3. Utilitzeu NGA.
services	string	Sí	Identificador del servei. Utilitzeu nga_bank_verification_number.
first_name	string	Sí	Nom.
last_name	string	Sí	Cognom.
bvn	string	Sí	Bvn.
date_of_birth	string	No	Data de naixement (comprovació creuada opcional).

Exemple de sol·licitud

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"

Exemple de resposta (coincidència concloent)

{
  "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"
      }
    }
  ]
}

Rendiment i facturació

• Latència: normalment un parell de segons.
• Cost: 0,80 $ per consulta concloent. Només se't factura pels resultats concloents — sense càrrec per temps d'inactivitat de la font, camps que falten o rebuigs previs a la font.
• Fiabilitat: funciona a la infraestructura de Didit amb un objectiu de temps d'activitat trimestral del 99,9%.

Casos d'ús

• Fintech i neobancs — confirma un titular de compte real i verificable abans d'obrir una cartera o concedir crèdit a Nigèria.
• Cripto i Web3 — compleix els requisits d'onboarding de VASP amb proves d'identitat de font autoritzada.
• Préstecs — redueix el frau d'identitat sintètica i de primera part amb dades verificades per la font.
• Mercats i plataformes de serveis — verifica els usuaris amb dades autoritzades, no només amb un formulari auto-informat.
• iGaming — satisfà les comprovacions d'identitat i elegibilitat per als jugadors de Nigèria amb un registre auditable.

Com integrar-se amb Didit

Pots executar la verificació del número de verificació bancària (BVN) de Nigèria de dues maneres:

1. Només API directa. Aquest servei s'executa mitjançant l'API en lloc del constructor de fluxos de treball sense codi.
2. API directa. Truca a l'endpoint /v3/database-validation/ mostrat anteriorment amb services=nga_bank_verification_number. Llegeix match_type i el bloc de validation per camp per impulsar la teva lògica d'aprovació / revisió / rebuig.

Cada compte de Didit inclou 500 verificacions gratuïtes al mes, perquè puguis provar el flux complet de principi a fi abans de pagar per una sola consulta.

Preguntes freqüents

Què confirma la comprovació de la verificació del número de verificació bancària (BVN) de Nigèria?

Valida les dades enviades amb el BVN i retorna un resultat de coincidència normalitzat, de manera que saps si el compte bancari existeix a la font autoritzada i quins camps han coincidit.

Què passa si la font no està disponible temporalment?

No se't cobra. La facturació només s'aplica als resultats concloents — el temps d'inactivitat de la font, els camps que falten i els rebuigs previs a la font són gratuïts.

Quant de ràpid és la comprovació?

La validació de la base de dades sol retornar-se en un parell de segons, de manera que s'adapta a un flux d'onboarding en temps real.

Necessito un SDK?

No. La comprovació és un únic POST HTTPS a un endpoint.

Llest per començar?

Valida el teu primer compte bancari de Nigèria avui mateix.

• Llegeix la referència de l'API: Verificació del número de verificació bancària (BVN) de Nigèria
• Consulta totes les validacions de bases de dades: Preus i cobertura de la validació de bases de dades
• Comença a construir: Crea un compte gratuït de Didit — 500 verificacions al mes, gratis.