Receive a billing provider webhook

POST

//api/billing/webhooks/{provider}

Provider-signed ingress. The raw body is verified before any billing
mutation. Duplicate provider events are accepted without re-applying
effects. Browser checkout return URLs never hit this endpoint and
never activate a subscription.

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Duplicate event already stored

Bodyapplication/json

🟢202

🟠401UnauthorizedWebhook

🟠404NotFound

🟠422ValidationError

🟠429TooManyRequests

Request Example

Shell

JavaScript

Java

Swift

curl --location '//api/billing/webhooks/' \
--header 'Content-Type: application/json' \
--data '{
    "property1": "string",
    "property2": "string"
}'

Response Example

200 - Example 1

{
    "message": "string",
    "duplicate": true,
    "event_id": "string"
}

Modified at 2026-08-18 22:33:35

Update a plan

Meta webhook verification challenge