Le verdict en trois phrases
Un webhook non testé est une bombe à retardement : il marche en démo, puis en production il rate un event et le client paie sans que la commande se confirme. La cible 2026 est claire : moins de 0,1 % d'events perdus et une alerte en moins de 5 minutes sur tout event non traité. Cela s'atteint avec un plan de test qui couvre rejeu, échec, signature et monitoring, du sandbox jusqu'à la prod.
Les 12 cas de test avant la mise en prod
Un webhook de paiement doit survivre à l'imprévu : un event reçu deux fois, dans le désordre, avec une signature invalide, ou pendant que votre serveur redémarre. Chaque cas à un résultat attendu précis.
| # | Scénario de test | Résultat attendu |
|---|---|---|
| 1 | Event SUCCESS standard | Commande confirmée |
| 2 | Même event reçu 2 fois (doublon) | Traité une seule fois (idempotence) |
| 3 | Signature invalide | Rejeté, 401, alerte |
| 4 | Event FAILED | Commande marquée échouée |
| 5 | Event reçu dans le désordre | État final cohérent |
| 6 | Serveur down pendant l'envoi | Rejeu automatique réussi |
| 7 | Payload malforme | Rejeté proprement, log |
| 8 | Event pour commande inconnue | Mis en attente / réconciliation |
| 9 | Latence > 10 s côté serveur | Pas de perte, retry opérateur |
| 10 | Remboursement (REFUND) | Statut mis à jour |
| 11 | Volume : 100 events en rafale | Aucun perdu |
| 12 | Bascule sandbox vers prod | Clés et URL correctes |
SLA d'alerte et taux d'events perdus toléré
En production, ce qui compte c'est de savoir vite quand un event n'a pas été traité. Un monitoring passif ne suffit pas ; il faut une alerte active et un tableau de réconciliation.
| Indicateur | Cible 2026 | Conséquence si dépassé |
|---|---|---|
| Events perdus | < 0,1 % | Commandes payées non confirmées |
| Délai d'alerte event non traité | < 5 min | Client sans confirmation, litige |
| Taux de doublons mal gérés | 0 % | Double confirmation / double stock |
| Signatures rejetées légitimes | 0 % | Blocage de vrais paiements |
| Délai de réconciliation | < 24 h | Écart caisse / commandes |
Un job de réconciliation quotidien compare vos commandes aux transactions de l'agrégateur : tout écart devient une tâche à traiter, pas une perte silencieuse.
Mini cas pratique
Moussa lance une boutique à Dakar, 600 commandes/mois. Sans idempotence, 1,5 % des events arrivaient en double et confirmaient deux fois la commande : 9 commandes/mois en litige stock, ~45 000 FCFA de manque à gagner et du temps SAV. Après le plan de 12 tests et l'ajout de l'idempotence, le taux tombe à 0 % de doublons et < 0,1 % d'events perdus. Coût : ~150 000 FCFA de dev une fois, contre une source de litiges récurrents supprimée.
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.
Pourquoi un webhook qui marche en sandbox échoue en prod ?
Parce que la prod ajoute du volume, de la latence réseau et des events réels en double ou dans le désordre. Les cas limites qui n'apparaissent jamais en démo deviennent quotidiens en production.
Qu'est-ce que l'idempotence et pourquoi est-elle critique ?
C'est traiter un même event une seule fois, même reçu plusieurs fois. Sans elle, un doublon confirmé deux fois la commande ; la cible est 0 % de doublons mal gérés.
Comment savoir qu'un event a été perdu ?
Avec un job de réconciliation quotidien qui compare commandes et transactions agrégateur, plus une alerte en moins de 5 minutes sur tout event non traité.
Faut-il vérifier la signature de chaque webhook ?
Oui, systématiquement : une signature invalide doit renvoyer 401 et déclencher une alerte. C'est la première défense contre les faux events injectés.
Quel taux d'events perdus est acceptable ?
Moins de 0,1 %, et chaque event manquant doit être rattrapé par la réconciliation sous 24 h. Zéro perte silencieuse est l'objectif.
Discutons de votre projet. Nous bâtissons vos webhooks avec idempotence, vérification de signature, rejeu et monitoring alerte < 5 min. 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.
