团购核销 API 接入常见问题
微信小程序怎么接美团、抖音团购核销？从申请与费用，到授权、开发和售后，按你的接入阶段找到答案。
免费接入 · 无需保证金 · 无额外等保接入要求
免费接入指免接口接入费，核销按账号适用档位计费，开发维护另计。开发流程以 V2 服务零售接口为例，其他业态需核对对应能力。
更新于 · 28 个接入问题 · 阅读 Markdown 版
接入路径与资质
已有微信小程序，怎样接入美团、抖音团购核销 API？
可以在现有小程序中增加选店、输码、套餐确认与结果页，由自己的业务后端调用无限聚核 V2 服务零售聚合接口。先准备服务端凭据、门店映射和商家授权，再接入预核销、核销，并把首次成功结果接回预约或会员权益系统。可从接入实战的完整流程开始。
哪些业务适用这套团购核销接入流程？
本页开发流程以美团、抖音的 V2 服务零售聚合接口为范围，适合已有小程序及业务后端、需要把团购券关联预约或服务权益的团队。准备接入时先确认实际业态、平台门店和所需能力，再核对当前文档；餐饮等其他业态不能直接照搬服务零售示例。
自行申请美团团购核销接口，要准备什么资质？
为商家开发软件的三方服务商，需要先完成企业入驻，再办理合作认证、开通对应业务并申请接口权限。申请指南列出企业与签约资料、协议、安全材料及相关保证金要求。先确认自己属于三方服务商还是自研开发者路径，再按美团当前申请页面准备材料和联调。
自行申请抖音团购核销接口，需要走哪些步骤？
申请指南中的路径是生活服务商家应用代开发：先核对公司年限、注册资本、经营范围和同主体 ICP 等条件，提交服务能力认证及对公认证，再创建应用、开通能力并完成开发验收。它针对第三方技术服务商；自有品牌自研应查看对应路径，当前要求以官方后台为准。
费用与接入门槛
无限聚核免费接入包括什么，团购核销是否收费？
免费接入指免接口接入费。实际核销按当前账号适用的充值档位和核销单价计费，自己的小程序开发、业务系统维护也要单独预算。开始联调前先在开发者后台确认适用档位，或查看充值档位文档；文档里的示例金额不应直接用作当前账号报价。
微信小程序接入团购核销 API，开发成本怎样估算？
把接口使用费用与自己的开发维护费用分别计算。接口用量可按预计核销次数和当前账号适用单价估算；开发工作要包含确认页面、门店与商品映射、商家授权、成功记录保存、权益发放及异常处理。先列出已有能力和需要补的流程，再决定接入接口及联调排期。
通过无限聚核接入美团、抖音核销，需要缴纳保证金吗？
通过无限聚核接入无需保证金。申请指南具体说明，客户无需自行承担其中列出的美团服务商保证金门槛，可以从系统门店、商家授权和业务联调开始。这个接入口径不等于各平台全部入驻路径都免保证金；若选择自行申请，仍应核对对应平台当前规则。
接入团购核销 API，需要额外办理等保吗？
无限聚核公开文档的接入口径是无额外等保接入要求，申请指南也说明客户无需自行承担所列美团服务商的相应接入安全资质门槛。该口径针对通过无限聚核接入；自己的系统仍需按实际业务确认适用安全要求。先区分接入路径，再核对平台及自身系统的要求。
最快 5 分钟接入，是否意味着小程序马上可以上线？
最快 5 分钟描述的是基础接入，不是整套业务的上线工期。完成凭据配置和基础请求后，还要核对门店授权、商品权益映射、顾客确认页、成功记录以及异常处理，并完成业务联调。可先按接入实战的验收清单拆分工作，再结合现有小程序和后端安排上线。
抖音生活服务团购核销费用，可以套用抖店电商 API 报价吗？
本页讨论微信小程序通过无限聚核接入生活服务团购核销，不应把抖店电商 API 报价或其他产品套餐套到本服务。先确认所接产品、平台能力和门店业态，再按目标能力的官方规则及当前账号适用充值档位核算费用，自己的开发维护另计；第三方报价不能代替当前账号单价。
开发配置与门店授权
团购核销 API key 从哪里获取，可以放在小程序前端吗？
从无限聚核开发者后台的开发者中心获取当前账号 API key，保存在自己的服务端配置中。服务零售示例使用 Authorization: Bearer <key> 请求头，由业务后端调用接口；小程序只接收必要展示信息和自己的确认上下文。接入前还要检查用户及业务门店权限。
延伸阅读：门店授权与服务端配置 · 当前 API 文档
shopId 应该填自己的门店 ID，还是美团、抖音门店 ID？
服务零售示例中的业务调用使用已保存的无限聚核子门店 shopId。先建立自己的业务门店到聚核子门店的映射，再核对该子门店关联的美团、抖音门店。主门店用于组织子门店，不能把自己的门店 ID、聚核主门店 ID 与平台门店 ID 混入同一请求字段。
微信小程序接入美团、抖音团购核销，必须安装插件吗？
本指南采用小程序、自己的业务后端、无限聚核 API 三层调用方案，接入步骤由页面和后端开发完成。文中的 Java 代码是 HTTP 接入示例，不是现成微信小程序插件。已有小程序可按流程增加确认页面，由后端管理凭据、门店映射和核销结果，再完成自己的权益业务。
延伸阅读：完整接入流程 · 门店授权与服务端配置
美团、抖音门店怎么授权，可以共用一次授权吗？
从对应聚核子门店分别发起美团、抖音授权，商家完成后再核对平台门店和授权状态。自建流程可调用 get/auth/url，传 shopId 及 platform，其中 1 为美团、2 为抖音，成功返回授权链接。拿到链接不代表授权完成，美团授权也不能代替抖音授权。
延伸阅读：门店授权与服务端配置 · 当前 API 文档
微信小程序团购核销必须接哪些 API？
在本文的 V2 服务零售两阶段流程中，预核销与核销是核心接口。门店创建和授权可先在控制台完成，也可按需集成进自己的后台；要展示套餐、配置业务权益时接团购列表，需要撤销售后时再接撤销核销。先把顾客确认与成功处理跑通，再补充对应的后台功能。
验券核销与权益映射
美团、抖音团购商品怎样对应预约、时长或会员权益？
先拉取门店团购列表，由管理员将平台商品配置到自己的权益。建议用平台、聚核子门店和平台商品 ID 共同定位映射，不能只按套餐名称匹配，不同平台同名套餐也要分别配置。顾客输入具体券码后仍需预核销，可靠识别商品并核对映射后，才进入确认使用流程。
预核销、验券和真正核销有什么区别？
文档中的输码验券校验是预核销，用于检查具体券并取得 ticketInfo；文档中的验券接口则会执行真实核销。服务零售流程先用同一门店、平台和券码预核销，展示套餐及权益，等顾客确认后再调用核销。预核销成功只进入确认页，不能直接发放权益。
ticketInfo 应怎样保存，预核销返回的 shopId 能直接使用吗？
把成功预核销响应的 data.ticketInfo 作为不透明字符串保存在服务端，核销时整段原样回传，不解析后重组或删字段。返回的 data.shopId 是套餐或门店兼容 ID，不能覆盖自己保存的聚核子门店。商品无法可靠识别时先完善适配与配置，也不要拆 ticketInfo 来猜映射。
怎样判断团购核销成功，首次响应需要保存哪些信息？
以顶层 success 为布尔值 true 作为进入核销成功处理的依据，不能只看 HTTP 状态或平台内部字段。保存首次完整响应、原请求、门店、平台和关联信息，并按 data[i] 与 consumeCredential[i] 的下标对应保存明细及撤销凭证，再处理自己的预约或会员权益。
延伸阅读：成功记录与权益补处理 · 当前 API 文档
异常处理与售后
核销幂等是否需要自己传 idempotencyKey？
当前聚合核销文档说明调用方无需传 idempotencyKey，旧客户端传入也会被忽略。业务系统仍需按券码和自身业务订单建立去重，并保存首次完整成功记录，不能依赖重复请求补回成功数据。幂等字段和规则应按所调用的具体接口核对，不要把聚合核销规则套到其他写接口。
团购核销接口超时或结果未知后，应该怎样处理？
先保存完整原请求和已收到的响应，保留原 shopId、platform、code、num、ticketInfo，页面显示结果待确认。当前公开文档要求结果未知时先查询平台券状态或完成对账，不能自动重试，也不要换参数发起新核销。核对原记录及当前接口规则后，再决定后续处理。
延伸阅读：当前 API 文档
返回 10500 已核销，但没有首次成功记录，可以补发权益吗？
不能仅凭已核销提示补发权益。当前聚合核销命中已成功订单时可能返回 success=false、code=10500，且不再返回首次成功明细和撤销凭证。应停止该次自动核销重试，核对原订单与成功记录；不要把提示当作成功响应，也不要据此编造 consumeCredential。
核销已经成功，但预约创建或权益发放失败怎么办？
根据已保存的首次核销成功记录补处理自己的业务，确保同一笔权益只发放一次。接入实战将成功响应保存与后续权益操作分开，本地异常进入补处理记录，不再重新核销已成功的券。页面可以分别表达核销成功与权益正在处理，方便顾客了解进度和后台继续恢复。
延伸阅读：成功记录与权益补处理
美团、抖音撤销核销怎么做，是否同时给消费者退款？
先检查自己的权益是否允许撤回，再用原门店、平台和首次成功响应保存的 consumeCredential 数组调用聚合撤销。它适用于有效凭证且符合平台规则的记录，V1、平台原生及历史无凭证记录不能直接套用。撤销核销与消费者付款退款是两项流程，售后要分别处理。
撤销核销部分成功或返回 unknown，后端应该如何处理？
按原 consumeCredential 逐项检查 data 中的状态：succeeded 更新对应记录和权益，rejected 保留拒绝原因，unknown 记为待核对。只有全部成功时顶层 success 才为 true，不能因此忽略部分成功项。相同凭证重复撤销仍会请求平台，未知结果应先查券状态或对账。
联调排查与验收
接入时出现 key 无效、门店不存在或未找到门店映射，先查什么？
先检查 API key 是否来自当前账号、复制完整，请求头只保留一个 Bearer 前缀；再核对 shopId 是否为可访问的聚核子门店，以及对应平台配置和授权状态。排查时保存接口路径、响应及 traceId；不要只凭 HTTP 状态判断成功，也不要把所有失败码都归为可重试错误。
有没有微信小程序接入美团、抖音核销的 Java 示例？
接入实战提供 Java 11+ 与 Jackson 的 HTTP 示例，覆盖授权、商品关联、预核销、核销与撤销，不是可直接安装的 SDK。门店创建与重试段落需按当前 API 文档调整：当前创建主门店后需另建子门店，结果未知先核对，不直接自动重试。使用前请对照当前接口文档并自行完成业务联调。
微信小程序团购核销上线前，需要验收哪些场景？
按业务结果验收服务端凭据、后端 HTTPS、微信请求合法域名、门店与双平台授权、商品映射和确认页。继续检查首次成功记录与凭证完整、权益只发一次、业务拒绝停止重试，以及未知结果核对、本地补处理和逐项撤销。先完成这些流程，再安排真实业务上线。