MTN MoMo API integration guide for developers in Kampala 2026

The verdict in three sentences

In Uganda, MTN MoMo exposes the Collections API with a subscription key and a dedicated sandbox environment. The right method is to validate in sandbox before go-live, with separate keys per environment, then switch to production keys once callbacks are confirmed. Lock down from the start the transaction limit (ballpark 7,000,000 UGX), the subscription key and the callback carrying the X-Reference-Id.

Sandbox then go-live: the sequence that avoids production incidents

The classic mistake is coding straight against production. Going through a sandbox environment, with dedicated subscription keys, lets you test callbacks, timeouts and failure cases without moving real money.

Only request production keys once sandbox callbacks are stable. This avoids exposing production credentials during trial phases.

Endpoints, keys and limits in Kampala for 2026

Here are the parameters to lock down for MTN MoMo Collections in Uganda. Limits are 2026 ballparks, to confirm with the merchant contract.

Comparison with Burkina Faso mobile money (Ouagadougou)

In Burkina Faso, Orange Money and Moov Money expose distinct Collect APIs, best wrapped behind a common abstraction, with limits expressed in FCFA.

Mini case study

David runs a spare-parts store in Kampala, collecting 350 orders per month at an average basket of 450,000 UGX, i.e. 157,500,000 UGX. Some B2B orders exceeded the 7,000,000 UGX per-transaction limit and failed silently. By automatically splitting these payments into several under-limit transactions and reconciling via status(), he eliminates 100 % of these failures, securing about 12,000,000 UGX of previously lost B2B sales each month.

FAQ

Is there a single mobile money API in Uganda? MTN MoMo Collections is the main one in Kampala, but if you also serve Airtel you will wrap both behind a common abstraction, one implementation per provider.

Why go through a sandbox before production? To test callbacks, timeouts and failure cases without moving real money, and to expose production keys only once the flow is stable. It avoids costly production incidents.

What is the per-transaction limit in 2026? Ballpark 7,000,000 UGX for MTN MoMo Uganda, to confirm with your merchant contract. For large B2B payments, automatically split into several under-limit transactions.

What is the subscription key for? It authenticates your calls to the Collections API and distinguishes your test and production environments. Never mix a sandbox key with production calls.

How do I handle a missing callback? Plan reconciliation via a status() call on the unique reference-id. If the callback never arrives, this fallback check confirms or refutes the payment.

Let's talk about your project. We integrate the MTN MoMo Collections API in Kampala, from sandbox to go-live, with limit handling and reconciliation. WhatsApp +221 77 596 93 33.