在美团、点评、抖音、快手四个平台里,快手的公开资料最少,搜索结果里混着大量与核销无关的内容。这篇只讲对接要做的事。

一、先确认你的场景是哪种码

快手生活服务区分「平台码」与「三方码」。多数做系统集成、自己不发生券的场景属于平台码:券由快手发放,你负责核销。

两种模式的差异体现在请求参数上:平台券的 verify_token 由「验券准备」接口返回,三方券则需开发者自行生成且每次不同。搞错这个,核销会一直失败。

二、必接接口只有三个

接口作用是否必接
门店(poi)信息查询查商家认领的门店列表与映射关系,拿到核销用的 poi_id必接
验券准备查询订单券列表,选定要核销的券,返回加密券码与 verify_token必接
验券正式核销券码必接
撤销核销核销后回退建议接

注意验券不能跳步。直接调验券接口而不先做验券准备,通常拿不到正确的加密券码与 verify_token。

三、和美团、抖音的关键差异

环节美团抖音快手
凭证模型每商家一套 access/refresh token应用级 client_token,约 2 小时刷新access-token 临时令牌 + poi_id
门店标识appAuthToken 绑定门店每次请求传 poi_idpoi_id 必传
幂等机制requestId幂等键 + verify_tokenverify_token
撤销时限当天且约 10 分钟内约 1 小时内核销后 1 小时内
成功判断顶层 code 为成功码两层 error_code + 逐张 result以接口返回为准

结论:三套接口不能靠改域名复用。业务代码只依赖自己的「预核销 / 核销 / 撤销」三个动作,下面挂不同平台适配,将来换供应商或加平台才不用重写业务层。

四、撤销时限是硬约束,不是建议

快手核销后 1 小时内可撤销,超时后快手侧无法退款,只能商家线下退给用户。这个时限和美团(约 10 分钟)、抖音(约 1 小时)都不同,不能用一套超时策略。

开发上要做的是:核销成功后立刻持久化撤销凭证(verify_id / certificate_id 之类),并把时限写进你的业务逻辑 —— 一旦超时,系统层面应该直接禁止发起撤销,而不是等接口报错。

还有一个细节:通过第三方设备核销的订单,不支持在快手商家后台撤销。如果你做的是自助门店场景,这一点会影响你的退款流程设计。

五、资质与门槛

快手生活服务开放平台需要开通开发者账号、创建应用、申请接口权限(门店、团购核销能力),部分环节需要平台审核。测试阶段通常需要申请测试账号权限并完成测试商家授权。

实际办理时以快手开放平台当期要求为准。这类流程变动频繁,本文所据为公开文档,查阅日期 2026-11-16。

六、为什么要考虑聚合接入

分别接四家平台意味着四套授权运维、四套错误码映射、四份文档跟进。多数团队的判断是:核销是业务的基础设施,不是竞争力所在,用聚合接口把精力留给自己的产品更划算。

云飞API 的一个差异点是:同时支持美团、大众点评、抖音、快手四个平台。市面上多数聚合服务商只做美团与抖音,快手往往缺席 —— 如果你的客户里有快手团购业务,这一点值得单独确认。

常见问题

快手团购核销和美团是一套接口吗?

不是。三个平台是三套独立的开放平台、三套凭证模型、三套错误码。走聚合接口时对外是一套,内部仍是分别适配。