billing

Stripe Webhook

Apply a Stripe event.

The status code answers one question: would redelivering this help?

Stripe retries a non-2xx for three days and disables an endpoint that keeps failing, so a permanent condition must never answer 5xx — one malformed payload would otherwise take the webhook down for every customer. A signature failure (401), a malformed body (400), an event type MAIA does not act on (204), and any payload this system cannot process (204, logged) are all permanent for that delivery and are answered without retry.

5xx is reserved for the transient: no secret configured yet, or a Stripe API call that failed while re-fetching. Those are worth redelivering.

post/api/v1/billing/webhooks/stripe

Headers

Stripe-Signaturestring nullable

Response

Successful Response

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

Changes

Changed in 1 of the 30 revisions of this API.1