refund.created

Money on an order went back to the customer — to the card, in cash or as club credit — or the club lost a card dispute (method: chargeback). Once per refund: refunding an order in three steps sends three signals. data.object is the refund, with order embedded AS IT IS NOW, so order.amount_refunded never goes down from one refund signal to the next. A refund recorded more than a day before OpenCourt could announce it is not announced late; GET /v1/orders/{id} still lists it. Returning an order paid in full with points moves no money and sends nothing.

Scope: the webhook endpoint’s scopes must include orders:read. Missed a delivery? The same signal is available from GET /v1/signals.

Header Parameters

svix-id*string

The message id — stable across retries of the same message. Deduplicate on the body’s id (the signal id), not on this: an endpoint whose api_version changes while a signal is being retried can receive that signal once per version, as two messages with two message ids.

svix-timestamp*string

When this attempt was sent, in Unix seconds.

svix-signature*string

Signature over the id, timestamp and raw body, made with your endpoint’s secret. Verify it with any Standard Webhooks library before trusting the payload.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

id*string

Opaque sig_-prefixed id. Identifies WHAT HAPPENED, and never changes.

object*string

Value in"signal"

type*string

Value in"refund.created"

created*string

When the signal was emitted (ISO-8601, UTC) — not when it was delivered.

Formatdate-time

sequence*integer

Per-club counter. A staleness key, not an ordering guarantee. Use it to compare two signals about the SAME resource: the lower one is older and may be discarded. Gaps are normal and carry no meaning — a webhook endpoint receives only the types it subscribes to, and GET /v1/signals returns only the signals your key’s scopes cover — so never infer loss from a gap, wait for a missing number, or compare sequence across clubs.

api_version*string

The API version this payload is shaped by, e.g. 2026-11-01. A signal is delivered and returned at your version (your webhook endpoint's or your request's), rendered down from the version it was created at. A signal created BEFORE the version you read at is returned as it was created, so this field can be older than your version — never newer. See /developers/versioning.

data*

data.object is the matching /v1 resource — the same fields carrying the same values that endpoint returns. Compare it as parsed JSON: key order is not part of the contract.

Response Body

Example Requests

POST/refund.created

Header Parameters

Request Body

Response Body

200

Bodyapplication/json

Header