Le verdict en trois phrases
En 2026, 2 a 5 % des webhooks de paiement mobile money ne sont pas livres du premier coup, ce qui produit des commandes payees mais non confirmees. La parade tient en deux mots : idempotence (ne jamais traiter deux fois le meme evenement) et file de retry exponentielle. Avec un polling de secours toutes les 15 minutes, le taux de commandes fantomes passe sous 0,1 %.
Anatomie d'un webhook perdu
| Cause | Frequence 2026 | Parade |
|---|---|---|
| Serveur indisponible 2-3 s | 1-2 % | retry exponentiel |
| Timeout reseau | 0,5-1,5 % | retry + polling |
| Reponse non 200 | 0,5-1 % | rejouer l'evenement |
| Doublon d'evenement | 3-6 % | cle d'idempotence |
| Ordre inverse (paye avant cree) | 1-2 % | file tamponnee |
Un webhook n'est jamais garanti : il faut le traiter comme un signal au mieux effort. La verite reste le statut cote operateur, verifie par polling en secours.
Strategie de retry et d'idempotence
| Parametre | Valeur recommandee 2026 |
|---|---|
| Sequence de retry | 1 s / 5 s / 30 s / 300 s |
| Nombre de tentatives | 4-6 |
| Fenetre d'idempotence | 24 h |
| Polling de secours | toutes les 15 min |
| Delai avant alerte manuelle | 72 h |
| Cout d'une commande non reconciliee | 5 000-50 000 FCFA de SAV |
La cle d'idempotence est generalement l'identifiant de transaction de l'operateur. Si le meme identifiant arrive deux fois, le second est ignore. Cette regle simple elimine la majeure partie des doublons et des credits doubles.
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.
Mini cas pratique
Moussa exploite une boutique a Dakar, 1 200 commandes/mois. Sans idempotence ni retry, il subissait 3 % de commandes fantomes, soit 36/mois, chacune generant en moyenne 20 000 FCFA de SAV (temps, remboursement, image) : 720 000 FCFA/mois de degats. Apres mise en place de la file de retry (1/5/30/300 s) + polling 15 min, le taux tombe a 0,08 %, soit ~1 commande/mois. Economie : ~700 000 FCFA/mois et une equipe support qui respire.
FAQ
Pourquoi ne pas se fier uniquement au webhook ? Parce que 2 a 5 % n'arrivent jamais du premier coup. Le webhook accelere la confirmation, mais la source de verite reste le statut interroge par polling cote operateur.
Qu'est-ce qu'une cle d'idempotence concretement ? C'est un identifiant unique (souvent l'ID transaction operateur) que votre systeme memorise 24 h. Si le meme evenement revient, il est ignore, ce qui evite de crediter deux fois une commande.
Le polling ne surcharge-t-il pas l'API ? Non si on ne poll que les transactions en attente, toutes les 15 minutes, avec arret des qu'un statut final arrive. C'est un filet de securite, pas le mecanisme principal.
Combien coute une commande fantome ? Entre 5 000 et 50 000 FCFA selon qu'il faut rembourser, renvoyer ou gerer un litige. Sur des dizaines de cas par mois, la note grimpe vite au-dela de 500 000 FCFA.
Discutons de votre projet. Nous fiabilisons vos webhooks Flutterwave, Wave et Orange Money avec idempotence et retry pour eliminer les commandes fantomes. 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.
