billing

Stripe Webhook

Stripe webhook handler — processes subscription events.

This endpoint does NOT require Bearer auth. Instead, Stripe signs the payload with the webhook secret, which we verify.

Handled events:

  • checkout.session.completed — activate plan
  • customer.subscription.updated — update plan on change
  • customer.subscription.deleted — downgrade to free
  • invoice.paid — reset quota on billing cycle renewal
  • invoice.payment_failed — log warning

IMPORTANT: invoice.paid must be registered in the Stripe Dashboard webhook settings for monthly quota reset to work.

post/v1/billing/webhook

Response

Successful Response

{"stackTrail":"paths:/v1/billing/webhook:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 1 revision of this API.