Le verdict en trois phrases
Un webhook perdu, c'est un client qui a payé mais dont la commande reste « en attente » : de l'argent encaissé, un client mécontent, et 1 à 5 % de transactions invisibles en base. La solution n'est pas de faire plus confiance aux webhooks mais d'ajouter un job de réconciliation périodique qui compare l'API de l'opérateur à votre base de données. En 2026, tout site sérieux combine webhook + reconcile, jamais webhook seul.
Pourquoi les webhooks se perdent
Un webhook est une notification HTTP envoyée par l'opérateur à votre serveur. Il peut échouer pour mille raisons : serveur momentanément indisponible, timeout, déploiement en cours, erreur 500, ou simple perte réseau. Si vous ne traitez que le webhook, ces paiements disparaissent de votre système alors que l'argent, lui, est bien arrivé.
| Cause racine | Fréquence relative | Correctif |
|---|---|---|
| Serveur down / déploiement | Élevée | File d'attente + retry |
| Timeout de traitement | Moyenne | Réponse 200 immédiate, traitement async |
| Erreur applicative (500) | Moyenne | Idempotence + logs |
| Signature non vérifiée rejetée | Faible | Vérif signature correcte |
| Perte réseau | Faible | Job de reconcile périodique |
| Doublon mal géré | Moyenne | Clé d'idempotence |
Polling vs webhook + reconcile
Deux grandes stratégies existent. Le polling interroge l'API en boucle : simple mais coûteux et lent. Le webhook + reconcile combine la réactivité du webhook avec un filet de sécurité qui rattrape les trous. C'est la référence en 2026.
| Stratégie | Latence | Coût API | Fiabilité | Recommandé |
|---|---|---|---|---|
| Webhook seul | Faible | Faible | Moyenne (trous 1-5 %) | Non |
| Polling seul | Élevée (min) | Élevé | Bonne | Petit volume |
| Webhook + reconcile | Faible | Modéré | Excellente | Oui |
| Reconcile quotidien | J+1 | Faible | Bonne (filet) | En complément |
Rythme de réconciliation conseillé
| Volume de commandes/jour | Fréquence du job reconcile |
|---|---|
| < 100 | Toutes les heures |
| 100 à 1 000 | Toutes les 15 min |
| 1 000 à 10 000 | Toutes les 5 min |
| > 10 000 | Continu + reconcile horaire |
Mini cas pratique
Aminata gère une boutique en ligne à Dakar, 1 200 commandes/mois, panier moyen 18 000 FCFA. Un déploiement mal timé a fait perdre les webhooks pendant 3 heures : environ 3 % des paiements du mois, soit 36 commandes jamais traitées, pour 648 000 FCFA encaissés mais bloqués. Sans reconcile, elle aurait remboursé des clients furieux et perdu ce chiffre. Avec un job de réconciliation toutes les 15 minutes comparant l'API Wave à sa base, les 36 commandes ont été rattrapées automatiquement dans l'heure : 648 000 FCFA récupéré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.
FAQ
Les webhooks ne sont-ils pas fiables ?
Ils sont utiles mais jamais garantis à 100 %. Un taux de perte de 1 à 5 % est normal en conditions réelles ; c'est pourquoi il faut un job de reconcile en filet de sécurité.
Qu'est-ce que l'idempotence et pourquoi c'est vital ?
C'est le fait de pouvoir traiter le même événement plusieurs fois sans effet de bord (pas de double commande). Avec une clé d'idempotence, webhook et reconcile peuvent se chevaucher sans risque de doublon.
À quelle fréquence lancer le reconcile ?
Toutes les 15 minutes pour un volume de 100 à 1 000 commandes/jour ; toutes les 5 minutes au-delà. Un reconcile quotidien reste utile comme dernier filet.
Comment détecter les paiements manquants concrètement ?
Le job liste les transactions « réussies » côté opérateur (API) et cherche leur référence en base. Toute transaction présente chez l'opérateur mais absente en base est un paiement manquant à traiter.
Le polling seul suffit-il pour un petit site ?
Pour moins de 100 commandes/jour, un polling régulier peut suffire, mais il est plus lent et plus coûteux en appels API que la combinaison webhook + reconcile.
Discutons de votre projet. On audite vos webhooks et on met en place un job de réconciliation pour ne plus jamais perdre un paiement. 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.
