transfers:write and an Idempotency-Key. The bank’s ledger decides whether it may go ahead: funds, limits, whose wallet it is and closed-loop rules.
Between wallets
To another bank
1
Find the bank code
GET /v1/banks lists banks and their codes.2
Check the name
GET /v1/account-names?account_number=0123456789&bank_code=058 returns the name on the account. Show it before you send.3
Send
queued: the amount, the charge and its VAT have left the wallet.4
Follow it
GET /v1/transfers/interbank/{transactionId} moves through processing to settled, failed or reversed. You also receive transfer.interbank.settled, .failed or .reversed.To your own bank account
POST /v1/settlements moves money from your wallet to your business’s account at the bank. Follow it with GET /v1/settlements/{transactionId} or the settlement.* webhooks.
Rules
- Payouts and settlements leave only from your business’s own wallet (
422, code86). - Limits. A business wallet sends at most ₦5,000,000 a transfer and ₦25,000,000 a day unless the bank set it its own (
422, code83). - Customers’ wallets. Only a closed-loop business can move money out of its customers’ wallets (
403, code82), and that money can go only to its own wallets or its other customers (422, code81). - Not enough money for the amount and its charges is
422(code80); a restricted account,422(code85).