Skip to main content
POST
Resolve bank account by country
Look up the account holder name for a bank account before creating a bank-transfer payout. Currently only ng is supported. Both account_number and bank_code are required in the request body.

Test mode (sk_test_*)

Name enquiry is simulated — no real NIP lookup.

Authorizations

Authorization
string
header
required

Secret key: Authorization: Bearer sk_test_... or sk_live_.... Business and live/test mode are inferred from the key.

Path Parameters

country
string
required

ISO 3166-1 alpha-2 country code. Bank list is currently supported for ng (Nigeria) only.

Example:

"ng"

Body

application/json
account_number
string
required

10-digit NGN account number

Example:

"0123456789"

bank_code
string
required

Bank code from GET /misc/banks/ng

Example:

"058"

Response

Account resolved

message
string
Example:

"Account resolved successfully"

data
object