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

# Taking orders in chat: the checkout module

> Turn on checkout so your sales agents can build, confirm, and register customer orders inside the conversation, and where your team manages them afterwards.

With the checkout module on, a **Sales agent** does more than quote prices. It builds a real order while the conversation flows, collects the details you need for every sale, reads the order back, and registers it the moment the customer confirms. Your team then takes over payment and delivery from the **Orders** page.

## Turn on checkout

Checkout is an add-on.

<Steps>
  <Step title="Open Add-ons">
    Go to **Settings**, then **Add-ons**.
  </Step>

  <Step title="Activate the Checkout card">
    **See details** shows everything the module includes before you decide. Once active, **Orders** appears in the sidebar for your whole team. While it is off, the Orders page stays hidden.

    <img src="https://mintcdn.com/ciaremaai/5qTE4zW337oYjJEH/images/ciarem-help-checkout-enable.png?fit=max&auto=format&n=5qTE4zW337oYjJEH&q=85&s=ff31abccb41fccfdd2dcdaaa1de25086" alt="The Checkout card under Settings > Add-ons, with its details modal one click away" data-og-width="1568" width="1568" data-og-height="782" height="782" data-path="images/ciarem-help-checkout-enable.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/ciaremaai/5qTE4zW337oYjJEH/images/ciarem-help-checkout-enable.png?w=280&fit=max&auto=format&n=5qTE4zW337oYjJEH&q=85&s=542a96e1c2ec0830c2405020679280da 280w, https://mintcdn.com/ciaremaai/5qTE4zW337oYjJEH/images/ciarem-help-checkout-enable.png?w=560&fit=max&auto=format&n=5qTE4zW337oYjJEH&q=85&s=d126bf28ccfb3f9afd90502e3ade2fcb 560w, https://mintcdn.com/ciaremaai/5qTE4zW337oYjJEH/images/ciarem-help-checkout-enable.png?w=840&fit=max&auto=format&n=5qTE4zW337oYjJEH&q=85&s=484ffe05b2e70dc6c3731a9ed50c4960 840w, https://mintcdn.com/ciaremaai/5qTE4zW337oYjJEH/images/ciarem-help-checkout-enable.png?w=1100&fit=max&auto=format&n=5qTE4zW337oYjJEH&q=85&s=e5a9b3cef8e4511439692a92c10b6fa6 1100w, https://mintcdn.com/ciaremaai/5qTE4zW337oYjJEH/images/ciarem-help-checkout-enable.png?w=1650&fit=max&auto=format&n=5qTE4zW337oYjJEH&q=85&s=f8ce5ddd664d0d590d123960d452ac90 1650w, https://mintcdn.com/ciaremaai/5qTE4zW337oYjJEH/images/ciarem-help-checkout-enable.png?w=2500&fit=max&auto=format&n=5qTE4zW337oYjJEH&q=85&s=1f68201f2cac53fb5c60374fac0ad617 2500w" />
  </Step>

  <Step title="Open Orders and click Settings">
    Define the **order fields**: the details the agent must collect for every order, such as a delivery address or a payment method.
  </Step>

  <Step title="Configure each field">
    Each field has a type (**Text** or **Options**) and can be marked **required**. The agent will not confirm an order while a required field is missing. It keeps asking, conversationally, until the customer has answered everything.

    <img src="https://mintcdn.com/ciaremaai/5qTE4zW337oYjJEH/images/ciarem-help-checkout-settings.png?fit=max&auto=format&n=5qTE4zW337oYjJEH&q=85&s=57802b9ce7ad85f9aef9ce392d371c03" alt="The checkout settings dialog: the module switch plus the order fields the agent collects" width="1568" height="782" data-path="images/ciarem-help-checkout-settings.png" />
  </Step>
</Steps>

Checkout applies to your **Sales agents** that have access to at least one catalog. There is nothing to configure per agent. Once the module is on, every sales agent that can sell from a catalog can take orders.

## Orders are catalog-only

The agent can only add items that exist in a [catalog](/using-ciarem/catalogs) it has access to, at the prices the catalog states. If a customer asks for something that is not in the catalog, the agent says so and offers the closest alternatives. It never invents an item or a price. Delivery fees or add-ons you sell should therefore exist as catalog records too.

## How an order happens in chat

The flow mirrors how a good human seller closes:

1. The customer decides on something, and the agent adds it to the order.
2. As the chat advances the agent collects your order fields one at a time, inside the conversation, never as a form.
3. Before confirming, the agent reads the complete order back: items, quantities, total, and the collected details.
4. Only after the customer explicitly agrees does the agent confirm the order. Confirmation and recap always happen in separate messages, so the customer always sees what they are agreeing to.

If the customer changes their mind mid-way, the agent updates quantities, removes items, or cancels the order. Customers can also ask about **previous purchases**. The agent reads the contact's order history, so "what did I order last time?" or "send me the same as always" get real answers, and repeats are rebuilt at current catalog prices.

## After the confirmation

When the customer confirms, Ciarem saves the order and hands the conversation to your team. The agent tells the customer a teammate takes over from there. It never claims the order is on its way or promises delivery times. Coordinating payment and fulfillment is [your team's job after the handoff](/using-ciarem/after-the-handoff).

Everything lands on the **Orders** page: every order with its items, totals, collected details, and status. Move an order from **Confirmed** to **Completed** when it is fulfilled, or to **Cancelled** if it falls through.

<img src="https://mintcdn.com/ciaremaai/7QAbJ7EhqGxItErA/images/ciarem-help-orders-page.png?fit=max&auto=format&n=7QAbJ7EhqGxItErA&q=85&s=0006cab2818f6766eb9f9d1c8e20433e" alt="The Orders page: every order the AI has taken, filterable by status" width="1568" height="782" data-path="images/ciarem-help-orders-page.png" />

## Orders where your team works

The order follows the conversation and the customer, so your team never hunts for context:

* **In the inbox**, the conversation's details panel shows an **Orders** card with what this chat produced. The teammate who inherits the handoff sees what was bought without leaving the thread.

<img src="https://mintcdn.com/ciaremaai/7QAbJ7EhqGxItErA/images/ciarem-help-inbox-order-card.png?fit=max&auto=format&n=7QAbJ7EhqGxItErA&q=85&s=d28ff8897a4dfbf54bacaa294b0e983e" alt="A confirmed order on the conversation's details panel, right where the handoff lands" width="1568" height="782" data-path="images/ciarem-help-inbox-order-card.png" />

* **On the contact**, an **Orders** tab lists the customer's full history: every order across all their conversations, with status and total.

<img src="https://mintcdn.com/ciaremaai/7QAbJ7EhqGxItErA/images/ciarem-help-contact-orders.png?fit=max&auto=format&n=7QAbJ7EhqGxItErA&q=85&s=f12ebfde91012cecb62885866f8d5538" alt="The contact's order history tab" width="1568" height="782" data-path="images/ciarem-help-contact-orders.png" />

## Try it without real orders

In the agent **Playground**, checkout runs as a rehearsal. The agent behaves as it would live (adding items, collecting fields, reading back, confirming) but nothing is saved. Use it to try the flow with your own catalog and fields before going live.
