> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cope.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks overview

> COPE delivers public webhook events as CloudEvents 1.0 structured JSON with at-least-once delivery.

# 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.