# 美团团购券/用户可用券码查询

<div id="bkmrk-%E6%8E%A5%E5%8F%A3%E7%94%A8%E9%80%94"><div>**接口用途**</div></div><div id="bkmrk-%E6%94%AF%E4%BB%98%E5%AE%9D%E6%94%AF%E4%BB%98-%E5%BE%AE%E4%BF%A1%E8%A2%AB%E6%89%AB%E6%94%AF%E4%BB%98-%E9%93%B6%E8%A1%8C%E4%BA%8C%E7%BB%B4%E7%A0%81%E6%94%AF%E4%BB%98">- 根据用户手机号和门店查询用户在对应门店可使用的团购券

</div>### **接口地址**

<div id="bkmrk-https%3A%2F%2Febuywebposp-"><div><div><div><div>- `https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/mtTuangouUserCouponQuery`

</div></div></div></div></div>### **action**

<div id="bkmrk-qrcodesale">- mtTuangouUserCouponQuery

</div>**请求参数，中件间===&gt;易百后台**

<div id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t"><table style="width: 809px; height: 440px;"><thead><tr style="height: 46px;"><th style="width: 139px; height: 46px;">字段</th><th style="width: 167px; height: 46px;">类型</th><th style="width: 59px; height: 46px;">是否必填</th><th style="width: 113px; height: 46px;">字段意义</th><th style="width: 331px; height: 46px;">备注</th></tr></thead><tbody><tr style="height: 46px;"><td style="width: 139px; height: 46px;">traceNo</td><td style="width: 167px; height: 46px;">String(40)</td><td style="width: 59px; height: 46px;">是</td><td style="width: 113px; height: 46px;">收银机流水号</td><td style="width: 331px; height: 46px;">不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 139px;">mobile</td><td style="width: 167px;">String</td><td style="width: 59px;">是</td><td style="width: 113px;">手机号</td><td style="width: 331px;">用户在美团APP手机号</td></tr><tr><td style="width: 139px;">onlineTid</td><td style="width: 167px;">String</td><td style="width: 59px;">是</td><td style="width: 113px;">终端编号</td><td style="width: 331px;">请联系易百技术获取</td></tr></tbody></table>

</div>### **请求报文举例**

```JSON
{
  "traceNo": "11660100389202605260019995",
  "mobile": "18516319999",
  "onlineTid":"99021080"
}
```

**返回参数，易百后台===&gt;中件间**

<div id="bkmrk-%E5%8F%AF%E8%83%BD%E8%BF%94%E5%9B%9E%E6%B4%BB%E5%8A%A8%E4%BA%A7%E5%93%81%E9%80%89%E9%A1%B9%EF%BC%8C%E9%9C%80%E8%A6%81%E8%BF%9B%E8%A1%8C%E9%80%89%E6%8B%A9-%E5%AD%97%E6%AE%B5">- <span style="color: rgb(224, 62, 45);">userCouponQueryResultList请参见美团文档</span>

