Brancher un paiement Mobile Money prend quelques jours. Le faire tenir en production prend beaucoup plus longtemps, parce que l’essentiel du travail porte sur ce qui se passe quand le paiement ne se déroule pas normalement.
Le paiement n’est pas instantané
Contrairement à une carte bancaire, une transaction Mobile Money passe par un appareil que l’utilisateur doit manipuler. Entre le moment où votre boutique demande le paiement et celui où l’opérateur confirme, il peut s’écouler quelques secondes — ou plusieurs minutes si le client cherche son téléphone. Une boutique qui considère l’absence de réponse immédiate comme un échec annule des commandes qui allaient aboutir.
L’échec partiel est la règle
Le client est débité mais la notification n’arrive jamais ; la notification arrive deux fois ; le client relance et paie deux fois. Ces trois cas se produiront. Ils se traitent par une clé d’idempotence sur chaque tentative, un état de commande explicite et une réconciliation quotidienne avec les relevés de l’opérateur.
Une intégration de paiement se juge sur ce qu’elle fait quand elle échoue, pas quand elle réussit.
Réconcilier, tous les jours
La réconciliation n’est pas un luxe comptable, c’est le seul moyen de savoir ce qui s’est réellement passé. Nous rapprochons chaque nuit les transactions de l’opérateur et les commandes de la boutique, puis nous signalons les écarts. Sans cela, les erreurs se découvrent en fin de mois, quand personne ne se souvient du contexte.
Ce qu’il faut dire au client
Affichez l’état du paiement en clair, avec un message qui explique quoi faire. « Paiement en attente de confirmation, ne relancez pas » évite la moitié des doubles paiements à lui seul.
À prévoir dès le devis
Comptez le temps de traitement des cas limites dans l’estimation initiale, pas en correctif après la mise en ligne. C’est la partie du travail qui décide si votre boutique est fiable.