Orange Money API : tutoriel d'intégration sur votre site e-commerce

Pourquoi garder Orange Money en 2026

Même si Wave est en forte croissance, Orange Money reste dominant dans plusieurs segments au Sénégal : fonctionnaires, clients de plus de 40 ans, diaspora qui envoie de France et Espagne, clients en zone rurale où Orange a un meilleur réseau que Free et Tigo.

Ne pas proposer Orange Money sur votre site e-commerce, c'est exclure 40% de votre marché.

Ce que l'API Orange Money officielle couvre

• Web Payment : page hébergée Orange pour encaisser
• Cash-in / Cash-out : pour les agents ou plateformes B2B
• Transfert : payer vos apporteurs automatiquement
• Disponible au Sénégal, Côte d'Ivoire, Mali, Burkina, Cameroun, RDC

Setup : les étapes réelles

1. Accès au portail développeurs

Allez sur developer.orange.com, créez un compte, puis abonnez-vous au produit Orange Money Web Payment. Orange demande votre contrat PSE (Point de Service Électronique) — il faut passer par votre commercial Orange Business. Comptez 2 à 4 semaines de validation.

Oui c'est lent. Oui c'est plus long que Wave. Non vous ne pouvez pas contourner.

2. Obtenir les credentials

Une fois validé, vous récupérez :

• Client ID et Client Secret
• Merchant Key (spécifique à votre compte marchand)
• Accès à la sandbox (obligatoire avant production)

3. Implémenter le flow OAuth + paiement

Le flow est en 3 temps :

• Obtenir un token OAuth : POST https://api.orange.com/oauth/v3/token avec Basic Auth
• Initier le paiement : POST /orange-money-webpay/v1/webpayment avec le token
• Rediriger le client sur la payment_url renvoyée

Orange vous renvoie sur votre return_url avec un paramètre pay_token. Vous appelez alors transactionstatus pour vérifier que le paiement est vraiment SUCCESS avant de valider la commande.

4. Ne jamais faire confiance à la redirection

Règle d'or : le statut réel du paiement n'est PAS dans l'URL de retour. Il faut toujours re-vérifier côté serveur avec l'endpoint transactionstatus. J'ai vu des sites perdre des millions de FCFA parce qu'un malin a modifié le paramètre dans l'URL.

Les différences avec Wave

Ma recommandation : intégrez les deux. Wave pour la vitesse, Orange Money pour la couverture.

Les 5 erreurs fatales à éviter

• Ne pas séparer sandbox et prod : créez deux comptes, deux variables d'environnement
• Hardcoder le Merchant Key : toujours dans .env, jamais dans le code
• Oublier le timeout : la première requête OAuth peut prendre 8s en période de pic, mettez 15s minimum
• Valider uniquement via return_url : toujours re-checker via transactionstatus
• Ne pas logger les échecs : Orange change parfois ses réponses sans annonce, il faut un log complet

Architecture que nous utilisons chez Kolonell

• Service isolé /src/lib/payments/orange-money.ts avec cache du token OAuth
• Table Prisma Payment avec statuts : PENDING, SUCCESS, FAILED, EXPIRED
• Cron job toutes les 5 minutes pour re-vérifier les paiements PENDING de plus de 10 min
• Alerte Slack si plus de 3 échecs d'affilée

On branche Orange Money + Wave sur votre site

Chez Kolonell, on livre des intégrations e-commerce Wave + Orange Money + Stripe sur Next.js avec webhooks robustes et rapprochement comptable automatique. Plusieurs clients Dakar encaissent 1 million+ FCFA/jour sans friction.

Demandez un devis gratuit ou écrivez-moi sur WhatsApp +221 77 596 93 33. On sécurise vos paiements en 7 jours.