Intégrer Wave et Orange Money sur votre site web au Sénégal : guide technique 2026

Le paiement mobile au Sénégal : un incontournable pour tout site e-commerce

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

Comprendre l'architecture d'intégration : 4 modes disponibles

Wave et Orange Money offrent chacun plusieurs modes d'intégration selon votre niveau technique et votre volume de transactions.

Mode lien de paiement (le plus simple) : Wave Business permet de générer 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. Limité : pas de réconciliation automatique, suivi manuel obligatoire.

Mode QR code : Wave génère un QR statique ou dynamique. Le QR dynamique encode le montant — l'acheteur scanne, valide, et Wave confirmé. Intégrable dans une page de checkout classique via une simple image SVG. Orange Money dispose du même mécanisme via son portail Max It.

Mode API REST avec redirection : c'est le mode recommandé 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 confirmé. Ce flux est identique au modèle Stripe Checkout.

Mode SDK mobile : pour les applications Flutter ou React Native, les deux opérateurs fournissent des SDK qui déclenchent directement l'application mobile installée sur le téléphone.

Mise en place du checkout Wave Business : les étapes clés

• Créer un compte Wave Business sur business.wave.com et soumettre les documents KYB (pièce d'identité du gérant, NINEA, extrait RCCM). Délai : 3 à 7 jours ouvrables.
• Récupérer votre clé API dans les paramètres du compte (section Développeurs).
• Appel API pour créer 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 retournée dans le champ wave_launch_url.
• Écouter le webhook sur votre endpoint /webhook/wave et valider la signature HMAC-SHA256.

Pour un article de 15 000 FCFA, Wave prélève environ 1 % de frais marchand (150 FCFA). Le virement vers votre portefeuille Wave Business est instantané.

Mise en place du checkout Orange Money via Max It

Orange Money au Sénégal s'intègre via le portail Max It (maxitpay.orange.sn). Le processus :

• S'inscrire en tant que marchand et fournir les documents d'entreprise (mêmes que Wave).
• Obtenir le merchant_key et le secret dans l'espace développeur.
• 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 redirigé 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 à 72 h.

Gestion des callbacks et réconciliation

Le point le plus critique est la gestion des callbacks. Plusieurs scénarios d'échec existent : l'utilisateur ferme son navigateur avant la redirection, le webhook n'arrive pas (timeout serveur), où le paiement est en statut "en attente".

Bonnes pratiques :

• Ne jamais confirmer une commande uniquement sur là return_url (l'utilisateur peut manipuler l'URL).
• Confirmer uniquement après réception et validation du webhook serveur-à-serveur.
• Stocker chaque événement de webhook dans une table payment_events avec le statut et l'horodatage.
• Implémenter un job de réconciliation toutes les 15 minutes qui interroge l'API Wave/OM pour les paiements dont le statut est encore "pending" après 10 minutes.

Tester sans risquer de l'argent réel

Wave propose un environnement sandbox (sandbox.wave.com/v1/...) avec des numéros de téléphone de test. Orange Money Max It dispose également d'un environnement de recette avec des credentials séparés. Testez systématiquement les cas : paiement réussi, paiement annulé, timeout, montant incorrect.

FAQ

Combien coûte l'intégration Wave + Orange Money sur un site e-commerce ?

Le développement d'un checkout double (Wave + Orange Money) avec gestion des webhooks et réconciliation compte entre 150 000 et 350 000 FCFA selon la complexité du site. L'accès aux API est gratuit ; seuls les frais de transaction s'appliquent (1 % Wave, 1,5 % Orange Money environ).

Faut-il une entreprise enregistrée pour accéder aux API marchandes ?

Oui. Wave Business et Orange Money Max It exigent un NINEA et un extrait RCCM en cours de validité. Un compte personnel ne donne pas accès aux API de paiement marchand.

Peut-on intégrer les deux plateformes en même temps sur la même page de checkout ?

Oui, c'est même recommandé. Proposez deux boutons distincts ("Payer avec Wave" et "Payer avec Orange Money") qui déclenchent chacun leur propre session de paiement. La plupart des développeurs sénégalais utilisent une abstraction (une fonction createPaymentSession(provider, amount)) pour éviter la duplication de code.

Combien de temps prend l'onboarding marchand ?

Wave : 3 à 7 jours. Orange Money Max It : 7 à 15 jours selon la complétude du dossier. Anticipez ces délais dans votre planning de lancement.

Discutons de votre projet. Kolonell intègre Wave et Orange Money dans votre site e-commerce clé en main. WhatsApp +221 77 596 93 33.