Handle incoming Stripe webhook events
billing
Handle incoming Stripe webhook events
Handle incoming Stripe webhook events.
This endpoint receives events from Stripe’s webhook system. It verifies the signature using the webhook secret, then routes to the appropriate handler. No API key auth required — Stripe signs with its own secret.
Handles:
- checkout.session.completed → upgrade plan (+ store the subscription id)
- invoice.payment_failed → start grace period
- customer.subscription.updated → sync plan from the subscription’s price
- customer.subscription.deleted → downgrade to free
- invoice.paid → confirm renewal, clear grace period
POST
Handle incoming Stripe webhook events
Authorizations
Enter your API key (e.g. dai_sk_test_key_001)
Response
Successful Response