cart.order.completed
Generated from COPE public event contracts. Do not edit this page by hand.Use this event to start fulfillment or grant access. Reconcile money on
payment.sale.succeeded, which can arrive after it.
Delivery Contract
| Field | Value |
|---|---|
| Encoding | JSON: id, type, version, source, created_at, occurred_at, data |
| Delivery | At least once |
| Idempotency | Deduplicate on the envelope’s id: it is covered by the signature, and every retry and replay of this event repeats it. The X-Cope-Event-Id header carries the same value but is not signed. |
| Source | cope.cart |
| Category | Orders |
| Availability | Available in the public webhook reference. |
| Schema title | cart.order.completed webhook body |
| Schema ID | https://schemas.cope.com/webhooks/cart.order.completed/v1 |
Payload Fields
| Field | Required | Type | Allowed Values | Description |
|---|---|---|---|---|
attribution | yes | `object | null` | - |
business | no | object | - | - |
buyer | yes | object | - | The buyer as the checkout captured them. email is null when the checkout did not ask for one. |
cart | no | `object | null` | - |
currency | yes | string | - | - |
event_type | yes | const | cart.order.completed | - |
first_click_ref | no | `string | null` | - |
line_items | yes | array | - | - |
metadata | no | object | - | The metadata you attached to the cart when you created it, returned to you so you can group this order with your own records. Identify the order by order.id, not by its metadata: on a cart created with your publishable key or from a checkout link, the buyer can set or change the metadata before paying. On a cart created from an offer or with a secret API key the metadata is locked, and a change from the buyer’s page is refused. Includes the reserved external_reference and intended_payment_method keys when you set them, and omits keys COPE reserves for its own use. An empty object when you attached none, and absent entirely on orders placed before this field shipped — treat absent and empty as the same thing. A post-purchase upsell is a separate order that repeats the originating order’s metadata, so external_reference is not unique per order; key on order.id and treat this as a grouping reference. |
mor_posture | yes | string | - | - |
occurred_at | yes | string | - | - |
order | no | object | - | - |
payment | no | object | - | - |
payment_chunk | no | object | - | The payment chunk this event concerns. Carries object (what it is) and id (which one); id is the public identifier a merchant addresses it by. |
payment_method | yes | `object | null` | - |
phone_offer_id | no | `string | null` | - |
promo | yes | `object | null` | - |
promo_code | no | `string | null` | - |
rail | yes | string | - | - |
schema_version | yes | const | 1.3 | - |
seller_vat_info | no | `object | null` | - |
totals | yes | object | - | - |
vat_mode | no | string | cope_vat, creator_vat | Which party is liable for VAT on this sale: COPE (cope_vat) or the creator (creator_vat). |
vat_responsibility | no | string | cope, creator | Which party remits VAT to the tax authority. |
Example delivery
{
"created_at": "2026-05-05T12:00:00.000Z",
"data": {
"attribution": {
"fbclid": "IwAR3pX7kQ9mZ2vL8sT1",
"gclid": "Cj0KCQjw8e2xBhD3ARIsAA",
"msclkid": "4f7a9c2e1b3d4e6f8a0b1c2d3e4f5a6b",
"ttclid": "E.C.P.Cn8kQ2vX7mL",
"utm_campaign": "spring_sale",
"utm_content": "hero_banner",
"utm_medium": "email",
"utm_source": "newsletter",
"utm_term": "watercolour"
},
"business": {
"id": "biz_g7-Jq2PxT_4mRvNa",
"name": "Northwind Studio",
"object": "business"
},
"buyer": {
"billing_address": {
"city": "Musterstadt",
"country": "DE",
"line1": "Musterstraße 1",
"line2": "2nd floor",
"postal_code": "12345",
"region": "Musterland"
},
"company_name": "Mustermann Analytics GmbH",
"email": "erika.mustermann@example.com",
"first_name": "Erika",
"full_name": "Erika Mustermann",
"last_name": "Mustermann",
"locale": "de",
"phone": "+1 202 555 0143",
"private_person": false,
"shipping_address": {
"city": "Musterstadt",
"country": "DE",
"line1": "Musterstraße 1",
"line2": "2nd floor",
"postal_code": "12345",
"region": "Musterland"
},
"tax_id": "DE000000000"
},
"cart": {
"id": "5b1f8c2e-7d4a-4e9b-a3c6-0f2d9e8b7a61",
"object": "cart"
},
"currency": "EUR",
"event_type": "cart.order.completed",
"first_click_ref": "partner-anna",
"line_items": [
{
"amounts": {
"gross_cents": 4900,
"net_cents": 4118,
"tax_cents": 782,
"tax_percentage": 19
},
"base_net_amount_cents": 4118,
"commission_notional_vat_bps": 1900,
"currency": "EUR",
"discount": {
"applied_cents": 1000,
"original_gross_cents": 5900
},
"is_trial": false,
"payment_plan": {
"id": "plan_Yr8K2vPd",
"object": "payment_plan"
},
"plan": {
"charge_shipping_once": false,
"display_name": "Monthly membership",
"first_payment_gross_cents": 4900,
"interval": "month",
"interval_count": 1,
"next_payment_gross_cents": 4900,
"payments_count": null,
"plan_type": "subscription",
"shipping_depend_on_quantity": false,
"shipping_price_cents": 500
},
"platform_fee_amount_cents": 490,
"product": {
"id": "prod_Hq2W8xLm",
"object": "product",
"refund_period_days": 14
},
"promo_applies": true,
"quantity": 1,
"shipping": {
"gross_cents": 500,
"net_cents": 420,
"tax_cents": 80,
"tax_percentage": 19
},
"subscription": {
"id": "ps_Gm3Tq8ZrW1bN",
"object": "subscription"
},
"trial_days": 14
}
],
"metadata": {},
"mor_posture": "mor",
"occurred_at": "2026-05-12T16:30:12Z",
"order": {
"created_at": "2026-05-12T16:28:04Z",
"currency": "EUR",
"id": "ord_V7kP2mQx9RtL",
"object": "order",
"source": "checkout"
},
"payment": {
"id": "py_4nHs8QwZ2pLk",
"object": "payment"
},
"payment_chunk": {
"id": "pc_Tz6Rb1Vc9KdQ",
"object": "payment_chunk"
},
"payment_method": {
"brand": "visa",
"last4": "4242",
"type": "card"
},
"phone_offer_id": "spring-call-01",
"promo": {
"amount_discounted_cents": 1000,
"code": "SPRING10",
"currency": "EUR"
},
"promo_code": "SPRING10",
"rail": "stripe",
"schema_version": "1.3",
"seller_vat_info": {
"address": "Beispielweg 7, 54321 Beispielstadt, Germany",
"email": "billing@northwind-studio.example.com",
"name": "Northwind Studio GmbH",
"phone": "+1 202 555 0178",
"tax_id": "DE000000001"
},
"totals": {
"charged": {
"currency": "EUR",
"gross_minor_units": 0,
"net_minor_units": 0,
"tax_minor_units": 0
},
"product": {
"gross_cents": 4900,
"net_cents": 4118,
"tax_cents": 782
},
"shipping": {
"gross_cents": 500,
"net_cents": 420,
"tax_cents": 80
},
"total": {
"gross_cents": 5400,
"net_cents": 4538,
"tax_cents": 862
}
},
"vat_mode": "cope_vat",
"vat_responsibility": "cope"
},
"id": "8d2f6c1a-4e7b-4a39-b5d0-2c9e1f7a3b64",
"occurred_at": "2026-05-05T11:59:58.500Z",
"source": "cope.cart",
"type": "cart.order.completed",
"version": "v1"
}