台球厅的团购商品形态比较集中:「2 小时畅打」「3 小时包台」「工作日下午场」。看起来简单,但落地时会遇到一个平台接口解决不了的问题 —— 顾客几乎总会超时。

一、团购券怎么换算成台费

平台商品本地权益开台方式超时处理
2 小时畅打免费时长 120 分钟核销后扫码开台超出按门店价率计时
3 小时包台免费时长 180 分钟核销后扫码开台同上
下午场(限时段)时段内免费 120 分钟需校验当前时间在时段内时段外按正常价
1 小时体验券免费时长 60 分钟核销后开台同上

映射表的主键用「平台 + 门店 + 商品 ID」,不要按商品名匹配。台球厅常有多家门店、不同价格档位,同名商品在不同店可能对应不同时长。

二、核心难点:核销只解决入场资格,不解决计费

这是台球厅与洗车店最大的不同。洗车券对应一次固定服务,核销完就结束了;台球券对应一段时间,核销只是开始。

正确的三段结构:

  1. 核销券 → 把套餐换算成免费时长,记进顾客账户
  2. 开台 → 锁定球台、开始计时,记录起止时间与关联权益
  3. 结算 → 免费时长用完后按门店价率继续计费,结账时合并收取

三、开台的三个必要条件

  • 顾客账户里有可用免费时长,或已确认接受按时计费
  • 球台空闲,没有其他进行中的使用记录
  • 该台的控制器在线(如需联动灯光与电源)

任何一项不满足都不应开台,也不应扣减权益。台球厅常见的投诉是「两个顾客同时扫了同一张台」,本质是缺少锁台这一步的原子性 —— 开台要在一个事务里完成「检查空闲 → 写入占用」,不要先查再写。

四、超时与续费

这是台球厅收入的重要来源,也是最容易出纠纷的地方。设计时明确几点:

情况推荐做法
免费时长剩 10 分钟小程序推送提醒,可选择「加钟」或「结束」
免费时长用尽仍在打自动转入按时计费,页面显示当前累计金额
顾客想提前结束按实际使用结算,剩余免费时长作废(在商品规则中写明)
顾客中途离场未结束设定无操作自动结算阈值(如 30 分钟无动作),避免通宵挂账

「剩余免费时长是否顺延」必须在商品规则里写清楚,否则一定会有顾客主张「我只打了 1 小时,剩 1 小时应该留着下次用」。默认不顺延,并在下单页说明。

五、灯光与电源联动

台球厅的智能改造通常包含灯控。「开台即开灯、结算即关灯」看起来自然,但要注意:

  • 开台成功不等于灯已亮 —— 要等控制器回报,再开始计时
  • 关灯不要单靠定时任务,控制器本地要有最长运行保护,避免网络断开后灯一直开着
  • 开台失败(台已被占)绝不能开灯,否则会误导顾客
  • 断电恢复后默认保持关闭状态,不要自动恢复「上次开灯」

六、异常与售后

券核销了但开不了台,是台球厅最常见的现场问题。处理顺序:

  1. 先给顾客换一张空台(多数情况下只是锁台冲突)
  2. 账户里的免费时长保留,不要因为开台失败就扣掉
  3. 不要让顾客重新核销 —— 券已经核掉了,重复提交只会返回已核销
  4. 顾客坚持退款时,先确认时长是否已使用,未使用再走撤销核销 + 平台退款

撤销核销与退款是两回事:撤销只让券恢复未使用状态,钱怎么退走平台售后流程。

七、接入方式与成本

自己申请美团服务商需要企业主体、10 万元保证金余额、WAF 与等保或网安险材料,抖音另有一套资质。对只服务自己几家门店的经营者,这笔投入通常不划算。

云飞API 走聚合路径:免保证金、接入方无需单独做等保测评,同一套协议覆盖美团、大众点评、抖音、快手。台球厅通常在多个平台都有团购,能少接一套是一套。调试阶段免费,跑通后再充值。