Resolve an account name
Name enquiry against the destination institution. Use the returned name as destination_account_name on the payout — it is the institution-confirmed name, not a merchant guess. Results are cached briefly per account.
Authorizations
Headers
Unique idempotency token per logical write (UUID v4). Re-send the same value on safe retries.
"a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6"
Body
BANK_ACCOUNT, MOBILE_MONEY "BANK_ACCOUNT"
ISO 4217 currency code of the destination
"NGN"
Bank account number or mobile number
"0123456789"
Bank code or mobile money code — from GET /v1/banks
"044"
Response
The name the institution holds for this account. Use this as destination_account_name on the payout — never the merchant-typed guess.
"KWAME MENSAH"
"0123456789"
"044"
MOBILE_MONEY, BANK_ACCOUNT, CRYPTO_WALLET