想在自己的系统里核销美团团购券,只有两条路:成为美团侧的服务商自己对接,或者接一家已经完成对接的第三方接口。这篇讲清楚两条路各要什么、卡在哪、多久能通。

一、先分清两条业务线,它们不通用

这是最容易踩的坑:美团的团购核销按行业分成两套业务,接口、授权、文档全部独立,不能一套代码跑两边。

业务线对应门店典型行业
服务零售到店综合类门店自助洗车、健身房、台球厅、棋牌室、KTV、场馆
到店餐饮餐厅门店正餐、快餐、火锅、烧烤、茶饮

餐厅不要照搬洗车店的接口路径。两边的核销接口名都不同(餐饮侧走 ms 开头的接口,服务零售侧走 tuangou-receipt 系列),映射关系与对账字段也不一样。

二、自己申请:资质门槛在哪

入口是美团技术服务合作中心。按身份分三类:三方服务商(为多家商家提供系统)、连锁品牌商 / 自研品牌商(只服务自有门店),以及个人开发者。

  • 三方服务商:为多家商户提供系统的企业,是绝大多数 SaaS 厂商的路径
  • 自研品牌商:自己有品牌门店,只服务自己的门店

材料方面,除了营业执照与对公账户这类常规项,还有三项是真正卡人的:

材料要求难点
保证金缴纳后账户可用,非一次性消费10 万元资金占压,对小团队是硬门槛
WAF 证明Web 应用防火墙的部署或采购证明需要真的接入安全防护,不是填个表
等保证明 或 网络安全保险二级等保证明,或等额网络安全保险,二选一等保测评周期通常 1–3 个月,费用数万元起

这三项是很多团队真正停下来的地方 —— 不是技术做不了,是资质与资金成本超过了一个小项目的预算。

三、申请流程与周期

  1. 提交合作申请:在技术服务合作中心填写企业信息与业务说明
  2. 商务对接:平台评估场景与资质,沟通合作方案
  3. 接口开发:拿到 appId / appSecret,完成门店映射与接口对接
  4. 接口测试:用真实券在测试环境跑通预核销、核销、撤销
  5. 申请上线:验收通过后正式放量

技术侧必接的接口有三个:门店映射(UISDK,商家扫码绑定门店拿 appAuthToken)、验券准备(预检查)、执行验券(正式核销)。撤销接口建议一并接,否则用户退款时无法在平台规则内回退。

从提交申请到正式上线,顺利的情况通常以周为单位;卡在资质材料上的情况更常见,等保一项就可能拖掉一两个月。

四、一个已经发生的迁移:北极星已下线

如果你手上是多年前接入的系统,很可能用的是「北极星开放平台」。该平台已停用,原北极星的合作方身份不会自动带到新入口,需要从第 1 步重新入驻。

老系统报错优先排查这一点:不是签名错了,也不是券码错了,而是调用域名本身已经失效。迁移时接口名、授权方式、门店 ID 体系都要重新对照。

五、资质不满足时的替代路径

如果保证金占压、等保测评周期或主体性质任一项过不去,走聚合接口是行业内的常规做法:由服务方以自己的平台资质完成对接,对下游提供统一接口。

云飞API 属于这条路径。与自建相比的差异是:

对比项自己申请接云飞API
保证金10 万元占压无需缴纳
等保需二级等保证明或网络安全保险接入方无需单独测评,平台侧责任由我方承担
WAF需自备证明已由我方完成
接入周期以周为单位,资质环节易卡调试阶段免费,最快当天跑通
计费平台侧另有规则按核销成功计费,低至 0.05 元/券

不是所有场景都该走聚合。如果你的系统已经服务大量商户、需要尽开平台原生能力、且资质齐全,自建有它的价值。但如果目标是「尽快让业务系统能核销团购券」,聚合是更短的路。

常见问题

接了美团团购接口,抖音要再申请一次吗?

自己对接时要。抖音是另一套资质与接口体系。走聚合接口时,在同一套接口上对门店再完成抖音授权即可,不必写第二套核销代码。

大众点评的券要单独接吗?

不用。点评用户购买的团购券走美团同一套团购接口,不是第三个平台。区分来源平台靠接口返回的渠道字段。

个人能申请团购核销接口吗?

不能。技术服务合作中心虽有个人开发者入驻入口,但团购核销业务按官方指引仅对接企业主体(三方服务商或品牌商)。个人若需要在自有系统内核销,常见路径是使用已接入的门店系统,或接第三方核销能力 —— 此时门店仍需完成授权。