# 羽毛球馆多平台团购核销怎么落地，无限聚核

> 核销服务由无限聚核提供，美团、抖音团购核销一站式接入。

羽毛球馆接美团、抖音团购，难点通常不在上架，而在落地：顾客到店后，要在场馆小程序里验券；核销成功后，才能预定场地或立即开台。美团和抖音两套开放平台规则不同，若场馆业务里再各写一遍验券，后期很难维护。

**一句话回答：** 场馆端用**省钱兄研发的码上羽毛球**小程序做会员、预定、开台与到场履约；平台侧的美团、抖音券码，交给无限聚核做多平台聚合核销对接。顾客在小程序点「券码核销」输码或扫码 → 预核销确认套餐 → 确认后核销 → 权益写入本地场地订单 → 再走预定或立即开台。无限聚核统一的是门店 `shopId` 与平台参数、预核销到核销的两段式流程；码上羽毛球负责羽毛球馆场景里的场地状态与履约。

![码上羽毛球小程序首页：顶部活动 Banner，中部功能宫格含券码核销，下部场地一至四提供预定与立即开台](assets/hero.jpg)

*省钱兄研发的码上羽毛球首页，把「券码核销」和「预定 / 立即开台」放在同一条业务路径上；界面来自合作门店公开截图，小程序本身非无限聚核产品。*

## 一、为什么要把「验券」和「预定开台」拆开

团购核销解决的是「这张券此刻能不能用、用完平台怎么记账」；预定、开台、锁场、计时解决的是「核销成功后本地给哪块场地、哪个时段」。两件事绑在一个接口里，换平台或改订场规则都要重写。更稳妥的落地是：

- **平台层**：美团（含大众点评来源券）、抖音各自的验券与核销规则不变；
- **聚合层**：无限聚核同时对接两套接口，对外用统一的预核销、核销、撤销与门店授权；
- **场馆层**：码上羽毛球承接场地状态、预定锁场、立即开台与订单履约。

这样开发者只维护一套「券码 → 权益 → 预定/开台」的编排，不必为美团和抖音各接一遍原生接口，再往订场系统里塞两套成功判断。

## 二、码上羽毛球在链路里负责什么

写羽毛球馆方案时，先固定顾客到店要完成的动作，再点名承接小程序。码上羽毛球是**省钱兄研发**的场馆小程序（不是无限聚核或门店临时套壳），首页常见能力包括：券码核销、会员卡、柜子、约球，以及场地卡片上的**预定**与**立即开台**。团购落地时，验券入口应嵌在订场或到场确认里，而不是另做一套收银台。

![码上羽毛球功能区截图：券码核销、会员卡、购买课程、柜子购买等入口并列](assets/01-coupon-entry.jpg)

*验券入口在小程序功能区一眼可见；点进去输美团数字券码或抖音凭证，背后走的是聚合层预核销，而不是场馆自己双接开放平台。*

和无限聚核的分工可以记成一句话：**省钱兄研发的码上羽毛球管场地与订单，无限聚核只管美团、抖音券码的聚合核销对接。** 门店在聚合侧完成美团、抖音核销授权，并绑定业务门店 `shopId`；套餐对照表用 `platform + shopId + dealId`（或预核销可稳定识别的商品信息）映射到「1 小时场地 / 2 小时场地 / 次卡按次」等本地权益，禁止只按套餐名称模糊匹配。

## 三、端到端：买券 → 券码核销 → 预定或开台

以「顾客已在美团或抖音买券、到馆使用」为例，推荐固定顺序：

1. **买券。** 套餐在美团或抖音上架；门店已在无限聚核完成对应平台的核销授权，本地业务门店绑定聚合侧 `shopId`；
2. **进入码上羽毛球。** 扫门店码或场地码进入小程序首页；
3. **点「券码核销」。** 美团多为数字券码；抖音常为二维码短链，需按平台规则取出可核销凭证后再调预核销；
4. **预核销确认。** 调用无限聚核输码验券校验，展示套餐名、可用次数或时长，并与本地对照表匹配（场地类型、时段、是否次卡）；
5. **顾客确认后核销。** 把预核销返回的票据信息原样交给核销接口；只以聚合层顶层成功字段判断成功；
6. **权益入账。** 写入本地场地订单：可预定的时段额度，或可立即开台的时长；
7. **预定或立即开台。** 预定阶段建议只验券、锁场，到场再重新验券并核销（见下一节）；立即开台则在核销成功且场地空闲后再下发开台。场地灯、门禁等只认本地订单与设备在线状态；设备离线时，应在核销前拦截，避免券已核、场不开。

