How to Integrate MoMo Mobile Money into Your App in Uganda

Mobile money is how most Ugandans move money day to day — so if your app or website needs to accept payments, integrating MTN MoMo and Airtel Money isn't optional, it's essential. Here's how the process actually works.

1. Register as a Developer / Merchant

Both MTN and Airtel provide developer portals where you register your business, get sandbox API credentials for testing, and later apply for production API keys once your integration is verified.

2. Choose Your Integration Method

• Collections API — request payment from a customer's MoMo wallet (used for checkout, loan repayments, deposits).
• Disbursements API — send money out to a customer's wallet (used for refunds, loan payouts, marketplace seller payments).
• USSD fallback — for users without smartphones or data, a USSD prompt can trigger the same payment flow.

3. Handle the Payment Flow Correctly

A typical flow: your app triggers a payment request → the customer receives a PIN prompt on their phone → they approve → your backend receives a webhook/callback confirming success or failure → you update the order/loan/wallet record accordingly. This all happens asynchronously, so your backend needs to handle "pending" states gracefully rather than assuming instant confirmation.

4. Common Pitfalls

• Not handling failed or timed-out transactions — always show a clear retry option.
• Ignoring currency and minimum transaction limits set by the providers.
• Skipping the sandbox testing phase — production approval requires proof of a working sandbox integration first.

Where We've Built This

DeryCode has integrated MoMo and Airtel Money into SACCO wallets, e-commerce checkouts, and the DeryCoin ecosystem, handling both collections and disbursements at scale for Ugandan businesses.