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

# cart.order.created

> An order has been created.

# cart.order.created

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

Use this event to track order creation before the order reaches a terminal payment outcome.

## 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 | `order:<identifier>`                                                                 |
| Category        | Orders                                                                               |
| Availability    | Planned; not currently emitted.                                                      |
| Schema title    | cart.order.created v1 payload                                                        |
| Schema ID       | `https://schemas.cope.com/events/cart.order.created/v1`                              |

## Payload Fields

| Field             | Required | Type     | Allowed Values       | Description |
| ----------------- | -------- | -------- | -------------------- | ----------- |
| `business`        | yes      | `object` | -                    | -           |
| `buyer`           | yes      | `object` | -                    | -           |
| `created_at`      | yes      | `string` | -                    | -           |
| `event_type`      | yes      | `const`  | `cart.order.created` | -           |
| `failure_code`    | no       | `string` | -                    | -           |
| `failure_message` | no       | `string` | -                    | -           |
| `line_items`      | yes      | `array`  | -                    | -           |
| `metadata`        | no       | `object` | -                    | -           |
| `occurred_at`     | yes      | `string` | -                    | -           |
| `order`           | yes      | `object` | -                    | -           |
| `payment_method`  | no       | `object` | -                    | -           |
| `schema_version`  | yes      | `const`  | `1.0`                | -           |
| `totals`          | yes      | `object` | -                    | -           |

## Example CloudEvent

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "business": {},
    "buyer": {},
    "created_at": "2026-05-05T12:00:00.000Z",
    "event_type": "cart.order.created",
    "line_items": [
      {
        "amounts": {
          "gross_cents": 1000,
          "net_cents": 1000,
          "tax_cents": 1000
        },
        "is_trial": true,
        "product": {},
        "quantity": 1000
      }
    ],
    "occurred_at": "2026-05-05T12:00:00.000Z",
    "order": {
      "currency": "EUR"
    },
    "schema_version": "1.0",
    "totals": {
      "currency": "EUR",
      "total": {
        "gross_cents": 1000,
        "net_cents": 1000,
        "tax_cents": 1000
      }
    }
  },
  "datacontenttype": "application/json",
  "dataschema": "https://schemas.cope.com/events/cart.order.created/v1",
  "id": "cart.order.created:example",
  "idempotency_key": "cart.order.created:example",
  "source": "cope.cart",
  "specversion": "1.0",
  "subject": "order:example",
  "time": "2026-05-05T12:00:00.000Z",
  "type": "cart.order.created"
}
```

## Compatibility

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