Skip to main content

Partner API — Start Here

The Fiatsend Partner API converts USDT or USDC into Ghana Cedis (GHS) and delivers funds to MTN Mobile Money, Telecel Cash, or AirtelTigo wallets.

Your system  →  POST /v1/withdrawals  →  FX conversion  →  Recipient MoMo wallet

Target: first sandbox payout in under an hour.

Prerequisites

  1. Console account — Sign up at console.fiatsend.com.
  2. API keySettings → API Keys — sandbox keys use prefix fs_test_*.
  3. Base URL — Sandbox: https://sandbox.fiatsend.com/v1 · Production: https://api.fiatsend.com/v1.

See Environments and Authentication.

Quickstart (sandbox)

1. Health check

curl https://sandbox.fiatsend.com/v1/health \
-H "Authorization: Bearer $FIATSEND_API_KEY"

2. Get a rate quote

curl "https://sandbox.fiatsend.com/v1/rates?from_currency=USDT&to_currency=GHS&amount=50" \
-H "Authorization: Bearer $FIATSEND_API_KEY"

3. Create a payout

Use a unique reference_id per payout (idempotency).

curl -X POST https://sandbox.fiatsend.com/v1/withdrawals \
-H "Authorization: Bearer $FIATSEND_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": "50.00",
"currency": "USDT",
"recipient_phone": "+233501234567",
"mobile_network": "MTN",
"reference_id": "payout-001"
}'

4. Track status

Poll GET /v1/withdrawals/{withdrawal_id} or register webhooks. In sandbox, status auto-progresses: pendingprocessingcompleted (about 15 seconds).

PageTopic
WithdrawalsFull payout flow and status model
Payment intentsMerchant collect from FiatsendOne users
WebhooksPush notifications and signature verification
API referenceAll endpoints
OpenAPIMachine-readable spec

Support

ChannelContact
Partnerspartners@fiatsend.com
Consoleconsole.fiatsend.com