Disbursement API | SpeedPesa

Authentication

Every request requires your API key and security PIN in the headers/body.

Required Headers

Content-Type application/json

Header Name x-api-key

Alternative Authorization: Bearer KEY

Mobile Payout (Send Money)

Send money to a customer's mobile money account instantly.

POST https://speedpesa.com/api/v1/mobilepayout

Request Body (JSON)

Field	Type	Required	Description
`phonenumber`	string	Yes	Recipient phone: `2557XXXXXXXX`
`amount`	string/number	Yes	Amount in TZS (min: 100, max: 1,000,000)
`pin`	string	Yes	Your security PIN for authorization

cURL Example

curl -X POST https://speedpesa.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

Success Error

{ "type": "success", "message": "Payout sent successfully via M-PESA", "data": { "reference": "A1B2C3D4E5", "phonenumber": "255712345678", "amount": "10000.00", "fee": "1284.00", "total_charged": "11284.00", "currency": "TZS", "status": "SUCCESS", "channel": "M-PESA", "accountname": "Juma Mtemi", "balance_after": "38716.00", "created": "2026-02-23 14:30:45" } }

{ "type": "error", "message": "Insufficient balance. Required: 15468.00 TZS", "data": { "requested_amount": "15000.00", "fee": "468.00", "available_balance": "10000.00" } }