Le verdict en trois phrases
Au Sénégal, la majorité des paiements « échoués » ne sont pas des refus : ce sont des statuts *pending* que le code marque à tort comme perdus. Environ 60 % de ces pending se résolvent seuls en 30 à 180 secondes si l'on interroge le provider au lieu d'abandonner la transaction. Le bon réflexe n'est pas de rejouer aveuglément, mais d'appliquer un arbre de décision par code d'erreur.
L'arbre de décision par code d'erreur
Chaque code appelle une action précise. Confondre un timeout réseau avec un solde insuffisant fait perdre des ventes récupérables (ordre de grandeur 2026).
| Code d'erreur | Part des échecs | Cause réelle | Action correcte |
|---|---|---|---|
| Timeout USSD | 25-35 % | Client trop lent / réseau | Polling puis relance push |
| Insufficient funds | ~30 % | Solde réel insuffisant | Proposer autre moyen / plus tard |
| Invalid PIN | 10-15 % | Erreur de saisie | Nouvelle tentative immédiate |
| Network error | 3-8 % | Coupure opérateur | Retry auto après délai |
| Pending non résolu | reste | Statut en transit | Polling 10 s pendant 3 min |
La règle d'or : ne jamais marquer « échec » avant d'avoir polé. Un pending mal classé, c'est une vente perdue et un client qui a peut-être déjà été débité.
Les délais et seuils à câbler
Le débogage mobile money est une affaire de temporisation. Ces valeurs 2026 encadrent la stratégie de polling.
| Paramètre | Valeur repère 2026 | Rôle |
|---|---|---|
| Timeout USSD | 120 s | Fenêtre de saisie client |
| Pending qui se résout seul | ~60 % | À attendre, pas rejouer |
| Délai de résolution provider | 30-180 s | Fenêtre de polling |
| Fréquence de polling | Toutes les 10 s | Pendant 3 min |
| Taux d'échec réseau | 3-8 % | Retry automatique |
| Insufficient funds | ~30 % des échecs | Non récupérable direct |
À retenir : un polling toutes les 10 secondes pendant 3 minutes couvre 95 % des résolutions naturelles. Au-delà, le statut est réellement figé et l'on bascule sur la relance.
Mini cas pratique
Moussa exploite une plateforme de recharge à Dakar : 1 000 paiements/jour, dont 12 % remontent en « échec », soit 120 transactions. En auditant les logs, il découvre que 60 % de ces échecs étaient des pending non polés, soit 72 transactions par jour. À un ticket moyen de 5 000 FCFA, c'était 360 000 FCFA/jour faussement perdus. En câblant un polling 10 s / 3 min, il récupère l'essentiel : plus de 10 millions de FCFA de volume sauvé par mois.
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.
FAQ
Pourquoi un paiement reste-t-il « en attente » aussi longtemps ?
Parce que la confirmation transite entre l'opérateur, le provider et votre serveur. Ce trajet prend 30 à 180 secondes ; 60 % des pending se résolvent seuls dans cette fenêtre si vous polez au lieu d'abandonner.
Faut-il rejouer automatiquement un paiement échoué ?
Seulement pour les erreurs réseau (retry après délai). Pour un solde insuffisant, rejouer est inutile ; pour un PIN invalide, laissez le client ressaisir immédiatement.
Combien de temps poller avant de conclure à un échec ?
Interrogez le provider toutes les 10 secondes pendant 3 minutes. Cette fenêtre capte 95 % des résolutions naturelles ; au-delà, le statut est réellement figé.
Le client peut-il être débité alors que je vois un échec ?
Oui, c'est le danger d'un pending mal classé : le débit passe mais votre système croit à un échec. D'où l'obligation de réconcilier par polling avant tout remboursement ou relance.
Quelle est la première cause réelle d'échec en 2026 ?
Le solde insuffisant, environ 30 % des échecs. C'est le seul cas non récupérable immédiatement ; proposez un autre moyen ou une relance plus tard.
Discutons de votre projet. Nous auditons vos logs de paiement et câblons le polling qui transforme vos faux échecs en ventes. 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.
