Le verdict en trois phrases
Un webhook rate transforme une commande payee en client mecontent : l'argent est parti, la commande n'est jamais validee. Les taux d'echec bruts observes vont de 1 a 5 % selon la qualite du reseau et de l'endpoint. Avec signature verifiee, idempotence, retry exponentiel et polling de secours, on descend sous 0,1 % de perte.
Les cinq lignes de defense
Un webhook fiable n'est pas une seule fonction, c'est une chaine. Chaque maillon rattrape le precedent.
| Defense | Role | Effet sur le taux de perte |
|---|---|---|
| Signature HMAC | Rejeter les faux appels | Securite, pas de fraude |
| Idempotency key | Traiter une fois meme si recu 2x | Zero double validation |
| Retry exponentiel | Rejouer si l'endpoint tombe | -70 a -90 % d'echecs |
| Dead-letter queue | Isoler les cas bloques | Aucune perte silencieuse |
| Polling getStatus | Rattraper les webhooks jamais recus | Sous 0,1 % |
Aucune de ces defenses n'est optionnelle en production.
Le calendrier de retry
Un endpoint peut tomber 30 secondes ou 10 minutes. Le retry doit etre patient sans matraquer. Ordres de grandeur recommandes.
| Tentative | Delai apres la precedente | Cumul |
|---|---|---|
| 1 (immediate) | 0 s | 0 s |
| 2 | 30 s | 30 s |
| 3 | 2 min | ~2,5 min |
| 4 | 10 min | ~12,5 min |
| 5 | 1 h | ~1 h 12 |
| 6 (finale) | 6 h | ~7 h |
Apres la derniere tentative, l'evenement part en *dead-letter queue* pour traitement manuel ou reprise. Le cout d'une file managee tourne autour de 5 000 a 20 000 FCFA/mois selon le volume, negligeable face a une seule commande perdue.
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
Fatou exploite une plateforme de livraison a Dakar avec environ 3 000 paiements/mois. Avant durcissement, son taux d'echec webhook etait de 4 %, soit 120 commandes/mois payees mais bloquees, a un panier moyen de 6 500 FCFA : 780 000 FCFA de chiffre en litige et un support sature. Apres ajout de l'idempotence, du retry et d'un polling toutes les 15 minutes, le taux tombe a 0,08 %, soit 2 a 3 commandes/mois rattrapees a la main. Cout de la mise en place : 500 000 FCFA, amorti en moins d'un mois.
FAQ
Pourquoi mon webhook echoue-t-il parfois ? Reseau instable, endpoint momentanement indisponible, timeout, ou pic de charge. C'est pour cela qu'on observe 1 a 5 % d'echecs bruts sans mecanisme de reprise.
A quoi sert la cle d'idempotence ? A ne valider une commande qu'une seule fois meme si le webhook est recu deux ou trois fois. Sans elle, le client peut etre debite ou servi en double.
Le retry suffit-il ? Non. Le retry rattrape les endpoints tombes, mais si l'operateur n'a jamais envoye le webhook, seul un polling getStatus de secours ferme le trou.
Qu'est-ce qu'une dead-letter queue ? Une file ou atterrissent les evenements que le systeme n'a pas pu traiter apres tous les retries, pour reprise manuelle sans jamais perdre l'information.
Quel objectif de fiabilite viser ? Moins de 0,1 % de perte sur les confirmations de paiement. C'est atteignable avec les cinq defenses combinees.
Discutons de votre projet. Nous durcissons vos webhooks mobile money avec signature, idempotence, retry et polling de secours pour viser moins de 0,1 % de perte. 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.
