Intégrer Orange Money et Moov Money à son site web : le guide pratique

Intégrer Orange Money et Moov Money à son site web : le guide pratique

Intégrer Orange Money et Moov Money à son site web est aujourd'hui une priorité pour tout business qui vend en ligne en Afrique de l'Ouest. Vos clients paient par mobile. Si votre site n'accepte pas ces modes de paiement, vous perdez des commandes. Cette réalité s'impose à toutes les structures, des petits e-commerces aux plateformes de services professionnels.

Pourquoi connecter Orange Money et Moov Money à votre site

En Côte d'Ivoire, au Burkina Faso, au Mali, au Sénégal ou au Togo, le portefeuille mobile est devenu le compte courant de millions de personnes. Orange Money et Moov Money (Flooz) couvrent une base d'utilisateurs considérable. Pour un décideur B2B, l'enjeu est direct : si votre client ne peut pas payer avec son téléphone, il cherche un concurrent qui accepte ce mode de règlement.

L'autre argument est la rapidité de confirmation. Un paiement mobile est confirmé en quelques secondes. Votre équipe reçoit la notification, votre système peut déclencher la livraison ou l'activation du service immédiatement, sans attendre la validation manuelle d'un virement bancaire qui prend deux à cinq jours ouvrés.

Comment fonctionne une API mobile money

Les deux opérateurs exposent des API REST qui permettent à votre application web d'initier une demande de paiement, de suivre son statut et de recevoir une confirmation par webhook. Le flux standard fonctionne ainsi :

1. Votre site envoie une requête à l'API de l'opérateur avec le montant, le numéro de téléphone du client et une référence de transaction.
2. Le client reçoit une notification USSD ou push sur son téléphone et confirme le paiement.
3. L'opérateur envoie un callback (webhook) à votre serveur pour confirmer la transaction.
4. Votre système marque la commande comme payée et déclenche le traitement suivant.

Ce flux, simple en apparence, demande une implémentation soignée côté serveur. La gestion des timeouts, des doublons et des callbacks manqués doit être anticipée dès la conception, pas corrigée après coup.

Orange Money Developer

Orange expose son API via le portail Orange Developer. Pour l'Afrique subsaharienne, l'API Orange Money for Merchants permet d'initier des paiements entrants (collect) et sortants (disbursement). L'accès nécessite une inscription en tant que marchand auprès d'Orange, avec fourniture des documents légaux de votre entreprise. La sandbox est accessible librement pour les tests initiaux.

Points techniques à retenir : l'authentification se fait par OAuth 2.0, les requêtes doivent inclure un token Bearer, et les notifications de callback arrivent en JSON. Orange recommande de répondre au webhook en moins de cinq secondes pour éviter les tentatives répétées de notification.

Moov Money Flooz et son API

Moov Africa propose une API similaire. Les marchands s'inscrivent sur le portail Moov Africa Business. Le processus est comparable : validation du compte marchand, accès aux clés API de test, puis passage en production après validation technique. La documentation est disponible en ligne avec des exemples en PHP, JavaScript et Python.

Agrégateurs ou intégration directe

Pour un site e-commerce standard, passer par un agrégateur de paiements comme CinetPay, Kkiapay ou PayDunya simplifie considérablement le travail. Ces plateformes connectent Orange Money, Moov Money, Wave et parfois Visa/Mastercard via une seule API. Le coût de cette commodité est une commission supplémentaire sur chaque transaction, généralement entre 1 % et 3 %.

L'intégration directe auprès des opérateurs est préférable si vous traitez un volume élevé de transactions, si vous avez besoin de fonctionnalités avancées comme les remboursements automatisés ou le reporting personnalisé, ou si la maîtrise des coûts est critique pour votre modèle économique. Le choix dépend aussi de votre capacité technique interne : un agrégateur absorbe la complexité des mises à jour d'API et des incidents opérateurs.

Les erreurs fréquentes à éviter

Trois problèmes reviennent dans les projets d'intégration mobile money :

• Ne pas gérer les callbacks en double. L'opérateur peut envoyer plusieurs fois la même notification. Sans idempotence côté serveur, vous risquez de valider deux fois la même commande.
• Exposer les clés API côté client. Les appels à l'API doivent toujours transiter par votre serveur, jamais depuis le navigateur du client.
• Ignorer les transactions en attente. Certains paiements restent en statut pending plusieurs heures. Votre système doit les interroger périodiquement et agir en conséquence.

Préparer le terrain avant de coder

Avant d'écrire la première ligne de code, trois démarches administratives sont nécessaires : enregistrer votre entreprise comme marchand auprès d'Orange et Moov avec les pièces demandées (registre de commerce, pièce d'identité du gérant), définir votre architecture de données pour stocker les références et statuts de transaction, puis préparer votre environnement de test avec des numéros sandbox pour valider chaque scénario.

Ces étapes prennent parfois plusieurs semaines pour la validation opérateur. Anticipez-les dans votre planning projet. Si vous avez un projet d'intégration de paiement mobile en cours ou à planifier, parlez-nous de votre projet. ICONEDOR a accompagné des entreprises burkinabè et ouest-africaines dans ces déploiements et peut vous faire gagner un temps précieux sur les étapes d'homologation et d'implémentation.