Sign in

Payments

Mobile Money

View as Markdown

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

ProviderCodeNetwork
Airtel MoneyatlAirtel Kenya

Currency

All mobile money transactions in Kenya must use KES (Kenyan Shilling).

Copy linkTransaction flow

  1. Your server creates a charge with the customer's email, amount, currency, and a mobile_money object containing phone and provider.
  2. Paystack sends a payment prompt to the customer's handset.
  3. The customer approves the request by entering their wallet PIN.
  4. Paystack sends a charge.success webhook 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"
  }
}
Was this page helpful?