🍀Fastapesa
Sign in

Disbursement API

HomeDashboardDocumentationsDisbursement API
This endpoint is not available yet. It will open once a payout provider is connected.

Authentication

Every request requires your API key in the headers.

Content-Typeapplication/json
Header Namex-api-key
AlternativeAuthorization: Bearer KEY

Mobile Payout (Send Money)

Send payments directly to a customer's mobile money account. Requires your FastaPesa wallet PIN for authorization.

POSThttps://fastapesa.com/api/v1/mobilepayout

Request Body (JSON)

FieldTypeRequiredDescription
phonenumberstringYesRecipient phone: 2557XXXXXXXX
amountstring/numberYesAmount in TZS to send
pinstringYesYour FastaPesa wallet PIN
cURL Example
curl -X POST https://fastapesa.com/api/v1/mobilepayout \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "phonenumber": "255617919056",
  "amount": "10000",
  "pin": "1234"
}'

JSON Response

{
  "type": "success",
  "message": "Payout successful",
  "data": {
    "reference": "PWPBAH72NSNSI",
    "amount": "1000.00",
    "fee": "144.00",
    "direction": "debit",
    "paymenttype": "API Payout",
    "status": "SUCCESS",
    "currency": "TZS",
    "channelprovider": "Airtel Tanzania",
    "accountnumber": "0687819056",
    "accountname": "Joseph",
    "created": "2026-06-23 11:58:00",
    "completed": "2026-06-23 12:00:00"
  }
}