v1

latestOpenAPI 3.1.02026-07-24590534.0 KB

Verify a bank account

Checks that a bank account is valid and returns the account holder’s name.

post/refunds/{merchant_reference}/verify_account

Path parameters

merchant_referencestring required

The merchant reference of the original transaction. The transaction must belong to the merchant making the request.

Request body

account_numberstring

The bank account number that will receive the refund. It cannot be empty.

bank_codestring

The code that identifies the bank. It cannot be empty.

currency_codestring

The currency used to verify the account. If it is not provided, the API uses ngn.

Response

200

statusstring

messagestring

Example response

{
  "status": "ok",
  "message": "Bank account successfully verified",
  "data": {
    "account_name": "Ada Lovelace",
    "account_number": "0123456789",
    "bank_name": "GTBank",
    "bank_code": "058"
  }
}