Webhook Stripe (entrant)
Traitement interne des webhooks Stripe pour activation checkout, changements d'offre et suppression d'abonnement.
Parsurai expose un recepteur Stripe interne pour les evenements de facturation. Ceci est distinct des webhooks sortants clients, qui notifient vos propres systemes des evenements d'extraction, de revue et de workflow.
Endpoint Stripe
POST /webhooks/stripe
Stripe doit envoyer le header Stripe-Signature. Les requetes sans signature ou avec signature
invalide renvoient 400.
Developpement local
stripe listen --forward-to localhost:8000/webhooks/stripe
Definissez le signing secret affiche dans l'environnement backend:
STRIPE_WEBHOOK_SECRET=whsec_your_local_signing_secret
Events traites
| Event | Comportement backend actuel |
|---|---|
checkout.session.completed | Revalide l'association des coordonnees professionnelles et l'offre facturee, exige des identifiants client et abonnement utilisables, rapproche l'event de l'abonnement Stripe non terminal actuel, puis cree ou reactive le compte payant et persiste stripe_subscription_id. Une nouvelle souscription annule egalement toute suppression de compte deja planifiee. |
customer.subscription.updated | Applique un changement d'offre Stripe uniquement si l'identifiant d'abonnement de l'event correspond encore a l'abonnement actuellement enregistre pour le compte. Les mises a jour retardees d'un ancien abonnement sont ignorees. |
customer.subscription.deleted | Coupe l'acces et planifie la suppression du compte sous 30 jours uniquement si l'event correspond a l'abonnement actuel du compte. L'ecriture de la suppression est elle aussi liee a cet abonnement, de sorte qu'un ancien event retarde ne peut pas programmer une suppression apres une nouvelle souscription. |
L'activation checkout ne cree pas de cle API. Si la verification de l'adresse e-mail reste necessaire, le flux d'activation emet ou reutilise un jeton de verification; la creation des cles API reste dans le flux de verification de l'e-mail et de gestion des cles.
Les autres events Stripe sont acquittes avec {"received": true} mais ne declenchent pas de mise
a jour de compte. Les events traites qui sont obsoletes ou ne correspondent plus a l'abonnement
actuel sont egalement acquittes sans modifier l'etat du compte.
Securite
Le webhook verifie la signature Stripe avec STRIPE_WEBHOOK_SECRET avant de parser l'event. Ne contournez pas cette verification en local ou en production.