E-commerce11 min de lecture

API Orange Money Web: intégration paiement étape par étape à Cotonou (2026)

Mohamed Bah·Fondateur, Kolonell
18 août 2026
Partager :
API Orange Money Web: intégration paiement étape par étape à Cotonou (2026)

API Orange Money Web: intégration paiement étape par étape à Cotonou (2026)

E-commerce

Le verdict en trois phrases

Orange Money Web Payment fonctionne par redirection : votre serveur obtient un token d'accès, crée une transaction, redirige le client vers la page Orange, puis reçoit un callback à réconcilier. La commission tourne autour de 1,5 %, le settlement est T+1, et il faut prévoir un taux d'échec redirect d'environ 8 % (client qui abandonne ou revient sans payer). Toujours reconfirmer le statut côté serveur avant de valider la commande.

Les 4 étapes d'intégration Orange Money Web

ÉtapeAppel / actionRésultat attendu
1. AuthentificationPOST token OAuthaccess_token (durée limitée)
2. Création paiementPOST webpaymentpay_token + payment_url
3. Redirectionwindow.location vers payment_urlClient paie sur page Orange
4. Callback + statutnotif URL + GET statutSUCCESS / PENDING / FAILED

Le pay_token identifie la transaction ; stockez-le avec la commande. La return_url ramène le client, mais la source de vérité reste l'appel serveur de vérification de statut, pas l'URL de retour.

Orange Money (Bénin) vs Flutterwave (Ghana) : les chiffres 2026

CritèreOrange Money BéninFlutterwave Ghana
Commission locale~1,5 %~1,4 %
Transaction internationalen/a (local)~3,8 %
SettlementT+1T+2 (GHS)
ModèleRedirect + callbackRedirect hébergé (Standard)
Taux d'échec redirect~8 %~6 %
TVA sur fraisApplicableApplicable
DeviseXOF (FCFA)GHS (cedi)

Dans les deux cas, la TVA s'applique sur les frais de service : intégrez-la dans votre calcul de marge, pas seulement le taux brut.

Réconciliation : ne jamais se fier au retour navigateur

Un taux d'échec redirect de ~8 % signifie que près d'un client sur douze revient sans statut fiable. Votre logique doit :

  • Marquer la commande pending à la création du paiement.
  • Écouter la notif_url (callback serveur) pour la mise à jour.
  • Lancer un job de réconciliation qui interroge le statut des commandes pending de plus de 5 minutes.
  • Ne passer en paid qu'après un statut SUCCESS confirmé côté serveur.

Mini cas pratique

Ibrahim, gérant d'une boutique d'électronique à Cotonou, traite 240 paiements Orange Money par mois à 18 000 FCFA en moyenne, soit 4 320 000 FCFA. À 1,5 % de commission, il paie 64 800 FCFA de frais mensuels. Avec un taux d'échec redirect de 8 %, environ 19 transactions par mois nécessitent une réconciliation automatique ; sans job dédié, il risquerait de perdre la trace de 345 600 FCFA de commandes ambiguës chaque mois.

Besoin d'un site web professionnel ?

Kolonell crée des sites web qui attirent des clients, optimisés pour le marché sénégalais. Devis gratuit en 2 minutes.

FAQ

Le token Orange Money expire-t-il ?

Oui, l'access_token OAuth a une durée de vie limitée. Mettez-le en cache côté serveur et rafraîchissez-le avant expiration plutôt qu'à chaque requête.

Que faire quand le client revient sans avoir payé ?

Gardez la commande en pending et laissez le job de réconciliation trancher via l'appel de statut serveur. Le retour navigateur n'est pas une preuve de paiement.

Flutterwave est-il plus cher qu'Orange Money ?

En local, les taux sont proches (~1,4 % vs ~1,5 %). L'écart se creuse sur l'international (~3,8 %) et sur le settlement (T+2 GHS vs T+1).

La TVA s'applique-t-elle sur les frais ?

Oui, la TVA s'applique généralement sur les frais de service des deux prestataires. Comptez-la dans votre marge nette.

Combien de temps pour être payé ?

Orange Money règle en T+1 ; Flutterwave en GHS se rapproche plutôt de T+2. Planifiez votre trésorerie en conséquence.

Discutons de votre projet. Nous intégrons Orange Money Web avec callback et réconciliation automatique pour votre boutique à Cotonou. WhatsApp +221 77 596 93 33.

Tags :#orange money#flutterwave#checkout cotonou#integration api#paiement web#benin
Partager :

Mohamed Bah

Fondateur, Kolonell

Passionné par le digital et l'entrepreneuriat en Afrique, Mohamed accompagne les entreprises sénégalaises dans leur transformation digitale depuis 2020. Fondateur de Kolonell, il croit que chaque PME mérite une présence en ligne professionnelle et accessible.