Skip to main content

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

ContractBehavior
EncodingCloudEvents 1.0 structured JSON
DeliveryAt least once
OrderingNot globally ordered
IdempotencyDeduplicate by source + id; keep idempotency_key for producer-level duplicate suppression.
CompatibilityAdditive 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.