Skip to main content
POST
/
momo
/
payout
Create new MoMo Payout Request
curl --request POST \
  --url https://api.stablepay.ai/momo/payout \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 123,
  "destination": "Paybill",
  "accountName": "<string>",
  "accountNumber": "<string>",
  "reference": "<string>",
  "currency": "KES",
  "country": "KE",
  "businessNumber": "<string>",
  "code": "M-Pesa"
}
'
{
  "success": true,
  "transactionId": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer scheme. Format: Bearer {STA_xxxx}

Body

application/json

Create a new Mobile Money payment.

​
amount
number
required

The payment amount in local currency (KES, UGX, GHS, TZS, ETB, ZMW).

Use Get FX API to obtain USD stablecoin amount to debit user.

Refer to Countries & Limits for mimimum and maximum amounts.

​
destination
enum<string>
default:Paybill
required

Payment destination to either pay bills, pay merchants or mobile money.

Available options:
Paybill,
Till,
MoMo
​
accountName
string
required

The registered account name for M-pesa Paybill, M-pesa Till and MoMo payments.

​
accountNumber
string
required

For M-Pesa Paybill: the Paybill account number, i.e. which account or bill to be paid (1-20 characters).

For M-pesa Till: the Till number (6 digits).

For Momo: phone code + phone number (no plus sign).

Minimum string length: 1
​
reference
string
required

Wallet issuers optional unique reference.

​
currency
enum<string>
default:KES
required

Local currency type for the payout.

Available options:
KES,
UGX,
GHS,
TZS,
ZMW,
ETB
​
country
enum<string>
default:KE
required

Country code.

Available options:
KE,
UG,
GH,
TZ,
ZM,
ET
​
businessNumber
string

Only required for M-Pesa Paybill payments: the Paybill business number (6 digits).

Minimum string length: 6
​
code
enum<string>
default:M-Pesa

Payment method code of the telco.

Kenya: M-Pesa, Airtel

Uganda: MTN, Airtel

Ghana: MTN

Tanzania: Airtel, Tigo (Yas)

Ethiopia: Telebirr, CBE, M-Pesa

Zambia: MTN, Airtel, Zamtel

Available options:
M-Pesa,
MTN,
Airtel,
Tigo,
Telebirr,
CBE,
Zamtel

Response

Payout request successfully created.

​
success
boolean
required

Payout status.

​
transactionId
string

Transaction ID to query the transaction status using the Stablepay Get Payment Status webhook.