<table style="width: 99.7531%; height: 799.079px;"><thead><tr style="height: 46.5938px;"><th style="width: 18.0917%; height: 46.5938px;">字段</th><th style="width: 20.57%; height: 46.5938px;">类型</th><th style="width: 6.81537%; height: 46.5938px;">是否必填</th><th style="width: 15.9851%; height: 46.5938px;">字段意义</th><th style="width: 38.5378%; height: 46.5938px;">备注</th></tr></thead><tbody><tr style="height: 46.5938px;"><td style="width: 18.0917%; height: 46.5938px;">traceNo</td><td style="width: 20.57%; height: 46.5938px;">String</td><td style="width: 6.81537%; height: 46.5938px;">是</td><td style="width: 15.9851%; height: 46.5938px;">收银机流水号</td><td style="width: 38.5378%; height: 46.5938px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">orderNo</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">交易订单号</td><td style="width: 38.5378%; height: 29.7969px;">易百生成</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">transDate</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">交易时间</td><td style="width: 38.5378%; height: 29.7969px;">格式为：yyyyMMddHHmmss</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">returnCode</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">返回码</td><td style="width: 38.5378%; height: 29.7969px;">00表示交易成功，其他表示失败</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">returnDesc</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">返回信息</td><td style="width: 38.5378%; height: 29.7969px;">交易结果描述或错误原因</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">paidAmount</td><td style="width: 20.57%; height: 29.7969px;">Price</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">支付成功总金额</td><td style="width: 38.5378%; height: 29.7969px;">单位：元</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">receiptAmount</td><td style="width: 20.57%; height: 29.7969px;">Price</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">商户实收金额</td><td style="width: 38.5378%; height: 29.7969px;">单位：元</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">invoiceAmount</td><td style="width: 20.57%; height: 29.7969px;">Price</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">商户开票金额</td><td style="width: 38.5378%; height: 29.7969px;">单位：元</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">exchangeRate</td><td style="width: 20.57%; height: 29.7969px;">Number(8,6)</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">汇率</td><td style="width: 38.5378%; height: 29.7969px;">1外币等于多少人民币</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">currency</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">货币类型</td><td style="width: 38.5378%; height: 29.7969px;">例如:CNY</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">discountCode</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">折扣编码</td><td style="width: 38.5378%; height: 29.7969px;">由收银机分配，用于入账计折扣类型</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">discountNum</td><td style="width: 20.57%; height: 29.7969px;">Number</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">固定金额折扣数量</td><td style="width: 38.5378%; height: 29.7969px;">用于入账计折扣类型的数量</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">tenderCode</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">支付方式编码</td><td style="width: 38.5378%; height: 29.7969px;">由收银机分配，用于入账计支付方式</td></tr><tr style="height: 46.5938px;"><td style="width: 18.0917%; height: 46.5938px;">remainTimes</td><td style="width: 20.57%; height: 46.5938px;">Number</td><td style="width: 6.81537%; height: 46.5938px;">是</td><td style="width: 15.9851%; height: 46.5938px;">券码当前可用次数</td><td style="width: 38.5378%; height: 46.5938px;">如果有限制每天使用多少次，代表当天可使用次数</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">activityProductNo</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">活动产品编号</td><td style="width: 38.5378%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">activityProductName</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">活动产品名称</td><td style="width: 38.5378%; height: 29.7969px;">  
</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">goodsDetail</td><td style="width: 20.57%; height: 35.3906px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">折抵产品明细</td><td style="width: 38.5378%; height: 35.3906px;">返回后台已抵扣成功的产品明细</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">fundChannel</td><td style="width: 20.57%; height: 35.3906px;">List&lt;[fundChannel](https://book.e-buy.com/books/e-buy-B6z/page/14bfa "fundChannel")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">资金渠道</td><td style="width: 38.5378%; height: 35.3906px;">  
</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">printDetail</td><td style="width: 20.57%; height: 35.3906px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">打印信息</td><td style="width: 38.5378%; height: 35.3906px;">如需要在收银小票上打印信息时必填</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">memberDetail</td><td style="width: 20.57%; height: 35.3906px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">会员信息</td><td style="width: 38.5378%; height: 35.3906px;">返回本次交易的会员信息</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">voucherDetail</td><td style="width: 20.57%; height: 35.3906px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">优惠券信息</td><td style="width: 38.5378%; height: 35.3906px;">返回本次交易的优惠券信息</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">remainAmount</td><td style="width: 20.57%; height: 29.7969px;">Number</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">消费后卡余额</td><td style="width: 38.5378%; height: 29.7969px;">单位：元</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">extendsData</td><td style="width: 20.57%; height: 35.3906px;">Object&lt;[extendsData](https://book.e-buy.com/books/e-buy-B6z/page/06905 "extendsData")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">扩展信息</td><td style="width: 38.5378%; height: 35.3906px;">与ebuy约定</td></tr><tr><td style="width: 18.0917%;">transType</td><td style="width: 20.57%;">String</td><td style="width: 6.81537%;">是</td><td style="width: 15.9851%;">标识当笔交易类型</td><td style="width: 38.5378%;">下发alipayQrpay 表示 支付宝二维码支付业务</td></tr><tr><td style="width: 18.0917%;"><span style="color: rgb(224, 62, 45);">userCouponQueryResultList</span></td><td style="width: 20.57%;">List&lt;UserCouponQueryResult&gt;</td><td style="width: 6.81537%;">是</td><td style="width: 15.9851%;">用户团购券查询结果</td><td style="width: 38.5378%;">请参见：[可用券查询（小程序核销必接）-美团技术服务合作中心](https://developer.meituan.com/docs/biz/biz_dishconnect_9b0826f8-e4c6-4272-a365-a8692dc15898)

字段请参考UserCouponQueryResult

</td></tr></tbody></table>

</div>### **返回报文举例**

```JSON
{
	"receiptAmount":0,
	"returnCode":"00",
	"orderNo":"206200131092",
	"extendsData":{},
	"userCouponQueryResultList":[
		{
			"sqtInfo":{
				"sqtOrder":2,
				"sqtNeedInvoice":2
			},
			"dealSkuMappingDetail":{
				"count":1,
				"vendorSkus":[
					"10004"
				]
			},
			"orderId":"5026046803269241588",
			"dealId":1651648032,
			"dealRuleCouponLimit":-1,
			"dealValue":12.0,
			"dealTitle":"点评荠菜生煎",
			"couponBuyPlatform":10,
			"dealPrice":11.9,
			"dealMenu":[
				[
					{
						"type":"0",
						"content":"生煎",
						"notDishes":false
					},
					{
						"images":[
							"[]"
						],
						"total":"12",
						"price":"12",
						"specification":"1 份",
						"type":"128",
						"content":"荠菜生煎4只"
					}
				]
			],
			"dealType":2,
			"couponEndTime":1782316799000,
			"realAmount":11.9,
			"canShareOtherPromotion":false,
			"couponStartTime":1781193600000,
			"dealIdLong":1651648032,
			"poiDealTitle":"点评荠菜生煎",
			"couponCode":"77029426332281"
		}
	],
	"traceNo":"11660100389202606160019991",
	"transDate":"20260616103615",
	"invoiceAmount":0,
	"paidAmount":0,
	"returnDesc":"交易成功"
}
```