做餐饮收银系统和点餐小程序的团队,迟早会遇到这个需求:顾客扫桌台码点餐,点完准备付钱,说「我在美团买了券」。
这时如果让他退出小程序、去美团 App 里核销、再回来重新下单,转化就断在这里了。券必须在点餐流程内部消化掉。
一、先分清三套方案,别混着做
团购核销在餐饮有三条完全不同的落地路径,取决于券在哪个环节被用掉:
| 方案 | 谁操作 | 在哪完成 | 适合 |
|---|---|---|---|
| 收银台核销 | 收银员 | 收银机 / POS | 到店先付后吃、或结账时用券 |
| 顾客自助核销 | 顾客 | 商家自己的小程序 | 顾客自己扫码查券、自助用券 |
| 点餐内嵌核销 | 顾客 | 点餐流程内部 | 扫码点餐、桌台码点餐 |
三种方案的授权模型不同,这一点决定了不能只写一套代码。收银台核销只需门店授权;后两种多一层用户授权 —— 顾客要先授权,系统才能查到他名下有哪些券。
二、点餐内嵌核销的完整时序
顾客在点餐小程序里的体验应该是连贯的,技术上是四步:
- 顾客授权(首次进入时一次性完成,不要每次点餐都弹)
- 查询可用券:按当前顾客 + 当前门店,取出他名下的券
- 在结算页展示可用的券,让顾客勾选,实时算出抵扣与尾款
- 提交订单时先核销券、核销成功后再生成订单并下发后厨
三、饭菜券和代金券的叠加规则
这是扫码点餐场景最复杂、也最容易写错的部分。平台对同一订单里能同时用什么券是有约束的。
用官方给出的示例来理解会更清楚:
顾客点了鸡翅 10 元、汉堡 20 元、可乐 5 元,共 35 元。手里有一张鸡翅券(面额 10 元、售价 8 元、秒杀价 5 元)和一张「2 元抵 10 元」的代金券(限饮料品类)。
| 项 | 值 | 说明 |
|---|---|---|
| 收银订单总金额 | 35 元 | 10 + 20 + 5 |
| 券抵扣总金额 | 15 元 | 鸡翅券抵 10 元 + 代金券抵 5 元 |
| 商家实收总金额 | 7 元 | 两张券商家各自收到的钱:5 + 2 |
| 商家优惠总金额 | 8 元 | 商家承担的让利合计 |
| 尾款金额 | 20 元 | 35 − 10 − 5,顾客还需支付 |
注意「券抵扣 5 元」这一段:代金券限饮料品类,而饮料只有可乐 5 元,面额 10 元也用不上,实际只抵 5 元。
四、尾款怎么算,怎么收
尾款 = 订单总金额 − 券抵扣总金额。上例中是 35 − 15 = 20 元。
- 尾款由你自己的收银或支付渠道收,与团购券结算无关
- 券抵扣的部分你不向顾客收钱,钱由平台结给你(结算口径见「代金券的实收金额怎么算」)
- 两张券的钱可能分两笔结算,来源不同、时间不同,账要分开记
- 如果尾款为 0,仍要生成一笔 0 元订单,否则后厨收不到单
五、餐饮收银系统厂商要特别注意的三件事
1. 多商户要带商户维度
给几十上百家餐厅做系统时,授权、门店映射、券查询三处都必须带商户维度。最危险的 bug 是「串商户」:A 商户的核销请求用到了 B 商户的授权,表现是券核到了别的店。
2. 业务线要选对
餐饮走的是到店餐饮业务线,接口与到店综合(服务零售)是两套。判断依据是门店主营类目,不是门店名字。混合业态(餐厅里还卖别的)按主营类目归属,接入前应向平台确认。
3. 门店授权必须逐店完成
授权粒度是门店级,一家店 × 一个平台算一份。连锁客户开新店就必须补授权,否则新店所有核销都会失败。建议把授权状态做成可查看的列表,而不是等核销报错才发现。
六、高峰期:扫码点餐最脆弱的时段
午晚高峰的扫码点餐请求量是平时的几十倍,而这条链路比收银台核销更长:查券、算抵扣、核销、下单、出餐,五个环节任一超时都会让顾客卡在结算页。
- 查券与核销的超时要分开设置,查券可以短、核销要给足
- 超时后的重试必须幂等 —— 高峰期最常见的资损是「请求已成功但超时,重试又核一次」
- 核销成功但下单失败时,要有补偿:要么补下单,要么撤销核销
- 门店网络不稳时,考虑先把订单暂存本地、恢复后补核销(但这会带来新的对账复杂度,需谨慎)
幂等的具体做法见「团购核销接口幂等设计」,那里有完整的四种方案对比。
七、用聚合接口时的做法
云飞API 覆盖美团、大众点评、抖音、快手四个平台。做扫码点餐时:
- 查券返回按平台分组,前端可统一展示「本店可用券」,不必让顾客自己记是哪个平台的
- 核销时带平台参数,业务代码只认「顾客选了哪张券」
- 点评的券与美团券在同一门店下分别返回,不需要写两套逻辑
- 错误语义已归类(券已用 / 不适用本店 / 已过期 / 授权失效),可直接映射成顾客能看懂的提示
需要说明的是:接口只负责券的查询与核销。菜品、库存、抵扣计算、出餐调度仍由你自己的系统管理,这部分不能用接口替代。
常见问题
顾客已经在美团 App 里核销了,还能在点餐时用吗?
不能。券一旦核销状态就变了,查券时会返回已使用。所以要在点餐早期就提示顾客「先在结算页选券,不要提前在美团里核销」。
一桌多人点餐,能用多张券吗?
按券的实际规则来。多份套餐通常是同一订单里的多张券,需要逐张处理,且出餐动作要放在全部核销成功之后。详见「多张团购券怎么核销」。
扫码点餐和顾客自助核销是同一个东西吗?
技术上是两套方案。顾客自助核销是「在一个专门页面里查券用券」,点餐内嵌核销是「把用券嵌进点餐结算流程」。后者对体验要求更高,对券的适用范围判断也更细。