Sur un site sénégalais, une part importante des tentatives de paiement mobile money n'aboutit pas du premier coup. Solde insuffisant, mauvais PIN, push jamais vu, réseau qui coupe : ces échecs sont normaux. Ce qui distingue un commerçant qui perd ses ventes d'un commerçant qui les récupère, c'est la façon de gérer l'après-échec.
Ce guide couvre les causes réelles des échecs, comment gérer techniquement les timeouts et les retries sans jamais double-débiter, et comment relancer le client et réconcilier vos transactions pour transformer un échec en vente.
Pourquoi un paiement mobile money échoué
Avant de corriger, il faut comprendre. Les échecs se classent en quelques familles.
Échecs côté client
Le plus fréquent : solde insuffisant. Au Sénégal, beaucoup de comptes Orange Money ou Wave ont un solde juste, et un panier de 25 000 FCFA dépasse ce qu'il reste. Viennent ensuite le mauvais code PIN, l annulation volontaire, et le push jamais validé parce que le client a quitté la page ou n'a pas vu la notification.
Échecs réseau
Le push USSD n'arrive pas, où la confirmation se perd entre l'opérateur et l'agrégateur. Le client a peut-être payé, mais votre serveur ne le sait pas encore. C'est le cas le plus dangereux car il crée une incertitude.
Échecs techniques
Clé d'API expirée, webhook mal configuré, timeout trop court côté serveur, ou une commande mal enregistrée qui empêche le rapprochement. Ceux-la sont de votre côté et entièrement évitables.
Les timeouts : combien de temps attendre
Un paiement mobile money est asynchrone. Le client reçoit un push et peut mettre une, deux, voire trois minutes à taper son PIN, surtout sur un vieux téléphone. Si votre serveur abandonné au bout de 30 secondes, vous déclarez un échec alors que le client est en train de payer.
Règle pratique
Laissez la fenêtre de validation ouverte plus longtemps que votre intuition ne le suggéré. Un délai de l'ordre de deux à trois minutes avant de marquer une transaction "expirée" est raisonnable pour le contexte sénégalais. Pendant ce temps, affichez au client un message d'attente clair : "Validez le paiement sur votre téléphone."
Ne fermez jamais sur un timeout sans vérifier
Avant de déclarer un échec définitif, interrogez l'agrégateur sur le statut réel de la transaction (endpoint de vérification de statut). Le client a peut-être payé après votre timeout. Cette vérification évite le scénario cauchemar : client débité, commande marquée échouée.
Retries et idempotence : ne jamais débiter deux fois
Quand un paiement échoue, le client va souvent réessayer. Et votre système aussi peut être tente de relancer automatiquement. Sans précaution, vous risquez de débiter deux fois.
La clé d'idempotence
À chaque tentative de paiement, générez un identifiant unique (clé d'idempotence) et envoyez-le à l'agrégateur. Si la même requête arrive deux fois avec la même clé, l'agrégateur traité une seule fois. C'est votre protection contre le double clic et les retries automatiques.
Webhooks idempotents
Les agrégateurs renvoient parfois le même webhook plusieurs fois pour fiabiliser la livraison. Votre back-end doit détecter qu'une transaction est déjà traitée et ignorer les doublons. Stockez le statut et vérifiez-le avant tout traitement.
Retry intelligent, pas aveugle
Ne relancez pas automatiquement un paiement refusé pour solde insuffisant : ça échouera encore. En revanche, un échec réseau (timeout) peut justifier une nouvelle tentative après vérification de statut. Distinguez les types d'échec avant de décider.
Relancer le client : récupérer le panier
Un échec n'est pas une vente perdue, c'est une vente en pause. Le panier abandonné sur échec de paiement est l'un des plus récupérables, car le client voulait acheter.
Le bon canal : WhatsApp
Au Sénégal, WhatsApp est le canal de relance le plus efficace. Un message simple, personnalisé, envoyé dans l'heure : "Bonjour, votre commande de [produit] n'a pas pu être validée. Voici un lien pour réessayer." Le taux de récupération est nettement supérieur à l'email.
Besoin d'un site web professionnel ?
Kolonell crée des sites web qui attirent des clients, optimisés pour le marché sénégalais. Devis gratuit en 2 minutes.
Le bon timing
Relancez vite. Plus vous attendez, plus l'intention s'évapore. Une première relance dans l'heure, une seconde le lendemain si pas de réponse. Au-delà, vous fatiguez le client.
Adaptez le message à la cause
Si l'échec était un solde insuffisant, proposez un paiement en plusieurs fois ou un montant ajusté. Si c'était un timeout, rassurez : "Aucun débit n'a eu lieu, vous pouvez réessayer en sécurité." Un message générique convertit moins qu'un message qui adresse la vraie raison.
Réconciliation : faire correspondre l'argent et les commandes
La reconciliation, c'est vérifier que chaque franc encaissé correspond à une commande, et que chaque commande payée à bien reçu son argent. C'est ennuyeux et c'est vital.
Le décalage classique
Les webhooks peuvent arriver en retard, en double, ou se perdre. Résultat : des commandes payées marquées "en attente", ou l'inverse. Sans réconciliation, vous expédiez des produits non payés où vous laissez des clients qui ont payé sans commande.
Comment réconcilier
Au minimum une fois par jour, récupérez la liste des transactions réussies côté agrégateur et comparez-la à vos commandes. Toute divergence est traitée manuellement : commande payée mais en attente, on débloqué ; commande marquée payée sans transaction, on enquête.
Mini cas client : une librairie en ligne à Thiès
Une librairie en ligne à Thiès perdait environ 30 % de ses commandes sur échec de paiement, sans relance. Après analyse, deux tiers de ces échecs étaient des soldes insuffisants ou des timeouts, donc des clients qui voulaient vraiment acheter.
Nous avons mis en place trois choses : une vérification de statut systématique après timeout (qui a sauve des paiements déjà effectués mais non confirmés), une relance WhatsApp automatique dans l'heure avec lien de reprise, et une réconciliation quotidienne. En six semaines, le taux de commandes récupérées sur échec initial est passé de presque zéro à 41 %. Aucune nouvelle acquisition, juste une meilleure gestion de l'échec.
Réduire les échecs à la source
Récupérer c'est bien, éviter c'est mieux.
- Affichez clairement le montant avant la validation pour éviter les surprises de solde.
- Proposez plusieurs opérateurs : un client sans solde Orange Money a peut-être du Wave.
- Donnez des instructions visibles : "Validez le push sur votre téléphone, ne fermez pas cette page."
- Testez tous les parcours en sandbox avant la prod.
FAQ
Quelle est la première cause d'échec de paiement mobile money au Sénégal ?
Le solde insuffisant, suivi du push jamais validé (client qui quitte la page) et des timeouts réseau. Ce sont majoritairement des échecs récupérables par une relance.
Combien de temps attendre avant de déclarer un paiement échoué ?
Laissez deux à trois minutes pour la validation, puis interrogez l'agrégateur sur le statut réel avant de conclure à un échec. Le client a peut-être payé après votre délai.
Comment éviter de débiter un client deux fois ?
Utilisez une clé d'idempotence par tentative et rendez vos webhooks idempotents en stockant et vérifiant le statut de chaque transaction avant traitement.
Faut-il relancer automatiquement un paiement refusé ?
Pas un refus pour solde insuffisant, il échouera encore. Une relance a du sens après un timeout réseau, et seulement après avoir vérifié le statut réel côté agrégateur.
À quelle fréquence réconcilier ses paiements ?
Au minimum une fois par jour. Comparez la liste des transactions réussies de l'agrégateur à vos commandes pour rattraper les webhooks perdus ou en double avant d'expédier.
Discutons de votre projet. Vous perdez des ventes sur des échecs de paiement évitables ? Parlons-en sur WhatsApp +221 77 596 93 33.
Mohamed Bah
Fondateur, Kolonell
Passionné par le digital et l'entrepreneuriat en Afrique, Mohamed accompagne les entreprises sénégalaises dans leur transformation digitale depuis 2020. Fondateur de Kolonell, il croit que chaque PME mérite une présence en ligne professionnelle et accessible.
