核销服务由无限聚核提供美团、抖音团购核销一站式接入。账号注册好了开发者中心也能看到 API Key一点核销却报「门店不存在」「未授权」——现场最常见的不是接口写错而是还没建具体门店或者建了商户却拿商户 ID 去授权。新客里「注册了但行业未知、门店为空」的比例很高美团侧核销量通常也远大于抖音。所以这篇只盯一条新手路径注册 → 建商户 → 建具体门店拿到 shopId→ 美团授权 → 抖音授权。跑通这一条才能开始预核销和核销。洗车、健身、台球、舞室这类自助业态以及给门店做系统的行业软件步骤一样。先给结论路径注册无限聚核账号在开发者中心拿到 API Key只放服务端控制台先新建商户选业务类目再在该商户下新建具体门店记下返回的shopId用具体门店的shopId分别发起美团、抖音授权商家本人在平台页确认回到门店列表核对授权状态和平台显示名确认绑的是这家店有券、有授权之后再接预核销 / 核销那是下一篇文章的事。关系示意授权和核销用的是具体门店shopId不是商户 ID。一、注册之后立刻做的两件事注册本身不绑定门店。账号活了只说明你能登录控制台、能拿凭据。步骤做什么验收标准拿 API Key登录后打开开发者中心复制当前账号的 API KeyKey 完整、只保存在业务服务端配置不进小程序包、不进前端仓库确认业态想清楚门店是服务零售还是到店餐饮建商户时类目选对洗车、健身、台球、舞室等一般走服务零售餐厅另走餐饮别混用示例API Host、请求头格式以当前公开 API 文档为准。常见写法是服务端请求头带Authorization: Bearer key具体 Host 和路径前缀以文档「快速开始」为准不要抄过期博客。个人、工作室、公司都可以注册接入无限聚核对接入方没有营业执照要求。能不能核销前提是门店已经在美团 / 抖音开出来并能完成授权——开店资质看平台规则一般要营业执照个体工商户即可以平台入驻页为准。二、先建商户再建具体门店无限聚核后台是两级商户组织一组门店门店才是授权和核销的对象。商户本身不做授权、也不接受核销请求。控制台操作顺序打开门店列表点新建商户填内部名称给自己看的比如品牌名或客户名选择业务类目服务零售 / 到店餐饮在该商户卡片下点新建门店填具体门店名称建议带店址或店号方便以后对账创建成功后门店会有独立的shopId——把它记进自己的业务门店映射表。真实后台截图示意已裁切、敏感信息遮盖保留「新建商户」「新建门店」和逐店授权入口。真实后台截图新建商户先填内部名称并选业务类目。真实后台截图门店创建后获得独立shopId。要把入驻放进自己的 SaaS / 行业软件后台时可调「创建商户或门店」接口POST /api/hexiao/v2/store/create字段以当前文档为准不传masterShopId只创建商户返回的data.shopId是商户 ID不会自动创建首家门店再传masterShopId上一步的商户 ID在该商户下创建具体门店这次返回的data.shopId才是后续授权、预核销、核销要用的门店 IDbusinessCategory只在创建商户时生效service_retail/dining省略时默认服务零售创建门店时继承商户类目门店请求里带这个字段会被忽略。POST /api/hexiao/v2/store/create Authorization: Bearer key Content-Type: application/json { shopName: 示例商户, businessCategory: service_retail }POST /api/hexiao/v2/store/create Authorization: Bearer key Content-Type: application/json { shopName: 示例门店·人民路店, masterShopId: 123 }上面的数字和名称都是占位示例。连锁有几家实体店就建几个无限聚核门店一家店对应一条shopId映射不要让十家店共用一个商户 ID 去核销。本步验收门店列表里能看到商户卡片卡片下有具体门店并且你已经把门店shopId不是商户 ID写进自己的系统。三、分清四个 ID别塞进同一个字段接到「门店不存在 / 当前 shopId 对应主门店」一类报错时先对这张表名称是什么能不能拿去授权 / 核销自己系统的业务门店 ID行业软件、小程序里的门店主键否要先映射到聚核门店无限聚核商户 ID组织用store/create不传masterShopId时返回的那个否传给授权接口会报仅支持子门店无限聚核具体门店shopId商户下新建门店后返回的 ID是授权、预核销、核销、撤销都用它美团 / 抖音平台门店或账号显示名授权后在列表里看到的平台侧信息用于核对绑对没有不是聚核请求里的shopId一句话业务调用里的shopId 具体门店 ID。四、美团授权优先把这一侧跑通数据上美团核销量通常更大新手建议先完成美团授权再补抖音。控制台路径在门店列表找到目标具体门店 → 点美团授权入口 → 把链接交给管理该店的美团账号本人打开并确认。自建后台时调「获取美团/抖音授权链接」POST /api/hexiao/v2/get/auth/url Authorization: Bearer key Content-Type: application/json { shopId: 123, platform: 1 }shopId必须是具体门店platform1美团2抖音不传时默认美团成功时data是授权 URL以文档响应为准。拿到链接 ≠ 授权完成。商家还要在美团页面点完确认你这边还要回门店列表核对美团授权状态为已授权平台显示名能对上这家店。配置了授权成功 Webhook 的也不能只信一次投递文档口径是 best-effort、不自动重试最终仍以查询或后台列表为准。跟老板怎么说少绕弯用哪一个美团账号登必须对目标门店有权限授权给谁、授权后能干什么验券、核销、撤销多店时逐家点避免 A 店链接落到 B 店。本步验收该门店美团状态已授权用测试券或店主确认有在售套餐的门店可以进入后续预核销联调报错里不再出现未授权类原因。授权场景示意门店、授权链接、成功状态是三步图中界面不是真实后台。五、抖音授权另一条线不能共用美团结果同一家聚核门店抖音要单独再走一遍控制台点抖音授权或get/auth/url传platform: 2。商家用来客侧有权限的账号确认。注意美团已授权不能代替抖音只开了一个平台的店可以先接这一个另一个平台开店后再补授权授权后同样核对抖音显示名防止绑错店。本步验收门店列表里抖音状态单独为已授权若本店暂不接抖音可明确标记「未开抖音 / 暂缓」不要误以为美团勾上了就两边都能核。六、授权完才能核销最小联调顺序门店和授权齐了再动接口。最小顺序细节以 API 文档为准服务端保存 API Key 与业务门店 → 聚核shopId映射预核销文档称「输码验券校验」同一shopId、platform、券码顾客 / 店员确认套餐后再核销文档称「验券」成功只看顶层success为布尔true并保存首次成功结果与凭证。预核销、核销、撤销、错误码重试不是本文重点把建店和授权卡点清掉之后再对照接入实战文档联调即可。七、常见卡点 FAQ注册完为什么还是核不了因为核销落在具体门店 对应平台已授权上。只注册、只拿了 API Key、或只建了商户没建门店请求都会失败。按本文第二节、第四节做完再试。商户和门店必须都建吗可以只建一个吗必须先有商户再在商户下建门店。只建商户拿不到可授权的shopId不传masterShopId的store/create也不会自动创建首家门店。授权接口报「当前 shopId 对应主门店该接口仅支持子门店」是什么意思你传的是商户 ID。换成该商户下某家具体门店的shopId再取链接。美团授权了抖音还要授权吗要。两个平台状态分开记、分开核对platform分别传1/2。连锁十家店授权一次就够了吗不够。几家实体店就建几个聚核门店每店 × 每平台各走授权不要共用一个shopId。控制台建店和接口建店有什么差别结果一样都是商户下的具体门店 shopId。控制台适合人手少、店不多行业软件 / SaaS 要把入驻做进自己后台时再接store/create和get/auth/url。授权链接发给谁开发者能代点吗发给管理该店的美团 / 抖音商家账号必须本人在平台页确认开发者代不了。多店时写清店名降低选错店概率。字段、类目、报错文案和文档不一致怎么办以无限聚核当前控制台和公开 API 文档为准本文示例只保留主线不保证穷尽所有字段。八、做完这一页再往下走勾完下面这些再排预核销联调API Key 仅在服务端已建商户类目正确每家实体店都有独立聚核门店shopId并已写入业务映射目标店美团已授权且显示名核对无误若接美团目标店抖音已授权且显示名核对无误若接抖音没有把商户 ID、业务门店 ID、平台门店 ID 塞进核销请求的shopId。