staqlydocs
REST APIAPI referenceBilling

Stripe webhook endpoint

Stripe webhook endpoint

Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.

POST
/v1/billing/webhook

Called by Stripe, not by clients. Verified with the Stripe-Signature header and STRIPE_WEBHOOK_SECRET; each event is applied once. Handles checkout.session.completed and customer.subscription.*.

Header Parameters

Stripe-Signature*string

Request Body

application/json
  1. body

Response Body

Received

application/json
  1. response
received*boolean
curl -X POST 'https://staqly.example.com/v1/billing/webhook' \  -H 'Stripe-Signature: string' \  -H 'Content-Type: application/json' \  -d '{}'
{  "received": true}