The verdict in three sentences
The MTN MoMo Collections API is essential for online stores in Accra, where MTN holds the largest mobile money base in Ghana. Integration relies on an API user and API key, a subscription (primary) key and a unique X-Reference-Id per request that also serves as your idempotency handle. The sensitive part is not the code but moving cleanly from sandbox to production and respecting the GHS 20,000 per day limit, so design your checkout for both.
API setup and key fields
The Collections flow has three moments: authenticate with your API user and key, create a requesttopay with amount and reference, then poll or receive the status. The customer approves on their handset, which introduces latency.
| Field / element | 2026 value | Note |
|---|---|---|
amount | Integer in GHS | Min 1 GHS |
currency | GHS | Ghana |
X-Reference-Id | UUID per request | Idempotency |
| Subscription key | Primary key | Header Ocp-Apim |
| API user / key | Created via provisioning | Auth |
| Merchant fee | 1-2 % | Estimate |
| Settlement | T+1 | To MoMo/bank |
| Daily limit | ~GHS 20,000 | Per account, estimate |
Errors and states to handle
A robust integration anticipates the most common failures. Handle each state and never confirm the order before the status is a verified SUCCESSFUL.
| Situation | Expected behaviour | Store action |
|---|---|---|
| Insufficient funds | Payment failed | Clear message + retry |
| Timeout / no approval | Pending status | Poll status endpoint |
| Wrong subscription key | Request rejected | Fix header |
| Duplicate submission | Same X-Reference-Id | Idempotent, ignore |
| Callback missed | Notification lost | Reconcile via API |
| Customer cancels | Rejected | Release cart |
Mini case study
Ama runs an online deli in Osu, Accra. She handles 200 orders a month at GHS 130, about GHS 26,000. At a 2 % MoMo fee she pays GHS 520 a month. Negotiating a 1.5 % tier above a volume threshold drops that to GHS 390, saving GHS 130 a month. More importantly, handling approval timeouts properly recovers roughly 5 % of orders that would otherwise be wrongly abandoned, saving about GHS 1,300 in monthly revenue.
Need a professional website?
Kolonell builds websites that attract clients, optimized for the Sénégalese market. Free quote in 2 minutes.
FAQ
What is the minimum amount I can collect?
MTN MoMo Collections supports transactions from 1 GHS, suitable even for small baskets. Fees stay proportional, around 1 to 2 %.
What is the difference between sandbox and production?
Sandbox uses a provisioned API user with test numbers to simulate success and failure; production requires an approved merchant profile and live keys. Plan a clean promotion of credentials between the two.
Is there a daily limit I should design around?
Yes, roughly GHS 20,000 per day per account as an order of magnitude. High-volume stores should confirm their limit and consider splitting or upgrading the account.
What if I never receive the status callback?
Build reconciliation: poll the status endpoint every few minutes using the X-Reference-Id. A small share of notifications is always lost, so a safety net is required.
Let's talk about your project. We integrate the MTN MoMo Collections API for your Accra store, sandbox to production included. WhatsApp +221 77 596 93 33.
Mohamed Bah
Fondateur, Kolonell
Passionate about digital and entrepreneurship in Africa, Mohamed has been helping Sénégalese businesses with their digital transformation since 2020. Founder of Kolonell, he believes every SME deserves a professional and accessible online présence.
