SpeedPesa Pro API v1
Disbursement API
Send money to customers, agents or vendors.
PAYOUT · POSTYou send a request (POST) to pay out money; funds go directly to the recipient's phone.
Authentication
Every request requires your API key in the headers.
Required Headers
Authorization
Bearer sk_live_XXXXXXXXXXXX
Content-Type
application/json
Overview
Send a payout directly to mobile money. Each request is charged a 6.6% fee and returns a transaction_id for tracking.
POST
Mobile Payout (Send Money)
Send money from your SpeedPesa Pro balance to a customer, agent or vendor's mobile money. The request enters the payment queue and the initial status is pending until it is disbursed.
POST https://www.speedpesapro.com/api/public/v1/disbursements
Use www.speedpesapro.com specifically (without www the request is redirected and some HTTP clients drop the POST body — which causes a server error).
Request Body (JSON)
| Parameter | Type | Required | Description |
|---|---|---|---|
| phone | string | Yes | Recipient's phone number.example: 0712345678 |
| amount | integer | Yes | Amount to send in TZS.example: 10000 |
| name | string | No | Recipient's name.example: Joseph Mushi |
| reference | string | No | Your unique payout reference.example: PAY-2001 |
bash
curl -X POST 'https://www.speedpesapro.com/api/public/v1/disbursements' \
-H 'Authorization: Bearer sk_live_XXXXXXXXXXXX' \
-H 'Content-Type: application/json' \
-d '{
"phone": "0712345678",
"amount": 10000,
"name": "Joseph Mushi"
}'Note: Payout fees are 6.6% of the amount. Check your balance via /balance before sending a large request.