Intégrer les paiements mobile money en Côte d'Ivoire : ce qu'il faut savoir

En Côte d’Ivoire, la majorité des paiements en ligne passent par le mobile money. Si vous lancez une billetterie, une boutique ou une plateforme d’abonnement, l’intégration du paiement est souvent ce qui fait la différence entre un produit utilisable et un prototype. Voici comment j’aborde le sujet, sur la base de mes projets de billetterie et d’e-commerce.

Le paysage des moyens de paiement

Les principaux canaux à couvrir localement :

Wave — très répandu, frais bas.
Orange Money, MTN MoMo, Moov Money — les opérateurs télécoms.
Carte bancaire — pour une clientèle internationale ou professionnelle.
PI-SPI — le Système de Paiement Instantané, une infrastructure régionale de paiement conçue et opérée par la BCEAO (Banque Centrale des États de l’Afrique de l’Ouest), qui vise l’interopérabilité des paiements dans l’UEMOA.

Intégration directe ou via agrégateur ?

Deux approches :

Agrégateur de paiement : une seule intégration donne accès à plusieurs moyens de paiement. Plus rapide à mettre en place, idéal pour démarrer.
Intégration directe avec chaque opérateur : plus de contrôle et de meilleurs frais à volume élevé, mais plus de travail et de maintenance.

Le bon choix dépend du volume attendu et du délai de lancement.

Le flux de paiement, étape par étape

Quel que soit le fournisseur, le schéma est presque toujours le même :

Initialisation : l’application crée une transaction côté serveur (montant, référence unique) et appelle l’API du fournisseur.
Autorisation côté client : l’utilisateur confirme via l’application de paiement, un code USSD ou une page hébergée.
Notification (webhook) : le fournisseur notifie votre serveur du résultat réel. C’est cette notification qui fait foi, jamais le retour affiché à l’écran.
Réconciliation : on met à jour la commande et on vérifie régulièrement les transactions en attente.

Les règles que je ne transgresse jamais

La confirmation vient du serveur, pas du navigateur. Un utilisateur peut fermer la page avant le retour ; seul le webhook est fiable.
Idempotence : un même webhook peut arriver deux fois. Chaque transaction a une référence unique, et on ne crédite jamais deux fois la même commande.
Vérifier la signature du webhook : on s’assure que la notification vient bien du fournisseur, pas d’un tiers qui tente de valider une commande gratuitement.
Tout tracer : chaque transaction est journalisée (montant, statut, horodatage) pour la réconciliation et le support.
Gérer les états intermédiaires : en attente, échoué, remboursé — et pas seulement « payé / pas payé ».

En résumé

Un paiement mobile money fiable, ce n’est pas « appeler une API ». C’est un flux serveur-first, idempotent, vérifié par signature et réconcilié. C’est précisément là que se joue la confiance de vos clients.

Un projet qui doit encaisser des paiements ? Discutons-en.