Handle Stripe webhook events

POST

/api/v1/webhooks/stripe

• Production
• Local development

Validates the Stripe-Signature header, parses the event, checks Redis idempotency, and routes it to the billing webhook handler. Always returns 200 to Stripe on success so Stripe does not retry.

Authorizations

• ApiKeyAuth

Responses

200

Successful Response

Generic webhook acknowledgement response.

Attributes: received: Always True when the webhook was accepted. status: Optional status string (e.g. “duplicate” for idempotent replay).

object

received

boolean

default: true

status

Any of:

string

string

null

null