Transfer With Name Inquiry
A 3-step recipe with Interswitch. We can help you get access.
Recipe · 3 steps
Transfer With Name Inquiry
with Interswitch
Confirm the recipient account name, then disburse a single transfer.
- Return CBN bank codes and names addressable by the transfer endpoints.
- Resolve the registered account name on the recipient account before transferring. A 90000 responseCode confirms a valid account.
- Submit the single transfer to the confirmed recipient account. The terminalId is supplied as a header; responseCode 90000 indicates success.
What you'll need to have ready
- accessToken: Bearer access token from the Passport OAuth token endpoint.
- terminalId: Terminal id header required on transfer requests.
- bankCode: 6-digit CBN bank code of the recipient bank.
- accountNumber: Recipient NUBAN account number.
- transferCode: Transfer code identifying the transfer product.
- mac: SHA-512 hash of the canonical transfer fields.
- initiatingEntityCode: Code of the entity initiating the transfer (e.g. PBL).
- amount: Transfer amount in minor currency units.
- currencyCode: ISO currency code for the transfer.
- recipientEntityCode: Recipient bank entity code used on termination.
For your developer
Arazzo workflow interswitch:transfer-with-name-inquiry, 3 operations: listBanks → nameInquiry → sendSingleTransfer. Specs on APIs.io.