故障排查
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（英文）
显示的价格有误
解决方法：
- 先在 POS 系统中更新
- 检查是否有生效的促销
- 核对税费设置
- 检查价格等级
- 清除缓存
集成问题
无法连接 POS 系统
解决方法：
- 核对凭据
- 检查权限
- 查看 API 限制
- 在沙盒中测试
- 联系 POS 系统支持
KYC 验证延迟
解决方法：
- 检查文件是否清晰
- 确认已提供所有必需的文件
- 确认信息一致
- 如果被拒绝，请重新提交
- 联系支持
顾客问题
无法完成订单
解决方法：
- 确认配送范围覆盖该地址
- 查看付款设置
- 确认您的 POS 系统支持到店付款（Square、Smile、SpotOn、Qu 不支持）
- 测试下单流程
- 检查菜品是否可供应
未显示到店付款选项
并非所有 POS 系统或订单类型都支持到店付款。
解决方法：
- 配送订单需要预先用银行卡付款——只有在由您自己的骑手配送时才能送达时付款
- Square、Smile、SpotOn 和 Qu 不支持到店付款
- 检查助手的 Orders 设置中是否已启用 Pay in Store