做餐饮收银系统和点餐小程序的团队,迟早会遇到这个需求:顾客扫桌台码点餐,点完准备付钱,说「我在美团买了券」。

这时如果让他退出小程序、去美团 App 里核销、再回来重新下单,转化就断在这里了。券必须在点餐流程内部消化掉。

一、先分清三套方案,别混着做

团购核销在餐饮有三条完全不同的落地路径,取决于券在哪个环节被用掉:

方案谁操作在哪完成适合
收银台核销收银员收银机 / POS到店先付后吃、或结账时用券
顾客自助核销顾客商家自己的小程序顾客自己扫码查券、自助用券
点餐内嵌核销顾客点餐流程内部扫码点餐、桌台码点餐

三种方案的授权模型不同,这一点决定了不能只写一套代码。收银台核销只需门店授权;后两种多一层用户授权 —— 顾客要先授权,系统才能查到他名下有哪些券。

二、点餐内嵌核销的完整时序

顾客在点餐小程序里的体验应该是连贯的,技术上是四步:

  1. 顾客授权(首次进入时一次性完成,不要每次点餐都弹)
  2. 查询可用券:按当前顾客 + 当前门店,取出他名下的券
  3. 在结算页展示可用的券,让顾客勾选,实时算出抵扣与尾款
  4. 提交订单时先核销券、核销成功后再生成订单并下发后厨

三、饭菜券和代金券的叠加规则

这是扫码点餐场景最复杂、也最容易写错的部分。平台对同一订单里能同时用什么券是有约束的。

用官方给出的示例来理解会更清楚:

顾客点了鸡翅 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 里核销了,还能在点餐时用吗?

不能。券一旦核销状态就变了,查券时会返回已使用。所以要在点餐早期就提示顾客「先在结算页选券,不要提前在美团里核销」。

一桌多人点餐,能用多张券吗?

按券的实际规则来。多份套餐通常是同一订单里的多张券,需要逐张处理,且出餐动作要放在全部核销成功之后。详见「多张团购券怎么核销」。

扫码点餐和顾客自助核销是同一个东西吗?

技术上是两套方案。顾客自助核销是「在一个专门页面里查券用券」,点餐内嵌核销是「把用券嵌进点餐结算流程」。后者对体验要求更高,对券的适用范围判断也更细。