Le verdict en trois phrases
Un timeout USSD n'est pas un échec de paiement, c'est un statut inconnu : en 2026 à Niamey, entre 5 % et 12 % des paiements Orange Money USSD partent en timeout selon la charge réseau. La faute la plus grave est de conclure trop vite à l'échec et de re-débiter le client. La bonne mécanique combine fenêtre de confirmation, polling de statut espace et backoff exponentiel pour récupérer un ordre de grandeur de +9 % de transactions.
La fenêtre de confirmation et le polling de statut
Quand un client valide un paiement USSD, la confirmation n'arrive pas instantanément. Il faut laisser une fenêtre de 60 à 120 secondes, puis interroger le statut par polling, sans marteler l'API. Un polling trop agressif déclenche un rate-limit et aggrave la situation.
| Statut renvoyé | Action recommandée | Délai avant prochaine action |
|---|---|---|
| PENDING | Continuer le polling | 5 s, puis 10 s, puis 20 s |
| SUCCESS | Confirmer la commande | immédiat |
| FAILED | Proposer un nouveau paiement | immédiat |
| TIMEOUT (pas de réponse) | Polling prolonge puis marquer à vérifier | jusqu'à 120 s |
| RATE_LIMITED | Ralentir le polling (backoff) | doubler l'intervalle |
| UNKNOWN après 120 s | Revue manuelle / réconciliation | différé |
Le principe du backoff exponentiel : au lieu d'interroger toutes les 2 secondes, on espace 5 s, 10 s, 20 s, 40 s. On reste sous le seuil de rate-limit tout en couvrant la fenêtre de confirmation.
Taux de timeout et récupération après retry
Un retry bien conçu ne re-débité jamais : il vérifie d'abord le statut. Si le premier paiement a finalement abouti, on ne relance pas. Voici les ordres de grandeur 2026 observés.
| Métrique | Sans gestion | Avec gestion timeout/retry |
|---|---|---|
| Taux de timeout brut | 5 - 12 % | 5 - 12 % (inchangé) |
| Transactions perdues définitivement | 5 - 12 % | 1 - 3 % |
| Récupération via polling prolongé | 0 % | +6 à +9 % |
| Double-débit accidentel | possible | ~0 % |
| Satisfaction client (message clair) | faible | élevée |
Le message client fait la différence : "Paiement en cours de confirmation, ne fermez pas cette page" évite qu'il relance de son côté et crée un double-débit.
Mini cas pratique
Fatou tient un service de livraison à Niamey, 800 paiements Orange Money USSD/mois. À 10 % de timeout, elle perdait 80 transactions/mois, soit ~400 000 FCFA à 5 000 FCFA le panier. En ajoutant polling prolonge et backoff, elle récupère +8 %, soit 64 transactions sauvées = ~320 000 FCFA/mois regagnés. Coût de développement : ~200 000 FCFA une fois. Rentabilisé en moins d'un 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 USSD met-il si longtemps à se confirmer ?
Le flux USSD passe par plusieurs relais opérateur ; la confirmation peut prendre 60 à 120 secondes en charge. Il faut donc une fenêtre de polling, pas un verdict immédiat.
Le retry va-t-il débiter mon client deux fois ?
Non, s'il est bien conçu : le retry vérifie d'abord le statut de la première tentative. On ne relance un paiement que si le statut est clairement FAILED, jamais sur un simple timeout.
À quelle fréquence interroger le statut ?
En backoff exponentiel : 5 s, 10 s, 20 s, 40 s. Un polling toutes les 2 secondes déclenche un rate-limit et empire la situation.
Que faire d'un paiement UNKNOWN après 120 secondes ?
Le marquer pour réconciliation : un job de fin de journée compare vos commandes aux transactions opérateur et résout les cas restants (souvent < 1 %).
Combien de ventes peut-on vraiment récupérer ?
Un ordre de grandeur de +6 à +9 % de transactions qui seraient perdues sans gestion, sur un taux de timeout brut de 5 à 12 %.
Discutons de votre projet. Nous fiabilisons vos flux USSD Orange Money avec polling, backoff et réconciliation automatique. 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.
