Skip to main content
POST
Top up the wallet from M-Pesa (STK push)

Authorizations

Authorization
string
header
required

access_token from register or login. Expires after JWT_TTL (default 15m) or when the session ends.

Body

application/json
amount
integer<int64>
required

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

Required range: x >= 1
Example:

100000

idempotency_key
string
required

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

Required string length: 8 - 100
msisdn
string

Kenyan mobile number in local or international format.

Example:

712345678

Response

Top-up accepted (new or replayed).

status
object
required
data
object