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

# Toast through StreamOrders

> For Toast locations connected through StreamOrders

<Info>
  This page covers Toast locations connected through StreamOrders. New locations connect straight to Toast: see
  [Toast](/orders/pos/toast).
</Info>

Connect Maple to your Toast POS system through StreamOrders, Maple's ordering relay. Orders taken via phone or SMS appear in your Toast system.

<Info>Card payments run through Stripe and need business verification (KYC). Stripe sets how long the review takes, and some businesses wait a few days.</Info>

## Prerequisites

Before starting, ensure you have:

* ✅ Admin access to Toast
* ✅ A Maple Pro plan, which includes phone ordering and POS integrations
* ✅ Business documentation for KYC
* ✅ Bank account information
* ✅ A Toast location you can connect to StreamOrders

## Setup Process

<Steps>
  <Step title="Start KYC Verification">Submit business verification documents</Step>
  <Step title="Connect Through StreamOrders">Open StreamOrders from the Maple dashboard and link your Toast location</Step>
  <Step title="Select Locations">Choose which locations to connect in StreamOrders</Step>
  <Step title="Configure Payment Settings">Set up payment methods and rules</Step>
  <Step title="Test Integration">Place test orders to verify setup</Step>
</Steps>

## Step 1: KYC Verification

### Required Documents

* Business registration (LLC, Corp, etc.)
* EIN or Tax ID letter
* Owner's government-issued ID
* Bank statement or voided check
* Business address verification

<Warning>Stripe sets how long the KYC review takes, and some businesses wait a few days. Start this early to avoid delays.</Warning>

### Submit Documents

1. Navigate to **Orders Module** → **Setup**
2. Click **Start KYC Verification**
3. Upload required documents
4. Complete owner information
5. Submit for review

## Step 2: Connect Toast Through StreamOrders

Toast connects through StreamOrders. Maple does not sign in to Toast itself.

1. Go to **Orders Module** → **POS Integration**
2. Select **Toast** from the options
3. Click **Open StreamOrders**
4. In StreamOrders, authorize Maple, connect your Toast location and choose which locations to connect
5. Return to the Maple dashboard and click **I completed this step**

<Tip>
  You need Toast admin permissions to connect Toast in StreamOrders. Contact your Toast administrator if you don't have
  access.
</Tip>

## Step 3: Configure Locations

### Single Location

1. Your location will auto-populate
2. Verify the information is correct
3. Enable order processing
4. Set default prep times

### Multiple Locations

1. All locations will be listed
2. Toggle each location on/off
3. Configure settings per location:
   * Prep times
   * Payment methods
   * Delivery zones (if applicable)
   * Operating hours

## Step 4: Menu Sync

Your Toast menu syncs to Maple automatically through StreamOrders:

### What Syncs Automatically

* ✅ All menu items and prices
* ✅ Modifiers and options
* ✅ Categories and organization
* ✅ 86'd items
* ✅ Price changes
* ✅ Availability schedules
* ✅ Menu hours
* Hidden Toast items are not synced

### Sync Timing

* Menu changes: usually 5-10 minutes, as StreamOrders passes them on
* 86'd items: usually faster, within minutes

<Note>Menu changes must be made in Toast. Changes sync to Maple automatically.</Note>

## Step 5: Payment Configuration

### Payment Methods

Configure which payment types to accept:

* **Credit/Debit cards**: Paid through Maple's secure payment link, sent to the customer by SMS and processed by your Maple payment provider (Stripe by default). The customer pays before the order is sent to Toast.
* **Pay in store**: Pickup orders, if enabled. Delivery orders can be paid on delivery only when your own drivers deliver them.
* **Gift cards**: Not supported
* **House accounts**: Not supported

<Note>
  This integration does not use Toast Hosted Checkout, and card payments do not settle into your Toast account. See
  [Payment Methods](/orders/config/payment-methods) for how Maple payment links work.
</Note>

### Payment Rules

Set when customers pay:

| Order Type | Payment Options |
| - | - |
| **Delivery** | Pay upfront; pay on delivery only when your own drivers deliver |
| **Pickup** | Pay now or pay in store |
| **Dine-in** | Not applicable |

