Verify a bank account

Deprecated — use POST /accounts/validate with accountType: bank_account instead.

Verifies a bank account before initiating a payout. Use this to confirm the account exists, is open, and optionally that the account holder identity or business registration matches. Reduces failed payouts and helps with reconciliation. Currently supported for South Africa (ZAR); use the same bank codes as for ZAR payouts.

**Deprecated — use [`POST /accounts/validate`](#operation/validateAccount) with `accountType: bank_account` instead.** Verifies a bank account before initiating a payout. Use this to confirm the account exists, is open, and optionally that the account holder identity or business registration matches. Reduces failed payouts and helps with reconciliation. Currently supported for South Africa (ZAR); use the same bank codes as for [ZAR payouts](/payout-market-south-africa#bank-codes-south-africa).

Authentication

AuthorizationBearer

OAuth 2.0 access token

Request

This endpoint expects an object.

accountNumberstringRequired

Bank account number to verify

bankCodestringRequired

Bank identifier. For ZAR use a supported bank code (e.g. absa, standard_bank, fnb). See South Africa payout guide for the full list.

countryenumRequired

3-letter ISO country code (e.g., ZAF for South Africa)

merchantIdstringRequired

Merchant ID for the verification request

accountTypeenumOptional

Optional account type; verified if provided

accountHolderobjectOptional

Optional account holder details. When provided, the API verifies that the account matches (e.g. name, identity or business registration).

Response

Bank account verification result

verifiedboolean

Overall verification result. True if the account is valid and open, and any provided identity/name/registration matched.

accountHolderNamestringOptional

Account holder name as returned by the bank, when available

accountExistsbooleanOptional

Whether the account exists at the bank

identityMatchbooleanOptional

Whether the provided identity document or business registration matched the account holder (only when accountHolder was provided)

accountOpenbooleanOptional

Whether the account is still open at the bank

accountAcceptsCreditsbooleanOptional

Whether the account can receive credits (e.g. payouts)

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

500

Internal Server Error