Comment intégrer MTN MoMo et Moov Money dans votre application web

En Afrique de l'Ouest, plus de 70 % des transactions en ligne passent par le paiement mobile. MTN Mobile Money et Moov Money (Flooz) sont les deux acteurs dominants au Togo — et si votre application ne les supporte pas, vous vous coupez d'une grande majorité de vos utilisateurs potentiels. Voici ce que nous avons appris en les intégrant dans plusieurs projets clients.

Comprendre l'architecture des API Mobile Money

Les deux opérateurs proposent des API REST sécurisées par OAuth 2.0. Le flux standard est le suivant : votre application initie une demande de paiement, l'opérateur envoie une notification USSD au téléphone du client, celui-ci confirme, et votre système reçoit un callback avec le statut final. La différence principale entre MTN MoMo et Moov Money réside dans le format des données et les délais de réponse.

Les étapes d'intégration dans un projet Node.js/Next.js

Créer un compte développeur sur la sandbox de chaque opérateur et récupérer vos clés API
Implémenter la couche d'authentification OAuth avec refresh token automatique
Créer un endpoint de callback sécurisé sur votre backend pour recevoir les notifications de paiement
Mettre en place un mécanisme d'idempotence pour éviter les doubles débits en cas de retry réseau
Gérer le polling de statut en parallèle du callback pour les cas où le webhook échoue

Les pièges à éviter absolument

Le principal problème que nous rencontrons sur les projets est la gestion des timeouts réseau. Sur des connexions 3G variables, la réponse d'un opérateur peut prendre 30 à 60 secondes. Votre interface doit afficher un état de chargement clair et votre backend doit traiter le paiement de manière asynchrone. Ne bloquez jamais la requête HTTP en attendant la confirmation — votre utilisateur aura déjà quitté la page.

Autre point critique : testez abondamment en mode sandbox avant le passage en production. Les comportements diffèrent selon les opérateurs, et les erreurs de paiement en production coûtent cher en termes de confiance client. Chez INOVERTIX, nous dédions systématiquement une semaine complète aux tests d'intégration Mobile Money sur chaque projet.

Vous avez un projet qui nécessite l'intégration Mobile Money ? Notre équipe a déjà réalisé ce travail sur plusieurs plateformes et peut vous faire gagner des semaines de développement.

Nous contacter