Core

Payouts

Withdraw funds from your CamelPay wallet to mobile money. Request payouts, check status, and handle reversals.

Withdraw funds from your CamelPay wallet to mobile money using the payouts API.

Request a Payout

curl -X POST https://api.camelpay.in/payouts \
  -H "X-API-Key: cp_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10000,
    "recipient_phone": "+255712345678",
    "recipient_name": "John Doe",
    "narration": "Payment for services",
    "idempotency_key": "payout_unique_123"
  }'

Request Fields

Field	Type	Required	Description
`amount`	integer	Yes	Amount in TZS (minimum 500)
`recipient_phone`	string	Yes	Recipient's mobile money number
`recipient_name`	string	Yes	Recipient's name
`narration`	string	No	Payment description
`idempotency_key`	string	Yes	Unique identifier for this payout

A fee is automatically calculated and added to the total. The fee is deducted from your wallet balance along with the payout amount.

Check Payout Status

bash

curl -X GET https://api.camelpay.in/payouts/snippe_payout_ref_xyz/status \
  -H "X-API-Key: cp_live_your_api_key_here"

List Your Payouts

bash

curl -X GET "https://api.camelpay.in/payouts/me?page=1&per_page=20" \
  -H "X-API-Key: cp_live_your_api_key_here"