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

# Orders 故障排查

> 解决常见的接单问题

Orders Module 常见问题的解决方法。

## 订单处理问题

### 订单没有出现在 POS 系统中

**解决方法：**

- 确认 POS 系统集成处于启用状态
- 检查 POS 系统是否在线
- 查看错误日志
- 确认门店映射
- 重新同步菜单（**Menus** → **Resync Menu**）；菜单未完全同步（尤其是套餐菜品）会导致订单无法到达 POS 系统
- 用一笔简单的订单测试

### 付款失败

**解决方法：**

- 核对银行卡信息
- 检查处理限额
- 查看拒付代码
- 确认 KYC 已通过
- 换一张银行卡测试

### 未收到支付链接

顾客下单后没有收到付款短信。

**解决方法：**

- 确认顾客的电话号码正确
- 检查顾客是否屏蔽了来自短代码的短信
- 确保支付服务商（Stripe、Gravity 或 Shift4）已正确配置
- 在 Maple 控制台中查看订单状态——链接会在订单确认时发送
- 请顾客检查被过滤或垃圾短信文件夹
- 如果仍未收到链接，请把下单日期和时间、顾客的电话号码以及所点内容发给 Maple 支持团队

### 订单一直处于未付款状态

顾客已下单，但尚未通过链接完成付款。

**解决方法：**

- 系统会自动发送付款提醒：如果短信从您门店自己注册的号码发出，会在 3、6 和 10 分钟时发送；如果从 Maple 的共用号码发出，则只在 5 分钟时发送一次
- Chowbus 订单的提醒时间不同：如果短信从您门店自己注册的号码发出，会在 5、10 和 15 分钟时发送；如果从 Maple 的共用号码发出，则只在 10 分钟时发送一次。Chowbus 订单下单 20 分钟后仍未付款，会被取消，而不是转为到店付款
- 如果启用了自动转为到店付款，自取订单会在提醒结束后自动转换
- 在控制台中查看订单，了解付款状态和提醒记录
- 如果所有提醒发送完毕仍未付款，商户会收到短信通知

## 配送问题

### 顾客的地址无法配送

**解决方法：**

- 确认已在 Maple 控制台中配置配送范围
- 检查顾客的地址是否在已配置的范围内
- 对于圆形范围，确认半径足够大
- 对于多边形范围，检查范围边界是否包含该地址
- 确保该门店已启用配送

### 配送订单需要银行卡付款

配送订单需要通过支付链接预先用银行卡付款。只有在由您自己的骑手配送时才能送达时付款，并且仅限支持到店付款的 POS 系统。

**解决方法：**

- 告知顾客配送订单需要银行卡付款
- 如果顾客希望到店付款，可以改为自取
- 如果由您自己的骑手配送且您想提供送达时付款，请检查您的配送设置是否使用自有车队，以及您的 POS 系统是否支持到店付款

### Maple Fleet 未分配骑手

**解决方法：**

- 确认已为您所在地区配置配送区域
- 检查订单是否在配送时段内提交
- 如果持续无法分配骑手，请联系 Maple 支持

## 菜单问题

### 菜单未同步

**解决方法：**

- 等待 5 分钟完成同步
- 检查 POS 系统连接
- 确认菜单已在 POS 系统中发布
- 查看同步日志
- 手动刷新
- 参阅 [Menu sync issues](https://docs.maple.inc/help/troubleshooting/menu-sync-troubleshooting.md)（英文）

### 显示的价格有误

**解决方法：**

- 先在 POS 系统中更新
- 检查是否有生效的促销
- 核对税费设置
- 检查价格等级
- 清除缓存

## 集成问题

### 无法连接 POS 系统

**解决方法：**

- 核对凭据
- 检查权限
- 查看 API 限制
- 在沙盒中测试
- 联系 POS 系统支持

### KYC 验证延迟

**解决方法：**

- 检查文件是否清晰
- 确认已提供所有必需的文件
- 确认信息一致
- 如果被拒绝，请重新提交
- 联系支持

## 顾客问题

### 无法完成订单

**解决方法：**

- 确认配送范围覆盖该地址
- 查看付款设置
- 确认您的 POS 系统支持到店付款（Square、Smile、SpotOn、Qu 不支持）
- 测试下单流程
- 检查菜品是否可供应

### 未显示到店付款选项

并非所有 POS 系统或订单类型都支持到店付款。

**解决方法：**

- 配送订单需要预先用银行卡付款——只有在由您自己的骑手配送时才能送达时付款
- Square、Smile、SpotOn 和 Qu 不支持到店付款
- 检查助手的 **Orders** 设置中是否已启用 Pay in Store

## 后续步骤

- [查看系统状态](https://status.maple.inc)
- [查看设置指南](https://docs.maple.inc/zh/orders/overview.md)
- [特定 POS 系统的故障排查](https://docs.maple.inc/zh/troubleshooting/pos-specific.md)
- [AI ordering issues](https://docs.maple.inc/help/troubleshooting/ai-ordering-troubleshooting.md)、[Menu recognition issues](https://docs.maple.inc/help/troubleshooting/ai-menu-recognition-troubleshooting.md)、[Printer issues](https://docs.maple.inc/help/troubleshooting/printer-troubleshooting.md)、[Stripe issues](https://docs.maple.inc/help/troubleshooting/stripe-account-troubleshooting.md)（英文）
- [联系支持](mailto:hello@maple.inc)