Orange Money is still number two in Senegal with 4 million active users in 2026, despite Wave's surge. Ignoring OM means losing 25 to 35% conversion on customers over 40, civil servants and rural areas. The Orange Money API integration deserves to be done properly.
TL;DR
- OM Senegal merchant fee: 1.5% to 2% depending on monthly volume
- 3 separate APIs: Web Payment, Bulk Pay, Cash-in
- Merchant activation: 2 to 4 weeks (slower than Wave)
- Sandbox at api.orange.com/oauth/v3/token
- Multi-country: 18 African countries via OM API Hub
H2 — Orange Money landscape 2026
In Senegal, Orange Money is operated by Sonatel. In 2026, OM claims 4M+ active users, XOF 1.2 billion in daily inflows and a network of 70,000 cash points. Its strength: rural coverage and seniors. Its weakness: merchant fees still higher than Wave.
H3 — The three API surfaces
| API | Use | Method | Use cases |
|---|---|---|---|
| Web Payment | Collect from customer | Web redirect | E-commerce, ticketing |
| Bulk Pay | Pay many recipients | Server-to-server | Payroll, commissions |
| Cash-in API | Payment push notification | USSD initiated client side | Kiosks, restaurants |
H2 — Activate an Orange Money merchant account
The process runs through a Sonatel Business agency or an authorized partner. Required: NINEA, RCCM, manager ID, address proof, articles. Plan 2 to 4 weeks, sometimes more.
H3 — Typical financial terms
| Monthly volume | Merchant fee | Bank cash-out |
|---|---|---|
| Below XOF 1M | 2% | XOF 500 flat |
| XOF 1M to 10M | 1.7% | XOF 500 flat |
| Over XOF 10M | 1.5% negotiable | Free on volume |
Fees become negotiable above XOF 5M per month.
H2 — Web Payment: front integration
Orange Web Payment looks like 3D Secure: the customer is redirected to an Orange page, types their OM number, gets an SMS OTP and confirms.
- Step 1: get an access_token via /oauth/v3/token (client_credentials).
- Step 2: POST /omcoreapis/1.0.2/mp/init with amount, return_url, cancel_url, order_id.
- Step 3: receive a payment_token and redirect to webpayment.orange-money.com.
- Step 4: Orange POSTs to your return_url with status SUCCESS, FAILED or PENDING.
- Step 5: verify via GET /mp/status/{payment_token} before marking paid.
H3 — Bulk Pay for mass payouts
Bulk Pay pays N recipients in one call. Common with transfer agencies, NGOs, employers. Limit: 10,000 recipients per batch, ceiling XOF 2M per recipient.
H2 — Sandbox and test environment
Need a professional website?
Kolonell builds websites that attract clients, optimized for the Sénégalese market. Free quote in 2 minutes.
Orange provides a sandbox at api.orange.com/oauth/v3/token with dedicated sandbox credentials. No real money moves. Senegal test numbers: +221 770 000 001 to 005.
H2 — Wave vs Orange Money: which to pick?
| Criterion | Wave | Orange Money |
|---|---|---|
| Merchant fee | 1% | 1.5% to 2% |
| Activation | 5-10 days | 2-4 weeks |
| Demographic | 18-40 urban | 30+ rural-friendly |
| Multi-country | 5 countries | 18 countries |
| API stability | Excellent | Good, incident 1x/month |
Practical answer: integrate both. Wave for 70% urban traffic, OM to keep the remaining 30%.
FAQ
Q: What does Orange Money really cost for e-commerce?
A: Plan 1.7% to 2% merchant fees depending on volume, plus XOF 500 flat per bank cash-out. On XOF 5M collected, that is roughly XOF 85,000 to 100,000 in fees.
Q: Is the Orange Money API stable?
A: Mostly yes, but network incidents happen 1 to 2 times per month (short downtime). Always code a Wave fallback in parallel.
Q: Can I accept Orange Money Ivory Coast on the same account?
A: No. Each country has its own Orange legal entity. You need a separate OM Ivory Coast merchant account. The global API Hub exists but needs a group contract.
Q: How long does the full integration take?
A: For an experienced developer: 4 to 6 days for Web Payment alone, 8 to 12 days for Web Payment plus Bulk Pay plus accounting reconciliation.
Q: Aggregator or direct with Orange?
A: Direct above XOF 3M per month. Below that, an aggregator like PayDunya or CinetPay smooths the activation.
Conclusion
Orange Money is no longer the leader on mobile, but it stays mandatory to reach wide in Senegal. Pair it with Wave and you cover 90% of the market. Kolonell ships OM + Wave on its e-commerce sites by default. Free audit or 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.