Webhooks : le statut de paiement se décide côté serveur
Se fier à la page de remerciement pour activer un abonnement, c'est accorder l'accès à qui ne paie pas, ou le refuser à qui a payé. Cette leçon vous apprend à faire construire la fonction qui reçoit les webhooks Stripe et tient le statut d'abonnement à jour en base, puis à la tester sur les cas qui comptent, avec ou sans la Stripe CLI.
Mis à jour le 29 septembre 2026.
En bref
Un webhook Stripe est un message envoyé par Stripe à votre serveur quand un événement se produit, comme un paiement réussi ou un abonnement résilié. C'est lui, et non la page de remerciement, qui doit mettre à jour le statut d'abonnement. Le serveur vérifie sa signature et ignore les doublons pour que l'accès corresponde toujours au paiement réel.
Objectif de la leçon
À la fin de cette leçon, vous serez capable de faire construire une fonction serveur qui reçoit les webhooks Stripe, vérifie leur signature, ignore les doublons et tient à jour le statut d'abonnement en base, puis de la tester (paiement, doublon, résiliation par le portail client) avec le tableau de bord Stripe ou la Stripe CLI.
Les questions auxquelles cette leçon répond
À quoi servent les webhooks Stripe dans une app avec abonnement ?
À informer votre serveur des événements de paiement et d'abonnement, pour qu'il mette à jour l'accès de l'utilisateur à partir d'une source fiable plutôt que du navigateur.
Comment éviter qu'un webhook Stripe reçu deux fois fausse le statut ?
En enregistrant l'identifiant de chaque événement traité et en ignorant ceux déjà vus, pour que le même message reçu deux fois ne produise qu'un seul effet.
Comment tester ses webhooks avec la Stripe CLI ?
La Stripe CLI relaie les événements de votre compte de test vers votre fonction locale et permet d'en déclencher à la demande, pour tester sans attendre un vrai paiement.
Thèmes abordés
- webhooks Stripe
- statut d'abonnement
- Stripe CLI
- idempotence
- paiement côté serveur
Dans le glossaire
Guide sur ce thème
- MCP ou API : quelle différence
Quand exposer une API, un serveur MCP ou les deux, et ce que cela change pour votre produit.
Dans quel module
Encaisser un paiement Stripe, en mode test
Comment faire payer un abonnement, et savoir à coup sûr qui a payé ?
Leçons du module
- Ouvrir un paiement Stripe Checkout depuis le serveur
- Webhooks : le statut de paiement se décide côté serveur (cette leçon)
Ce que vous apprendrez dans la formation
Cette leçon fait partie de la formation Ajouter une base de données, l’authentification et le paiement à son app
Formations liées
- Tech pour PMJuniorQuelques bases utiles : notions de contexte ou du domaine.
Concevoir et tester une intégration API en tant que PM
3 h
- IA & ProduitExpertNiveau avancé : pour approfondir et aller plus loin.
Concevoir des agents et du tool calling fiables
3 h 30 min
- Product ManagementConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Installer une discovery continue avec l'IA
3 h 4 min