Zum Hauptinhalt springen
POST
Prüft Eingabedaten gegen die Datenbank der nigerianischen Bankenbranche. Ein Selfie ist erforderlich: Das beim BVN hinterlegte Registrierungsfoto wird per Gesichtsabgleich mit dem Selfie verglichen, und der Datensatz wird nur zurückgegeben, wenn es sich um dieselbe Person handelt. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten gegen die maßgebliche Quelle prüfen und normalisierte Abgleichsergebnisse erhalten. Eingabeformat: bvn nimmt die nigerianische Bank Verification Number entgegen (genau 11 Ziffern).

Abdeckung

  • Abdeckung: ~ 100%
  • Land: Nigeria
  • Service-ID: nga_bank_verification_number
  • Datenbereich: Finanzen
  • Kategorie: Bankwesen

Eingaben

  • Pflichteingaben: bvn, selfie
  • Optionale Eingaben: first_name, last_name, date_of_birth, vendor_data
  • Einwilligung: Nicht erforderlich
  • Verfügbarkeit im Workflow: Im Workflow mit Feldzuordnung verfügbar
  • Abdeckung: ~ 100%
  • Preis: $0.35 pro erfolgreicher Abfrage
In einem Workflow steht bvn nicht auf einem Ausweisdokument, daher wird es von keinem Schritt automatisch erzeugt. Erfassen Sie es aus einer Fragebogen-Antwort, einem Feld einer Document-AI-Extraktion oder einem Wert, den Sie beim Erstellen der Sitzung übergeben, und ordnen Sie es dem Schritt Datenbankvalidierung zu. Solange es nicht zugeordnet ist, zeigt der Workflow-Editor diesen Dienst als deaktiviert an und nennt die fehlende Eingabe. Fehlt sie zur Laufzeit, wird die Prüfung übersprungen, bevor eine Abfrage erfolgt. So wird Ihnen nie eine Datenbankabfrage berechnet, die nicht ausgeführt werden konnte.

Body-Parameter

string
Standard:"NGA"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: NGA
string
Standard:"nga_bank_verification_number"
erforderlich
Array mit dieser Service-ID. Die Festlegung des Dienstes beschränkt die Anfrage auf genau diese Datenbank.Beispiel: nga_bank_verification_number
string
Standard:"11111111111"
erforderlich
Bank Verification Number.Beispiel: 11111111111
file
erforderlich
Selfie-Bilddatei, die für die biometrische Datenbankvalidierung hochgeladen wird. Akzeptierte Formate: JPEG, PNG oder WebP.Beispiel: @./selfie.jpg
string
Zu validierender Vorname.Beispiel: John
string
Zu validierender Nachname.Beispiel: Doe
string
Standard:"1990-01-01"
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
string
Standard:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen derselben Endbenutzerin bzw. desselben Endbenutzers zuzuordnen und die Zahl unnötiger Dublettenmeldungen zu verringern.Beispiel: user-1234

Eingaberegeln und Hinweise zur Validierung

  • Nigerianische Bank Verification Number (genau 11 Ziffern)
  • bvn darf nur Ziffern enthalten. Entfernen Sie Leerzeichen, Bindestriche und Satzzeichen, bevor Sie die Anfrage senden.
  • bvn muss genau 11 Zeichen lang sein.

So rufen Sie es auf

Rückgabedaten

Die genauen Felder, die in source_data ausgegeben werden, hängen davon ab, was das Register zurückgibt. Das generierte Beispiel für nga_bank_verification_number dokumentiert derzeit diese normalisierte Struktur:
  • date_of_birth
  • first_name
  • last_name

Preise und SLAs

Abfragen der nigerianischen Bank Verification Number (BVN) werden nur berechnet, wenn Didit von der Validierungsquelle ein eindeutiges Ergebnis erhält.
  • Preis pro Aufruf: $0.35 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Ihnen wird nichts berechnet, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typischer p95-Wert unter 2 s.
  • Verfügbarkeit: 99.9% pro Quartal auf Seiten von Didit. Die Verfügbarkeit der nachgelagerten Quelle variiert je nach Land und Datensatz.

Weiterlesen

Zuletzt geändert am 7. November 2026