> ## 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 merchant 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) | In addition to `order.placed`: the merchant accepted the order on its side. |
| [`order.failed`](/webhooks/orders/order-failed) | A confirm ended without a placed order. |
| [`order.updated`](/webhooks/orders/order-updated) | After `order.placed`: the order moved to a new delivery stage, such as picked up, arriving or delivered. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.