Le verdict en trois phrases
Un timeout USSD n'est pas un echec de paiement, c'est un statut inconnu : en 2026 a Niamey, entre 5 % et 12 % des paiements Orange Money USSD partent en timeout selon la charge reseau. La faute la plus grave est de conclure trop vite a l'echec et de re-debiter le client. La bonne mecanique combine fenetre de confirmation, polling de statut espace et backoff exponentiel pour recuperer un ordre de grandeur de +9 % de transactions.
La fenetre de confirmation et le polling de statut
Quand un client valide un paiement USSD, la confirmation n'arrive pas instantanement. Il faut laisser une fenetre de 60 a 120 secondes, puis interroger le statut par polling, sans marteler l'API. Un polling trop agressif declenche un rate-limit et aggrave la situation.
| Statut renvoye | Action recommandee | Delai avant prochaine action |
|---|---|---|
| PENDING | Continuer le polling | 5 s, puis 10 s, puis 20 s |
| SUCCESS | Confirmer la commande | immediat |
| FAILED | Proposer un nouveau paiement | immediat |
| TIMEOUT (pas de reponse) | Polling prolonge puis marquer a verifier | jusqu'a 120 s |
| RATE_LIMITED | Ralentir le polling (backoff) | doubler l'intervalle |
| UNKNOWN apres 120 s | Revue manuelle / reconciliation | differe |
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 fenetre de confirmation.
Taux de timeout et recuperation apres retry
Un retry bien concu ne re-debite jamais : il verifie d'abord le statut. Si le premier paiement a finalement abouti, on ne relance pas. Voici les ordres de grandeur 2026 observes.
| Metrique | Sans gestion | Avec gestion timeout/retry |
|---|---|---|
| Taux de timeout brut | 5 - 12 % | 5 - 12 % (inchange) |
| Transactions perdues definitivement | 5 - 12 % | 1 - 3 % |
| Recuperation via polling prolonge | 0 % | +6 a +9 % |
| Double-debit accidentel | possible | ~0 % |
| Satisfaction client (message clair) | faible | elevee |
Le message client fait la difference : "Paiement en cours de confirmation, ne fermez pas cette page" evite qu'il relance de son cote et cree un double-debit.
Mini cas pratique
Fatou tient un service de livraison a Niamey, 800 paiements Orange Money USSD/mois. A 10 % de timeout, elle perdait 80 transactions/mois, soit ~400 000 FCFA a 5 000 FCFA le panier. En ajoutant polling prolonge et backoff, elle recupere +8 %, soit 64 transactions sauvees = ~320 000 FCFA/mois regagnes. Cout de developpement : ~200 000 FCFA une fois. Rentabilise 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 a se confirmer ?
Le flux USSD passe par plusieurs relais operateur ; la confirmation peut prendre 60 a 120 secondes en charge. Il faut donc une fenetre de polling, pas un verdict immediat.
Le retry va-t-il debiter mon client deux fois ?
Non, s'il est bien concu : le retry verifie d'abord le statut de la premiere tentative. On ne relance un paiement que si le statut est clairement FAILED, jamais sur un simple timeout.
A quelle frequence interroger le statut ?
En backoff exponentiel : 5 s, 10 s, 20 s, 40 s. Un polling toutes les 2 secondes declenche un rate-limit et empire la situation.
Que faire d'un paiement UNKNOWN apres 120 secondes ?
Le marquer pour reconciliation : un job de fin de journee compare vos commandes aux transactions operateur et resout les cas restants (souvent < 1 %).
Combien de ventes peut-on vraiment recuperer ?
Un ordre de grandeur de +6 a +9 % de transactions qui seraient perdues sans gestion, sur un taux de timeout brut de 5 a 12 %.
Discutons de votre projet. Nous fiabilisons vos flux USSD Orange Money avec polling, backoff et reconciliation 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.
