Sign in

Payments

Mobile Money

View as Markdown

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

ProviderCodeNetwork
MTN Mobile Money (MoMo)mtnMTN Ghana
AirtelTigo MoneyatlAirtelTigo Ghana
Telecel CashvodTelecel Ghana

Currency

All mobile money transactions in Ghana must use GHS (Ghanaian Cedi).

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": 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"
  }
}
Was this page helpful?