Integrer l'API Orange Money au Senegal : checkout web en 2026

Le verdict en trois phrases

L'API Web Payment d'Orange Money Senegal fonctionne avec un token OAuth de 90 minutes que vous rafraichissez cote serveur et une URL de paiement vers laquelle rediriger le client. Contrairement a Wave, le webhook peut manquer sur reseau instable : prevoyez un polling de statut en filet de securite. Ce guide compare le cycle d'authentification, le timeout et la gestion des paiements en attente entre Orange Money Senegal et M-Pesa Daraja au Kenya.

Cycle d'authentification et checkout

Le flux Orange Money Web Payment se deroule en trois temps : d'abord vous obtenez un token OAuth via POST /oauth/token (Basic Auth avec vos identifiants marchand), ensuite vous creez une transaction avec le montant en XOF et une reference 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 rafraichissez-le avant expiration plutot qu'a chaque requete.

Sur une commande de 30 000 FCFA, un frais indicatif de 1,5 % represente 450 FCFA a votre charge selon votre convention marchand 2026.

Timeout et paiements en attente

Le point sensible d'Orange Money : le client peut mettre plusieurs minutes a valider sur son telephone. Ne considerez jamais une transaction comme echouee trop tot. Interrogez le statut toutes les 30 secondes pendant 3 minutes avant de basculer en "a verifier". Comparons avec M-Pesa Daraja au Kenya, dont le STK Push impose une fenetre plus courte.

Au Kenya, Daraja envoie un STK Push qui declenche un prompt sur le telephone du client ; le callback doit etre valide sous ~60 secondes, sinon la transaction est consideree expiree. La logique de rattrapage est donc plus serree qu'avec Orange Money.

Mini cas pratique

Fatou tient une epicerie en ligne a 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 a 15 minutes, le taux de commandes non resolues tombe a 1 %, soit 2 a 3 par mois. Sur un panier moyen de 18 000 FCFA, elle securise 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 etre regenere a chaque paiement ? Non. Il vaut ~90 minutes : mettez-le en cache cote serveur et rafraichissez-le juste avant expiration. Regenerer a chaque requete ralentit le checkout inutilement.

Pourquoi le polling est-il indispensable avec Orange Money ? Parce que le webhook peut ne pas arriver sur reseau instable. Un polling toutes les 30 secondes confirme le statut cote API et evite de laisser une commande payee en "attente".

Quelle difference avec le STK Push de M-Pesa ? M-Pesa Daraja pousse un prompt directement sur le telephone avec une fenetre d'environ 60 secondes, plus courte que les 3 minutes typiques d'Orange Money. Le rattrapage doit donc etre plus rapide.

Que faire d'un paiement reste PENDING au-dela de 3 minutes ? Basculez-le en "a verifier" et laissez le cron de reconciliation interroger l'API toutes les 15 minutes. La plupart se resolvent seuls sous une heure.

Combien coute une integration Orange Money Web Payment ? Ordre de grandeur 2026 : 300 000 a 550 000 FCFA selon votre stack, hors frais marchand de ~1 a 1,5 % par transaction.

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