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

# Toast Orders & Routing

> How storekit injects orders onto Toast checks, maps dining options and revenue centers, applies discounts, service charges and payments, and receives order-status updates back from Toast.

When you accept an online order, storekit builds a Toast check and posts it to Toast. This page covers how orders are routed and what you need to configure.

## When Orders Inject

Orders are dispatched to Toast **when you accept them** (not at payment). storekit sets the order to *syncing*, posts it to Toast, and on success marks it **Accepted** and stores the Toast check number. Pre-orders can be buffered so they reach Toast closer to the fulfillment time rather than days ahead.

## Dining Options

Toast requires a dining option on every order, so you map each storekit fulfillment method to a Toast dining option under **Dining Options**:

* **Default Dining Option**
* **Pickup Dining Option**
* **Delivery Dining Option**
* **In-Store Dining Option**
* **Curbside Dining Option**

storekit auto-suggests these from your Toast configuration when you connect, but you can change them. If an order's fulfillment method has no dining option (and no default), injection fails — always set at least the **Default Dining Option**.

## Revenue Centers

Under **Revenue Centers**, set a **Default Revenue Center** and, optionally, **Revenue Center Rules** to route orders to different revenue centers.

Click **Add Rule** to add a rule. Each rule matches on any combination of:

* **Fulfillment Method** — one of **Any**, **Delivery**, **Pickup**, **In-Store**, **Curbside**
* **Channel** — one of **Any**, **Web**, **PWA**, **App**, **Kiosk**
* **Service Area** — a Toast service area (from your synced floor plan)

and routes matching orders to the chosen **Revenue Center**. The first matching rule wins; if no rule matches, the **Default Revenue Center** is used. The **How does routing work?** link on the page opens an in-dashboard explainer.

## Payments, Discounts & Charges

These all live under **Additional Settings**:

| Setting                            | What it does                                                                                  |
| ---------------------------------- | --------------------------------------------------------------------------------------------- |
| **Alternate Payment Type**         | The Toast payment type used to record the online payment on the check. Required when enabled. |
| **Check Discount**                 | The open, check-level Toast discount used to apply an order discount. Required when enabled.  |
| **Service Charge**                 | The Toast service charge applied for the order's service charge.                              |
| **Delivery Fee Service Charge**    | The Toast service charge applied as the delivery fee on delivery orders.                      |
| **Send Cash as Paid**              | When on, cash orders are sent to Toast as paid.                                               |
| **Use Check Number as Order Code** | When on, the storekit order code is replaced with the Toast check number.                     |

storekit records the payment on the check (amount and tip separately). Discounts only reach Toast if **Check Discount** is set; service charges and delivery fees only reach Toast if their respective service charge is set.

## Order Notes

Set an order note template under **Additional Settings** (the **Order Note Template** control). storekit attaches the composed note to the order's first item on the Toast check as a special request. Per-item notes the customer adds are attached to their own items the same way.

## What Toast Receives

Each order includes the customer name, phone and email, all items with their modifiers (including nested modifiers), the dining option, the revenue center (if resolved), the check discount and service charges (if configured), the tip, delivery address (for delivery), curbside details (for curbside), and the table (for dine-in).

## Order-Status Updates

Toast sends status updates back to storekit, which map onto your order status:

| Toast status     | storekit status  |
| ---------------- | ---------------- |
| In preparation   | Preparing        |
| Ready for pickup | Ready for pickup |
| Closed           | Complete         |
| Voided           | Cancelled        |

<Note>
  Status updates require Toast to be sending guest order status events to storekit. These are configured as part of your integration setup.
</Note>

## When an Order Fails to Inject

If Toast rejects an order, storekit marks it **failed** and records the Toast error on the order — the customer's order still completes, so you never lose it. You can re-dispatch a failed order from the storekit dashboard. Common causes and fixes are in [Troubleshooting](/docs/guides/integrations/pos/toast/troubleshooting).

## Related

* [Connecting Toast](/docs/guides/integrations/pos/toast/connect)
* [Managing Live Orders](/docs/guides/orders/managing-live-orders)
* [Dine-in: Floor Plan & Tables](/docs/guides/integrations/pos/toast/dine-in)


## Related topics

- [Toast POS](/docs/guides/integrations/pos/toast/overview.md)
- [Toast Troubleshooting](/docs/guides/integrations/pos/toast/troubleshooting.md)
- [Toast Dine-in: Floor Plan & Tables](/docs/guides/integrations/pos/toast/dine-in.md)
- [Lightspeed Orders & Routing](/docs/guides/integrations/pos/lightspeed/orders.md)
- [Connecting Toast](/docs/guides/integrations/pos/toast/connect.md)