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.

FieldDescription
currencystringrequiredOne of UGX, KES, TZS, RWF or CDF. It decides the country and the wallet used.
amountintegerrequiredA positive whole number in that currency. No decimals.
phonestringrequiredThe mobile money number, e.g. +256701234567. A local number (0701234567) also works.
descriptionstringShown in your dashboard. Up to 140 characters.
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.