查券和验券
接口说明
type 传入不同值实现不同能力注意事项
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | http://wspacebot.yunfeiwork.com/wspace-openapi/partner/tuangou/receipt/consume?access_token=ACCESS_TOKEN |
| HTTP Method | POST |
请求参数
请求头
| 参数名 | 参数值 | 必填 |
|---|---|---|
| content-type | application/json | 是 |
Body
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| receiptCode | string | 是 | 团购券码，必须未验证，支持数字券码、抖音券码短链 |
| opPoiId | string | 是 | 云飞API侧门店ID |
| platform | string | 否 | 团购平台：meituan=美团（大众点评），douyin=抖音，kuaishou=快手（如果没传值则默认美团） |
| type | string | 否 | 验券类型：1=验券前准备（查券）， 2=确认验券（核销券）（如果没传值则默认确认验券） |
| verifyCount | int | 是 | type=1 不传 type=2（确认验券时必传，不传则默认取验券前准备返回的总数） |
请求示例
{
"opPoiId": "xxxx",
"receiptCode": "13565635289",
"platform":"meituan",
"type":"1"
}响应参数
Body
| 参数名 | 类型 | 说明 |
|---|---|---|
| dealId | long | 套餐ID（美团门店使用） |
| dealGroupId | long | 团购ID（美团门店使用） |
| skuId | string | 抖音的团购商品ID（抖音门店使用） |
| thirdSkuId | string | 商家系统（第三方）商品id（抖音、美团餐饮门店使用） |
| dealTitle | long | 商品名称 |
| mobile | string | 掩码手机号，例如：197****5316 |
| receiptCode | string | 团购券码 |
| verifiedReceiptCodes | arrays | 一次核销多张券时会返回 |
| type | string | 验券类型，源自请求入参的type字段 |
| verifyCount | int | type=1：表示当前可验证的券码总数量 type=2：表示已经验证成功的券码数量 |
| orderId | string | 订单编号（注意：新版授权后美团到店综合类门店在查券时不返回orderId，只有验券成功后才返回） |
| payAmount | int | 支付金额（单位：分） |
| originCode | string | 原始数字券码，适用于抖音扫码通过短链核销时返回 |
| result | arrays | 验券返回结果 |
result集合字段
| 参数名 | 类型 | 说明 |
|---|---|---|
| dealId | long | 套餐ID |
| dealGroupId | long | 团购ID |
| skuId | string | 抖音的团购商品ID（抖音返回） |
| thirdSkuId | string | 商家系统（第三方）商品id（抖音、美团餐饮门店使用） |
| dealMarketPrice | double | （团购）套餐原价 |
| dealPrice | double | （团购）套餐价格 |
| dealTitle | long | 商品名称 |
| orderId | string | 订单编号（注意：新版授权后美团到店综合类门店在查券时不返回orderId，只有验券成功后才返回） |
| paymentDetail | arrays | 支付信息 |
| productItemId | long | |
| receiptCode | string | 券码 |
| tgTimesCardFlag | boolean | 默认 false ,暂无业务含义 |
paymentDetail集合字段
| 参数名 | 类型 | 说明 |
|---|---|---|
| amount | string | 支付金额 |
| amountType | int | 金额类型：10=顾客实付金额 |
| paymentDetailId | string | 支付流水号 |
响应示例
{
"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-07-21 04:07:46