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

# SpotOn

> 将 Maple 连接到您的 SpotOn POS 系统，实现订单自动处理

将 Maple 直接连接到您的 SpotOn POS 系统，实现顺畅的订单处理。通过电话或短信下的订单会即时出现在您的 SpotOn 系统中。

<Info>
  银行卡支付通过 CyberSource 处理，并随您的 SpotOn 连接一并设置，因此无需单独进行 Stripe 验证。
</Info>

## 前提条件

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

* ✅ SpotOn 的管理员权限
* ✅ Maple Pro 套餐，其中包含电话点餐和 POS 集成

## 设置流程

<Steps>
  <Step title="连接 SpotOn 账户">
    通过 OAuth 授权 Maple 访问您的 SpotOn 系统。您会被重定向到 SpotOn 以批准连接。
  </Step>

  <Step title="选择门店">选择要为 Maple 点餐启用的 SpotOn 门店。</Step>

  <Step title="菜单同步">
    您的 SpotOn 菜单会自动同步。请确认菜品、加料选项和价格已正确导入。
  </Step>

  <Step title="测试集成">下几笔测试订单，验证从来电到后厨的完整订单流程。</Step>
</Steps>

## 连接 SpotOn

SpotOn 使用 OAuth 进行授权：

1. 前往 **Orders Module** → **POS Integration**
2. 从可用选项中选择 **SpotOn**
3. 点击 **Connect SpotOn Account**
4. 您会被重定向到 SpotOn 的登录页面
5. 输入您的 SpotOn 凭据并批准 Maple 的访问
6. 您会被重定向回 Maple 控制台

<Tip>
  您需要 SpotOn 管理员权限才能授权该集成。如果您没有权限，请联系您的 SpotOn 管理员。
</Tip>

## 菜单同步

您的 SpotOn 菜单会自动同步到 Maple：

* ✅ 所有菜单菜品和价格
* ✅ 加料组和加料选项
* ✅ 分类和组织结构
* ✅ 菜品供应状态更新
* ✅ 价格变更

<Note>菜单修改应在 SpotOn 中进行。修改会自动同步到 Maple。</Note>

## 支付处理

SpotOn 集成使用 CyberSource 处理支付：

* 支持信用卡/借记卡
* 安全的令牌化交易
* 符合 PCI 标准的处理

<Warning>
  SpotOn 订单不支持到店付款。每笔订单都必须通过 Maple 短信发送给来电者的支付链接，提前用银行卡付款。
</Warning>

### 支付规则

| 订单类型 | 支付方式 |
| - | - |
| **自取** | 必须提前刷卡支付 |
| **外送** | 必须提前刷卡支付 |

## 订单管理

Maple 订单在 SpotOn 中显示为：

* 来源：Maple
* 标准 SpotOn 订单格式
* 完整的报表集成
* 兼容后厨显示屏

### 订单流程

1. 顾客通过 Maple（电话或短信）下单
2. 订单即时出现在 SpotOn 中
3. 后厨通过显示屏或打印机收到订单
4. 适用标准的 SpotOn 工作流程

## 多门店支持

对于拥有多家门店的餐厅：

* 分别配置每家门店
* 每家门店可使用不同菜单
* 门店专属定价
* 可提供集中报表

## 故障排查

<AccordionGroup>
  <Accordion title="菜单菜品未同步">
    * 确认菜品在 SpotOn 中处于启用状态 - 检查可见性设置 - 等待 5-10 分钟让同步完成 - 如果问题仍然存在，请联系支持
  </Accordion>

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

  <Accordion title="支付失败">
    * 确认支付设置已正确配置 - 检查支付处理方的状态 - 在控制台中查看拒付原因 - 确认顾客的银行卡信息有效
  </Accordion>

  <Accordion title="OAuth 连接已过期">
    * 从控制台重新授权 SpotOn 连接 - 前往 **Orders Module** → **POS Integration** →
      **Reconnect**
  </Accordion>
</AccordionGroup>

## 支持

* **SpotOn 支持**：联系您的 SpotOn 代表
* **Maple 支持**：发短信至 +1 929 543 0229

## 下一步

<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>
</CardGroup>


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