Disponible pour missions & renforts d’agence · Réponse rapide, par la personne qui intervient

Qu’est-ce qu’un webhook ?

Un webhook est une requête HTTP automatique, généralement de type POST, qu’un service tiers envoie vers une URL du site marchand lorsqu’un événement précis se produit, sans action de la part de l’utilisateur.

Décrire mon problème Discuter sur WhatsApp

Le cas d’usage le plus courant

Lors d’un paiement, le client quitte souvent le site pour finaliser la transaction sur la page de la passerelle de paiement. Une fois le paiement confirmé, la passerelle envoie un webhook vers une URL dédiée du site marchand pour signaler que la transaction a réussi. C’est ce webhook, et non la seule redirection du navigateur, qui valide la commande de façon fiable, même si le client ferme son navigateur avant de revenir sur le site.

Quand ça tourne mal

Si le webhook n’atteint pas le site, par exemple à cause d’une URL incorrecte, d’une indisponibilité temporaire ou d’un pare-feu bloquant, la notification n’arrive jamais. La commande reste bloquée au statut « en attente » dans le back-office, alors même que le paiement a bien été débité côté client.

Questions fréquentes

Pourquoi une commande reste-t-elle « en attente » alors que le client a payé ?
Le plus souvent parce que le webhook envoyé par la passerelle de paiement n’a pas atteint le site, par exemple à cause d’une URL mal configurée ou d’une indisponibilité temporaire du serveur.
Un webhook est-il la même chose qu’une API ?
Non. Une API est interrogée activement par un système qui demande une information ; un webhook est envoyé automatiquement par le service émetteur lorsqu’un événement survient, sans requête préalable.
Comment vérifier qu’un webhook fonctionne correctement ?
En consultant l’historique des notifications dans l’interface de la passerelle, et en vérifiant que l’URL configurée sur le site est accessible publiquement.

Décrivez votre besoin en 1 minute

Quelques questions ciblées pour que je vous réponde avec une estimation, pas avec un questionnaire de plus.

Pourquoi cette définition vous intéresse-t-elle ?
Quelle est votre plateforme, si vous en avez déjà une ? (facultatif)
Une question précise en tête ? (facultatif)

Posez-la telle quelle, la réponse vous reviendra directement.

Indiquez au moins un e-mail ou un téléphone pour que je puisse vous répondre.

Indiquez au moins un e-mail ou un téléphone pour que je puisse vous répondre.