Integrer Wave et Orange Money sur votre site web au Senegal : guide technique 2026

Le paiement mobile au Senegal : un incontournable pour tout site e-commerce

En 2026, plus de 70 % des transactions en ligne au Senegal passent par Wave ou Orange Money. Si votre site ne propose pas ces deux options, vous perdez la majorite de vos acheteurs potentiels. Les cartes bancaires restent minoritaires ; le mobile money est le vrai rail de paiement du marche local. Ce guide technique explique, etape par etape, comment integrer les deux plateformes sur un site web, que vous soyez developpeur solo ou PME qui sous-traite son dev.

Comprendre l architecture d integration : 4 modes disponibles

Wave et Orange Money offrent chacun plusieurs modes d integration selon votre niveau technique et votre volume de transactions.

Mode lien de paiement (le plus simple) : Wave Business permet de generer un lien pay.wave.com/?to=XXXX&amount=YYYY directement depuis le tableau de bord. Pas de code requis. Utile pour les petites boutiques ou les prestataires de services qui envoient des factures par WhatsApp. Limite : pas de reconciliation automatique, suivi manuel obligatoire.

Mode QR code : Wave genere un QR statique ou dynamique. Le QR dynamique encode le montant — l acheteur scanne, valide, et Wave confirme. Integrable dans une page de checkout classique via une simple image SVG. Orange Money dispose du meme mecanisme via son portail Max It.

Mode API REST avec redirection : c est le mode recommande pour les sites e-commerce. Vous appelez l API, obtenez une URL de paiement, redirigez l utilisateur, puis Wave/Orange Money rappellent votre serveur via un webhook une fois le paiement confirme. Ce flux est identique au modele Stripe Checkout.

Mode SDK mobile : pour les applications Flutter ou React Native, les deux operateurs fournissent des SDK qui declenchent directement l application mobile installee sur le telephone.

Mise en place du checkout Wave Business : les etapes cles

• Creer un compte Wave Business sur business.wave.com et soumettre les documents KYB (piece d identite du gerant, NINEA, extrait RCCM). Delai : 3 a 7 jours ouvrables.
• Recuperer votre cle API dans les parametres du compte (section Developpeurs).
• Appel API pour creer une session de paiement :

`

POST https://api.wave.com/v1/checkout/sessions

Authorization: Bearer

{

"amount": "15000",

"currency": "XOF",

"success_url": "https://votresite.sn/merci",

"error_url": "https://votresite.sn/echec",

"client_reference": "commande_789"

}

`

• Rediriger l utilisateur vers l URL retournee dans le champ wave_launch_url.
• Ecouter le webhook sur votre endpoint /webhook/wave et valider la signature HMAC-SHA256.

Pour un article de 15 000 FCFA, Wave preleve environ 1 % de frais marchand (150 FCFA). Le virement vers votre portefeuille Wave Business est instantane.

Mise en place du checkout Orange Money via Max It

Orange Money au Senegal s integre via le portail Max It (maxitpay.orange.sn). Le processus :

• S inscrire en tant que marchand et fournir les documents d entreprise (memes que Wave).
• Obtenir le merchant_key et le secret dans l espace developpeur.
• Initier le paiement via l API Web Payment :

`

POST https://api.maxitpay.orange.sn/webpayment

{

"merchant_key": "XXXX",

"currency": "XOF",

"order_id": "CMD_456",

"amount": 25000,

"return_url": "https://votresite.sn/confirmation",

"cancel_url": "https://votresite.sn/annulation",

"notif_url": "https://votresite.sn/webhook/om"

}

`

• L utilisateur est redirige sur la page Orange Money, saisit son PIN et valide.
• Orange Money poste la confirmation sur votre notif_url.

Frais marchand Orange Money : environ 1,5 % du montant. Les virements vers votre compte bancaire se font sous 24 a 72 h.

Gestion des callbacks et reconciliation

Le point le plus critique est la gestion des callbacks. Plusieurs scenarios d echec existent : l utilisateur ferme son navigateur avant la redirection, le webhook n arrive pas (timeout serveur), ou le paiement est en statut "en attente".

Bonnes pratiques :

• Ne jamais confirmer une commande uniquement sur la return_url (l utilisateur peut manipuler l URL).
• Confirmer uniquement apres reception et validation du webhook serveur-a-serveur.
• Stocker chaque evenement de webhook dans une table payment_events avec le statut et l horodatage.
• Implementer un job de reconciliation toutes les 15 minutes qui interroge l API Wave/OM pour les paiements dont le statut est encore "pending" apres 10 minutes.

Tester sans risquer de l argent reel

Wave propose un environnement sandbox (sandbox.wave.com/v1/...) avec des numeros de telephone de test. Orange Money Max It dispose egalement d un environnement de recette avec des credentials separes. Testez systematiquement les cas : paiement reussi, paiement annule, timeout, montant incorrect.

FAQ

Combien coute l integration Wave + Orange Money sur un site e-commerce ?

Le developpement d un checkout double (Wave + Orange Money) avec gestion des webhooks et reconciliation compte entre 150 000 et 350 000 FCFA selon la complexite du site. L acces aux API est gratuit ; seuls les frais de transaction s appliquent (1 % Wave, 1,5 % Orange Money environ).

Faut-il une entreprise enregistree pour acceder aux API marchandes ?

Oui. Wave Business et Orange Money Max It exigent un NINEA et un extrait RCCM en cours de validite. Un compte personnel ne donne pas acces aux API de paiement marchand.

Peut-on integrer les deux plateformes en meme temps sur la meme page de checkout ?

Oui, c est meme recommande. Proposez deux boutons distincts ("Payer avec Wave" et "Payer avec Orange Money") qui declenchent chacun leur propre session de paiement. La plupart des developpeurs senegalais utilisent une abstraction (une fonction createPaymentSession(provider, amount)) pour eviter la duplication de code.

Combien de temps prend l onboarding marchand ?

Wave : 3 a 7 jours. Orange Money Max It : 7 a 15 jours selon la completude du dossier. Anticipez ces delais dans votre planning de lancement.

Discutons de votre projet. Kolonell integre Wave et Orange Money dans votre site e-commerce cle en main. WhatsApp +221 77 596 93 33.