Skip to main content
Before sending funds to an account, use this endpoint to verify the account exists and retrieve the registered account holder’s name. This lets you confirm the recipient’s identity with your customer before committing to a transfer or refund, reducing the risk of sending funds to the wrong account.
Headers

​
Request body

​
string
required
The bank code for the account you want to look up. Use GET /banks to retrieve a list of supported codes. See List Banks.
​
string
required
The bank account number to resolve.
​
string
required
ISO 4217 currency code associated with the account (e.g. NGN).

​
Example request

​
Example response

​
Response fields

​
string
Full display name of the bank.
​
string
The bank code that was supplied in the request.
​
string
The account number that was supplied in the request.
​
string
The registered name of the account holder as returned by the bank. Display this to your customer for confirmation before proceeding with a transfer or refund.
Use account resolution as the first step in any outbound payment flow:
1

Collect recipient details

Ask the customer for their bank code and account number.
2

Resolve the account

Call POST /banks/resolve and display the returned account_name to the customer for confirmation.
3

Get customer confirmation

Only proceed if the customer confirms the account_name matches the intended recipient.
4

Initialize the transfer or refund

Use the verified details to call POST /disbursements/initialize or POST /refunds/initialize.