Skip to main content
Use this endpoint to verify bank account details before sending money. It confirms that the account number and bank code are valid and returns the official account name. Base paths:
  • Sandbox: https://sandbox.payvessel.com/kyc
  • Production: https://api.payvessel.com/kyc
All paths below are relative to the base URL.

​
Verify bank account

POST /api/v1/merchant/bank/verify-account Typical request body fields:
  • account_number – destination bank account number
  • bank_code – bank identifier code
  • reference – unique verification reference
The response returns:
  • A boolean flag indicating whether the account details are valid
  • The resolved account_name as held by the bank
  • Additional metadata that can be stored with your recipient record
Use this before calling transfer endpoints to reduce failed transfers and chargebacks.

​
Example

curl -X POST "https://sandbox.payvessel.com/kyc/api/v1/merchant/bank/verify-account" \
  -H "Content-Type: application/json" \
  -d '{
    "account_number": "0123456789",
    "bank_code": "999991",
    "reference": "BANK_VERIFY_2026_001"
  }'