Saltar al contingut principal
POST
Verifica les dades introduïdes amb la base de dades del Nigerian Banking Industry. Cal un selfie: el retrat de registre associat al BVN es compara facialment amb aquest selfie, i el registre només es retorna quan tots dos corresponen a la mateixa persona. Didit ofereix aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font autoritzada i rebre resultats de coincidència normalitzats. Format d’entrada: bvn accepta el Nigerian Bank Verification Number (exactament 11 dígits).

Cobertura

  • Cobertura: ~ 100%
  • País: Nigèria
  • ID del servei: nga_bank_verification_number
  • Domini de dades: Financer
  • Categoria: Banca

Entrades

  • Entrades obligatòries: bvn, selfie
  • Entrades opcionals: first_name, last_name, date_of_birth, vendor_data
  • Consentiment: No cal
  • Disponibilitat al flux: Disponible al flux de treball amb mapatge de camps
  • Cobertura: ~ 100%
  • Preu: $0.35 per consulta satisfactòria
En un flux de treball, bvn no apareix imprès en cap document d’identitat, de manera que cap pas no el produeix per si sol. Recull-lo d’una resposta d’un qüestionari, d’un camp d’extracció de Document AI o d’un valor que enviïs en crear la sessió, i mapa’l al pas de Validació en bases de dades. Mentre no estigui mapat, l’editor de fluxos mostra aquest servei desactivat i indica quina entrada falta; en temps d’execució, una entrada que falta fa que la comprovació s’omet abans de cap consulta, de manera que mai no es factura una base de dades que no s’ha pogut consultar.

Paràmetres del cos

string
predeterminat:"NGA"
requerit
Codi de país ISO 3166-1 alfa-3 per a aquest servei de base de dades.Exemple: NGA
string
predeterminat:"nga_bank_verification_number"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: nga_bank_verification_number
string
predeterminat:"11111111111"
requerit
Bank Verification Number.Exemple: 11111111111
file
requerit
Fitxer d’imatge selfie per pujar per a la validació biomètrica de la base de dades. Formats acceptats: JPEG, PNG o WebP.Exemple: @./selfie.jpg
string
Nom de pila a validar.Exemple: John
string
Cognoms a validar.Exemple: Doe
string
predeterminat:"1990-01-01"
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
string
predeterminat:"user-1234"
La teva referència d’usuari estable per a aquesta persona, com ara el teu ID d’usuari intern. Didit l’utilitza per vincular les verificacions independents amb el mateix usuari final i reduir el soroll de detecció de duplicats.Exemple: user-1234

Notes sobre les regles d’entrada i la validació

  • Nigerian Bank Verification Number (exactament 11 dígits)
  • bvn ha de contenir només dígits; elimina espais, guions i signes de puntuació abans d’enviar la sol·licitud.
  • bvn ha de tenir exactament 11 caràcters.

Com fer la crida

Dades retornades

Els camps exactes que es mostren a source_data depenen del que retorni el registre. L’exemple generat per a nga_bank_verification_number documenta actualment aquesta forma normalitzada:
  • date_of_birth
  • first_name
  • last_name

Preus i SLA

Les consultes del Nigerian Bank Verification Number (BVN) només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $0.35 USD.
  • Facturació: per consulta satisfactòria. No se’t factura quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
  • Latència: p95 habitual < 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font externa varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026