Skip to navigation

Look up bank account name

View as Markdown
Validates a bank account and returns the registered account name. Confirm the name with your beneficiary, then pass it on the payout transfer.

Authentication

x-api-keystring

Dashboard Public Key. Maps to x-api-key.

x-api-secretstring

Dashboard Secret Key. Maps to x-api-secret. Server-side only.

Headers

x-api-secretstringRequired

Request

This endpoint expects an object.
bankstringRequired
Bank shortcode, for example ABSA, CRDBBANK, NMB. Use the shortcode list documented under Bank payouts.
accountstringRequired
Beneficiary bank account number.

Response

Account name found
statusstring
codeinteger
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error