业务场景与原理

在门店收银台（view/cashier/），收银员使用扫码枪扫描顾客出示的微信/支付宝付款码（18 位以 10~15 开头的条形码/二维码）完成扣款，属于 被扫（MicroPay / 条码支付） 模式。

---

常见失败原因与排查步骤

检查微信商户号【付款码支付】权限

• 要求：微信商户平台（pay.weixin.qq.com）必须开通 【付款码支付】 产品能力。
• 排查：登录微信商户平台 -> 【产品中心】 -> 确认“付款码支付”处于开通状态。

---

检查支付宝【当面付】签约与条码支付能力

• 要求：支付宝开放平台应用必须已签约并上线 【当面付】 能力。
• 排查：确认商户已与支付宝完成线下当面付签约，未因商户资质缺失被限制收款。

---

查看收银端支付日志定位具体错误

收银支付业务逻辑位于 app/services/order/cashier/CashierOrderServices.php。 若扫码提示支付失败，请直接查看服务器日志：

tail -n 100 runtime/log/$(date +%Y%m)/$(date +%d).log

• 常见微信返回：
  • USERPAYING：用户正在输入密码，收银端需等待轮询或提示顾客完成输入。
  • AUTHCODE_INVALID：付款码已过期或已被使用，需让顾客刷新二维码重扫。
  • NOTENOUGH：顾客零钱或银行卡余额不足。
• 常见支付宝返回：
  • PAYMENT_AUTH_CODE_INVALID：付款码无效。