重庆环卫咖啡机预扣款对接流程
一句话结论：咖啡机接入是“第三方设备预扣款订单”，不是微信支付，也不是小程序控制设备。
用户在咖啡机上选择商品，咖啡机向智慧餐厅取小程序扫码参数；用户扫码后生成正式待支付订单，并沿用现有手机端订单支付流程。咖啡机只在查询到付款成功后制作，出货后再回传结果。
二维码只放关键参数
设备 SN = machid
扫码走个人中心
订单表用 ydy_prepay_order
二维码内容确认
取码接口返回给咖啡机的
twocode 是小程序扫码参数，设备负责展示二维码图片。
type=200&torderid=8
其中 torderid 为预扣款订单 ID。不再放旧版 orderid、machid 冗余参数。
1. 总体链路
2. 核心规则
设备校验
PC 端设备类型增加咖啡机，设备 SN 码对应咖啡机
machid。接口 A/C/B 均统一校验签名和设备有效性。
扫码绑定
小程序个人中心扫码识别
type=200 后，后端判断预扣款订单存在、未被其他用户绑定、状态仍允许支付。
支付与出货
用户支付走现有待支付订单页。咖啡机只有查询到
code=1 才制作，出货后通过接口 B 回传成功或失败。
3. 状态码说明
| code | 对外含义 | 系统触发点 |
|---|---|---|
| 0 | 失败 | 系统异常、设备校验失败、出货失败等。 |
| 1 | 消费者付款成功 | 手机端正式订单支付完成后更新。 |
| 2 | 正在等待消费者付款 | 预扣款订单默认状态，或正式订单仍待支付。 |
| 3 | 此次交易已过期 | 已生成正式订单但超时未支付，由现有超时关闭脚本兼容更新。 |
| 4 | 此次交易已关闭 | 当前暂不主动产生该状态，保留协议口径。 |
| 5 | 此次交易已完成 | 咖啡机出货成功后更新。 |
4. 三个项目分工
| 项目 | 职责 |
|---|---|
store |
PC 设备类型、预扣款订单表、接口 A/C/B、支付成功回写、超时脚本兼容、订单管理、报表和导出查询补充。 |
ai_api |
小程序扫码后的预扣款订单绑定、正式待支付订单创建、支付流程衔接。 |
ai_app |
个人中心扫码识别 type=200，调用后台绑定接口，跳转现有待支付订单页。 |
5. 交付验收主链路
联调链路
PC 创建咖啡机设备；Apifox 模拟咖啡机取码；小程序扫码绑定；生成真实待支付订单；用户按现有流程支付；咖啡机查扣款；咖啡机报出货结果。
查询链路
小程序订单列表可查，PC 订单管理可查，相关报表和导出按咖啡机订单来源补充查询口径。
本页为当前实现口径说明，用于销售、项目负责人和研发确认。代码上线验收仍以真实设备、Apifox、微信小程序开发者工具、PC 订单查询的全链路结果为准。