餐饮是团购核销里体量最大的行业,也是最容易踩坑的行业 —— 因为它的接口体系和自助门店那套完全不一样,而绝大多数教程只讲其中一套。
一、先确认你在哪条业务线上
美团把到店业务分成两条线,接口、授权流程、文档全部独立:
| 业务线 | 门店类型 | 典型行业 |
|---|---|---|
| 到店餐饮 | 餐厅门店 | 正餐、快餐、火锅、烧烤、茶饮、烘焙 |
| 到店综合(服务零售) | 非餐饮的到店门店 | 洗车、健身、台球、棋牌、KTV、场馆 |
混合业态要注意:一家店如果既卖餐又在店里提供其他服务,平台侧会按主营类目归属。这种情况需要按实际类目分别处理,不能凭门店名字判断。
二、餐饮侧核销的特殊之处
1. 券分两种,用法不同
| 券类型 | 含义 | 核销后做什么 |
|---|---|---|
| 套餐券 | 固定商品组合 | 按套餐出餐,可能还要选规格(辣度、冷热、大小份) |
| 代金券 | 抵扣固定金额 | 在结账环节抵扣,需要和实收金额一起算 |
| 单品券 / 折扣券 | 指定商品或按比例优惠 | 按平台规则计算实收 |
很多人只处理了套餐券,上线后发现代金券核销了但账单金额不对 —— 因为代金券核销只是「券被扣了」,实收金额要自己按规则算。
2. 核销要接上出餐流程
餐饮和自助门店最大的区别:核销之后有人要做饭。所以核销结果必须能推到后厨或点餐系统,而不是只弹一个「核销成功」。
- 核销成功后自动生成待出餐订单,带套餐明细与规格要求
- 规格信息通常在验券准备阶段就能拿到,要在确认页让顾客选完
- 核销与下单是两个动作,中间失败要有补偿机制
- 退单 / 撤销核销要能联动撤掉未出餐的订单
3. 高峰期并发
餐饮核销集中在午晚高峰,短时间请求量是平时的几十倍。需要提前考虑:
- 接口限流阈值 —— 超出会被平台限制,需要有排队或降级策略
- 超时设置 —— 高峰期平台响应变慢,超时设太短会造成大量「假失败」
- 重复提交 —— 收银员手抖多点两次,必须有幂等保护
- 门店网络 —— 餐厅 WiFi 不稳定是常态,要能脱机暂存后补传
三、接入流程
- 确认业务线为到店餐饮,选择对应的接口体系
- 完成每个门店的授权(餐饮侧授权粒度与综合侧不同,需按该业务线文档)
- 跑通验券准备,确认能拿到套餐明细与规格选项
- 在确认页展示套餐、让顾客选规格
- 执行核销,把结果推到出餐流程
- 对接撤销,处理退款场景
- 压测高峰并发,确认限流与超时策略
四、和自助门店场景的对照
| 维度 | 餐饮 | 自助门店(洗车/健身/台球) |
|---|---|---|
| 业务线 | 到店餐饮 | 到店综合 |
| 核销后动作 | 出餐 / 下单 | 开门 / 上电 / 开台 |
| 规格处理 | 重要(辣度、份量) | 通常无 |
| 并发特征 | 午晚高峰尖峰明显 | 全天较均匀 |
| 金额计算 | 代金券需算实收 | 一般直接计次 |
| 典型终端 | 收银机 / 点餐屏 | 门口扫码 / 自助机 |
五、用聚合接口时的处理
云飞API 把两条业务线的差异收在接口内部,餐饮接入时需要确认的是:
- 门店按到店餐饮类目配置,不要按综合类目配
- 代金券与套餐券的返回结构不同,按券类型分支处理
- 美团、点评、抖音、快手的餐饮券走同一套调用,平台参数区分
- 核销成功的返回里带券类型与金额信息,可直接用于出餐与结账
抖音的餐饮团购是独立体系,走聚合接口时不需要额外的抖音资质,授权与协议差异由服务方处理。
常见问题
餐厅能用自助门店的接口吗?
不能。两条业务线接口独立,用错会直接报错或查不到券。
一张券能核多人份吗?
取决于券的定义。多份套餐通常是同一个订单里的多张券,需要逐张处理,详见「多张团购券怎么核销」。
扫码点餐小程序能直接核销吗?
小程序端不能持有密钥,须由服务端调用。见「微信小程序接入团购核销」。