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

# Order events

> Every confirm on the Purchase API ends in exactly one order event, plus a confirmation when the retailer accepts.

Filter: `order.*`. Every confirm on `POST /buy` produces exactly one `order.placed` or `order.failed` to the company that owns the connection. `order_id` is the same key the `/buy` envelope carries. Reconcile on it, never on amount and time.

| Event                                                 | Fires when                                                                                                                                                                                  |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`order.placed`](/webhooks/orders/order-placed)       | An order was placed at the merchant.                                                                                                                                                        |
| [`order.confirmed`](/webhooks/orders/order-confirmed) | Retail orders only, in addition to `order.placed`: the retailer accepted the order on its side (usually within a minute) and issued its own order number, delivery window, and final total. |
| [`order.failed`](/webhooks/orders/order-failed)       | A confirm ended without a placed order.                                                                                                                                                     |