Registration
BVN Registration.
Enrol Nigerian customers who don't yet have a BVN via a partner-bank consent flow — the missing link between onboarding and NIBSS.
One request
A single call. Real data.
Copy, paste your test key, and get a real response in seconds.
curl -X POST https://api.karverifi.com/v1/registrations/bvn \
-H "Authorization: Bearer kv_test_xxxx" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"first_name": "Chukwuemeka",
"last_name": "Nwosu",
"date_of_birth": "1995-11-03",
"phone": "+2348034567890",
"consent_ip": "102.89.44.12"
}'What you get
Everything the compliance team asks for.
Consent capture
We record the timestamp, IP, and copy shown to the customer — or use your own consent template.
NIBSS submission
Enrolment is routed through a licensed partner bank and lodged with NIBSS in one flow.
Completion webhook
You'll get a `registration.completed` callback the moment the BVN issues — often within 24 hours.
PDF audit trail
Every registration produces a signed PDF receipt you can hand to auditors on demand.
Heads up
One flow, verify and register
If your customer already has a BVN, the same call reuses the verification path. You never have to branch on "verify vs register" in your own code.
Response shape
A typical successful response.
{
"id": "reg_01HXKA2G5MFJ6E8VEXAMPLE",
"type": "bvn_registration",
"status": "pending_biometrics",
"created_at": "2026-07-17T09:14:12Z",
"partner_bank": "Providus Bank",
"appointment": {
"slot_url": "https://register.karverifi.com/appt/HXKA2G5M",
"expires_at": "2026-07-24T09:14:12Z"
},
"callback_url": "https://api.yourdomain.com/webhooks/karverifi",
"consent": {
"captured_at": "2026-07-17T09:14:10Z",
"ip": "102.89.44.12",
"receipt_url": "https://receipts.karverifi.com/r/reg_01HXKA2G5MFJ6E8VEXAMPLE.pdf"
}
}Questions
Common questions on bvn registration.
A valid government ID (NIN slip, driver's licence, or international passport) and a working Nigerian phone number. Biometrics are captured at the partner-bank branch appointment we book.
Ready to ship?
Wire up bvn registration today.
Test in sandbox for free, go live the same afternoon.