Identity Verification
BVN Verification
Verify BVN
Get the bvn details match on any bvn number.
Endpoint: /bvn/verify
Method: POST
Header
| Param | Type | Required? | Decription |
|---|---|---|---|
| authorization | string | Yes | Set value to Bearer SECRET_KEY |
| content-type | string | Yes | Set value to application/json |
Body Param
| Param | Type | Required? | Decription |
|---|---|---|---|
| bvn | string | Yes | bvn to verify (use 00000000000 in test mode) |
| callback_url | string | Yes | your callback url to get verification response |
| first_name | string | No | bvn firstname |
| middle_name | string | No | bvn middlename |
| last_name | string | No | bvn lastname |
| phone_number | string | No | bvn phone number |
| dob | string | No | bvn date of birth (YYYY-MM-DD) |
| gender | string | No | bvn user gender |
| reference | string | No | your unique reference number (we will generate one automatically if not provided) |
Sample Post
curl https://api.budpay.com/api/v2/bvn/verify
-H "Authorization: Bearer YOUR_SECRET_KEY"
-H "Content-Type: application/json"
-d '{
"bvn": "00000000000",
"first_name": "Tolulope",
"middle_name": "Samuel",
"last_name": "Segun",
"phone_number": "08011111111",
"dob": "1972-12-03",
"gender": "Male",
"reference": "20220540300003938",
"callback_url": "http://your_webhook_url"
}'
-X POST
Sample Response
{
"success": true,
"message": "Request Submitted Successfully",
"reference": "20220540300003938"
}