E-commerce11 min read

MTN MoMo Collections API in Uganda: 2026 Guide

Mohamed Bah·Fondateur, Kolonell
August 30, 2026
Share:
MTN MoMo Collections API in Uganda: 2026 Guide

MTN MoMo Collections API in Uganda: 2026 Guide

E-commerce

The verdict in three sentences

For an online store in Uganda, MTN MoMo Collections is the widest collection channel in 2026, built around the RequestToPay endpoint that pushes a validation prompt to the customer's phone. Merchant fees run at 1 to 2 % and confirmation arrives by callback, provided you handle intermediate statuses cleanly. In Senegal, Orange Money Web Payment follows an equivalent logic via redirect plus USSD push, validated within 120 seconds and with merchant fees around 1.5 %.

The MTN MoMo Collections flow step by step

A MoMo payment in Uganda follows a precise sequence. The customer picks MoMo at checkout, your server calls RequestToPay, the customer receives a push prompt or a code to dial and confirms with their PIN.

StepActorActionTypical delay
1. CreateMerchant serverRequestToPay call, amount + reference< 1 s
2. PromptOperatorPush notification on customer phone3-10 s
3. PIN entryCustomerValidate with MoMo PIN10-90 s
4. CallbackOperator → serverFinal status notification1-5 s after validation
5. Status pollMerchant servergetTransactionStatus fallbackon demand
6. ConfirmationStoreDeliver + mark paidimmediate

The timeout window is 60-90 seconds: if the customer does not validate, the transaction expires and must be marked TIMEOUT, never a permanent FAILED until the callback decides.

Transaction statuses and confirmation delays

Modeling statuses well prevents ghost orders. Here is the combined MTN MoMo Uganda / Orange Money Senegal reference table.

StatusMTN MoMo (UG)Orange Money (SN)Merchant action
InitiatedPENDINGPENDINGWait, deliver nothing
Awaiting customerPENDINGINITIATEDShow "confirm on your phone"
SuccessfulSUCCESSFULSUCCESSDeliver + mark paid
FailedFAILEDFAILEDOffer another method
ExpiredTIMEOUTEXPIREDRe-initiate or cancel
Average confirmation6-15 s8-20 sAdd a fallback poll
Merchant fees1-2 %~1.5 %Build into margin

As a 2026 order of magnitude, 90 % of confirmed MoMo payments settle in under 15 seconds. The MTN MoMo sandbox lets you simulate every status before going live, a real asset for edge-case testing.

Mini case study

Grace, who runs a cosmetics store in Kampala, handles 400 orders per month at an average of UGX 45,000 (about 12,000 FCFA equivalent), a monthly volume around UGX 18,000,000. At 1.5 % MoMo merchant fees she pays roughly UGX 270,000 in monthly commission. By enabling fallback polling for missed callbacks, she recovers 3 % of orders stuck in PENDING, roughly UGX 540,000 in rescued sales each month — twice the fee cost.

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 MTN MoMo Collections timeout?

The RequestToPay validation window is typically 60-90 seconds in 2026. Beyond that the transaction moves to TIMEOUT and must be re-initiated by the customer.

What merchant fees apply to MTN MoMo in Uganda?

As a 2026 order of magnitude, expect 1 to 2 % per collected transaction. The exact rate depends on your merchant contract and negotiated volume.

Is a callback mandatory?

Yes, the callback is the source of truth for the final status. Always add a fallback poll (getTransactionStatus) for lost notifications, otherwise you risk paid orders that never ship.

Does Orange Money work like MTN MoMo?

The principle is identical: redirect plus USSD push triggers a validation prompt on the customer's phone. Fees are around 1.5 % and the timeout is 120 seconds.

Can I collect without the push prompt?

MoMo relies on the RequestToPay prompt for security. A fuller API flow exists depending on your contract, but PIN validation is always required on the customer side.

Let's talk about your project. We integrate MTN MoMo and Orange Money with robust callbacks and tested fallback polling. WhatsApp +221 77 596 93 33.

Tags:#Orange Money#MTN MoMo#collections#API#Senegal#Uganda#USSD#payment
Share:

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.