Le verdict en trois phrases
Le pire échec de paiement est celui où le client est débité mais la commande n'apparaît pas : un timeout USSD a coupe la session avant la confirmation. Un retry naïf qui relance sans vérifier provoque un double débit dans 2 à 4 % des cas et détruit la confiance ; un retry idempotent qui interroge d'abord le statut récupère 50 à 65 % des paiements bloqués sans jamais débiter deux fois. À Yaoundé, cette différence de logique vaut des centaines de milliers de FCFA par mois et zéro litige.
Anatomie d'un timeout Orange Money / MTN MoMo
Quand un client valide un paiement, le push USSD lui laisse 90 à 120 secondes pour saisir son PIN. Si le réseau où le client dépasse ce délai, la session expire côté opérateur, mais le débit à parfois déjà eu lieu. Votre serveur, lui, n'a rien reçu : il croît le paiement échoue. Sans réconciliation, cette transaction reste en statut "pending" pour 5 à 15 % des tentatives.
| Étape | Délai typique 2026 | Risque |
|---|---|---|
| Envoi push USSD | 1-3 s | Faible |
| Attente saisie PIN | 90-120 s | Timeout si dépassé |
| Confirmation opérateur | 2-10 s | Perte si réseau coupé |
| Callback vers marchand | 2-30 s | Event manqué |
| Statut final "pending" | jusqu'à 24 h | Débit sans commande |
Le statut "pending" prolonge est le piège : le client a peut-être payé, peut-être pas. Seule une vérification de statut côté serveur tranche.
Retry naïf vs retry idempotent
La manière de relancer fait toute la différence entre récupérer de l'argent et en détourner. Comparaison 2026.
| Critère | Retry naïf | Retry idempotent (vérif statut) |
|---|---|---|
| Vérifie le statut avant relance | Non | Oui |
| Taux de double débit | 2-4 % | ~0 % |
| Paiements récupérés | 20-30 % | 50-65 % |
| Nombre de tentatives | Illimité / aléatoire | 3 avec backoff |
| Fenêtre de réconciliation | Aucune | 24 h |
| Litiges clients générés | Élèves | Quasi nuls |
| Confiance client | Érodée | Préservée |
Le retry idempotent gagne partout : il récupère deux fois plus de paiements tout en supprimant le double débit. La règle : toujours interroger le statut avant de relancer, jamais relancer à l'aveugle.
La bonne séquence de récupération
En 2026, la séquence robuste est : détecter le timeout, attendre quelques secondes, interroger l'API de statut avec la référence d'origine. Si "payé", valider la commande sans relancer. Si "échoue" définitif, proposer un nouvel essai au client. Si toujours "pending", replanifier une vérification (backoff : 30 s, 2 min, 10 min) jusqu'à 3 fois, puis basculer en réconciliation 24 h. Cette logique évite le double débit et rattrape la majorité des transactions fantômes.
Mini cas pratique
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.
Ibrahim, restaurateur à Yaoundé avec un service de commande en ligne, traite 600 paiements/mois, panier moyen 9 000 FCFA. Environ 10 % finissent en "pending" après timeout, soit 60 transactions (540 000 FCFA en suspens). Son ancien système relançait à l'aveugle : il récupérait 25 % (135 000 FCFA) mais double-debitait 3 % des clients, générant 18 litiges/mois et des remboursements. Avec un retry idempotent vérifiant le statut, il récupère 60 % (324 000 FCFA) et les doubles débits tombent à zéro. Gain net : +189 000 FCFA/mois récupérés et 18 litiges éliminés, ce qui protège aussi sa réputation.
FAQ
Comment un client peut-il être débité sans que la commande passe ?
Le débit se produit côté opérateur, mais le callback de confirmation vers votre serveur se perd (réseau, timeout). Votre système croit l'échec alors que l'argent est parti. Une vérification de statut sur 24 h détecte et répare ces cas.
Comment éviter le double débit lors d'un retry ?
En interrogeant toujours le statut de la transaction avant de relancer, avec la même référence. Si elle est déjà "payée", vous ne relancez pas. Cette seule règle fait passer le double débit de 2-4 % à quasi zéro.
Combien de retries avec quel délai ?
Trois tentatives avec backoff exponentiel (par exemple 30 s, 2 min, 10 min) suffisent pour la plupart des timeouts. Au-delà, la transaction bascule en file de réconciliation manuelle sur 24 h.
Qu'est-ce que la fenêtre de réconciliation de 24 h ?
C'est la période pendant laquelle un statut "pending" peut encore se résoudre côté opérateur. Vous rejouez la vérification durant ce laps de temps avant de conclure à un échec définitif ou de rembourser.
Le double débit est-il grave commercialement ?
Très : au-delà du remboursement, il détruit la confiance et génère du bouche-à-oreille négatif. Un client double-débité une fois hésite à repayer. C'est pourquoi le retry idempotent est prioritaire sur toute optimisation de conversion.
Discutons de votre projet. On installe une logique de retry idempotente qui récupère vos paiements Orange Money et MTN MoMo bloqués sans jamais double-débiter. 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.
