FruxonDocs
IntegrationsWebhooks

Receive a Stripe billing webhook event.

Stripe POSTs platform-billing lifecycle events here (`checkout.session.completed`, `customer.subscription.*`, `invoice.paid`). The endpoint is anonymous — authentication is the HMAC `Stripe-Signature` header verified against the platform billing signing secret, so a bad or stale signature returns 401. On a valid signature the event provisions the tenant's license (resolving the tenant from event metadata) and returns 204. This is the platform billing webhook, distinct from the agent-facing per-tenant Stripe integration webhook.

POST
/v1/webhooks/stripe/billing

Response Body

curl -X POST "https://api.fruxon.com/v1/webhooks/stripe/billing"
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}