v1

latestOpenAPI 3.1.02026-07-2656114159.7 KB

Identity Verification

Enhanced BVN Verification

Verify a BVN and retrieve enriched identity information such as names, gender, birthday, photo, and phone numbers tied to the BVN.

post/api/v1/merchant/bvn/enhanced

Headers

api-keystring required

Your Payvessel public API key

api-secretstring required

Your Payvessel secret

Content-Type'application/json' required

Request content type

Request body

bvnstring required

Customer BVN

Example request

{
  "bvn": "22123456789"
}

Response

Enhanced BVN verification response

successboolean required

Whether the request completed successfully

messagestring required

Response message

Example response

{
  "success": true,
  "message": "BVN verification completed successfully",
  "data": {
    "bvn": "22123456789",
    "first_name": "John",
    "middle_name": "Adebayo",
    "last_name": "Doe",
    "gender": "MALE",
    "name_on_card": "JOHN A DOE",
    "birthday": "1992-08-14",
    "photo": "/9j/4AAQSkZJRgABAQAAAQABAAD...",
    "phone_number": "08012345678",
    "phone_number_2": "08087654321"
  },
  "charges": {
    "charged_amount": "0.00"
  }
}