The verdict in three sentences
In 2026, the MTN MoMo Collections API in Uganda covers more than 12 million subscribers — you cannot sell online in Uganda without it. The entry ticket: strict merchant KYC and 5 to 10 days of validation before going live. Technically the flow is simple: get a token, call the request-to-pay endpoint, poll the status, and confirm via webhook, for a success rate of around 92 %.
Integration steps, from sandbox to production
The integration journey always follows the same sequence. Here are the steps and realistic 2026 timelines.
| Step | Action | Typical delay | Watch point |
|---|---|---|---|
| 1. Developer account | Sign up on MTN MoMo developer portal | 1 day | Business email required |
| 2. Sandbox | Test keys, fake numbers | Immediate | Test every error case |
| 3. Merchant KYC | Registration, TIN, director ID | 5 – 10 days | Complete file upfront |
| 4. Production keys | Live subscription/API keys | 1 – 2 days after KYC | Store in env vars |
| 5. Webhook | HTTPS confirmation URL | 1 day | Verify the signature |
| 6. Go live | First real payment | ~T+15 | Test with small amount |
Expect around 15 days between sign-up and your first real collection, with KYC as the bottleneck.
The request-to-pay flow in detail
The core of the integration rests on a few calls. Here are the key parameters and their 2026 values.
| Technical parameter | Value / behaviour | Note |
|---|---|---|
| Auth | OAuth2, Bearer token | ~1 h lifetime |
| Collection endpoint | POST requesttopay | Amount, currency, number |
| Client USSD timeout | 60 s | Customer approves via USSD code |
| Status polling | GET every 3 – 5 s | Max 20 attempts |
| Statuses | PENDING / SUCCESSFUL / FAILED | Idempotency mandatory |
| Webhook | Signed POST to your URL | Final source of truth |
| Merchant fee | 1.5 % | Negotiable by volume |
| Success rate | ~92 % | 8 % drop-offs/timeouts |
Golden rule: the webhook is the source of truth, not polling. Never fulfil an order on a mere UI callback — wait for the server-confirmed SUCCESSFUL status.
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
David runs an electronics store in Kampala and sells 300 orders/month at 25 000 FCFA equivalent on average, i.e. 7 500 000 FCFA collected. With MTN MoMo at 1.5 %, his fees are 112 500/month. The 92 % success rate means that out of 326 attempts, 26 fail (timeout, insufficient balance). By adding an automatic follow-up message after a failure, he recovers about 40 % of those baskets, i.e. ~10 extra sales/month = 250 000 FCFA of regained revenue, for an additional fee cost of just 3 750.
FAQ
Can I test without a validated merchant account? Yes, the MTN MoMo sandbox works immediately with test numbers and keys. You build the entire flow before even starting KYC.
How long does KYC validation take? Expect 5 to 10 working days in 2026, provided the file (registration, TIN, director ID) is complete at submission. An incomplete file can double that delay.
What happens if the customer doesn't approve within 60 s? The transaction goes FAILED or expires. Your back-end must handle this cleanly, release reserved stock and offer a follow-up.
Is the webhook really mandatory? Technically you can rely on polling, but it's risky. The signed webhook is the only reliable server-side confirmation and protects against fake approvals.
What real fees should I plan for? About 1.5 % per transaction in 2026, negotiable above a certain monthly volume. Also budget the integration development cost if you use a provider.
Let's talk about your project. We integrate MTN MoMo end to end, signed webhook and retries 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.