Le verdict en trois phrases
Un marchand qui confirme ses paiements par polling (interrogation du statut toutes les 30 à 60 secondes) livré en retard et double-compte parfois ses ventes. Le webhook signé, idempotent et avec retry confirme en moins de 5 secondes et ramène le taux de confirmations manquées de 1-3 % à moins de 0,1 %. Trois briques sont non négociables en 2026 : vérification de signature HMAC, idempotence (un événement traité une seule fois) et file d'attente avec back-off exponentiel.
Polling contre webhook : la différence se voit sur la caisse
Le polling consiste à demander en boucle à l'opérateur si le paiement est passé. Le webhook, lui, reçoit une notification poussée dès que le statut change. Le premier est simple mais lent et coûteux en appels ; le second est rapide mais exige une sécurisation sérieuse.
| Critère | Polling statut | Webhook signé + retry |
|---|---|---|
| Délai de confirmation | 30 à 60 s | < 5 s |
| Taux de confirmations manquées | 1 à 3 % | < 0,1 % |
| Charge serveur | Élevée (appels répétés) | Faible (poussé) |
| Risque de double comptage | Moyen | Nul si idempotent |
| Sécurité | Côté appelant | Signature HMAC obligatoire |
| Coût d'intégration robuste | 150 000-400 000 FCFA | 300 000-800 000 FCFA |
Le surcoût du webhook robuste (300 000 à 800 000 FCFA) se justifie dès qu'on dépasse quelques dizaines de commandes par jour : une seule commande expédiée sans paiement peut coûter plus cher que la différence d'intégration.
Les trois briques d'un webhook fiable
Un webhook n'est fiable que s'il résiste aux rejeux, aux doublons et aux pannes réseau. Voici les mécanismes à implémenter et l'effet mesurable de chacun.
| Mécanisme | Rôle | Effet 2026 |
|---|---|---|
| Signature HMAC | Vérifier l'origine | Bloque les faux callbacks |
| Idempotence (clé event) | Traiter une fois | Zéro double comptage |
| File d'attente | Absorber les pics | Aucune perte en charge |
| Retry back-off exponentiel | Rejouer les échecs | Manqués < 0,1 % |
| Journalisation | Auditer/rejouer | Litiges tracés |
| Endpoint status query | Filet de sécurité | Réconcilie les rares manqués |
Le back-off exponentiel rejoue un webhook manqué après 1 s, 2 s, 4 s, 8 s... jusqu'à un plafond, ce qui laisse le temps à un serveur momentanément indisponible de se rétablir sans marteler l'infrastructure.
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
Ibrahima gère une boutique en ligne à Thiès qui traite 90 commandes par jour. Avec du polling, environ 2 % des confirmations arrivaient en retard ou manquaient, soit 1 à 2 commandes par jour expédiées sans certitude de paiement, pour un panier moyen de 18 000 FCFA.
Sur un mois, ce sont environ 45 commandes à risque, soit 810 000 FCFA de flux incertain. Après passage à un webhook signé avec retry (600 000 FCFA d'intégration), les manques tombent sous 0,1 %, soit moins d'une commande par mois. L'intégration est amortie en moins d'un mois rien qu'en pertes évitées.
FAQ
Pourquoi ne pas se contenter du polling ? Le polling confirme en 30 à 60 secondes et manque 1 à 3 % des paiements en cas de coupure. Le webhook confirme en moins de 5 secondes avec un taux de manque inférieur à 0,1 %.
Qu'est-ce que l'idempotence concrètement ? C'est traiter chaque événement une seule fois grâce à une clé unique : même si l'opérateur envoie deux fois le même callback, la vente n'est comptée qu'une fois, ce qui élimine le double comptage.
La signature HMAC est-elle obligatoire ? Oui. Sans vérification de signature, n'importe qui peut envoyer un faux callback de paiement et déclencher une expédition. La signature HMAC est la première ligne de défense.
Combien de temps prend le KYC marchand ? Chez la plupart des opérateurs mobile money, l'activation marchand prend 3 à 7 jours. Le sandbox de test est généralement gratuit et disponible immédiatement pour développer avant l'activation.
Que faire des rares webhooks quand même manqués ? On garde un endpoint de status query comme filet : un job périodique interroge le statut des commandes en attente et réconcilie les rares événements perdus, gardant le taux final sous 0,1 %.
Discutons de votre projet. On met en place vos webhooks mobile money signés, idempotents et avec retry pour ne plus jamais expédier une commande non payée. 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.
