Payments
Mobile Money
In a nutshell
Accept Airtel Money and other non-M-PESA mobile wallet payments in Kenya.
For M-PESA integration, see the dedicated M-PESA page. This page covers other mobile money providers in Kenya.
Copy linkSupported providers
| Provider | Code | Network |
|---|---|---|
| Airtel Money | atl | Airtel Kenya |
Currency
All mobile money transactions in Kenya must use KES (Kenyan Shilling).
Copy linkTransaction flow
- Your server creates a charge with the customer's email, amount, currency, and a
mobile_moneyobject containingphoneandprovider. - Paystack sends a payment prompt to the customer's handset.
- The customer approves the request by entering their wallet PIN.
- Paystack sends a
charge.successwebhook event confirming the payment.
The initial charge response returns data.status as pay_offline and includes display_text describing what the customer should do next.
Copy linkTiming and limits
The customer must approve the prompt within 180 seconds. If no charge.success webhook arrives after this window, verify the transaction using the Verify Transaction API to get the final status.
Copy linkReusability
Mobile money authorizations are not reusable. Each payment must start as a new charge. To set up recurring payments, consider using Paystack Subscriptions with an initial card authorization.
Copy linkCharge request
{
"email": "[email protected]",
"amount": 10000,
"currency": "KES",
"mobile_money": {
"phone": "+254710000000",
"provider": "atl"
}
}Copy linkWebhook confirmation
Listen for the charge.success event on your webhook endpoint. Do not fulfill orders or grant access based solely on the initial API response β always wait for the webhook or verify the transaction.
{
"event": "charge.success",
"data": {
"status": "success",
"reference": "your_reference",
"amount": 10000,
"channel": "mobile_money"
}
}