Webhooks

COPE webhooks deliver selected cart, checkout, order, payment, refund, chargeback, and payout events to subscriber endpoints as CloudEvents 1.0 structured JSON. Register HTTPS endpoints in the COPE dashboard. Use the event reference to choose the webhook types your integration is ready to process.

Delivery semantics

Contract	Behavior
Encoding	CloudEvents 1.0 structured JSON
Delivery	At least once
Ordering	Not globally ordered
Idempotency	Deduplicate by `source` + `id`; keep `idempotency_key` for producer-level duplicate suppression.
Compatibility	Additive payload changes may happen within the same major version. Breaking changes require a new event version.

Return a 2xx response only after the event is durably accepted. If processing fails, return a non-2xx response so delivery can be retried.

​Webhooks

​Delivery semantics

Webhooks

Delivery semantics