# Order created event

Sent when a new order is placed via checkout. Contains minimal
order data -- fetch the full order via GET /orders/{order_id}.

Endpoint: POST order-created
Version: 1.0.0
Security: 

## Request fields (application/json):

  - `event_id` (string, required)
    Unique identifier for this event. Use for idempotent processing.

  - `event_type` (string, required)
    The type of event that occurred. Determines the shape of the data field.

  - `created_at` (string, required)
    When the event occurred (ISO 8601 UTC).

  - `data` (object, required)
    Event-specific payload. Shape depends on event_type.
See individual event schemas for details.

  - `data.order_id` (string, required)
    Unique identifier for the created order.

  - `data.location_id` (string, required)
    The location (store) this order belongs to.

  - `data.status` (string, required)
    Order lifecycle status. Tracks the high-level state of the order from
creation through completion or cancellation.

- PENDING: Order created from cart checkout, awaiting payment.
- CONFIRMED: At least one payment completed; order accepted by the store.
- COMPLETED: Order fulfilled and closed.
- FAILED: Order could not be processed (e.g., all payments failed).
- VOIDED: Order voided before any fulfillment began.
- CANCELLED: Order cancelled by customer or system.

State transitions:
- PENDING -> CONFIRMED, FAILED, VOIDED, CANCELLED
- CONFIRMED -> COMPLETED, CANCELLED
- COMPLETED, FAILED, VOIDED, CANCELLED are terminal (no further transitions)
    Enum: "PENDING", "CONFIRMED", "COMPLETED", "FAILED", "VOIDED", "CANCELLED"

  - `data.handoff_mode` (string, required)
    The handoff mode selected for this order.
    Enum: "PICKUP", "CURBSIDE", "DELIVERY", "KIOSK"

  - `data.total` (object, required)
    Grand total for the order.

  - `data.total.amount` (integer, required)
    Monetary value in the smallest currency unit (cents for USD).
Example: 1299 = $12.99.
    Example: 1299

  - `data.total.currency` (string, required)
    ISO 4217 currency code.
    Example: "USD"

  - `data.created_at` (string, required)
    When the order was created (checkout time).


## Response 200 fields