API docs · 8 of 14
Send a payout
POST/v1/merchant/payouts
Sends money from your wallet to a mobile money number, for refunds, salaries, suppliers or winnings. The total is held in your wallet straight away and released again if the payout fails.
| Field | Description |
|---|---|
currencystringrequired | One of UGX, KES, TZS, RWF or CDF. It decides the country and the wallet used. |
amountintegerrequired | A positive whole number in that currency. No decimals. |
phonestringrequired | The mobile money number, e.g. +256701234567. A local number (0701234567) also works. |
descriptionstring | Shown in your dashboard. Up to 140 characters. |
Request
curl https://api.paranthropus.app/v1/merchant/payouts \
-H "Authorization: Bearer para_test_..." \
-H "Idempotency-Key: salary-2026-11-amina" \
-H "Content-Type: application/json" \
-d '{
"currency": "KES",
"amount": 4500,
"phone": "+254712345678",
"description": "November salary"
}'The response is a transaction with "type": "payout" and "status": "pending". If your wallet cannot cover the amount plus fees, you get insufficient_balance and nothing is sent.