<Warning>
  **Pay-on-delivery requires cash enabled in StreamOrders.** For pay-on-delivery (pay-in-store) orders routed to Toast
  through StreamOrders, you must enable **cash** as an accepted payment method for delivery in StreamOrders. Otherwise
  Toast rejects the order (`decision_failed` / "payment method declined") and it never reaches the kitchen. See
  [StreamOrders: accepted payment methods](https://help.streamorders.com/en/articles/13441016).
</Warning>

## Step 6: Order Flow Settings

### Prep Times

Set realistic prep times by order type:

* Pickup orders: Default 15-20 minutes
* Delivery orders: Default 30-45 minutes
* Large orders: Automatic adjustment

### Order Confirmation

Configure confirmation settings:

* Enable order readback
* Set confirmation method (number or email)
* Configure receipt delivery

### Special Requests

Define how to handle:

* Allergy notifications
* Special preparations
* Custom modifications
* Notes to kitchen

## Step 7: Testing

Before going live, test thoroughly:

### Test Checklist

1. **Place Test Order**
   * Call your Maple number
   * Order a few items with modifications
   * Verify order appears in Toast

2. **Check Order Details**
   * Correct items and quantities
   * Modifications captured
   * Pricing accurate
   * Payment processed correctly

3. **Test Edge Cases**
   * 86'd items handled properly
   * Large orders
   * Special requests
   * Different payment methods

<Tip>Use Toast's training mode for testing without affecting real inventory or reports.</Tip>

## Going Live

### Launch Checklist

* ✅ Staff trained on new orders appearing
* ✅ Kitchen knows about Maple orders
* ✅ Phone number updated on website/Google
* ✅ Test orders successful
* ✅ Payment processing verified

### Soft Launch Strategy

1. Start with limited hours
2. Monitor first few orders closely
3. Gather staff feedback
4. Adjust settings as needed
5. Expand to full hours

## Managing Orders

### In Toast POS

Maple orders appear as:

* Standard Toast orders, sent through StreamOrders
* All normal Toast features available
* Reports include Maple orders

### Disconnecting Toast

* Toast connects through StreamOrders, so disconnect Toast in StreamOrders
* Problems with the connection between StreamOrders and Toast are also fixed in StreamOrders, not in Maple

### In Maple Dashboard

View and manage:

* Call recordings and transcripts
* Order history
* Failed order reasons
* Customer information
* Performance metrics

## Common Issues & Solutions

<AccordionGroup>
  <Accordion title="Menu items not showing">
    * Check items are active in Toast - Verify menu visibility settings - Wait 5-10 minutes for sync - Contact support if
      persists
  </Accordion>

  <Accordion title="Orders not appearing in Toast">
    * Verify integration is active - Check Toast is online - Confirm location is selected - Review error logs in
      dashboard
  </Accordion>

  <Accordion title="Payment failures">
    * Verify payment settings - Check processor connection - Review decline reasons - Confirm customer card details
  </Accordion>

  <Accordion title="Wrong prices showing">
    * Update prices in Toast - Wait for sync (5-10 minutes) - Check for active promotions - Verify price levels
  </Accordion>
</AccordionGroup>

## Advanced Features

### Revenue Centers

* Not used
* Orders are placed through the configured takeout or delivery dining option

### Loyalty

* Not supported
* Saved cards are not supported

### Catering Orders

For large/advance orders:

* Extended prep times
* Deposit requirements
* Special instructions
* Scheduled ordering

## Best Practices

<Tip>**Menu Optimization**: Keep menu item names clear and pronunciation-friendly for voice ordering.</Tip>

<Tip>**Modifier Management**: Limit modifiers to essential options to reduce complexity.</Tip>

<Tip>**Regular Testing**: Make monthly test orders to ensure everything works smoothly.</Tip>

## Support Resources

* **Toast Support**: For POS-specific issues
* **Maple Support**: [hello@maple.inc](mailto:hello@maple.inc)
* **Integration Status**: Check dashboard for real-time status
* **Documentation**: [Toast API Docs](https://doc.toasttab.com)

## Next Steps

<CardGroup cols={2}>
  <Card title="Configure Payments" icon="credit-card" href="/orders/config/payment-methods">
    Set up payment processing
  </Card>

  <Card title="Delivery Settings" icon="truck" href="/orders/config/delivery">
    Configure delivery zones
  </Card>

  <Card title="Menu Management" icon="utensils" href="/orders/config/menu-management">
    Manage your menu
  </Card>

  <Card title="Go Live" icon="rocket" href="/going-live">
    Launch to customers
  </Card>
</CardGroup>