1. 团购核销API
云飞API(来客核销)
  • API接口
    • 📱 商务合作
    • 💁 技术支持
    • 🤖AI快速接入
    • 接入前准备【必看】
      • 🤖 AI 辅助开发指南
      • OpenAPI接口调用约定
      • 申请应用开户【必看】
      • 生成accessToken
      • 💰 查询应用余额
      • 生成accessToken
    • 团购核销
      • 接入前必看
      • 🚩常见问题汇总【必看】
      • 🚩常见响应码表【开发必看】
      • 📖更新日志
      • 门店
        • 已关联门店查询
        • 设置回调通知地址
        • 🚩关联美团门店
          • 0.快速接入美团门店指引【必看】
          • 1.应用绑定美团门店
          • 1.1.设置门店授权成功回调通知地址【可选】
          • 2.生成美团门店授权码【必看】
          • 2.1.美团门店授权成功回调【可选】
          • 美团门店解除授权
          • 美团门店同步结果回调通知
          • 美团服务零售客户授权结果回调通知
          • 查询已授权美团服务零售客户
        • 🚩关联抖音门店
          • 0.快速接入抖音门店指引【必看】
          • 1.抖音门店授权步骤【必看】
          • 2.应用绑定抖音门店
        • 🚩关联快手门店
          • 1.快手门店授权步骤【必看】
          • 应用绑定快手门店
      • 商品
        • 获取门店团购信息
      • 团购核销API
        • 查券和验券
        • 撤销验券
          POST
        • 批量撤销验券
          POST
        • 手机号查询可用团购券
          POST
        • 团购退款预校验
          POST
        • 团购退款申请
          POST
        • 团购退款信息查询
          POST
        • 团购退款审核
          POST
      • 订单服务API
        • 订单券码分摊金额查询
        • 查询团购订单结算扩展明细
  1. 团购核销API

查券和验券

接口说明#

该接口可以查券也可以验券,根据 type 传入不同值实现不同能力
查券信息不收费!查券信息不收费!查券信息不收费!
验券成功才扣费!验券成功才扣费!验券成功才扣费!
🚩注意:验券接口返回的金额只能作为订单流水金额,不是平台最终结算给商家的入账金额,具体结算金额请以平台(美团经营宝、来客核销、快手商家平台)结算为准

注意事项#

需要门店先完成授权,授权成功后(即在授权有效期内)该接口可正常调用获取券数据
获取 access_token 调用 点我生成accessToken

基本信息#

名称描述
HTTP URLhttp://wspacebot.yunfeiwork.com/wspace-openapi/partner/tuangou/receipt/consume?access_token=ACCESS_TOKEN
HTTP MethodPOST

请求参数#

请求头#

参数名参数值必填
content-typeapplication/json是

Body#

参数名类型必填说明
receiptCodestring是团购券码,必须未验证,支持数字券码、抖音券码短链
opPoiIdstring是云飞API侧门店ID
platformstring否团购平台:meituan=美团(大众点评),douyin=抖音,kuaishou=快手(如果没传值则默认美团)
typestring否验券类型:1=验券前准备(查券), 2=确认验券(核销券)(如果没传值则默认确认验券)
verifyCountint是type=1 不传 type=2(确认验券时必传,不传则默认取验券前准备返回的总数)
appShopAccountstring否商家在自研系统或第三方服务商系统内登录的帐号,仅用于记录验券者的信息,该字段不参与任何验券校验逻辑
appShopAccountNamestring否商家在自研系统或第三方服务商系统内登陆的用户名,仅用于记录验券者的信息,该字段不参与任何验券校验逻辑

请求示例#

{
    "opPoiId": "xxxx",
    "receiptCode": "13565635289",
    "platform":"meituan",
    "type":"1"
}

响应参数#

Body#

