24 小时无人健身房是团购核销里逻辑最绕的一类。洗车店核销完只是通电,健身房核销完要考虑:这是体验券还是次卡?这个人还能进几次?晚上十点没人值守,出了问题谁处理?

一、先分清两类券,它们的核销节奏不一样

券类型典型商品核销节奏本地权益
体验券 / 单次券9.9 元体验一次到店核销 1 次当天入场资格 1 次
次卡月卡 30 天 / 10 次卡每次到店核 1 次(num=1)剩余次数递减
时段卡工作日上午场按次核销 + 时段校验在允许时段内可入场
私教课1 对 1 私教 1 节一次核销,需预约对应一节课的履约记录

最容易做错的是次卡:很多人把它当「核销一次就无限用」,结果顾客买 10 次卡只核一次就一直能进。正确做法是每次到店都走一遍预核销 → 核销,且 num 固定为 1。

二、门禁不能直接读券状态

这是健身房场景最关键的设计决定。如果门禁逻辑写成「查这张券是否有效,有效就开门」,会立刻遇到两个问题:

  • 券退款后失效,顾客明明还有剩余次数,却进不来了
  • 一单多张券时,无法知道「今天该用哪一张」

正确结构是券和门禁之间隔一层本地权益:

三、完整入场流程

  1. 顾客在门口扫门店码,打开小程序
  2. 无可用权益时,引导「使用团购券」:输入券码或扫抖音券二维码
  3. 预核销:确认券有效、套餐匹配,展示「将获得 1 次入场资格」
  4. 顾客确认,服务端核销,写入本地权益
  5. 权益到账后点「开门」,服务端校验权益 + 会员状态 + 时段限制 + 门禁在线
  6. 下发开门指令,等设备回报「已开门」再放行
  7. 入场记录落库,权益扣减,出问题时可按记录追溯

第 3 步的预核销必须保留 —— 顾客如果在门口发现券不对(比如买成了别家门店的),可以直接退出,不会损失一张券。

四、夜间无人值守的三个坑

1. 门禁指令发了但门没开

和洗车工位上电同理,指令下发不等于设备执行。必须等控制器回报,或主动查一次门磁状态。如果超时没有回报,页面要明确提示「门禁响应异常,请稍候或联系店长」,而不是让顾客反复点开门。

2. 时段限制的前后校验不一致

我们审查过自营门店的系统,发现过一个典型不一致:上电接口在开始时间前留了 10 秒缓冲,开门接口没有。两个接口判断条件不同,顾客下单后立刻开门,就可能被开门接口判为「不在使用时间内」。

这类问题不需要复杂故障就会触发,只要顾客手快一点。解法是:开门、上电、断电、计次共用一个「是否可用」判断函数,不要各写一遍;时间窗边界写进配置和测试用例。

3. 顾客被困在场馆里

出门逻辑不能依赖网络和权益校验。至少要有一条无条件可用的出口(内部开门按钮或断电即开),否则一次网络故障就是安全事故。

五、异常处理:券核了门没开怎么办

先止损,再排查。

情况该做什么不该做什么
券核销成功但门没开店员远程开门或引导换门,退回本次权益不要撤销核销
顾客要退款先看权益是否已用(是否已入场),再决定是否撤销核销不要直接撤销再退款
核销结果未知页面显示「正在确认,请勿重复提交」,查券状态或对账不要让顾客重新输码
重复提交同一张券返回原订单结果不要再次发放权益

撤销核销与退款是两件事:撤销只让券恢复未使用,钱怎么退走平台售后流程。门店内的权益要在撤销前先冻结,撤销成功后回收。

六、要留的证据清单

这些字段第一次就要存好,事后排查全靠它们:

  • 自己的确认单 ID、会员 ID、业务门店 ID
  • 平台标识、券码(日志里不要打印完整券码)、对应套餐与本地权益 ID
  • 首次核销成功响应的订单号、明细、撤销凭证(按下标对应保存)
  • 每一次开门、上电、断电的指令 ID、操作人、时间与设备回报

七、用什么接

自己申请美团服务商需要企业主体、10 万元保证金余额、WAF 证明与等保或网安险;抖音生活服务另有一套资质要求。对多数做门店软件的小团队,这笔固定投入摊不平。

云飞API 走聚合路径:免保证金、接入方无需单独做等保测评、个人也能接,同一套协议覆盖美团、大众点评、抖音、快手。调试阶段免费,跑通后再决定充值。

如果你的门店同时有洗车、台球、健身多种业态,接口层统一之后,差异只在「核销之后接什么设备」这一段 —— 这部分本来也必须你自己做。