Le verdict en trois phrases
Une commande ne doit jamais etre marquee payee sur la redirection du client : seul un webhook verifie et idempotent est la verite. Le vrai choix est entre webhook + poll de reconciliation et confiance a la redirection, et les webhooks manques (2 a 5 %) causent des commandes doublement expediees ou perdues. Une cle d'idempotence, une verification de signature et un poll de secours ferment ces trous.
Pourquoi la redirection ment
La redirection navigateur peut echouer (reseau coupe, onglet ferme, retour arriere) alors que le paiement a bien eu lieu — ou l'inverse. Le webhook serveur-a-serveur, signe et rejoue, est la seule source fiable.
| Mecanisme | Redirection client | Webhook verifie |
|---|---|---|
| Fiabilite | Faible | Elevee |
| Manipulable par l'utilisateur | Oui | Non (signature) |
| Survit onglet ferme | Non | Oui |
| Double credit possible | Oui | Non (idempotence) |
| Risque de fraude | ~1 % | proche de 0 % |
Chiffres d'une integration robuste
Un webhook fiable combine retry, idempotence, verification de signature et un poll de secours pour rattraper les cas manques.
| Element | Valeur cible 2026 |
|---|---|
| Taux d'echec de livraison webhook | 2 a 5 % |
| Strategie de retry | backoff exponentiel |
| Poll de secours | toutes les 5 min |
| Gap rattrape par le poll | ~3 % |
| Cle d'idempotence | obligatoire (anti double-credit) |
| Verification signature IPN | obligatoire (anti spoofing) |
En M-Pesa, les URLs de confirmation et de validation C2B doivent verifier la transaction cote serveur avant de crediter la commande.
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
Aminata gere une boutique en ligne traitant 2 000 commandes par mois. A un taux d'echec de webhook de 3 %, environ 60 commandes/mois risquent de ne jamais etre confirmees automatiquement. Avec un poll de secours toutes les 5 minutes, elle rattrape ~3 % de ces cas et evite d'expedier a tort ou de rembourser a tort. Sur un panier moyen de 20 000 FCFA, securiser ne serait-ce que 20 commandes ambigues protege ~400 000 FCFA de flux par mois.
FAQ
Pourquoi ne pas se fier a la redirection ? Parce qu'elle peut echouer alors que le paiement a reussi, ou etre manipulee. Une boutique qui expedie sur une redirection non verifiee s'expose a environ 1 % de pertes de fraude. Seul le webhook verifie fait foi.
A quoi sert la cle d'idempotence ? Elle empeche de crediter deux fois la meme commande quand un webhook est rejoue (les prestataires renvoient les evenements en cas d'echec). Sans elle, un retry legitime peut declencher une double expedition.
Comment bloquer un faux webhook ? Par la verification de signature de l'IPN : chaque evenement est signe par le prestataire et rejete si la signature ne correspond pas. C'est la protection contre les IPN spoofees envoyees par un attaquant.
Le poll de reconciliation est-il vraiment necessaire ? Oui. Avec 2 a 5 % de webhooks manques, un poll de secours toutes les 5 minutes rattrape le ~3 % de commandes restees en attente, evitant les commandes perdues ou doublement traitees.
Discutons de votre projet. Nous construisons vos webhooks de paiement idempotents, signes et reconcilies, testes avant mise en production. 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.
