cart.currency.changed

Generated from COPE public event contracts. Do not edit this page by hand.

Use this event to reconcile cart repricing after a currency change.

Delivery Contract

Field	Value
Encoding	CloudEvents 1.0 structured JSON
Delivery	At least once
Idempotency	Use the CloudEvents `source` + `id` tuple, or COPE `idempotency_key` when available.
Source	`cope.cart`
Subject pattern	`cart:<identifier>`
Category	Cart
Availability	Available in the public webhook reference.
Schema title	cart.currency.changed v1 payload
Schema ID	`https://schemas.cope.com/events/cart.currency.changed/v1`

Payload Fields

Field	Required	Type	Allowed Values	Description
`business`	no	`object`	-	The business this event concerns. Carries `object` (what it is) and `id` (which one); `id` is the public identifier a merchant addresses it by.
`cart_id`	yes	`string`	-	-
`charge_currency`	yes	`string`	-	-
`new_currency`	yes	`string`	-	-
`old_currency`	yes	`string`	-	-

Example CloudEvent

{
  "data": {
    "cart_id": "example_id",
    "charge_currency": "example_charge_currency",
    "new_currency": "example_new_currency",
    "old_currency": "example_old_currency"
  },
  "datacontenttype": "application/json",
  "dataschema": "https://schemas.cope.com/events/cart.currency.changed/v1",
  "id": "cart.currency.changed:example",
  "idempotency_key": "cart.currency.changed:example",
  "source": "cope.cart",
  "specversion": "1.0",
  "subject": "cart:example",
  "time": "2026-05-05T12:00:00.000Z",
  "type": "cart.currency.changed"
}

Compatibility

Fields may be added within the same major version. Removing or changing the meaning of a documented field requires a new event version.