Payments
Mobile Money
In a nutshell
Mobile money payments for businesses in Ghana — MTN MoMo, Telecel Cash, and AirtelTigo Money.
Mobile money lets Ghanaian customers pay from their mobile wallet using a phone number and PIN. It is the most widely used digital payment method in Ghana and should be the primary channel offered at checkout.
Copy linkSupported providers
| Provider | Code | Network |
|---|---|---|
| MTN Mobile Money (MoMo) | mtn | MTN Ghana |
| AirtelTigo Money | atl | AirtelTigo Ghana |
| Telecel Cash | vod | Telecel Ghana |
Currency
All mobile money transactions in Ghana must use GHS (Ghanaian Cedi).
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": 100,
"currency": "GHS",
"mobile_money": {
"phone": "0551234987",
"provider": "mtn"
}
}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"
}
}