Guides
Send transfers
Check an account name, then send money from your balance to any Nigerian bank account.
Transfers move money from your CSwitch balance to any bank account in Nigeria. Always check the account name first, and always send an idempotency key.
Check the account name
Resolve an account
curl "https://sandbox.cswitchcba.com/v1/banks/resolve?account_number=0000000001&bank_code=058" \
-H "Authorization: Bearer $CSWITCH_SECRET_KEY"Show the returned account_name to whoever is sending the money, and only continue if it's the right person.
Send the transfer
Send a transfer
curl https://sandbox.cswitchcba.com/v1/transfers \
-H "Authorization: Bearer $CSWITCH_SECRET_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"amount": 25000000, "account_number": "0000000001", "bank_code": "058", "narration": "October salary", "reference": "payroll_10_173"}'A new transfer is processing. You get a transfer.successful or transfer.failed webhook when it completes, and you can check it any time with GET /transfers/{reference}.
When a transfer fails
The money goes back to your balance and you get a transfer.failed webhook. Fix the recipient's details and send again with a new idempotency key.
NotePaying many people at once? Upload a CSV in the dashboard for bulk payouts with approvals, or send one transfer per recipient from your code, each with its own idempotency key.