Le verdict en trois phrases
Le timeout USSD touche jusqu'à 15 % des tentatives de paiement Orange Money en 2026, et c'est là que naissent les doubles débits. La seule protection fiable combine une idempotency key stable, une réconciliation par référence externe et une fenêtre de retry bornée. MTN MoMo suit la même logique avec une fenêtre plus courte (60-90 s contre 120 s), mais le même piège : ne jamais recréer une transaction sans vérifier son statut réel.
Pourquoi le timeout crée des doubles paiements
Quand le client tarde à saisir son code, votre serveur ne reçoit pas de réponse dans le délai attendu. La tentation est de relancer une transaction — sauf que la première peut avoir abouti côté opérateur. Sans garde-fou, le client est débité deux fois.
| Fenêtre / paramètre | Orange Money (SN) | MTN MoMo (UG) |
|---|---|---|
| Timeout global | 120 s | 60-90 s |
| Taux de timeout observé | jusqu'à 15 % | jusqu'à 12 % |
| Idempotency native | via référence marchand | via X-Reference-Id |
| Délai avant statut fiable | 8-20 s | 6-15 s |
| Réponse recommandée | polling getStatus | polling getStatus |
| Fenêtre de réconciliation | 24 h | 24 h |
La règle d'or : ne jamais retenter tant qu'un getStatus n'a pas confirmé EXPIRED ou FAILED.
Stratégies de retry contre risque de double débit
Toutes les stratégies ne se valent pas. Voici le comparatif chiffré pour arbitrer.
| Stratégie | Risque double débit | Complexité | Recommandation |
|---|---|---|---|
| Retry immédiat sans check | Élevé (~15 %) | Faible | À proscrire |
| Retry après getStatus | Très faible (< 1 %) | Moyenne | Recommandé |
| Idempotency key + getStatus | Quasi nul | Moyenne | Optimal |
| Nouvelle référence à chaque essai | Élevé | Faible | À proscrire |
| Réconciliation batch 24 h | Faible | Élevée | Complément indispensable |
En pratique 2026, coupler idempotency key + polling + réconciliation nocturne ramène le taux de double débit sous 0,3 %, contre 3 à 5 % avec un retry naïf.
Mini cas pratique
Ibrahim, restaurateur à Abidjan, encaisse 900 commandes par mois via mobile money. Avec un retry naïf, 4 % subissent un double débit, soit 36 clients mécontents et autant de remboursements manuels à 15 minutes chacun — 9 heures de SAV mensuelles. Après passage à idempotency key + getStatus, le taux tombe à 0,3 %, soit moins de 3 incidents par mois : il économise plus de 8 heures de travail et préserve sa réputation.
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
Combien de paiements tombent en timeout ?
En ordre de grandeur 2026, jusqu'à 15 % des tentatives USSD Orange Money expirent, souvent parce que le client tarde à saisir son code. MTN MoMo se situe autour de 12 %.
Qu'est-ce qu'une idempotency key ?
C'est un identifiant unique et stable attaché à une tentative de paiement. Il garantit que rejouer la même requête ne crée pas une seconde transaction, donc pas de double débit.
Faut-il retenter automatiquement un paiement expiré ?
Jamais avant d'avoir confirmé le statut réel via getStatus. Si l'opérateur renvoie SUCCESS, aucun retry n'est nécessaire ; sinon vous pouvez proposer une nouvelle tentative au client.
Quelle différence de timeout entre Orange Money et MTN MoMo ?
Orange Money accorde 120 secondes, MTN MoMo 60 à 90 secondes. La fenêtre plus courte de MoMo augmente légèrement le taux d'abandon mais réduit l'attente serveur.
Comment gérer les webhooks perdus ?
Combinez un endpoint webhook idempotent et une réconciliation batch sur 24 h qui interroge getStatus pour toute transaction restée en attente. C'est le filet de sécurité indispensable.
Discutons de votre projet. Nous mettons en place idempotency, retry contrôlé et réconciliation pour éliminer les doubles débits. 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.
