Payouts

Withdraw your balance to a bank account or any crypto wallet.

Open the interactive version or read this guide as markdown.

API reference

A payout moves money out of your balance to someone else. Send crypto to any wallet address, cash out to a bank account, or pay a mobile money account across Africa. You choose the amount and destination, CoinCircuit shows the fee before you confirm, then sends the funds.

Payout to a bank or crypto wallet

How it works

  1. Save a recipient once with POST /api/v1/recipients: a crypto address, a bank account, or a mobile money account.
  2. Check the cost with GET /api/v1/payouts/fees, or POST /api/v1/payouts/cross-border/quote for KES and GHS.
  3. Create the payout with POST /api/v1/payouts (currency, amount, recipientId).
  4. Track it with GET /api/v1/payouts and GET /api/v1/payouts/{id}. A payout.success or payout.failed webhook tells you the result.

Supported currencies

Currency Recipient type Delivered as
USDT / USDC crypto_address Crypto transfer to any wallet
NGN ngn_bank_account Bank transfer to any Nigerian bank
KES kes_mobile_money M-Pesa mobile money
GHS ghs_mobile_money MTN mobile money
USD Coming soon ACH bank transfer
XAF Coming soon Coming soon
UGX Coming soon Coming soon

Use cases

Validate a recipient's details with POST /api/v1/recipients/validate before you send. Blockchain transfers cannot be reversed.