Skip to main content
POST
Basic BVN Verification

Headers

api-key
string
required

Your Payvessel public API key

api-secret
string
required

Your Payvessel secret

Content-Type
enum<string>
required

Request content type

Available options:
application/json

Body

application/json
bvn
string
required

Customer BVN

Example:

"22123456789"

first_name
string
required

Customer first name

Example:

"John"

middle_name
string
required

Customer middle name

Example:

"Adebayo"

last_name
string
required

Customer last name

Example:

"Doe"

gender
enum<string>
required

Customer gender

Available options:
MALE,
FEMALE
Example:

"MALE"

birthday
string<date>
required

Customer date of birth

Example:

"1992-08-14"

phone_number
string
required

Customer phone number

Example:

"08012345678"

Response

BVN verification response

success
boolean
required

Whether the request completed successfully

Example:

true

message
string
required

Response message

Example:

"BVN verification completed successfully"

data
object | null
required
charges
object
required