Le verdict en trois phrases
Sur mobile money, 8 à 15 % des paiements échouent pour des raisons souvent récupérables : solde insuffisant, coupure réseau, timeout USSD. Une logique de retry structurée — timeout de 90 à 120 s, back-off exponentiel 2/4/8 s, maximum 3 tentatives, clé d'idempotence obligatoire — récupère 40 à 60 % des transactions perdues. Ajoutez une relance SMS après 10 minutes avec un lien de paiement pour capter les abandons différés.
Cause d'échec, action et taux de récupération
Toutes les causes ne se traitent pas de la même manière. Ordres de grandeur 2026.
| Cause d'échec | Action recommandée | Taux de récupération |
|---|---|---|
| Timeout USSD | Retry immédiat + back-off 2/4/8 s | 50 % à 65 % |
| Solde insuffisant | Relance SMS après 10 min | 25 % à 40 % |
| Coupure réseau | Retry auto max 3 fois | 55 % à 70 % |
| PIN erroné | Renvoyer prompt USSD | 60 % à 75 % |
| Doublon détecté | Idempotency key (pas de retry) | 100 % (0 double débit) |
| Abandon volontaire | Lien de relance (dunning) | 10 % à 20 % |
Paramètres techniques de la mécanique de retry
Ces réglages 2026 équilibrent taux de succès et risque de double débit.
| Paramètre | Valeur recommandée |
|---|---|
| Timeout par tentative | 90 à 120 s |
| Back-off exponentiel | 2 s, 4 s, 8 s |
| Nombre max de tentatives | 3 |
| Clé d'idempotence | Obligatoire (par référence transaction) |
| Vérification statut | Webhook + polling toutes les 5 s |
| Relance SMS | Après 10 min, lien de paiement |
| Taux de récupération global observé | ~45 % |
Mini cas pratique
Moussa gère une boutique en ligne à Thiès avec 1 000 paiements/mois. À 12 % d'échec, il perd 120 transactions, soit environ 1 800 000 FCFA à 15 000 FCFA le panier. En déployant retry + idempotency + relance SMS, il récupère 45 % de ces échecs, soit 54 transactions et ~810 000 FCFA/mois — sans un seul double débit grâce à la clé d'idempotence.
FAQ
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.
Pourquoi une clé d'idempotence est-elle obligatoire ?
Sans elle, un retry peut débiter deux fois le client. La clé, liée à la référence de transaction, garantit qu'une même opération n'est traitée qu'une fois, même en cas de tentatives multiples.
Webhook ou polling pour confirmer le paiement ?
Les deux. Le webhook confirme en moins de 5 secondes, mais un polling de secours toutes les 5 secondes rattrape les webhooks manqués.
Combien de tentatives de retry au maximum ?
Trois, avec back-off 2/4/8 s. Au-delà, on bascule sur une relance différée par SMS pour ne pas harceler le client ni multiplier les prompts USSD.
Quel timeout choisir pour l'USSD ?
Entre 90 et 120 secondes : assez long pour que le client saisisse son PIN, assez court pour ne pas bloquer la caisse indéfiniment.
La relance SMS est-elle vraiment utile ?
Oui, surtout pour les échecs de solde insuffisant : le client recharge puis paie via le lien. Elle récupère 25 à 40 % de ces cas.
Discutons de votre projet. Nous implémentons une logique de retry, idempotency et relance SMS pour récupérer vos paiements échoués. 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.
