Disbursement API | SpeedPesa

Authentication

Every request requires your API key in the headers.

Required Headers

Content-Type application/json

Header Name x-api-key

Alternative Authorization: Bearer KEY

Mobile Payout (Send Money)

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

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 to send
`pin`	string	Yes	Your SpeedPesa wallet PIN

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 successful", "data": { "reference": "BAH72NSNSI", "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" } }

{ "type": "error", "message": "Insufficient balance", "data": { "error_code": "insufficient_funds" } }