美团验券接口怎么接，验券准备到执行核销别跳步, 无限聚核

核销服务由无限聚核提供美团、抖音团购核销一站式接入。搜「美团验券接口」前排经常是官方「券码验证」文档片段或教程里一步打完「验券」的半截示例。开发真正卡的是准备和执行哪一步改券状态服务零售和到店餐饮是不是同一套跳过准备会发生什么一句话回答美团团购验券固定两段——先验券准备再执行验券。准备只读不改券状态、不发权益真正扣券在执行步且必须原样回传准备拿到的不透明凭证。自研走美团开放平台准备验券接口族接第三方用统一「预核销 → 核销」platform1表示美团。餐饮文档里的mspreparemsconsume是另一路由勿与服务零售混抄。依据公开平台说明与无限聚核公开 APIFAQ查阅日期 2026-10-21以当期文档为准。准备 ≠ 核销准备成功只能进确认页执行才写状态凭证如ticketInfo整段原文回传餐饮服务零售分开mspreparemsconsume不是服务零售通用名成功认明确字段聚合侧认顶层successtrue失败分三类可原样重试、明确拒绝停手、已核销转核对。一、先认准你要接的「验券」说法属于谁下一步作用输码验券校验验券准备美团服务零售执行验券查可用券换凭证执行验券同上可选撤销真正核销msprepare→msconsume美团到店餐饮餐饮撤销另路径仅餐饮路由聚合预核销 → 核销第三方统一接口传撤销凭证platform区分美团抖音口语「验一下券」可能指准备也可能指执行代码里必须拆成两步 RPC。抖音是certificate.prepare→verify与美团餐饮msconsume不是一条链路——本文只咬合美团验券接口。二、最小闭环准备 → 确认 → 执行验券准备预核销传门店标识 券码聚合另加platform1。拿到展示信息与不透明凭证。不改券状态不发权益。顾客确认用准备返回的名称、售价、张数做确认页再执行。执行验券回传同一组门店、平台、券码、数量 凭证原文。成功后再落本地订单与权益。可选撤销用执行成功保存的撤销凭证在平台时限内撤销美团侧常见约 10 分钟以当期说明为准。撤销 ≠ 消费者退款。聚合语义名Host 以公开文档为准准备ddzh-tuangou-receipt-prepare→ 存ticketInfo执行ddzh-tuangou-receipt-consume→ 认successtrue存wxdgOrderNo、data[]、consumeCredential[]撤销ddzh-tuangou-receipt-cancel→ 传consumeCredentialshopId必须是聚合具体门店ID不是商户 ID、不是你系统门店主键、不是经营宝门店码。三、ticketInfo 当黑盒要不要服务端整段保存解析后删字段再序列化核销原样回传用凭证猜商品门店 ID成功后再发权益准备成功就写「已核销」商品可先用展示名售价与本地配置预匹配以核销成功返回明细为准。匹配不到唯一商品先完善配置。四、成功失败重试别跳步补枪成功聚合只认successtrue保存首次完整响应与撤销凭证下标对应关系再发权益。失败三类类别举例动作可重试CONSUME_IN_PROGRESS、RESULT_UNKNOWN、SERVICE_UNAVAILABLE、PROVIDER_UNAVAILABLE或超时无响应原请求有限重试明确拒绝PLATFORM_REJECTED等停重试展示原因已核销提示ALREADY_CONSUMED常见code10500停重试用原单号核对不补发、不编造凭证重试禁止重新准备、换参数、让顾客重输码。五、自研 vs 聚合只谈验券主链路维度自研开放平台第三方聚合前置资质商家 token建店店主授权准备执行平台准备验券族统一预核销核销platform1幂等按平台文档接口防重复核业务仍按券码本地单去重餐饮改走mspreparemsconsume等建店选对业态需要 Java HttpClient 示意时看「美团核销 Java」专文本文不复读长示例只讲跳步风险与字段纪律。六、联调自检业态路径未混用准备成功文案是「待确认」不是「已核销」凭证整段落库执行五元组一致成功字段与撤销凭证都落库未知态禁止引导重输码已核销类走核对撤销与退款流程分开。常见问题美团验券接口是一步还是两步两步先准备再执行。跳过准备或把准备当已核销是最常见错误。预核销和验券准备是一回事吗开发语境里常把准备口语叫预核销。财务软件的「预核销」是另一概念勿做技术主标题。mspreparemsconsume 能当通用名吗不能它们属于到店餐饮。服务零售用当期服务零售接口族聚合用统一接口 platform1。执行超时怎么办保留原请求仅白名单错误码或无响应时原样有限重试不要重新准备、不要重输码仍不确定查券状态或对账。