STK Push
Trigger M-Pesa payment prompts directly on your customer's phone.
Overview
STK Push (Lipa na M-Pesa Online) allows you to initiate a payment request that appears as a popup on the customer's mobile device, asking them to enter their M-Pesa PIN.
Initiate Request
Send a POST request to the /collections/stk endpoint.
POST /v1/collections/stk
{
"phone": "254712345678",
"amount": 1000,
"reference": "ORDER-123",
"description": "Payment for items"
}Parameters
- •phone: The customer's phone number in E.164 format (e.g., 2547...).
- •amount: The amount to charge in KES.
- •reference: Your internal order or invoice ID.
- •description: A short description shown to the user (max 20 chars).