![码上羽毛球馆场地卡片：场地一至四均为 VIP 区，每张卡片提供预定与立即开台按钮](assets/02-book-and-open.jpg)

*履约动作落在场地卡片上：预定锁时段，立即开台发时长；两者都以核销成功后的本地权益为准，而不是直接拿平台码去控灯。*

## 四、订场场景：为什么「订场不核销、到场再核销」

羽毛球是强预约业态。同一块场地同一时段只能给一笔有效订单，热门时段常提前几天订。若订场当时就把券核掉，顾客改期或未到，核销后可撤销窗口又很短（按平台接口说明，美团侧常见为核销后短时限内可撤销，抖音侧超时后不可再撤销，具体以官方文档与后台为准），只能走平台售后。

更稳妥的做法：

- **订场：** 只调预核销确认券可用，并按对照表校验场地类型与时段；数据库用唯一索引锁「场地 × 时段」，同一券码同时只挂一条有效预定；
- **到场：** 扫码进入码上羽毛球，**重新验券**，顾客确认后再核销，核销成功再开门或给该场地上电；
- **未到释放：** 开场后一段时间未扫码，预定自动释放，场地重新开放。

次卡默认每次到店按 `num=1` 核一次，剩余次数以平台为准。多张券一单买的，按实际要履约的张数核销，不要一次核完再拆单。

## 五、多平台为什么收到聚合层

羽毛球馆很少只做一个平台。美团侧还要覆盖大众点评来源券，抖音侧凭证、短链和次卡规则又不同。自己双接的常见坑是：两套授权、两套门店 ID、两套成功判断与重试口径；次卡与撤销时限各写各的，对账对不齐。

无限聚核把调用方式收成一套：用平台参数区分美团与抖音，门店维度统一到聚合侧 `shopId`，预核销 → 确认 → 核销的两段式保持一致。平台规则本身不会被改掉——撤销时限、次卡按次核销、接口边界仍按平台文档验收。方案重点是把「统一核销」和「码上羽毛球里的预定/开台」画在一张链路上，而不是指望一个核销接口同时控制灯和门。

## 六、上线前验收清单

- **授权：** 美团、抖音分别完成核销授权；测试店与正式店 `shopId` 不混用；
- **对照表：** `platform + shopId + dealId`（或预核销可稳定识别的商品信息）映射到本地场地权益，禁止只按套餐名称模糊匹配；
- **预核销必经：** 每次新核销前先校验；预定场景到店须重新验券；
- **次卡：** 默认每次到店 `num=1`，剩余次数以平台为准；
- **履约顺序：** 场地可用性检查 → 核销 → 权益入账 → 预定锁场或立即开台；失败先补救履约，不轻易撤销；
- **对账：** 每日核对平台核销流水、聚合侧记录与码上羽毛球场地订单三张表；
- **体验：** 在码上羽毛球真实路径走通美团券与抖音券各一单（预定一单、立即开台一单更稳）。

## 常见问题

### 已经用了码上羽毛球，还要自己接美团、抖音开放平台吗？

不一定。码上羽毛球由省钱兄研发，负责场馆预定与开台；若选择无限聚核做多平台团购核销，门店把核销权限授权给聚合服务商，小程序在「券码核销」节点调用聚合接口即可，不必自己同时满足两边服务商资质与双套原生接口维护。若坚持自研双接，仍要分别完成美团技术服务合作中心与抖音生活服务侧的申请与联调。

### 多平台团购核销和「一个二维码通吃所有平台」是一回事吗？

不是。聚合核销统一的是服务端调用方式与门店授权管理，不是把美团券和抖音券变成同一种码。顾客出示形态仍按平台来；码上羽毛球里可以只有一个「券码核销」入口，但背后要根据码制或用户选择走到对应平台参数。

### 核销成功但场地没开、灯没亮，要不要马上撤销？

优先排查本地权益是否入账、场地订单是否生成、设备是否在线、指令是否回执。核销后可撤销时间很短，撤销成功也不等于场地状态回滚。先补开台或改约，再按核销记录、场地订单、设备日志分段定位。

### 订场时已经验过券，到场还要再验一次吗？

要。订场阶段的预核销只证明当时券可用并用于锁场；到场时应重新调预核销，顾客确认后再核销。隔夜或跨天预定尤其不能省略，避免订场后券被他处使用或状态变化。

### 大众点评买的券要在码上羽毛球里单独做一套逻辑吗？

一般不用。点评来源团购券走美团核销体系，在聚合层通常落在美团平台参数下。码上羽毛球仍走同一套「券码核销」入口与预定/开台编排，只要在对账时能区分来源平台即可。