The verdict in three sentences
A well-encapsulated front-end SDK cuts mobile payment integration time from several days to a few hours. In Kigali, a React usePayment hook centralizes the state machine (pending, success, failed), status polling and retry UI, for MTN MoMo as for Airtel. The structural decision is reusable proprietary SDK or throwaway custom component: the SDK wins from the second project on.
Proprietary SDK or custom component: the team trade-off
A custom component written for a single project feels faster at first. But as soon as a second site must collect payment, you copy the logic, the bugs and the debt. A versioned SDK flips the equation.
| Criterion | Proprietary SDK | Custom component |
|---|---|---|
| Time, 1st project | 1 day | 0.5 day |
| Time, 2nd project | 2 hours | 0.5 day |
| Shared fixes | Yes (one version) | No (copy-paste) |
| Centralized tests | Yes | Per project |
| State machine | Reusable | Rewritten |
| Recommended for | Agency, multi-project | Single prototype |
For an agency or team shipping several stores per year, the SDK pays for itself from the second integration.
UI states, polling and error handling in 2026
The core of the SDK is a clear React state machine, fed by server status polling. Here are the recommended values for Rwanda in 2026.
| Element | 2026 value | Role |
|---|---|---|
| Initial state | idle | Before click |
| In-progress state | pending | Awaiting confirmation |
| Polling interval | 3 seconds | Calls status() |
| Global timeout | 90 seconds | Switches to failed |
| Final success state | success | Shows the receipt |
| Final failure state | failed | Offers retry |
| UI retries | 2 | Before abandon |
| Providers | MTN MoMo, Airtel | Selected at checkout |
Rule: the front never decides success alone, it reflects the status returned by the backend, itself confirmed by the provider webhook.
Comparison with Togo (Lomé)
Need a professional website?
Kolonell builds websites that attract clients, optimized for the Sénégalese market. Free quote in 2 minutes.
In Lomé, the same approach applies with T-Money and Moov: a React hook, status polling, a timeout matched to the USSD PIN entry time.
| Criterion | SDK Rwanda (MTN, Airtel) | SDK Togo (T-Money, Moov) |
|---|---|---|
| Hook | usePayment | usePayment |
| Providers | MTN MoMo, Airtel | T-Money, Moov |
| Polling interval | 3 s | 3 s |
| Global timeout | 90 s | 90 s |
| Currency | RWF | XOF (FCFA) |
| UI retry | 2 | 2 |
Mini case study
Eric runs a small web studio in Kigali shipping 5 React stores per year. Without an SDK, each payment integration cost him 3 person-days, i.e. 15 days per year. After encapsulating a reusable usePayment SDK (1.5 days of initial investment), each new integration drops to 3 hours. Across 5 projects, he goes from 15 days to about 3.4 days: over 11 person-days saved per year, reinvested into conversion and UX.
FAQ
Why an SDK rather than a custom component? Because a custom component is copied on every project, bugs and all. A versioned SDK shares fixes and tests: from the second project, integration drops from 0.5 day to 2 hours.
What polling interval should I choose? 3 seconds is the right balance in 2026: responsive enough for the buyer, spaced enough not to hammer the status() API. With a 90-second global timeout, you cover USSD PIN entry.
Can the front decide success alone? No. The hook only reflects the status returned by the backend, itself confirmed by the provider webhook. The SDK displays, it does not validate the payment.
How many UI retries should I plan? Two before abandon, to cover input errors or network timeouts without frustrating the buyer. Each retry cleanly restarts the state machine from pending.
Does the same SDK work in Togo? Yes, the structure is identical: usePayment hook, 3 s polling, 90 s timeout. Only the providers (T-Money, Moov) and currency (FCFA instead of RWF) change.
Let's talk about your project. We encapsulate a reusable React payment SDK for MTN MoMo and Airtel in Kigali, ready to wire into all your stores. 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.
