Skip to main content
POST
Pay a merchant by M-Pesa (STK push)

Path Parameters

code
string
required
Pattern: ^[a-z0-9]{10}$

Body

application/json
amount
integer<int64>
required

Cents (KES minor units). 100 = KES 1.00.

Required range: x >= 1
Example:

100000

msisdn
string
required

Kenyan mobile number in local or international format.

Example:

712345678

idempotency_key
string
required

Unique per customer per intended operation; a UUID is ideal.

Required string length: 8 - 100
network
enum<string>

Payer's network; Airtel needs a SasaPay or Paystack (charge) rail, T-Kash needs SasaPay.

Available options:
mpesa,
airtel,
tkash

Response

Prompt sent (new or replayed).

status
object
required
data
object