Le verdict en trois phrases
Un webhook non idempotent est une bombe a retardement : il double des commandes quand l'operateur renvoie l'evenement, ou en perd quand votre serveur est momentanement indisponible. La fiabilite ne depend pas de la chance mais de deux mecaniques : verifier la signature de chaque event et traiter chaque reference une seule fois, avec une file d'attente qui retente 5 fois sur 24 h. A Lome, ce sont ces details invisibles qui separent une boutique qui perd 1-3 % de commandes d'une boutique a 99,9 % de fiabilite.
Polling vs webhook signe : le vrai match
Beaucoup de boutiques interrogent l'API du provider en boucle ("polling") pour savoir si un paiement est passe. C'est simple mais lent et couteux. Le webhook signe avec file d'attente est plus robuste. Voici la comparaison 2026.
| Critere | Polling API | Webhook signe + file |
|---|---|---|
| Delai de confirmation | 30 s - 5 min | 2-30 s |
| Charge serveur | Elevee (appels repetes) | Faible (event unique) |
| Risque de rate-limit | Fort | Nul |
| Perte de commande | 2-5 % | < 0,3 % |
| Double commande | Frequent sans lock | Nul si idempotent |
| Cout infra / mois (est.) | 15 000-40 000 FCFA | 5 000-15 000 FCFA |
| SLA atteignable | ~99 % | 99,9 % |
Le webhook signe gagne sur presque tous les axes : plus rapide, moins cher, plus fiable. Le seul prerequis est de le construire correctement des le depart.
Les regles d'un webhook qui ne perd rien
Un webhook fiable en 2026 respecte quelques regles non negociables. D'abord, il verifie la signature HMAC de chaque requete : sans cela, n'importe qui peut simuler un "paiement confirme". Ensuite, il stocke chaque reference de transaction et refuse de la traiter deux fois (idempotence). Il repond immediatement 200 puis traite en asynchrone via une file d'attente, pour que l'operateur ne considere jamais l'event comme echoue. Enfin, il tolere les retries : l'operateur renvoie l'event plusieurs fois, votre code doit rester coherent.
| Regle | Pourquoi | Impact si absente |
|---|---|---|
| Verification signature HMAC | Securite | Faux paiements injectes |
| Idempotence par reference | Anti-doublon | Commandes dupliquees 1-3 % |
| Reponse 200 rapide (< 5 s) | Eviter retry inutile | Events rejoues en boucle |
| File d'attente asynchrone | Absorber les pics | Timeouts, events perdus |
| 5 retries sur 24 h | Rattraper les pannes | Commandes perdues au downtime |
| Journalisation complete | Audit / reconciliation | Litiges non tracables |
Mini cas pratique
Kofi, fondateur d'une epicerie en ligne a Lome, traite 700 commandes/mois, panier moyen 25 000 FCFA, soit 17 500 000 FCFA de CA. Avec son ancien systeme de polling, il perdait 2,5 % des commandes (event manque pendant un redemarrage serveur) : 17-18 commandes/mois, soit environ 437 500 FCFA perdus. Pire, 1,5 % etaient dupliquees, generant des litiges clients et des remboursements. Apres migration vers un webhook signe idempotent avec file et 5 retries, la perte tombe a 0,3 % (2 commandes, ~52 500 FCFA) et les doublons disparaissent. Gain net : environ 385 000 FCFA/mois plus la fin des litiges, pour une infra deux fois moins chere.
FAQ
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.
Qu'est-ce que l'idempotence, concretement ?
C'est garantir qu'un meme evenement traite plusieurs fois produit le meme resultat qu'une seule fois. En pratique : vous stockez la reference de transaction et, si elle revient, vous ignorez le doublon. Sans cela, 1 a 3 % des commandes se dupliquent.
Pourquoi verifier la signature du webhook ?
Parce qu'un endpoint public non protege peut recevoir de faux events "paiement confirme" et declencher des livraisons sans paiement reel. La verification HMAC garantit que l'event vient bien de l'operateur. C'est non negociable en 2026.
Combien de fois faut-il retenter un webhook echoue ?
La pratique recommandee est 5 tentatives reparties sur 24 h avec backoff exponentiel. Cela couvre les pannes courtes (redemarrage, deploiement) sans harceler un endpoint durablement mort. Au-dela, une alerte manuelle prend le relais.
Polling ou webhook si je debute ?
Commencez par le webhook signe : il est plus fiable et moins cher a l'usage. Gardez le polling comme filet de securite pour reconcilier les rares events perdus, pas comme mecanisme principal.
Combien coute un downtime de webhook ?
Enorme : pendant une panne du traitement paiement, c'est 100 % de vos ventes qui ne se confirment pas. C'est precisement pourquoi la file d'attente avec retries est indispensable : elle rattrape les commandes des que le service revient.
Discutons de votre projet. On audite votre webhook de paiement et on le rend idempotent, signe et resilient pour ne plus jamais perdre une commande. 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.
