# 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.

- Source canonique : [https://allaux.fr/glossaire/webhook](https://allaux.fr/glossaire/webhook)
- Langue : FR
- Dernière mise à jour : 2026-07-26

## 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.

## Une commande bloquée n’est pas toujours annulée

> Avant d’annuler une commande restée « en attente », il vaut mieux vérifier côté passerelle de paiement si le paiement a réellement été validé : le problème vient souvent d’un webhook qui n’a pas pu atteindre le site.

## FAQ

### 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.