Intégrer l'API Orange Money au Sénégal : checkout web en 2026

Le verdict en trois phrases

L'API Web Payment d'Orange Money Sénégal fonctionne avec un token OAuth de 90 minutes que vous rafraîchissez côté serveur et une URL de paiement vers laquelle rediriger le client. Contrairement à Wave, le webhook peut manquer sur réseau instable : prévoyez un polling de statut en filet de sécurité. Ce guide compare le cycle d'authentification, le timeout et la gestion des paiements en attente entre Orange Money Sénégal et M-Pesa Daraja au Kenya.

Cycle d'authentification et checkout

Le flux Orange Money Web Payment se déroule en trois temps : d'abord vous obtenez un token OAuth via POST /oauth/token (Basic Auth avec vos identifiants marchand), ensuite vous créez une transaction avec le montant en XOF et une référence de commande, enfin vous redirigez le client vers l'URL de paiement Orange Money. Le client saisit son code secret Orange Money et valide.

Le token expire au bout de 90 minutes : mettez-le en cache et rafraîchissez-le avant expiration plutôt qu'à chaque requête.

Sur une commande de 30 000 FCFA, un frais indicatif de 1,5 % représente 450 FCFA à votre charge selon votre convention marchand 2026.

Timeout et paiements en attente

Le point sensible d'Orange Money : le client peut mettre plusieurs minutes à valider sur son téléphone. Ne considérez jamais une transaction comme échouée trop tôt. Interrogez le statut toutes les 30 secondes pendant 3 minutes avant de basculer en "à vérifier". Comparons avec M-Pesa Daraja au Kenya, dont le STK Push impose une fenêtre plus courte.

Au Kenya, Daraja envoie un STK Push qui déclenche un prompt sur le téléphone du client ; le callback doit être valide sous ~60 secondes, sinon la transaction est considérée expirée. La logique de rattrapage est donc plus serrée qu'avec Orange Money.

Mini cas pratique

Fatou tient une épicerie en ligne à Dakar (Point E). Avec un checkout Orange Money sans polling, 6 % de ses 250 commandes mensuelles restaient en attente car le webhook n'arrivait pas toujours sur la 3G de ses clients, soit 15 commandes floues. En ajoutant un polling toutes les 30 secondes sur 3 minutes puis un cron de rattrapage à 15 minutes, le taux de commandes non résolues tombe à 1 %, soit 2 à 3 par mois. Sur un panier moyen de 18 000 FCFA, elle sécurise environ 12 x 18 000 = 216 000 FCFA par mois qui partaient en litige ou en abandon.

FAQ

Le token OAuth Orange Money doit-il être régénère à chaque paiement ? Non. Il vaut ~90 minutes : mettez-le en cache côté serveur et rafraîchissez-le juste avant expiration. Regénérer à chaque requête ralentit le checkout inutilement.

Pourquoi le polling est-il indispensable avec Orange Money ? Parce que le webhook peut ne pas arriver sur réseau instable. Un polling toutes les 30 secondes confirme le statut côté API et évite de laisser une commande payée en "attente".

Quelle différence avec le STK Push de M-Pesa ? M-Pesa Daraja pousse un prompt directement sur le téléphone avec une fenêtre d'environ 60 secondes, plus courte que les 3 minutes typiques d'Orange Money. Le rattrapage doit donc être plus rapide.

Que faire d'un paiement reste PENDING au-delà de 3 minutes ? Basculez-le en "à vérifier" et laissez le cron de réconciliation interroger l'API toutes les 15 minutes. La plupart se résolvent seuls sous une heure.

Combien coûte une intégration Orange Money Web Payment ? Ordre de grandeur 2026 : 300 000 à 550 000 FCFA selon votre stack, hors frais marchand de ~1 à 1,5 % par transaction.

Discutons de votre projet. Nous intégrons Orange Money, Wave et M-Pesa avec gestion du polling, des timeouts et des paiements en attente. WhatsApp +221 77 596 93 33.