想在自己的系统里核销美团团购券,只有两条路:成为美团侧的服务商自己对接,或者接一家已经完成对接的第三方接口。这篇讲清楚两条路各要什么、卡在哪、多久能通。
一、先分清两条业务线,它们不通用
这是最容易踩的坑:美团的团购核销按行业分成两套业务,接口、授权、文档全部独立,不能一套代码跑两边。
| 业务线 | 对应门店 | 典型行业 |
|---|---|---|
| 服务零售 | 到店综合类门店 | 自助洗车、健身房、台球厅、棋牌室、KTV、场馆 |
| 到店餐饮 | 餐厅门店 | 正餐、快餐、火锅、烧烤、茶饮 |
餐厅不要照搬洗车店的接口路径。两边的核销接口名都不同(餐饮侧走 ms 开头的接口,服务零售侧走 tuangou-receipt 系列),映射关系与对账字段也不一样。
二、自己申请:资质门槛在哪
入口是美团技术服务合作中心。按身份分三类:三方服务商(为多家商家提供系统)、连锁品牌商 / 自研品牌商(只服务自有门店),以及个人开发者。
- 三方服务商:为多家商户提供系统的企业,是绝大多数 SaaS 厂商的路径
- 自研品牌商:自己有品牌门店,只服务自己的门店
材料方面,除了营业执照与对公账户这类常规项,还有三项是真正卡人的:
| 材料 | 要求 | 难点 |
|---|---|---|
| 保证金 | 缴纳后账户可用,非一次性消费 | 10 万元资金占压,对小团队是硬门槛 |
| WAF 证明 | Web 应用防火墙的部署或采购证明 | 需要真的接入安全防护,不是填个表 |
| 等保证明 或 网络安全保险 | 二级等保证明,或等额网络安全保险,二选一 | 等保测评周期通常 1–3 个月,费用数万元起 |
这三项是很多团队真正停下来的地方 —— 不是技术做不了,是资质与资金成本超过了一个小项目的预算。
三、申请流程与周期
- 提交合作申请:在技术服务合作中心填写企业信息与业务说明
- 商务对接:平台评估场景与资质,沟通合作方案
- 接口开发:拿到 appId / appSecret,完成门店映射与接口对接
- 接口测试:用真实券在测试环境跑通预核销、核销、撤销
- 申请上线:验收通过后正式放量
技术侧必接的接口有三个:门店映射(UISDK,商家扫码绑定门店拿 appAuthToken)、验券准备(预检查)、执行验券(正式核销)。撤销接口建议一并接,否则用户退款时无法在平台规则内回退。
从提交申请到正式上线,顺利的情况通常以周为单位;卡在资质材料上的情况更常见,等保一项就可能拖掉一两个月。
四、一个已经发生的迁移:北极星已下线
如果你手上是多年前接入的系统,很可能用的是「北极星开放平台」。该平台已停用,原北极星的合作方身份不会自动带到新入口,需要从第 1 步重新入驻。
老系统报错优先排查这一点:不是签名错了,也不是券码错了,而是调用域名本身已经失效。迁移时接口名、授权方式、门店 ID 体系都要重新对照。
五、资质不满足时的替代路径
如果保证金占压、等保测评周期或主体性质任一项过不去,走聚合接口是行业内的常规做法:由服务方以自己的平台资质完成对接,对下游提供统一接口。
云飞API 属于这条路径。与自建相比的差异是:
| 对比项 | 自己申请 | 接云飞API |
|---|---|---|
| 保证金 | 10 万元占压 | 无需缴纳 |
| 等保 | 需二级等保证明或网络安全保险 | 接入方无需单独测评,平台侧责任由我方承担 |
| WAF | 需自备证明 | 已由我方完成 |
| 接入周期 | 以周为单位,资质环节易卡 | 调试阶段免费,最快当天跑通 |
| 计费 | 平台侧另有规则 | 按核销成功计费,低至 0.05 元/券 |
不是所有场景都该走聚合。如果你的系统已经服务大量商户、需要尽开平台原生能力、且资质齐全,自建有它的价值。但如果目标是「尽快让业务系统能核销团购券」,聚合是更短的路。
常见问题
接了美团团购接口,抖音要再申请一次吗?
自己对接时要。抖音是另一套资质与接口体系。走聚合接口时,在同一套接口上对门店再完成抖音授权即可,不必写第二套核销代码。
大众点评的券要单独接吗?
不用。点评用户购买的团购券走美团同一套团购接口,不是第三个平台。区分来源平台靠接口返回的渠道字段。
个人能申请团购核销接口吗?
不能。技术服务合作中心虽有个人开发者入驻入口,但团购核销业务按官方指引仅对接企业主体(三方服务商或品牌商)。个人若需要在自有系统内核销,常见路径是使用已接入的门店系统,或接第三方核销能力 —— 此时门店仍需完成授权。