Comment intégrer le mobile money à votre site ou application

1. API directe ou agrégateur : que choisir ?

Il existe deux façons d'accepter le mobile money :

• Les API des opérateurs : API Orange Money Web Payment, API MTN MoMo, Wave, M-Pesa Daraja. Frais plus bas et contrôle total, mais il faut s'inscrire et intégrer chaque opérateur séparément, souvent pays par pays.
• Les agrégateurs : CinetPay, PayDunya, PayTech, FedaPay, KkiaPay, Paystack ou Flutterwave. Une seule intégration donne accès à plusieurs opérateurs et aux cartes bancaires, souvent dans plusieurs pays, contre une commission par transaction.

Règle simple : si la plupart de vos clients utilisent un seul opérateur dans un seul pays, l'API directe est intéressante. Si vous vendez dans plusieurs pays de l'UEMOA ou avec plusieurs opérateurs, un agrégateur vous fait gagner des mois.

2. Ouvrir un compte marchand

L'argent arrive sur votre propre compte chez l'opérateur ou l'agrégateur : il faut donc d'abord un compte marchand. Prévoyez le registre de commerce (RCCM), l'IFU ou le NINEA selon le pays, les pièces d'identité des dirigeants et une description de votre activité. La validation peut prendre de quelques jours à quelques semaines : commencez tôt.

3. Comment se déroule un paiement mobile money

La plupart des API suivent le même schéma :

• Votre serveur s'authentifie auprès du fournisseur (souvent un jeton OAuth) avec des clés qui ne doivent jamais apparaître dans le code de votre site ou de votre application.
• Votre serveur envoie une demande de paiement avec le montant, le numéro du client et une référence. Le client valide sur son téléphone (code secret, USSD ou application Wave), ou il est redirigé vers une page de paiement.
• Le fournisseur appelle votre URL de notification (callback ou webhook) avec le résultat : réussi, échoué ou annulé.
• Votre système vérifie la notification, met à jour la commande et confirme au client. Si aucune notification n'arrive, vous interrogez le statut de la transaction.

4. Tester d'abord en environnement de test

Les fournisseurs sérieux proposent un environnement de test (sandbox). Testez les paiements réussis, refusés, expirés, les notifications en double et les remboursements avant de manipuler de l'argent réel. La plupart des problèmes en production viennent de cas jamais testés : le client qui ferme la fenêtre, la notification reçue deux fois, la connexion qui coupe au milieu.

5. Sécurité : la liste de contrôle

• Clés d'API et secrets uniquement sur le serveur.
• Vérifier chaque notification (signature, adresse IP ou interrogation du statut) avant de marquer une commande comme payée.
• Rendre le traitement idempotent : une notification répétée ne doit jamais créditer deux fois une commande.
• Journaliser chaque requête et réponse, et rapprocher chaque jour avec le relevé du fournisseur.

6. Rapprochement et comptabilité

Un paiement n'est vraiment terminé que lorsque l'argent sur votre compte correspond aux commandes dans votre système. Prévoyez dès le départ un rapport de rapprochement quotidien et un export pour votre comptable : c'est beaucoup plus difficile à ajouter après coup.

7. Combien ça coûte ?

Il y a deux types de coûts : les frais de transaction du fournisseur (un pourcentage ou un montant fixe par paiement, fixé par chaque opérateur ou agrégateur), et le développement, qui dépend du nombre d'opérateurs, du besoin de décaissements et de remboursements, et de l'intégration dans un logiciel existant ou nouveau.

FAQ

Service associé

Intégration paiement et mobile money