Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Transfers API: bank payouts from your NGN wallet

Send money from your NGN wallet to any Nigerian bank account in three calls: list banks, resolve the account, send.
get_bank_list ──────> resolve_transfer ─────────────────> transfer_funds returns client_Id, bank_Id, send them back as client_id, client_bvn bank_id, client_bvn

1. List banks

GET /payment/get_bank_list returns bank_name, bank_code and bank_logo for each bank. Cache it on your side; it rarely changes.
Use 999999 as bank_code to send to another SendCheap account.

2. Resolve the account

POST /payment/resolve_transfer
{ "account_number": "0123456789", "bank_code": "000013" }
Response
{ "status": "success", "message": "Retrieved Successfully", "data": { "sendcheap_user": false, "account_name": "JOHN DOE", "account_number": "0123456789", "bank_name": "GTBANK PLC", "client_bvn": "22212345678", "bank_code": "000013", "client_Id": "341256", "bank_Id": "058NIP2611211030" } }
Show account_name to your user and let them confirm before sending.

3. Send

Pass client_Id, bank_Id and client_bvn from the resolve response as client_id, bank_id and client_bvn.
POST /payment/transfer_funds
{ "amount": 25000, "account_number": "0123456789", "account_name": "JOHN DOE", "bank_name": "GTBANK PLC", "bank_code": "000013", "bank_id": "058NIP2611211030", "client_id": "341256", "client_bvn": "22212345678", "tranx_remark": "Order 10045 refund", "tranx_id": "ACME-20261121-000190" }
HTTPmessageMeaning
200your transfer was successful...Sent
206Transfer QueuedAccepted, not yet confirmed; verify
417reason in messageRejected, nothing sent

Fees and limits

  • Minimum ₦100 per transfer.
  • Your transfer fee (agreed at onboarding, ₦50 by default) is added to the amount.
  • ₦50 stamp duty is added on transfers of ₦10,000 or more.
  • A daily limit applies to your account. Exceeding it returns daily transfer limit exceeded....
You need amount + fee + stamp duty in your wallet, or the transfer is rejected.

Verify

GET /payment/verify_transfer?tranx_id=ACME-20261121-000190 returns the transfer with tranx_status: 1 pending, 2 successful, 3 failed and refunded.