参数名类型说明
dealIdlong套餐ID(美团门店使用)
dealGroupIdlong团购ID(美团门店使用)
skuIdstring抖音的团购商品ID(抖音门店使用)
thirdSkuIdstring商家系统(第三方)商品id(抖音、美团餐饮门店使用)
dealTitlelong商品名称
mobilestring掩码手机号,例如:197****5316 仅美团服务零售类门店返回,美团到店餐饮、抖音平台均不返回
receiptCodestring团购券码
receiptEndDatelong美团券过期时间,返回的是毫秒时间戳,示例:1730908799000。
verifiedReceiptCodesarrays一次核销多张券时会返回
typestring验券类型,源自请求入参的type字段
verifyCountinttype=1:表示当前可验证的券码总数量 type=2:表示已经验证成功的券码数量
orderIdstring订单编号
注意:
1、新版授权后美团服务零售(到店综合)类在查券时不返回orderId,只有验券成功后才返回;
2、美团餐饮切换为新版接口后不再返回orderId,如需获取需orderId请在券码核销完成后调用
查询团购订单结算扩展明细 接口
originCodestring原始数字券码,适用于抖音扫码通过短链核销成功时返回,查券时抖音不返回原始数字券码
platformAmountstring补贴金额(平台分摊)美团返回,新版美团餐饮不再返回,如需获取需在券码核销完成后调用 查询团购订单结算扩展明细 接口
merchantAmountstring补贴金额(商户分摊)美团返回
resultarrays验券返回结果
prepareResponseobject美团查券返回的原始数据(默认不返回,有需要联系技术客服开放)
consumeResponseobject美团验券返回的原始数据(默认不返回,有需要联系技术客服开放)

result集合字段#

参数名类型说明
dealIdlong套餐ID
dealGroupIdlong团购ID
skuIdstring抖音的团购商品ID(抖音返回)
thirdSkuIdstring商家系统(第三方)商品id(抖音、美团餐饮门店使用)
dealMarketPricedouble(团购)套餐原价
dealPricedouble(团购)套餐价格
dealTitlelong商品名称
orderIdstring订单编号
注意:新版授权后美团服务零售(到店综合)类、到店餐饮门店在查券时不返回orderId,只有验券成功后才返回
paymentDetailarrays支付信息(美团返回)
productItemIdlong
receiptCodestring券码
tgTimesCardFlagboolean默认 false ,暂无业务含义

paymentDetail集合字段#

参数名类型说明
amountstring支付金额
amountTypeint金额类型 类型说明: 2:抵用券 5:积分 6:立减 8:商户抵用券 10:C端美团支付 12:优惠代码 15:美团立减 or(抖音立减) 17:商家立减 18:美团商家立减 21:次卡 22:打折卡 23:B端美团支付 24:全渠道会员券 25:pos支付 26:线下认款平台 28:商家折上折 29:美团分销支付
paymentDetailIdstring支付流水号
注意:2026-10-14号之前申请的到店餐饮应用,需联系技术切换至美团到店餐饮新版接口,老版接口不支持;2026-10-14号开始申请的应用自动就是新版接口,无需切换

prepareResponse字段说明#

美团服务零售:https://developer.meituan.com/docs/api/ddzh-tuangou-receipt-prepare
美团到店餐饮:https://developer.meituan.com/docs/api/tuangou-ng-coupon-msprepare

consumeResponse字段说明#

美团服务零售:https://developer.meituan.com/docs/api/ddzh-tuangou-receipt-consume
美团到店餐饮:https://developer.meituan.com/docs/api/tuangou-ng-coupon-msconsume

响应示例#

{
    "code": 200,
    "count": 0,
    "data": {
        "dealId": 702566611,
        "dealTitle": "全日卡体验 . 限购一次(08:30-23:00)",
        "mobile": "197****5316",
        "orderId": "4999020894646564834",
        "payAmount": 1990,
        "receiptCode": "4853638755",
        "verifiedReceiptCodes": ["4853638755","4853638756"]
        "result": [
            {
                "dealGroupId": 656493807,
                "dealId": 702566611,
                "dealMarketPrice": 42,
                "dealPrice": 19.9,
                "dealTitle": "全日卡体验 . 限购一次(08:30-23:00)",
                "orderId": "4999020894646564834",
                "paymentDetail": [
                    {
                        "amount": "19.9",
                        "amountType": 10,
                        "paymentDetailId": "4999021328261358368"
                    }
                ],
                "productItemId": 0,
                "receiptCode": "4853638755",
                "tgTimesCardFlag": false
            }
        ],
        "type": "1",
        "verifyCount": 1
    },
    "msg": "验证校验通过",
    "tid": "370a3977d4144814b4ef9dfd6cf99497"
}

验券成功后重复验券返回示例#

{
    "code": 204,
    "count": 0,
    "msg": "此券码已被验证,验证时间:2025-09-08 15:47:55,验证商户:XXX门店",
    "tid": "419ca5218cc849e0bb38c480bb900cbc"
}
修改于 2026-11-13 08:46:57
上一页
获取门店团购信息
下一页
撤销验券
Built with