Le verdict en trois phrases
Un marchand qui confirme ses paiements par polling (interrogation du statut toutes les 30 a 60 secondes) livre en retard et double-compte parfois ses ventes. Le webhook signe, idempotent et avec retry confirme en moins de 5 secondes et ramene le taux de confirmations manquees de 1-3 % a moins de 0,1 %. Trois briques sont non negociables en 2026 : verification de signature HMAC, idempotence (un evenement traite une seule fois) et file d'attente avec back-off exponentiel.
Polling contre webhook : la difference se voit sur la caisse
Le polling consiste a demander en boucle a l'operateur si le paiement est passe. Le webhook, lui, recoit une notification poussee des que le statut change. Le premier est simple mais lent et couteux en appels ; le second est rapide mais exige une securisation serieuse.
| Critere | Polling statut | Webhook signe + retry |
|---|---|---|
| Delai de confirmation | 30 a 60 s | < 5 s |
| Taux de confirmations manquees | 1 a 3 % | < 0,1 % |
| Charge serveur | Elevee (appels repetes) | Faible (pousse) |
| Risque de double comptage | Moyen | Nul si idempotent |
| Securite | Cote appelant | Signature HMAC obligatoire |
| Cout d'integration robuste | 150 000-400 000 FCFA | 300 000-800 000 FCFA |
Le surcout du webhook robuste (300 000 a 800 000 FCFA) se justifie des qu'on depasse quelques dizaines de commandes par jour : une seule commande expediee sans paiement peut couter plus cher que la difference d'integration.
Les trois briques d'un webhook fiable
Un webhook n'est fiable que s'il resiste aux rejeux, aux doublons et aux pannes reseau. Voici les mecanismes a implementer et l'effet mesurable de chacun.
| Mecanisme | Role | Effet 2026 |
|---|---|---|
| Signature HMAC | Verifier l'origine | Bloque les faux callbacks |
| Idempotence (cle event) | Traiter une fois | Zero double comptage |
| File d'attente | Absorber les pics | Aucune perte en charge |
| Retry back-off exponentiel | Rejouer les echecs | Manques < 0,1 % |
| Journalisation | Auditer/rejouer | Litiges traces |
| Endpoint status query | Filet de securite | Reconcilie les rares manques |
Le back-off exponentiel rejoue un webhook manque apres 1 s, 2 s, 4 s, 8 s... jusqu'a un plafond, ce qui laisse le temps a un serveur momentanement indisponible de se retablir 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 gere une boutique en ligne a Thies qui traite 90 commandes par jour. Avec du polling, environ 2 % des confirmations arrivaient en retard ou manquaient, soit 1 a 2 commandes par jour expediees sans certitude de paiement, pour un panier moyen de 18 000 FCFA.
Sur un mois, ce sont environ 45 commandes a risque, soit 810 000 FCFA de flux incertain. Apres passage a un webhook signe avec retry (600 000 FCFA d'integration), les manques tombent sous 0,1 %, soit moins d'une commande par mois. L'integration est amortie en moins d'un mois rien qu'en pertes evitees.
FAQ
Pourquoi ne pas se contenter du polling ? Le polling confirme en 30 a 60 secondes et manque 1 a 3 % des paiements en cas de coupure. Le webhook confirme en moins de 5 secondes avec un taux de manque inferieur a 0,1 %.
Qu'est-ce que l'idempotence concretement ? C'est traiter chaque evenement une seule fois grace a une cle unique : meme si l'operateur envoie deux fois le meme callback, la vente n'est comptee qu'une fois, ce qui elimine le double comptage.
La signature HMAC est-elle obligatoire ? Oui. Sans verification de signature, n'importe qui peut envoyer un faux callback de paiement et declencher une expedition. La signature HMAC est la premiere ligne de defense.
Combien de temps prend le KYC marchand ? Chez la plupart des operateurs mobile money, l'activation marchand prend 3 a 7 jours. Le sandbox de test est generalement gratuit et disponible immediatement pour developper avant l'activation.
Que faire des rares webhooks quand meme manques ? On garde un endpoint de status query comme filet : un job periodique interroge le statut des commandes en attente et reconcilie les rares evenements perdus, gardant le taux final sous 0,1 %.
Discutons de votre projet. On met en place vos webhooks mobile money signes, idempotents et avec retry pour ne plus jamais expedier une commande non payee. 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.
