> ## 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.

# 通过 StreamOrders 连接 Toast

> 适用于通过 StreamOrders 连接的 Toast 门店

<Info>
  本页适用于通过 StreamOrders 连接的 Toast 门店。新门店直接连接 Toast：请参阅[Toast](/zh/orders/pos/toast)。
</Info>

通过 StreamOrders（Maple 的订单中继服务）将 Maple 连接到您的 Toast POS 系统。通过电话或短信下的订单会出现在您的 Toast 系统中。

<Info>银行卡支付通过 Stripe 处理，需要进行商户资质验证（KYC）。审核时长由 Stripe 决定，部分商户需要等待几天。</Info>

## 前提条件

开始之前，请确保您已具备：

* ✅ Toast 的管理员权限
* ✅ Maple Pro 套餐，包含电话订餐和 POS 集成
* ✅ 用于 KYC 的企业证明文件
* ✅ 银行账户信息
* ✅ 一个可连接到 StreamOrders 的 Toast 门店

## 设置流程

<Steps>
  <Step title="开始 KYC 验证">提交企业验证文件</Step>
  <Step title="通过 StreamOrders 连接">从 Maple 控制台打开 StreamOrders，并关联您的 Toast 门店</Step>
  <Step title="选择门店">在 StreamOrders 中选择要连接的门店</Step>
  <Step title="配置支付设置">设置支付方式和规则</Step>
  <Step title="测试集成">下测试订单，验证设置</Step>
</Steps>

## 第 1 步：KYC 验证

### 所需文件

* 企业注册证明（LLC、Corp 等）
* EIN 或税号函
* 所有者的政府签发身份证件
* 银行对账单或作废支票
* 企业地址证明

<Warning>KYC 审核时长由 Stripe 决定，部分商户需要等待几天。请尽早开始，以免延误。</Warning>

### 提交文件

1. 前往 **Orders Module** → **Setup**
2. 点击 **Start KYC Verification**
3. 上传所需文件
4. 填写所有者信息
5. 提交审核

## 第 2 步：通过 StreamOrders 连接 Toast

Toast 通过 StreamOrders 连接。Maple 本身不会登录 Toast。

1. 前往 **Orders Module** → **POS Integration**
2. 在选项中选择 **Toast**
3. 点击 **Open StreamOrders**
4. 在 StreamOrders 中授权 Maple，连接您的 Toast 门店，并选择要连接的门店
5. 返回 Maple 控制台，点击 **I completed this step**

<Tip>
  您需要 Toast 管理员权限，才能在 StreamOrders 中连接 Toast。如果您没有权限，请联系您的 Toast 管理员。
</Tip>

## 第 3 步：配置门店

### 单个门店

1. 您的门店会自动填充
2. 确认信息无误
3. 启用订单处理
4. 设置默认备餐时间

### 多个门店

1. 所有门店都会列出
2. 逐个开启/关闭门店
3. 按门店配置设置：
   * 备餐时间
   * 支付方式
   * 外送范围（如适用）
   * 营业时间

## 第 4 步：菜单同步

您的 Toast 菜单会通过 StreamOrders 自动同步到 Maple：

### 自动同步的内容

* ✅ 所有菜品和价格
* ✅ 加料选项和选项
* ✅ 分类和组织结构
* ✅ 已售罄（86）的菜品
* ✅ 价格变更
* ✅ 供应时段安排
* ✅ 菜单时段
* Toast 中隐藏的菜品不会同步

### 同步时间

* 菜单变更：通常为 5-10 分钟，取决于 StreamOrders 的转发
* 已售罄（86）的菜品：通常更快，几分钟内完成

<Note>菜单变更必须在 Toast 中进行。变更会自动同步到 Maple。</Note>

## 第 5 步：支付配置

### 支付方式

配置接受哪些支付类型：

* **信用卡/借记卡**：通过 Maple 的安全支付链接支付，链接以短信发送给顾客，并由您的 Maple 支付服务商处理（默认为 Stripe）。顾客在订单发送到 Toast 之前完成支付。
* **到店付款**：自取订单，如已启用。外送订单仅在由您自己的骑手配送时才可货到付款。
* **礼品卡**：不支持
* **挂账账户（house accounts）**：不支持

<Note>
  此集成不使用 Toast Hosted Checkout，银行卡付款也不会结算到您的 Toast 账户。有关 Maple 支付链接的工作方式，请参阅[支付方式](/zh/orders/config/payment-methods)。
</Note>

### 支付规则

设置顾客何时付款：

| 订单类型 | 支付选项 |
| - | - |
| **外送** | 预先支付；仅在由您自己的骑手配送时可货到付款 |
| **自取** | 立即支付或到店付款 |
| **堂食** | 不适用 |

