妙雀 308/318K 咖啡机对接流程图

重庆环卫项目 · 简版沟通页 · 2026-05-25
一句话结论：这就是“设备扫码消费扣款”，不是复杂咖啡机业务。
二维码由我方消费系统生成 咖啡机只展示二维码并出货 不走微信/支付宝收款 手机不直接控制设备

308 和 318K 当前按同一套 V2.4 协议看：weburlA 取码、weburlC 查扣款、weburlB 报出货。正式联调前，只需要厂家确认 318K 实机也按这个协议执行。

1. 对接业务流程图

用户 在咖啡机选咖啡 咖啡机 生成订单和价格 我方接口 A 校验设备，返回我方二维码 用户手机 扫码进我方消费系统 我方消费系统 扣餐卡/余额/补贴 咖啡机查结果 weburlC：扣款成功才出货 咖啡机制作/出货 设备自己完成动作 我方记录结果 weburlB：成功完成，失败处理 关键边界：我方不控制咖啡机出货；咖啡机不负责我方账户扣款；用户手机只负责扫码确认支付。

2. 双方边界图

咖啡机方边界 1. 设备上维护商品、价格、轨道 2. 调我方接口取二维码 3. 扣款成功后自己制作/出货 4. 把出货成功/失败告诉我方 不负责：我方账户、补贴、退款规则 双方交接点 weburlA：取我方二维码 weburlC：查我方扣款结果 weburlB：报设备出货结果 我方边界 1. 校验设备签名和商品价格 2. 生成我方消费确认二维码 3. 处理餐卡/余额/补贴扣款 4. 记订单、异常、冲正或人工处理 不负责：直接控制咖啡机制作动作

3. 三个接口就够了

接口 A：取码 咖啡机把订单、商品、价格、轨道、设备签名发给我方；我方返回消费系统二维码。
接口 C：查扣款 咖啡机轮询我方扣款结果；只有我方返回扣款成功，设备才制作/出货。
接口 B：报结果 设备出货后通知我方成功或失败；失败进入冲正、退款、补贴返还或人工处理。

4. 现在只差厂家确认这 6 件事

318K 实机是否按 V2.4 执行 设备清单和点位 每台 machid / appkey 测试设备和测试商品 twocode 能否展示我方 URL 出货失败 errinfo 错误码

5. 可以直接发给厂家的一句话

本项目不使用微信/支付宝收款，也不由手机直接控制咖啡机。咖啡机只需要在用户选品后调用我方接口获取二维码，用户扫码进入我方消费系统扣款；扣款成功后咖啡机自行出货，并把出货结果回传我方。请确认 308/318K 实机是否都支持 V2.4 文档中的 weburlA、weburlC、weburlB 三个接口。 待确认资料：设备清单、machid/appkey、测试设备、回调配置方式、轮询/重试规则、errinfo 错误码。

详细接口参数和资料清单仍保留在 summary.md、integration-design.md、pending-confirmation.md；本页只用于对接沟通。