企业官网建设流程全解析

核销服务由无限聚核提供

微信小程序怎么接入美团团购核销？为什么要接、如何落地

已有预约、会员或门店服务小程序时，接入团购核销可以把平台售出的券与自己的履约流程连接起来。落地时需要区分平台券状态、本地业务权益和顾客界面。本文以无限聚核作为第三方接入场景的文字示例，重点说明通用技术流程。

一、整体链路与职责

推荐由服务端串接平台能力，不要让小程序直接持有平台凭据。

小程序的一次点击不能直接作为“核销成功”的依据。服务端应读取接口业务结果，保存平台返回信息，再进入本地权益发放。

二、先理清商户和门店映射

多门店业务中，至少要区分自己系统的业务门店ID、接入服务中的具体门店ID、美团侧门店或商品ID。它们属于不同系统，不能混在一个字段里。建议为每家实际经营门店单独保存映射和授权状态，核销时按顾客选择的业务门店找到对应的平台门店，不要只凭名称匹配。

三、授权完成后再联调

接入前准备API Key、业务门店映射和待授权的美团门店。API Key只保存在业务服务端，通过服务端配置注入请求；不得写入小程序代码、页面参数或客户端日志。授权发起后还要核实具体门店的授权状态，不能把生成授权入口当作授权已完成。

四、把平台商品映射到本地权益

美团商品和自己的预约、会员或服务权益是两种数据。建议维护配置表，用“平台、具体门店ID、平台商品ID”定位本地权益：

不要单纯按套餐名称或实付金额发权益：名称可能调整，不同门店也可能有同名商品。无法可靠识别商品或找不到对应配置时，应停在确认前，提示管理员补齐映射。

五、按“预核销—确认—核销—入账”处理

1. 服务端校验用户是否有权使用所选门店，并找到对应的平台门店；
2. 调用预核销，检查券状态和套餐信息。预核销用于确认，不应自动扣券或发放权益；
3. 页面展示套餐和将获得的本地权益，由顾客明确确认；
4. 服务端使用确认单中保存的原始参数执行核销；
5. 只有业务结果明确成功后，保存首次成功响应和平台订单信息；
6. 按确认单唯一标识创建本地权益发放任务。

接入时需要保存平台核销结果、本地确认单ID、具体门店、请求追踪标识以及后续权益状态。券码和凭据应按敏感业务数据处理，日志只记录排查所需的脱敏信息。

六、重复请求和结果未知

用户可能重复点击，网络也可能在平台处理完成后中断。因此，业务服务端要保证幂等：同一个确认单最多产生一次有效核销处理和一次权益发放。

• 明确成功：保存原始结果，再执行本地入账；
• 明确拒绝：说明原因，不循环提交同一请求；
• 请求超时或结果未知：先查询订单和券状态，确认后再继续，不要直接再次核销；
• 平台核销成功、本地权益失败：只重试本地权益任务，不重新核销平台券。

次卡每次到店都要按平台规则重新校验，并记录本次核销数量和对应权益变化。

七、撤销、退款和权益回收要分开

售后时先核对平台核销记录和本地权益使用情况，再决定是否撤销核销。撤销处理的是平台券的使用状态；消费者退款、预约取消以及本地未使用权益回收属于不同业务动作，需要分别记录结果。撤销成功不等于消费者已经收到退款。

八、上线前检查

• API Key只保存在服务端；
• 业务门店与平台授权门店映射准确；
• 预核销不会提前扣券或发放权益；
• 顾客确认后才执行核销；
• 重复点击不会重复核销或重复发放权益；
• 超时和结果未知时有查询及人工核对路径；
• 平台核销状态、本地权益状态和退款状态分别展示；
• 关键操作记录请求时间、门店、平台订单和处理结果。

本文以无限聚核作为第三方接入场景示例。实际字段、授权流程和业务规则应以接入时的平台接口说明为准；小程序的会员、预约和履约逻辑由接入方自己的业务系统负责。