Sign in

v1

latestOpenAPI 3.1.02026-07-2656114159.7 KB
Identity Verification

Verify Bank Account

Verify a bank account against a BVN, bank code, and bank account number.

post/api/v1/merchant/bank/verify-account

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

bank_codestring required

Bank code

bank_accountstring required

Bank account number

Example request

{
  "bvn": "22123456789",
  "bank_code": "058",
  "bank_account": "0123456789"
}

Response

Bank account verification response

successboolean required
messagestring required

Example response

{
  "success": true,
  "message": "Bank account verification completed successfully",
  "data": {
    "verify_result": true,
    "bank_account_name": "JOHN ADEBAYO DOE",
    "name_match_percentage": 97
  },
  "charges": {
    "charged_amount": "0.00"
  }
}