The verdict in three sentences
The MTN MoMo Collections API collects directly into your merchant wallet in Accra with instant settlement, setting it apart from T+2 flows. In 2026, expect fees around 1.5 to 2%, a per-transaction cap, and a flow built on the API key, the X-Reference-Id header and status polling. The sandbox is free and faithfully mirrors production response codes.
The Collections flow step by step
The principle: you generate a unique X-Reference-Id (UUID) per payment request, you call requesttopay, then you poll the status until it resolves (SUCCESSFUL, FAILED, PENDING). The customer confirms on their phone via a MoMo prompt.
| Step | Call / header | Role |
|---|---|---|
| 1. Auth | POST /token (API key + user) | Access token |
| 2. Reference | X-Reference-Id (UUID v4) | Request idempotency |
| 3. Request | POST /requesttopay | Triggers the MoMo prompt |
| 4. Target | X-Target-Environment | sandbox / production |
| 5. Polling | GET /requesttopay/{id} | Real-time status |
| 6. Resolution | SUCCESSFUL / FAILED | Fulfil or fail |
Collections API versus hosted checkout
The direct API gives control over UX and wallet settlement, while the hosted checkout reduces integration work but externalizes the experience.
| Criterion | Collections API | Hosted checkout |
|---|---|---|
| Fees | ~1.5-2% | ~2% + aggregator margin |
| Settlement | Instant wallet | T+1 to T+2 |
| UX | Native in-app | External redirect |
| Txn cap | Provider limit | Variable |
| Dev effort | Medium (2-3 days) | Low (1 day) |
| Control | Full | Limited |
These figures are a 2026 order of magnitude to confirm under your MTN contract.
Need a professional website?
Kolonell builds websites that attract clients, optimized for the Sénégalese market. Free quote in 2 minutes.
Mini case study
Kwame runs an online hardware store in Accra, collecting the equivalent of 4,000,000 FCFA per month across ~800 transactions. Moving from a hosted checkout at ~2.3% to Collections API at 1.7% saves him roughly 24,000 FCFA/month. More importantly, instant wallet settlement removes the cash-flow gaps that were blocking his restocking.
FAQ
What is the X-Reference-Id for? It is the UUID that uniquely identifies each payment request. It guarantees idempotency: replaying the same request does not create a double charge.
Why poll instead of waiting for a callback? MoMo Collections relies heavily on status polling. You query GET /requesttopay/{id} at short intervals until SUCCESSFUL, FAILED or expiry.
Does the sandbox reflect production? Yes, it reproduces response codes and statuses. Always test SUCCESSFUL, FAILED and PENDING before going live.
What happens beyond the transaction cap? The transaction is rejected. For higher amounts, split the order or offer another payment method as a fallback.
Let's talk about your project. We integrate MTN MoMo Collections with robust polling and cap handling. 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.