billing

POST /v1/webhooks/stripe

Ingest a signed Stripe webhook event.

All billing endpoints

Authentication

This endpoint is public. It takes no credential and no organisation — it is what our own marketing site and AI answer engines read.

This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.

Try it

Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.

curl -X POST https://api.zinndigital.com/v1/webhooks/stripe

Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console

Details

**Unauthenticated by design** — Stripe holds no Zinn® credential, so the `Stripe-Signature` HMAC over the raw request body *is* the authentication. This is the only path that turns a confirmed SetupIntent into a chargeable mandate, and the only path that captures an async or SCA payment; neither may be asserted by a browser. Replays are expected and converge. An event type Zinn® does not handle is acknowledged with 200 (a non-2xx would make Stripe retry it for days).

Response

NameTypeRequiredWhat it is
statusstring<handled, ignored, duplicate>Yes`handled` — acted on. `ignored` — a valid event of a type Zinn® does not consume. `duplicate` — already processed; Stripe may stop redelivering.

Errors this endpoint can return

400