<Warning>
  **货到付款需要在 StreamOrders 中启用现金。** 对于通过 StreamOrders 发送到 Toast 的货到付款（到店付款）订单，您必须在 StreamOrders 中将 **cash** 设为外送可接受的支付方式。否则 Toast 会拒绝订单（`decision_failed` / "payment method declined"），订单也不会送达后厨。请参阅[StreamOrders: accepted payment methods](https://help.streamorders.com/en/articles/13441016)。
</Warning>

## 第 6 步：订单流程设置

### 备餐时间

按订单类型设置切合实际的备餐时间：

* 自取订单：默认 15-20 分钟
* 外送订单：默认 30-45 分钟
* 大额订单：自动调整

### 订单确认

配置确认设置：

* 启用订单复述
* 设置确认方式（号码或电子邮件）
* 配置收据发送方式

### 特殊要求

定义如何处理：

* 过敏提醒
* 特殊制作
* 自定义修改
* 给后厨的备注

## 第 7 步：测试

正式上线前，请充分测试：

### 测试清单

1. **下测试订单**
   * 拨打您的 Maple 号码
   * 点几样带加料选项的菜品
   * 确认订单出现在 Toast 中

2. **检查订单详情**
   * 菜品和数量正确
   * 加料选项已记录
   * 价格准确
   * 支付处理正确

3. **测试边缘情况**
   * 已售罄（86）的菜品处理正确
   * 大额订单
   * 特殊要求
   * 不同支付方式

<Tip>使用 Toast 的培训模式进行测试，不会影响真实库存或报表。</Tip>

## 正式上线

### 上线清单

* ✅ 员工已接受培训，了解新订单的出现方式
* ✅ 后厨知道有 Maple 订单
* ✅ 网站/Google 上的电话号码已更新
* ✅ 测试订单成功
* ✅ 支付处理已验证

### 软启动策略

1. 先在有限的时段内开通
2. 密切关注最初的几笔订单
3. 收集员工反馈
4. 根据需要调整设置
5. 扩展到全部营业时间

## 管理订单

### 在 Toast POS 中

Maple 订单显示为：

* 通过 StreamOrders 发送的标准 Toast 订单
* 所有常规 Toast 功能均可使用
* 报表包含 Maple 订单

### 断开 Toast 连接

* Toast 通过 StreamOrders 连接，因此请在 StreamOrders 中断开 Toast
* StreamOrders 与 Toast 之间的连接问题，也需在 StreamOrders 中解决，而不是在 Maple 中

### 在 Maple 控制台中

查看和管理：

* 通话录音和文字记录
* 订单历史
* 订单失败原因
* 顾客信息
* 绩效指标

## 常见问题与解决方法

<AccordionGroup>
  <Accordion title="菜单项未显示">
    * 检查菜品在 Toast 中是否已启用 - 确认菜单可见性设置 - 等待 5-10 分钟完成同步 - 如问题持续，请联系支持团队
  </Accordion>

  <Accordion title="订单未出现在 Toast 中">
    * 确认集成处于启用状态 - 检查 Toast 是否在线 - 确认已选择门店 - 在控制台中查看错误日志
  </Accordion>

  <Accordion title="支付失败">
    * 确认支付设置 - 检查支付处理商连接 - 查看拒付原因 - 与顾客确认银行卡信息
  </Accordion>

  <Accordion title="价格显示有误">
    * 在 Toast 中更新价格 - 等待同步（5-10 分钟） - 检查是否有生效的促销 - 确认价格级别
  </Accordion>
</AccordionGroup>

## 高级功能

### 收入中心（Revenue Centers）

* 不使用
* 订单通过已配置的外带或外送用餐方式（dining option）下单

### 会员忠诚度

* 不支持
* 不支持保存银行卡

### 餐饮外烩订单

适用于大额/提前下单的订单：

* 延长备餐时间
* 押金要求
* 特别说明
* 预约下单

## 最佳实践

<Tip>**菜单优化**：菜品名称要清晰，便于语音点餐时发音。</Tip>

<Tip>**加料选项管理**：只保留必要的选项，以降低复杂度。</Tip>

<Tip>**定期测试**：每月下一次测试订单，确保一切运行顺畅。</Tip>

## 支持资源

* **Toast 支持**：处理 POS 相关问题
* **Maple 支持**：[hello@maple.inc](mailto:hello@maple.inc)
* **集成状态**：在控制台查看实时状态
* **文档**：[Toast API Docs](https://doc.toasttab.com)

## 后续步骤

<CardGroup cols={2}>
  <Card title="配置支付" icon="credit-card" href="/zh/orders/config/payment-methods">
    设置支付处理
  </Card>

  <Card title="外送设置" icon="truck" href="/zh/orders/config/delivery">
    配置外送范围
  </Card>

  <Card title="菜单管理" icon="utensils" href="/zh/orders/config/menu-management">
    管理您的菜单
  </Card>

  <Card title="正式上线" icon="rocket" href="/zh/going-live">
    向顾客开放
  </Card>
</CardGroup>


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