Le verdict en trois phrases
Un webhook rate transforme une commande payée en client mécontent : l'argent est parti, la commande n'est jamais validée. Les taux d'échec bruts observés vont de 1 à 5 % selon la qualité du réseau et de l'endpoint. Avec signature vérifiée, idempotence, retry exponentiel et polling de secours, on descend sous 0,1 % de perte.
Les cinq lignes de défense
Un webhook fiable n'est pas une seule fonction, c'est une chaîne. Chaque maillon rattrape le précédent.
| Défense | Rôle | Effet sur le taux de perte |
|---|---|---|
| Signature HMAC | Rejeter les faux appels | Sécurité, pas de fraude |
| Idempotency key | Traiter une fois même si reçu 2x | Zéro double validation |
| Retry exponentiel | Rejouer si l'endpoint tombe | -70 à -90 % d'échecs |
| Dead-letter queue | Isoler les cas bloqués | Aucune perte silencieuse |
| Polling getStatus | Rattraper les webhooks jamais reçus | 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 être patient sans matraquer. Ordres de grandeur recommandés.
| Tentative | Délai après la précédente | Cumul |
|---|---|---|
| 1 (immédiate) | 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 |
Après la dernière tentative, l'événement part en *dead-letter queue* pour traitement manuel ou reprise. Le coût d'une file managée tourne autour de 5 000 à 20 000 FCFA/mois selon le volume, négligeable face à 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 à Dakar avec environ 3 000 paiements/mois. Avant durcissement, son taux d'échec webhook était de 4 %, soit 120 commandes/mois payées mais bloquées, à un panier moyen de 6 500 FCFA : 780 000 FCFA de chiffre en litige et un support saturé. Après ajout de l'idempotence, du retry et d'un polling toutes les 15 minutes, le taux tombe à 0,08 %, soit 2 à 3 commandes/mois rattrapées à la main. Coût de la mise en place : 500 000 FCFA, amorti en moins d'un mois.
FAQ
Pourquoi mon webhook échoue-t-il parfois ? Réseau instable, endpoint momentanément indisponible, timeout, ou pic de charge. C'est pour cela qu'on observe 1 à 5 % d'échecs bruts sans mécanisme de reprise.
À quoi sert la clé d'idempotence ? À ne valider une commande qu'une seule fois même si le webhook est reçu deux ou trois fois. Sans elle, le client peut être débité ou servi en double.
Le retry suffit-il ? Non. Le retry rattrape les endpoints tombés, mais si l'opérateur n'a jamais envoyé le webhook, seul un polling getStatus de secours ferme le trou.
Qu'est-ce qu'une dead-letter queue ? Une file où atterrissent les événements que le système n'a pas pu traiter après tous les retries, pour reprise manuelle sans jamais perdre l'information.
Quel objectif de fiabilité viser ? Moins de 0,1 % de perte sur les confirmations de paiement. C'est atteignable avec les cinq defenses combinées.
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.
