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 "vendor_data=user-1234" \
-F "bvn=11111111111" \
-F "selfie=@./selfie.jpg" \
-F "date_of_birth=1990-01-01"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="NGA",
services=["nga_bank_verification_number"],
date_of_birth="1990-01-01",
bvn="11111111111",
vendor_data="user-1234",
selfie=open("selfie.jpg", "rb"),
)
print(result)
import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "NGA",
services: ["nga_bank_verification_number"],
date_of_birth: "1990-01-01",
bvn: "11111111111",
vendor_data: "user-1234",
selfie: await fileFromPath("selfie.jpg"),
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "NGA",
Services: didit.Some([]string{"nga_bank_verification_number"}),
DateOfBirth: didit.String("1990-01-01"),
Bvn: didit.String("11111111111"),
VendorData: didit.String("user-1234"),
Selfie: didit.Some(didit.FileFromPath("selfie.jpg")),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.nio.file.Path;
import java.time.LocalDate;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("NGA")
.services(List.of("nga_bank_verification_number"))
.dateOfBirth(LocalDate.parse("1990-01-01"))
.bvn("11111111111")
.vendorData("user-1234")
.selfie(Path.of("selfie.jpg"))
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'NGA',
'services' => ['nga_bank_verification_number'],
'date_of_birth' => '1990-01-01',
'bvn' => '11111111111',
'vendor_data' => 'user-1234',
'selfie' => File::fromPath('selfie.jpg'),
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "NGA",
services: ["nga_bank_verification_number"],
date_of_birth: "1990-01-01",
bvn: "11111111111",
vendor_data: "user-1234",
selfie: Pathname("selfie.jpg")
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "NGA",
Services = new string[] { "nga_bank_verification_number" },
DateOfBirth = "1990-01-01",
Bvn = "11111111111",
VendorData = "user-1234",
Selfie = FileUpload.FromPath("selfie.jpg"),
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"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": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "NGA",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_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": {
"date_of_birth": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "NGA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "nga_bank_verification_number",
"service_name": "Nigeria Bank Verification Number (BVN)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "NGA",
"match_type": null,
"validations": [
{
"outcome_code": "INCONCLUSIVE",
"service_id": "nga_bank_verification_number",
"service_name": "Nigeria Bank Verification Number (BVN)",
"source_data": {},
"validation": {}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "NGA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "DOCUMENT_NOT_FOUND",
"service_id": "nga_bank_verification_number",
"service_name": "Nigeria Bank Verification Number (BVN)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
🇳🇬 Nigeria
API Bank Verification Number (BVN) Nigeria
Nigeria Bank Verification Number (BVN): pencarian database resmi Nigeria melalui Didit. Bayar per panggilan mulai $0.35, tanpa kontrak, tanpa minimum.
POST
/
v3
/
database-validation
/
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 "vendor_data=user-1234" \
-F "bvn=11111111111" \
-F "selfie=@./selfie.jpg" \
-F "date_of_birth=1990-01-01"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="NGA",
services=["nga_bank_verification_number"],
date_of_birth="1990-01-01",
bvn="11111111111",
vendor_data="user-1234",
selfie=open("selfie.jpg", "rb"),
)
print(result)
import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "NGA",
services: ["nga_bank_verification_number"],
date_of_birth: "1990-01-01",
bvn: "11111111111",
vendor_data: "user-1234",
selfie: await fileFromPath("selfie.jpg"),
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "NGA",
Services: didit.Some([]string{"nga_bank_verification_number"}),
DateOfBirth: didit.String("1990-01-01"),
Bvn: didit.String("11111111111"),
VendorData: didit.String("user-1234"),
Selfie: didit.Some(didit.FileFromPath("selfie.jpg")),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.nio.file.Path;
import java.time.LocalDate;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("NGA")
.services(List.of("nga_bank_verification_number"))
.dateOfBirth(LocalDate.parse("1990-01-01"))
.bvn("11111111111")
.vendorData("user-1234")
.selfie(Path.of("selfie.jpg"))
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'NGA',
'services' => ['nga_bank_verification_number'],
'date_of_birth' => '1990-01-01',
'bvn' => '11111111111',
'vendor_data' => 'user-1234',
'selfie' => File::fromPath('selfie.jpg'),
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "NGA",
services: ["nga_bank_verification_number"],
date_of_birth: "1990-01-01",
bvn: "11111111111",
vendor_data: "user-1234",
selfie: Pathname("selfie.jpg")
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "NGA",
Services = new string[] { "nga_bank_verification_number" },
DateOfBirth = "1990-01-01",
Bvn = "11111111111",
VendorData = "user-1234",
Selfie = FileUpload.FromPath("selfie.jpg"),
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"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": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "NGA",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_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": {
"date_of_birth": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "NGA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "nga_bank_verification_number",
"service_name": "Nigeria Bank Verification Number (BVN)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "NGA",
"match_type": null,
"validations": [
{
"outcome_code": "INCONCLUSIVE",
"service_id": "nga_bank_verification_number",
"service_name": "Nigeria Bank Verification Number (BVN)",
"source_data": {},
"validation": {}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "NGA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "DOCUMENT_NOT_FOUND",
"service_id": "nga_bank_verification_number",
"service_name": "Nigeria Bank Verification Number (BVN)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
Memverifikasi data input dengan Database Industri Perbankan Nigeria. Membutuhkan swafoto: wajah pada potret pendaftaran yang terkait dengan BVN dicocokkan dengan swafoto tersebut, dan catatan hanya dikembalikan jika keduanya merupakan orang yang sama. Didit menyediakan layanan ini melalui
POST /v3/database-validation/ sehingga Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil pencocokan yang telah dinormalisasi. Format input: bvn menerima Bank Verification Number Nigeria (tepat 11 digit).
Cakupan
- Cakupan: ~ 100%
- Negara: Nigeria
- ID layanan:
nga_bank_verification_number - Domain data: Keuangan
- Kategori: Perbankan
Input
| Kolom | Wajib | Contoh |
|---|---|---|
bvn | Ya | 11111111111 |
selfie | Ya | @./selfie.jpg |
first_name | Tidak | John |
last_name | Tidak | Doe |
date_of_birth | Tidak | 1990-01-01 |
vendor_data | Tidak | user-1234 |
- Input wajib:
bvn,selfie - Input opsional:
first_name,last_name,date_of_birth,vendor_data - Persetujuan: Tidak diperlukan
- Ketersediaan alur kerja: Tersedia dalam alur kerja dengan pemetaan kolom
- Cakupan: ~ 100%
- Harga: $0.35 per kueri yang berhasil
bvn tidak tercetak pada dokumen identitas, sehingga tidak ada langkah yang menghasilkannya sendiri. Kumpulkan dari jawaban Kuesioner, kolom hasil ekstraksi Document AI, atau nilai yang Anda kirim saat membuat sesi, lalu petakan pada langkah Validasi Database. Selama belum dipetakan, editor alur kerja menampilkan layanan ini dalam keadaan nonaktif dan menyebutkan input yang belum ada. Saat dijalankan, input yang hilang berarti pemeriksaan dilewati sebelum ada kueri apa pun, sehingga Anda tidak pernah ditagih untuk database yang tidak dapat dikueri.
Parameter body
string
default:"NGA"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh:
NGAstring
default:"nga_bank_verification_number"
wajib
Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya mengarah ke database yang tepat ini.Contoh:
nga_bank_verification_numberstring
default:"11111111111"
wajib
Bank Verification Number.Contoh:
11111111111file
wajib
File gambar swafoto yang diunggah untuk validasi database biometrik. Format yang diterima: JPEG, PNG, atau WebP.Contoh:
@./selfie.jpgstring
Nama depan yang akan divalidasi.Contoh:
Johnstring
Nama keluarga yang akan divalidasi.Contoh:
Doestring
default:"1990-01-01"
Tanggal lahir dalam format
YYYY-MM-DD.Contoh: 1990-01-01string
default:"user-1234"
Referensi pengguna yang stabil untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan mandiri ke pengguna akhir yang sama dan mengurangi noise deteksi duplikat.Contoh:
user-1234Aturan input & catatan validasi
- Bank Verification Number Nigeria (tepat 11 digit)
bvnhanya boleh berisi digit; hapus spasi, tanda hubung, dan tanda baca sebelum mengirim permintaan.bvnharus tepat 11 karakter.
Cara memanggilnya
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 "vendor_data=user-1234" \
-F "bvn=11111111111" \
-F "selfie=@./selfie.jpg" \
-F "date_of_birth=1990-01-01"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="NGA",
services=["nga_bank_verification_number"],
date_of_birth="1990-01-01",
bvn="11111111111",
vendor_data="user-1234",
selfie=open("selfie.jpg", "rb"),
)
print(result)
import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "NGA",
services: ["nga_bank_verification_number"],
date_of_birth: "1990-01-01",
bvn: "11111111111",
vendor_data: "user-1234",
selfie: await fileFromPath("selfie.jpg"),
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "NGA",
Services: didit.Some([]string{"nga_bank_verification_number"}),
DateOfBirth: didit.String("1990-01-01"),
Bvn: didit.String("11111111111"),
VendorData: didit.String("user-1234"),
Selfie: didit.Some(didit.FileFromPath("selfie.jpg")),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.nio.file.Path;
import java.time.LocalDate;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("NGA")
.services(List.of("nga_bank_verification_number"))
.dateOfBirth(LocalDate.parse("1990-01-01"))
.bvn("11111111111")
.vendorData("user-1234")
.selfie(Path.of("selfie.jpg"))
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'NGA',
'services' => ['nga_bank_verification_number'],
'date_of_birth' => '1990-01-01',
'bvn' => '11111111111',
'vendor_data' => 'user-1234',
'selfie' => File::fromPath('selfie.jpg'),
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "NGA",
services: ["nga_bank_verification_number"],
date_of_birth: "1990-01-01",
bvn: "11111111111",
vendor_data: "user-1234",
selfie: Pathname("selfie.jpg")
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "NGA",
Services = new string[] { "nga_bank_verification_number" },
DateOfBirth = "1990-01-01",
Bvn = "11111111111",
VendorData = "user-1234",
Selfie = FileUpload.FromPath("selfie.jpg"),
});
Console.WriteLine(JsonSerializer.Serialize(result));
Setiap panggilan yang berhasil mengembalikan HTTP 200. Kolom outcome_code menunjukkan apa yang sebenarnya terjadi, misalnya membedakan ketidakcocokan biometrik yang nyata (BIOMETRIC_NO_MATCH) dari swafoto yang tidak dapat dibaca (BIOMETRIC_IMAGE_UNUSABLE). status yang ditampilkan adalah status fitur default; tindakan Partial Match / No Match yang Anda konfigurasi dapat menggantinya.MATCH: Registri mengonfirmasi identitas dan setiap kolom yang diperiksa cocok.{
"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": {
"identification_number": "full_match"
}
}
]
}
PARTIAL_MATCH: BVN tercatat dan swafoto cocok dengan potret pendaftaran NIBSS, tetapi nama atau tanggal lahir yang Anda kirim tidak sesuai dengan catatan registri. Catatan dikembalikan agar Anda dapat melihat kolom mana yang berbeda.{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "NGA",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_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": {
"date_of_birth": "no_match",
"identification_number": "full_match"
}
}
]
}
BIOMETRIC_NO_MATCH: Skor pencocokan wajah berada di bawah ambang batas penerimaan, yang berarti swafoto bukan orang yang sama dengan foto di registri.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "NGA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "nga_bank_verification_number",
"service_name": "Nigeria Bank Verification Number (BVN)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
INCONCLUSIVE: Registri tidak dapat memastikan apakah orang tersebut cocok dengan catatan di registri. Hasilnya benar-benar tidak pasti (orang tersebut mungkin ada atau tidak ada di registri). Ini BUKAN ketidakcocokan dan BUKAN masalah teknis pada gambar; tidak ada kolom yang dapat dipastikan cocok, sehingga match_type bernilai null dan pemeriksaan dikirim ke peninjauan.{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "NGA",
"match_type": null,
"validations": [
{
"outcome_code": "INCONCLUSIVE",
"service_id": "nga_bank_verification_number",
"service_name": "Nigeria Bank Verification Number (BVN)",
"source_data": {},
"validation": {}
}
]
}
DOCUMENT_NOT_FOUND: Nomor dokumen yang dikirim tidak sesuai dengan catatan apa pun di registri.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "NGA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "DOCUMENT_NOT_FOUND",
"service_id": "nga_bank_verification_number",
"service_name": "Nigeria Bank Verification Number (BVN)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
Data yang dikembalikan
Kolom yang muncul disource_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk nga_bank_verification_number saat ini mendokumentasikan bentuk ternormalisasi berikut:
date_of_birthfirst_namelast_name
Harga & SLA
Kueri Bank Verification Number (BVN) Nigeria hanya ditagih ketika Didit menerima hasil yang meyakinkan dari sumber validasi.- Harga per panggilan: $0.35 USD.
- Penagihan: per kueri yang berhasil. Anda tidak ditagih ketika registri tidak dapat dijangkau, ketika kolom wajib tidak ada, atau ketika permintaan ditolak sebelum sampai ke sumber.
- Latensi: p95 tipikal < 2 dtk.
- Ketersediaan: 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan dataset.
Lanjut membaca
Terakhir diubah pada 7 November 2026