Skip to main content
New Card Issuing API v3 is now live — build branded card programs in minutes. Explore the docs →
Developers
Login Get Started
Payout API

Payout API

Automate disbursements to bank accounts and mobile wallets across Africa. Send single payouts or batch thousands in a single API call.

Get API Keys View Business Page

4.5/5 from 47,942 reviews

Send a Single Payout

Disburse funds to a mobile money wallet or bank account with a single API call.

POST /v1/payouts
bash 
curl -X POST https://api.fyatu.com/v1/payouts \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10000,
    "currency": "KES",
    "method": "mobile_money",
    "provider": "mpesa",
    "recipient": "+254712345678",
    "reference": "salary_jan_001"
  }'

Send Batch Payouts

Process thousands of payouts in a single request. Mix bank transfers and mobile money in the same batch.

POST /v1/payouts/batch
bash 
curl -X POST https://api.fyatu.com/v1/payouts/batch \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "batch_reference": "payroll_feb_2026",
    "payouts": [
      {"amount": 50000, "currency": "NGN", "method": "bank_transfer", "bank_code": "044", "account_number": "0123456789"},
      {"amount": 35000, "currency": "NGN", "method": "bank_transfer", "bank_code": "058", "account_number": "9876543210"},
      {"amount": 8000, "currency": "KES", "method": "mobile_money", "provider": "mpesa", "recipient": "+254798765432"}
    ]
  }'

Webhook Notification

Receive real-time notifications when payouts are completed, failed, or reversed.

Webhook Event: payout.completed
json 
// Webhook payload for completed payout
{
  "event": "payout.completed",
  "data": {
    "id": "pay_xyz789",
    "amount": 10000,
    "currency": "KES",
    "status": "completed",
    "reference": "salary_jan_001"
  }
}

API Endpoints

POST /v1/payouts
POST /v1/payouts/batch
GET /v1/payouts
GET /v1/payouts/:id
GET /v1/payouts/batch/:id
POST /v1/payouts/validate
GET /v1/payouts/providers

API capabilities

Comprehensive tools to automate disbursements across Africa.

Single & Batch Payouts

Send individual payouts or batch thousands of disbursements in a single API call. Perfect for payroll, vendor payments, and refunds.

Bank & Mobile Money

Disburse to bank accounts and mobile money wallets across 30+ African countries. All major banks and mobile money providers supported.

Account Validation

Verify bank account details and mobile numbers before sending payouts. Reduce failed transactions and improve delivery rates.

Idempotent Requests

Every payout request supports idempotency keys. Safely retry requests without risk of duplicate disbursements.

Real-time Tracking

Track payout status from initiation to completion. Query the API or receive webhook notifications for every status change.

FX Conversion

Automatic foreign exchange conversion at competitive rates. Send from your base currency and recipients receive local currency.

Got questions?

Everything you need to know about getting started.

A single batch can contain up to 10,000 individual payouts. For larger volumes, you can submit multiple batches sequentially. Enterprise customers can request higher batch limits through their account manager.
Use the Account Validation endpoint (POST /v1/payouts/validate) to verify bank account details or mobile numbers before initiating a payout. This checks account existence and returns the account holder name for confirmation.
You can send payouts in 25+ African currencies including KES, NGN, GHS, ZAR, TZS, UGX, CDF, XAF, and XOF. The API automatically handles FX conversion if you fund your account in a different currency.
Failed payouts trigger a webhook notification with the failure reason. Common reasons include invalid account details, insufficient balance, or provider downtime. Funds from failed payouts are automatically returned to your balance for retry.
Minimum payout amounts vary by country and method. Typically the minimum is equivalent to $0.50 USD. There is no maximum limit for verified business accounts, though individual provider limits may apply.

Start sending payouts today

Integrate the Payout API and automate your disbursements in minutes. Free sandbox access included.

Get API Keys Read Full Docs