The verdict in three sentences
Migrating payment aggregator never requires downtime: the 2026 method is the dual run (both integrations live in parallel) followed by a progressive percentage rollout (5 %, 25 %, 50 %, 100 %). The realistic duration is 2 to 4 weeks, with a tolerated failure rate under 1 % during the transition and a rollback plan ready at each step. The gain justifies the effort: a better fee structure often saves 0.5 to 1 point across your entire volume.
The migration plan, step by step
A successful migration is not a big bang but a controlled sequence. Each phase has a quantified exit criterion before moving to the next.
| Phase | Duration | Traffic on the new aggregator | Pass criterion |
|---|---|---|---|
| Integration + tests | 1 week | 0 % (sandbox) | Webhooks tested, idempotency OK |
| Canary | 2-3 days | 5 % | Success rate >= old one |
| Ramp-up | 3-5 days | 25 % then 50 % | Failure < 1 %, stable latency |
| Switch | 2-3 days | 100 % | 48 h without incident |
| Decommission | 1 week | Old one as backup | Webhook replay validated |
The 5 % canary is the key: you expose a small fraction of real traffic, measure, and only ramp up if the indicators are green. At any moment, reverting to the old aggregator must take minutes.
Technical traps and their countermeasures
Three risks break a poorly prepared migration: lost webhooks, double debits, and the lack of a fallback plan. Here is how to neutralize them.
| Risk | Consequence | Countermeasure | Target |
|---|---|---|---|
| Webhook lost during switch | Paid order not confirmed | Replay queue + reconciliation | 0 orphan order |
| Double debit (2 integrations) | Customer charged twice | Shared idempotency key | 0 double payment |
| Rollback impossible | Prolonged outage | Percentage feature flag | Return < 5 min |
| Status divergence | Wrong accounting | Daily reconciliation | Gap = 0 |
| Misestimated fees | Fictional saving | Simulation on real volume | Gain confirmed before switch |
The feature flag driving the traffic percentage is the central tool: it lets you move forward or back instantly, without redeployment, making rollback trivial.
Mini case study
A marketplace in Dakar processes 40,000,000 FCFA of monthly volume at 2.4 % all-in (960,000 FCFA of fees/month). A new aggregator offers 1.7 % all-in. Kolonell migration in 3 weeks: week 1 integration and tests, week 2 canary 5 % then 25 %, week 3 switch to 100 % after 48 stable hours. During the transition, measured failure rate: 0.6 %, under target. On arrival, monthly fees: 680,000 FCFA. Saving: 280,000 FCFA/month, or 3,360,000 FCFA/year, for a migration project paid back in under a month of gains.
Become a Kolonell business referrer
Need a professional website?
Kolonell builds websites that attract clients, optimized for the Sénégalese market. Free quote in 2 minutes.
Do you know a merchant paying too much for their aggregator, or a company wanting to rebuild its checkout? The Kolonell business referrer program pays you for each signed project. Commissions by pole: showcase 15 % + 5 % recurring, e-commerce 12 %, marketplace 10 %, institutional 8 %. Just introduce us to the contact; we handle the audit, migration, and follow-up, and you earn your commission at signing, plus, for showcase sites, a recurring share on maintenance.
FAQ
How long does an aggregator migration take?
Usually 2 to 4 weeks: one week of integration and testing, then a progressive percentage rollout. The duration depends mostly on webhook volume and reconciliation complexity.
Is there a risk of checkout downtime?
No, if you run a dual run with progressive rollout. Both integrations coexist, a feature flag drives the traffic percentage, and rollback takes under 5 minutes.
How do you avoid double debits during the transition?
By sharing an idempotency key between both integrations and reconciling statuses daily. The goal is zero double payment throughout the switch.
What fee saving can be expected?
Often 0.5 to 1 point on total volume, depending on your current structure. On 40,000,000 FCFA/month, that can be several hundred thousand FCFA of monthly saving.
Can I be paid for recommending this service?
Yes, via the Kolonell business referrer program: up to 15 % + 5 % recurring for showcase, 12 % for e-commerce, 10 % for marketplace, 8 % for institutional. You introduce, we deliver, you earn.
Let's talk about your project. Zero-downtime migration, optimized fees, or a referrer commission: let's discuss it. 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.
