不少自助门店系统当年是通过大众点评的北极星开放平台接团购核销的。近期常见的求助是:原控制台进不去、门店授权刷新不了、新签的门店绑不上美团、顾客的团购券只能让店员在美团后台手动验。

这不是某一家系统的故障。北极星的技术及运营服务已经转到美团技术服务合作中心,老接口要么迁移,要么换一条路接入。

一、先核对官方口径:两处说法不一致

动手之前必须先看这一节。关于下线时间,官方有两处页面,写法不同:

出处原文要点
北极星原站首页《迁移通知》技术及运营服务将由美团技术服务合作中心提供;2025 年 5 月 31 日至 7 月 1 日环境迁移与部署,期间暂停入驻审核,7 月 2 日起恢复;已合作企业自 7 月 2 日起可登录新平台逐步完成接口改造与授权升级;原文档中心与控制台「逐步进行下线处理」
技术服务合作中心《北极星迁移指引》「原北极星已于 2025 年 6 月 25 日正式下线,如您需要对接接口请在美团技术服务合作中心完成对接。」

另外提醒:《北极星迁移指引》《接口明细对照表》都注明仅适用于原北极星开放平台的存量开发者。没接过北极星的,直接按新平台文档对接,不要照着迁移文档读,会绕远。

二、怎么判断自己受影响

以下几种情况,基本可以确定要处理:

  • 系统里的美团对接配置来自北极星控制台,密钥也在原平台申请
  • 原控制台或文档已经打不开
  • 老门店还能核销,新门店却无法完成授权
  • 授权刷新失败,接口开始返回鉴权类错误
  • 平台运营通过邮件或电话联系过你

三、名词先对齐,再读文档

新平台的整套名词都换了。不先对齐,读新文档会一直卡在「这说的是我认识的那个东西吗」:

合作中心叫法北极星叫法迁移时要改什么
三方服务商开发者 / ISV为多家商家提供系统的,按这个身份入驻
自研品牌商商家只为自有门店服务
开发者应用入驻后平台分配开发者ID 与签名密钥
access_tokensession换成 OAuth 2.0 令牌,按业务分别获取
服务场景模块授权时作为权限项
OpenAPIAPI调用方式从 method 名换成接口路径
公共请求参数公共参数公共参数与签名规则按新平台重写
回调地址回调域名须为 HTTPS

四、接口对照:method 换成路径

团购模块的接口在新平台是「路径」形式,不再是 method 名。命名规律很好记:把 method 里的点换成斜杠,加上 /ddzh 前缀。

接口用途北极星 method合作中心路径
输码验券校验(预核销)tuangou.receipt.prepare/ddzh/tuangou/receipt/prepare
验券(执行核销)tuangou.receipt.consume/ddzh/tuangou/receipt/consume
撤销核销tuangou.receipt.cancel/ddzh/tuangou/receipt/cancel
查询已验券信息tuangou.receipt.getconsumed/ddzh/tuangou/receipt/getconsumed
次卡批量验券tuangou.receipt.batchconsume/ddzh/tuangou/receipt/batchconsume
获取团购信息tuangou.deal.queryshopdeal/ddzh/tuangou/deal/queryshopdeal
查询门店消费码商品tuangou.product.queryproduct/ddzh/tuangou/product/queryproduct
按类型查门店商品tuangou.product.queryproductbytype/ddzh/tuangou/product/queryproductbytype

五、授权:session 换成 access_token

这是迁移里改动最大的一块,也是最容易出错的地方:

  • 授权方式从 session 改成标准 OAuth 2.0,拿到的令牌是 access_token(门店级)
  • 按业务分别授权,令牌不能跨业务使用 —— 一个业务的 token 拿去调另一个业务会失败
  • 再次授权时权限范围要传全量,不能只传新增项,否则原有权限会被覆盖掉
  • 令牌会过期,需要刷新机制;刷新失败要有明确的降级与告警
  • 换过开发者或系统的门店,必须重新授权 —— 商家本人在美团页面操作,你替代不了

六、门店ID:openShopUuid 要转换

这一项最容易踩,因为两个值「看起来像」但不等价:

项含义
openShopUuid(北极星)混淆后的点评门店ID
opPoiId(合作中心)混淆后的美团门店ID

两者一一对应,但值不同。也就是说:你库里的 openShopUuid 不能直接填到新平台,必须调官方的「混淆后门店ID 转换」接口换一次。

建议迁移时把转换做成一次性脚本,结果落库并保留「北极星值 → 新值」的映射记录,便于事后核对。

七、存量迁移的顺序

  1. 完成新平台入驻(原合作开发者、合作商家都要重新入驻,身份不会自动带过来)
  2. 申请接口权限、配置回调地址(须 HTTPS)
  3. 用转换接口把 openShopUuid 批量换成 opPoiId,落库留映射
  4. 用授权迁移接口把存量 session 搬成新平台的授权数据
  5. 迁移单店验证:预核销 → 核销 → 撤销 三条路径各跑一遍
  6. 按门店分批切流
  7. 切流稳定、对账一致后,再下线旧通道

八、切换期最危险的事:同一张券核两次

切换当天出问题,几乎都是因为新旧两套系统同时在线:

  • 按门店分批切,先切一两家,稳定后再推其余
  • 同一家门店同一时刻只保留一个核销入口,旧入口直接下线,不要两边都能点
  • 本地按券码去重 —— 平台的「券已使用」只是兜底,不能当主要防线
  • 旧系统核的券在旧系统撤销,不要跨系统撤销
  • 切换当天把新旧两边的核销记录与美团后台的验券记录核对一遍,差异当天处理

九、三条路怎么选

路径适合谁主要代价
换用已完成迁移的门店系统没有开发团队、本来就用成品系统功能不一定贴合业务
自己入驻技术服务合作中心为多家商家提供软件、长期做服务商改造量最大,周期受资质与审核影响
接第三方核销接口已有自己的小程序或业务系统只改调用层,业务逻辑不动;依赖服务方稳定性

云飞API 属于第三条路。走这条路的改造集中在调用层:把「验券准备 / 核销 / 撤销」三个调用换成新接口,业务逻辑(预约、开门、上电、对账)不需要重写。门店侧仍需商家完成一次平台授权。

常见问题

北极星还能继续用吗?

不要依赖它。官方两处说明都指向同一结论:新的对接在技术服务合作中心完成,原控制台逐步下线。

北极星时期的密钥和授权能直接沿用吗?

不要指望直接沿用。授权方式本身就从 session 换成了 OAuth 2.0 令牌,换过开发者或系统的门店必须重新授权。

只有一两家自己的店,也要按服务商入驻吗?

不一定。平台另有自研品牌商路径,条件与服务商不同,以申请页面为准。

北极星迁移会影响抖音核销吗?

不影响。北极星只涉及美团与大众点评,抖音团购走抖音开放平台的独立体系。若这次改走聚合接口,美团、点评、抖音、快手可以用同一套调用接入。