Le verdict en trois phrases
En 2026, 2 à 5 % des webhooks de paiement mobile money ne sont pas livrés du premier coup, ce qui produit des commandes payées mais non confirmées. La parade tient en deux mots : idempotence (ne jamais traiter deux fois le même événement) et file de retry exponentielle. Avec un polling de secours toutes les 15 minutes, le taux de commandes fantômes passe sous 0,1 %.
Anatomie d'un webhook perdu
| Cause | Fréquence 2026 | Parade |
|---|---|---|
| Serveur indisponible 2-3 s | 1-2 % | retry exponentiel |
| Timeout réseau | 0,5-1,5 % | retry + polling |
| Réponse non 200 | 0,5-1 % | rejouer l'événement |
| Doublon d'événement | 3-6 % | clé d'idempotence |
| Ordre inversé (payé avant créé) | 1-2 % | file tamponnée |
Un webhook n'est jamais garanti : il faut le traiter comme un signal au mieux effort. La vérité reste le statut côté opérateur, vérifié par polling en secours.
Stratégie de retry et d'idempotence
| Paramètre | Valeur recommandée 2026 |
|---|---|
| Séquence de retry | 1 s / 5 s / 30 s / 300 s |
| Nombre de tentatives | 4-6 |
| Fenêtre d'idempotence | 24 h |
| Polling de secours | toutes les 15 min |
| Délai avant alerte manuelle | 72 h |
| Coût d'une commande non réconciliée | 5 000-50 000 FCFA de SAV |
La clé d'idempotence est généralement l'identifiant de transaction de l'opérateur. Si le même identifiant arrive deux fois, le second est ignoré. Cette règle simple élimine la majeure partie des doublons et des crédits doublés.
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 à Dakar, 1 200 commandes/mois. Sans idempotence ni retry, il subissait 3 % de commandes fantômes, soit 36/mois, chacune générant en moyenne 20 000 FCFA de SAV (temps, remboursement, image) : 720 000 FCFA/mois de dégâts. Après mise en place de la file de retry (1/5/30/300 s) + polling 15 min, le taux tombe à 0,08 %, soit ~1 commande/mois. Économie : ~700 000 FCFA/mois et une équipe support qui respire.
FAQ
Pourquoi ne pas se fier uniquement au webhook ? Parce que 2 à 5 % n'arrivent jamais du premier coup. Le webhook accélère la confirmation, mais la source de vérité reste le statut interroge par polling côté opérateur.
Qu'est-ce qu'une clé d'idempotence concrètement ? C'est un identifiant unique (souvent l'ID transaction opérateur) que votre système mémorisé 24 h. Si le même événement revient, il est ignore, ce qui évite de créditer 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 arrêt dès qu'un statut final arrivé. C'est un filet de sécurité, pas le mécanisme principal.
Combien coûte une commande fantôme ? Entre 5 000 et 50 000 FCFA selon qu'il faut rembourser, renvoyer ou gérer un litige. Sur des dizaines de cas par mois, la note grimpe vite au-delà de 500 000 FCFA.
Discutons de votre projet. Nous fiabilisons vos webhooks Flutterwave, Wave et Orange Money avec idempotence et retry pour éliminer les commandes fantômes. 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.
