Payment gateway integration in Ghana usually means connecting your website or app to a licensed gateway that collects MTN MoMo, Telecel Cash, AT Money and card payments through one API. You send a payment request, the customer approves on their phone, and the gateway confirms by callback. The hard parts are confirmations, failures and reconciliation.
This guide is for business owners and developers in Accra, Tema and Kumasi adding payments to a shop, booking site, school portal or app. It covers how mobile money APIs work in Ghana, the gateways in the market, what a solid integration handles, and what PED Solution Studios has integrated. It is not legal or financial advice. Check each provider’s current terms.
How mobile money payments reach your app in Ghana
Most businesses do not connect to each telco separately. A payment gateway or aggregator holds the connections to MTN, Telecel and AT, and to the card networks, and gives you one API. The usual flow is:
- Your system creates an order with a unique reference.
- It asks the gateway to charge the customer: a wallet number and network for a direct prompt, or a redirect to the gateway’s hosted checkout page.
- The customer approves the prompt on their phone with their PIN.
- The gateway sends your server a callback (webhook) with the result.
- Your server checks the result with the gateway, marks the order paid exactly once, and tells the customer.
Payment services in Ghana are regulated by the Bank of Ghana under the Payment Systems and Services Act, 2019 (Act 987). The Bank publishes the list of licensed payment service providers. Confirm a provider is licensed before you sign.
Payment gateways used in Ghana
- Hubtel. An Accra company whose developer platform offers an online checkout (modal, redirect or embedded), direct mobile money collection and more. Its checkout takes a callback URL and your own client reference for each order (developers.hubtel.com).
- PaySwitch (theteller). An East Legon, Accra company whose theteller API processes mobile money and card payments. A request names the network (“r-switch”) such as MTN, Telecel or AT, and a transaction ID (theteller.net documentation).
- Paystack. Widely used in Ghana for cards and mobile money, with documented support for MTN, AT and Telecel wallets and signed webhooks (paystack.com/docs).
- PayPal and Stripe. For international card payments. Stripe’s own site lists Ghana as an “extended network” country and points Ghana businesses to Paystack (which Stripe owns), so a Ghana-registered business usually cannot open a standard Stripe account directly. Stripe suits companies registered abroad that take foreign payments. Check eligibility before planning around it.
- Telco developer programmes. For example MTN’s MoMo developer portal (momodeveloper.mtn.com), for businesses that need a direct MTN integration and can meet its onboarding requirements.
PED has integrated Hubtel and PaySwitch for mobile money, including bulk payouts, and PayPal for card and international payments. PED has used Stripe to take foreign payments for foreign companies. Paystack is listed here as a market option. It is not a PED integration.
What a solid integration handles (and cheap ones skip)
Confirmation from the server, not the browser. A customer closing the page does not mean they did not pay. Only the gateway’s callback, checked against the gateway’s status API, marks an order paid.
Idempotency. Gateways may send the same callback twice. Your system must recognise the reference and not credit, ship or send a receipt twice.
Verifying the callback. Check the signature or token the gateway provides, or re-query the transaction, so nobody can fake a “paid” message.
Pending and timed-out prompts. Customers miss prompts, lack balance or enter the wrong PIN. Show a clear “waiting for approval” state, a retry, and a way to pay with another wallet.
Network selection and number formats. Validate the wallet number and network before sending the prompt. Many failures start with a wrong network.
Reconciliation. Every day, your records should match the gateway’s settlement report. Build an admin view that shows pending, failed, reversed and settled payments by reference.
Refunds and reversals. Decide who can refund, how it is logged, and how the customer is told.
Payouts. Marketplaces, agribusinesses and delivery firms often need to pay many wallets at once: sellers, farmers or riders. Bulk payouts need an approval step before money goes out, a record per recipient, and handling for failed transfers. PED’s Hubtel and PaySwitch integrations can do bulk payouts.
Fees and settlement. Gateways charge per transaction and settle on their own schedule. Check each provider’s current Ghana pricing and settlement terms. They change, and we do not quote them here.
Test and live keys. Keep keys in server configuration, never in app code, and in your company’s account.
Typical use cases for businesses in Accra and Tema
- Online shops, with MoMo and card checkout. See e-commerce with mobile money.
- Mobile apps, with in-app MoMo prompts. See mobile app development in Ghana.
- School and event fees, with a reference per student or ticket.
- Bookings and rentals, with deposits and balances. For example, Thirdspace, a gear and crew rental marketplace we built in Accra.
- Marketplaces, where payments, commissions and seller payouts must reconcile. See BYOB, a commerce and logistics platform we built.
Choosing a gateway
Ask each provider, in writing:
- Which wallets and cards do you support today?
- What are the current fees and the settlement timeline to a Ghana bank account?
- What documents are needed to go live?
- Is there a sandbox, and how good are the docs?
- How are callbacks signed, and is there a status-check API?
- Do you support payouts to wallets if you need to pay sellers or riders?
- What support do you offer when a payment is disputed?
Many businesses use one gateway for mobile money and a second for international cards. Design the code so a gateway can be swapped without rewriting checkout.
How PED Solution Studios integrates payments
Payments are part of most PED builds rather than a separate product. They are scoped with the site or system as part of custom software and apps, operations software or a website. A typical integration includes:
- the checkout or wallet prompt flow in your web or Android app;
- server-side callbacks with verification and idempotent order updates;
- a payments admin showing every transaction by reference and status;
- refunds and manual review where the gateway supports them;
- testing on each network before go-live.
Frequently asked questions
What is the best payment gateway in Ghana?
There is no single best one. It depends on the wallets and cards you need, fees, settlement time, documentation and support. PED has integrated Hubtel and PaySwitch for mobile money, PayPal for cards, and Stripe for foreign companies taking foreign payments.
Can I accept MTN MoMo, Telecel Cash and AT Money on my website?
Yes, through a gateway that supports all three. PED integrates them through Hubtel or PaySwitch, so customers approve the payment on their phone.
Can a Ghanaian business use Stripe?
Usually not directly. Stripe lists Ghana as an extended-network country and directs Ghana businesses to Paystack. A standard Stripe account usually needs a company registered in a supported country. PED has used Stripe for foreign companies taking foreign payments. Check Stripe’s current eligibility.
How long does a mobile money integration take?
It depends on the gateway’s onboarding, documents and the scope of your checkout and admin. PED agrees timelines in the project scope.
Do I need a licence to accept mobile money payments?
It depends on what your business does with the money. Payment service providers in Ghana are licensed by the Bank of Ghana under Act 987. If you only sell goods or services and collect through a licensed gateway, ask the gateway what it requires from you. For anything more, check with the Bank of Ghana or your legal adviser.
Add payments to your product
If you need customers to pay by MoMo or card, book a call and tell us where the payment happens and what should happen after it succeeds or fails.