Stripe webhook handler (internal)

POST

/v1/billing/webhook

• Production

Internal endpoint - not for direct API use. Handles Stripe webhook events to sync subscription status. Authentication is via Stripe signature verification.

Request Body ^required

Stripe webhook event payload

object

Responses

200

Webhook processed successfully

object

received

boolean

Example

true

400

Invalid webhook signature or payload

object

error

object

code

Machine-readable error code

string

Example

INVALID_REQUEST

message

Human-readable error message

string

Example

endpoint must be a valid HTTPS URL

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

req_xyz123