Vai al contenuto principale
POST
Verifica i dati inseriti rispetto al database del settore bancario nigeriano. Richiede un selfie: il ritratto di registrazione associato al BVN viene confrontato con il selfie, e il record viene restituito solo se si tratta della stessa persona. Didit espone questo servizio tramite POST /v3/database-validation/ per permetterti di verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati. Formato di input: bvn accetta il Bank Verification Number nigeriano (esattamente 11 cifre).

Copertura

  • Copertura: ~ 100%
  • Paese: Nigeria
  • ID servizio: nga_bank_verification_number
  • Dominio dei dati: Finanziario
  • Categoria: Bancaria

Input

  • Input obbligatori: bvn, selfie
  • Input facoltativi: first_name, last_name, date_of_birth, vendor_data
  • Consenso: Non richiesto
  • Disponibilità nel workflow: Disponibile nel workflow con mappatura dei campi
  • Copertura: ~ 100%
  • Prezzo: $0.35 per query riuscita
In un workflow, bvn non è stampato su nessun documento d’identità, quindi nessun passaggio lo produce da solo. Raccoglilo da una risposta di un Questionario, da un campo estratto da Document AI, oppure da un valore che invii al momento della creazione della sessione, e mappalo sul passaggio Validazione su database. Finché non è mappato, l’editor dei workflow mostra questo servizio disabilitato e indica l’input mancante; in fase di esecuzione un input mancante fa sì che il controllo venga saltato prima di qualsiasi query, quindi non ti viene mai addebitata una banca dati che non è stato possibile interrogare.

Parametri del body

string
predefinito:"NGA"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di banca dati.Esempio: NGA
string
predefinito:"nga_bank_verification_number"
obbligatorio
Array che contiene l’ID di questo servizio. Fissare il servizio mantiene la richiesta limitata a questa specifica banca dati.Esempio: nga_bank_verification_number
string
predefinito:"11111111111"
obbligatorio
Bank Verification Number.Esempio: 11111111111
file
obbligatorio
File immagine del selfie da caricare per la validazione biometrica su database. Formati accettati: JPEG, PNG o WebP.Esempio: @./selfie.jpg
string
Nome da validare.Esempio: John
string
Cognome da validare.Esempio: Doe
string
predefinito:"1990-01-01"
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, come il tuo ID utente interno. Didit lo usa per collegare i controlli autonomi allo stesso utente finale e ridurre il rumore dei rilevamenti di duplicati.Esempio: user-1234

Regole di input e note di validazione

  • Bank Verification Number nigeriano (esattamente 11 cifre)
  • bvn deve contenere solo cifre; rimuovi spazi, trattini e punteggiatura prima di inviare la richiesta.
  • bvn deve essere esattamente di 11 caratteri.

Come effettuare la chiamata

Dati restituiti

I campi esatti restituiti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per nga_bank_verification_number documenta attualmente questa struttura normalizzata:
  • date_of_birth
  • first_name
  • last_name

Prezzi e SLA

Le query sul Bank Verification Number (BVN) della Nigeria vengono addebitate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.35 USD.
  • Fatturazione: per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
  • Latenza: p95 tipico < 2 s.
  • Disponibilità: 99.9% per trimestre lato Didit; la disponibilità delle fonti a valle varia in base al paese e al dataset.

Continua la lettura

Ultima modifica il 7 novembre 2026