在美团、点评、抖音、快手四个平台里,快手的公开资料最少,搜索结果里混着大量与核销无关的内容。这篇只讲对接要做的事。
一、先确认你的场景是哪种码
快手生活服务区分「平台码」与「三方码」。多数做系统集成、自己不发生券的场景属于平台码:券由快手发放,你负责核销。
两种模式的差异体现在请求参数上:平台券的 verify_token 由「验券准备」接口返回,三方券则需开发者自行生成且每次不同。搞错这个,核销会一直失败。
二、必接接口只有三个
| 接口 | 作用 | 是否必接 |
|---|---|---|
| 门店(poi)信息查询 | 查商家认领的门店列表与映射关系,拿到核销用的 poi_id | 必接 |
| 验券准备 | 查询订单券列表,选定要核销的券,返回加密券码与 verify_token | 必接 |
| 验券 | 正式核销券码 | 必接 |
| 撤销核销 | 核销后回退 | 建议接 |
注意验券不能跳步。直接调验券接口而不先做验券准备,通常拿不到正确的加密券码与 verify_token。
三、和美团、抖音的关键差异
| 环节 | 美团 | 抖音 | 快手 |
|---|---|---|---|
| 凭证模型 | 每商家一套 access/refresh token | 应用级 client_token,约 2 小时刷新 | access-token 临时令牌 + poi_id |
| 门店标识 | appAuthToken 绑定门店 | 每次请求传 poi_id | poi_id 必传 |
| 幂等机制 | requestId | 幂等键 + verify_token | verify_token |
| 撤销时限 | 当天且约 10 分钟内 | 约 1 小时内 | 核销后 1 小时内 |
| 成功判断 | 顶层 code 为成功码 | 两层 error_code + 逐张 result | 以接口返回为准 |
结论:三套接口不能靠改域名复用。业务代码只依赖自己的「预核销 / 核销 / 撤销」三个动作,下面挂不同平台适配,将来换供应商或加平台才不用重写业务层。
四、撤销时限是硬约束,不是建议
快手核销后 1 小时内可撤销,超时后快手侧无法退款,只能商家线下退给用户。这个时限和美团(约 10 分钟)、抖音(约 1 小时)都不同,不能用一套超时策略。
开发上要做的是:核销成功后立刻持久化撤销凭证(verify_id / certificate_id 之类),并把时限写进你的业务逻辑 —— 一旦超时,系统层面应该直接禁止发起撤销,而不是等接口报错。
还有一个细节:通过第三方设备核销的订单,不支持在快手商家后台撤销。如果你做的是自助门店场景,这一点会影响你的退款流程设计。
五、资质与门槛
快手生活服务开放平台需要开通开发者账号、创建应用、申请接口权限(门店、团购核销能力),部分环节需要平台审核。测试阶段通常需要申请测试账号权限并完成测试商家授权。
实际办理时以快手开放平台当期要求为准。这类流程变动频繁,本文所据为公开文档,查阅日期 2026-11-16。
六、为什么要考虑聚合接入
分别接四家平台意味着四套授权运维、四套错误码映射、四份文档跟进。多数团队的判断是:核销是业务的基础设施,不是竞争力所在,用聚合接口把精力留给自己的产品更划算。
云飞API 的一个差异点是:同时支持美团、大众点评、抖音、快手四个平台。市面上多数聚合服务商只做美团与抖音,快手往往缺席 —— 如果你的客户里有快手团购业务,这一点值得单独确认。
常见问题
快手团购核销和美团是一套接口吗?
不是。三个平台是三套独立的开放平台、三套凭证模型、三套错误码。走聚合接口时对外是一套,内部仍是分别适配。