核销服务由无限聚核提供微信小程序怎么接入美团团购核销为什么要接、如何落地已有预约、会员或门店服务小程序时接入团购核销可以把平台售出的券与自己的履约流程连接起来。落地时需要区分平台券状态、本地业务权益和顾客界面。本文以无限聚核作为第三方接入场景的文字示例重点说明通用技术流程。一、整体链路与职责推荐由服务端串接平台能力不要让小程序直接持有平台凭据。部分主要职责微信小程序选择门店、提交券码、展示套餐和核销结果业务服务端校验用户权限、匹配门店、保存确认单、发放本地权益接入服务处理平台授权、调用预核销和核销能力、返回结果美团平台保存平台商品和券状态执行平台侧核销小程序的一次点击不能直接作为“核销成功”的依据。服务端应读取接口业务结果保存平台返回信息再进入本地权益发放。二、先理清商户和门店映射多门店业务中至少要区分自己系统的业务门店ID、接入服务中的具体门店ID、美团侧门店或商品ID。它们属于不同系统不能混在一个字段里。建议为每家实际经营门店单独保存映射和授权状态核销时按顾客选择的业务门店找到对应的平台门店不要只凭名称匹配。三、授权完成后再联调接入前准备API Key、业务门店映射和待授权的美团门店。API Key只保存在业务服务端通过服务端配置注入请求不得写入小程序代码、页面参数或客户端日志。授权发起后还要核实具体门店的授权状态不能把生成授权入口当作授权已完成。四、把平台商品映射到本地权益美团商品和自己的预约、会员或服务权益是两种数据。建议维护配置表用“平台、具体门店ID、平台商品ID”定位本地权益平台商品示例本地权益示例说明三小时门店服务三小时预约权益指定可用门店和时段洗车30分钟30分钟洗车时长使用时再检查工位状态人工护理服务一张服务单核销后进入店员履约流程不要单纯按套餐名称或实付金额发权益名称可能调整不同门店也可能有同名商品。无法可靠识别商品或找不到对应配置时应停在确认前提示管理员补齐映射。五、按“预核销—确认—核销—入账”处理服务端校验用户是否有权使用所选门店并找到对应的平台门店调用预核销检查券状态和套餐信息。预核销用于确认不应自动扣券或发放权益页面展示套餐和将获得的本地权益由顾客明确确认服务端使用确认单中保存的原始参数执行核销只有业务结果明确成功后保存首次成功响应和平台订单信息按确认单唯一标识创建本地权益发放任务。接入时需要保存平台核销结果、本地确认单ID、具体门店、请求追踪标识以及后续权益状态。券码和凭据应按敏感业务数据处理日志只记录排查所需的脱敏信息。六、重复请求和结果未知用户可能重复点击网络也可能在平台处理完成后中断。因此业务服务端要保证幂等同一个确认单最多产生一次有效核销处理和一次权益发放。明确成功保存原始结果再执行本地入账明确拒绝说明原因不循环提交同一请求请求超时或结果未知先查询订单和券状态确认后再继续不要直接再次核销平台核销成功、本地权益失败只重试本地权益任务不重新核销平台券。次卡每次到店都要按平台规则重新校验并记录本次核销数量和对应权益变化。七、撤销、退款和权益回收要分开售后时先核对平台核销记录和本地权益使用情况再决定是否撤销核销。撤销处理的是平台券的使用状态消费者退款、预约取消以及本地未使用权益回收属于不同业务动作需要分别记录结果。撤销成功不等于消费者已经收到退款。八、上线前检查API Key只保存在服务端业务门店与平台授权门店映射准确预核销不会提前扣券或发放权益顾客确认后才执行核销重复点击不会重复核销或重复发放权益超时和结果未知时有查询及人工核对路径平台核销状态、本地权益状态和退款状态分别展示关键操作记录请求时间、门店、平台订单和处理结果。本文以无限聚核作为第三方接入场景示例。实际字段、授权流程和业务规则应以接入时的平台接口说明为准小程序的会员、预约和履约逻辑由接入方自己的业务系统负责。