Payouts | Stakaba Docs

Send funds directly to a Tanzanian mobile money wallet. Payouts leave the merchant wallet the moment they are confirmed.

Send a payout

POST /api/v1/disbursements
x-api-key: sk_live_...
Content-Type: application/json

{
  "amount": 50000,
  "currency": "TZS",
  "destinationType": "mobile_money",
  "destinationDetails": {
    "phoneNumber": "255742000331",
    "network": "Mpesa",
    "accountName": "Jane Doe"
  }
}

Response:

{
  "disbursement": {
    "id": "...",
    "status": "completed",
    "amount": 50000,
    "currency": "TZS"
  }
}

Parameters

Field	Type	Required	Description
`amount`	integer	Yes	Amount in TZS — whole numbers only
`currency`	string	No	Always `TZS`
`destinationType`	string	Yes	Always `mobile_money`
`destinationDetails.phoneNumber`	string	Yes	`255XXXXXXXXX` format
`destinationDetails.network`	string	Yes	`Mpesa`, `AirtelMoney`, `TigoPesa`, or `HaloPesa`
`destinationDetails.accountName`	string	No	Recipient name shown on confirmation

Payout statuses

Status	Meaning
`completed`	Funds delivered to recipient
`processing`	Sent to operator, awaiting confirmation
`failed`	Delivery failed — funds returned to wallet
`pending_review`	Held for fraud review

List payouts

GET /api/v1/disbursements
x-api-key: sk_live_...

Save payout destinations

Store recurring recipient details as payout methods to avoid re-entering details each time:

POST /api/v1/merchant/payout-methods
x-api-key: sk_live_...

{
  "destinationType": "mobile_money",
  "destinationDetails": {
    "phoneNumber": "255742000331",
    "network": "Mpesa",
    "accountName": "Jane Doe"
  }
}