> ## 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 系统是否在线
* 查看错误日志
* 确认门店映射
* 用一笔简单的订单测试

### 付款失败

**解决方法：**

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

### 未收到支付链接

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

**解决方法：**

* 确认顾客的电话号码正确
* 检查顾客是否屏蔽了来自短代码的短信
* 确保支付服务商（Stripe、Gravity 或 Shift4）已正确配置
* 在 Maple 控制台中查看订单状态——链接会在订单确认时发送

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

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

**解决方法：**

* 系统会在 5、10 和 20 分钟时自动发送付款提醒
* 如果启用了自动转为到店付款，自取订单会在提醒结束后自动转换
* 在控制台中查看订单，了解付款状态和提醒记录
* 如果所有提醒发送完毕仍未付款，商户会收到短信通知

## 配送问题

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

**解决方法：**

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

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

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

**解决方法：**

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

### Maple Fleet 未分配骑手

**解决方法：**

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

## 菜单问题

### 菜单未同步

**解决方法：**

* 等待 5 分钟完成同步
* 检查 POS 系统连接
* 确认菜单已在 POS 系统中发布
* 查看同步日志
* 手动刷新

### 显示的价格有误

**解决方法：**

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

## 集成问题

### 无法连接 POS 系统

**解决方法：**

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

### KYC 验证延迟

**解决方法：**

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

## 顾客问题

### 无法完成订单

**解决方法：**

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

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

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

**解决方法：**

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

## 后续步骤

* [查看系统状态](https://status.maple.inc)
* [查看设置指南](/zh/orders/overview)
* [特定 POS 系统的故障排查](/zh/troubleshooting/pos-specific)
* [联系支持](mailto:hello@maple.inc)


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