最新更新时间：2019.09.29 版本说明
可通过该接口查询用户在某商户号可用的全部券，可用于商户的小程序/H5中，用户"我的代金券"或"提交订单页"展示优惠信息。无法查询到微信支付立减金。本接口查不到用户的微信支付立减金（又称“全平台通用券”），即在所有商户都可以使用的券，例如：摇摇乐红包；当按可用商户号查询时，无法查询用户已经核销的券
适用对象：直连商户
请求URL：https://api.mch.weixin.qq.com/v3/marketing/favor/users/{openid}/coupons
请求方式：GET
接口频率：不区分来源 2000/s 单ip 500/s
接口耗时：平均100ms以内
幂等规则：接口支持幂等重入
path指该参数为路径参数
query 指该参数需在请求URL传参
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 用户标识 | openid | string[1,128] | 是 | path 用户在商户appid 下的唯一标识。 校验规则：该openid需要与接口传入中的appid有对应关系。 示例值：2323dfsdf342342 |
| 公众账号ID | appid | string[1,128] | 是 | query 微信为发券方商户分配的公众账号ID，接口传入的所有appid应该为公众号的appid（在mp.weixin.qq.com申请的）或APP的appid（在open.weixin.qq.com申请的）。 校验规则： 1、该appid需要与接口传入中的openid有对应关系； 2、该appid需要与调用接口的商户号（即请求头中的商户号）有绑定关系，若未绑定，可参考该指引完成绑定（商家商户号与AppID账号关联管理） 示例值：wx233544546545989 |
| 批次号 | stock_id | string[1,20] | 否 | query 批次号，是否指定批次号查询，填写available_mchid，该字段不生效。 示例值：9865000 |
| 券状态 | status | string[1,20] | 否 | query 代金券状态： 选填creator_mchid时， SENDED：返回可用 USED：返回可用+已实扣 选填available_mchid时，该字段不生效，仅返回 可用 状态的券。 示例值：SENDED |
| 创建批次的商户号 | creator_mchid | string[1,20] | 三选一 | query 批次创建方商户号。 示例值：9865002 请求参数传创建商户号返回除过期以外所有状态的用户券 |
| 批次发放商户号 | sender_mchid | string[1,20] | query 批次发放商户号 （该字段暂未开放） 示例值：9865001 |
|
| 可用商户号 | available_mchid | string[1,20] | query 可用商户号 示例值: 9865000 请求参数传核销商户号只能返回可用的代金券，实扣的与过期的无法返回 |
|
| 分页页码 | offset | uint32 | 否 | query 分页页码，默认0，填写available_mchid，该字段不生效。 示例值：0 |
| 分页大小 | limit | uint32 | 否 | query 分页大小，默认20，填写available_mchid，该字段不生效。 示例值：20 |
https://api.mch.weixin.qq.com/v3/marketing/favor/users/2323dfsdf342342/coupons?appid=wx233544546545989
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| +结果集 | data | array |
否 | 结果集 |
| 查询结果总数 | total_count | uint32 | 是 | 查询结果总数 示例值：100 |
| 分页大小 | limit | uint32 | 是 | 分页大小 示例值：10 |
| 分页页码 | offset | uint32 | 是 | 分页页码 示例值：10 |
{
"data": [{
"stock_creator_mchid": "9800064",
"stock_id": "9865888",
"coupon_id": "98674556",
"cut_to_message": {
"single_price_max": 100,
"cut_to_price":100
},
"coupon_name": "微信支付代金券",
"status": "SENDED",
"description": "微信支付营销",
"create_time": "2015-05-20T13:29:35+08:00",
"coupon_type": "CUT_TO",
"no_cash": true,
"available_begin_time": "2015-05-20T13:29:35+08:00",
"available_end_time": "2015-05-20T13:29:35+08:00",
"singleitem": true,
"normal_coupon_information": {
"coupon_amount": 100,
"transaction_minimum": 100
},
"consume_information": {
"consume_time": "2015-05-20T13:29:35+08:00",
"consume_mchid": "9856081",
"transaction_id": "2345234523",
"goods_detail": [{
"goods_id": "a_goods1",
"quantity": 7,
"price": 1,
"discount_amount": 4
}]
}
}],
"total_count": 100,
"limit": 10,
"offset": 10
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 回调url不能为空 | 请填写回调url |
| PARAM_ERROR | 回调商户不能为空 | 请填写回调商户 | |
| PARAM_ERROR | 券id必填 | 请填写券id | |
| PARAM_ERROR | appid必填 | 请输入appid | |
| PARAM_ERROR | openid必填 | 请输入openid | |
| PARAM_ERROR | 页大小超过阈值 | 请不要超过最大的页大小 | |
| PARAM_ERROR | 输入时间格式错误 | 请输入正确的时间格式 | |
| PARAM_ERROR | 批次号必填 | 请输入批次号 | |
| PARAM_ERROR | 商户号必填 | 请输入商户号 | |
| PARAM_ERROR | 非法的批次状态 | 请检查批次状态 | |
| 400 | MCH_NOT_EXISTS | 商户号不合法 | 请输入正确的商户号 |
| 400 | INVALID_REQUEST | openid与appid不匹配 | 请使用appid下的openid |
| INVALID_REQUEST | 活动已结束或未激活 | 请检查批次状态 | |
| INVALID_REQUEST | 非法的商户号 | 请检查商户号是否正确 | |
| 400 | APPID_MCHID_NOT_MATCH | 商户号与appid不匹配 | 请绑定调用接口的商户号和appid后重试 |
| 403 | USER_ACCOUNT_ABNORMAL | 用户非法 | 该用户账号异常，无法领券。商家可联系微信支付或让用户联系微信支付客服处理。 |
| 403 | NOT_ENOUGH | 批次预算不足 | 请补充预算 |
| 403 | REQUEST_BLOCKED | 调用商户无权限 | 请开通产品权限后再调用该接口 |
| REQUEST_BLOCKED | 商户无权发券 | 调用接口的商户号无权发券，请检查是否是自己的批次或是已授权的批次。 | |
| REQUEST_BLOCKED | 批次不支持跨商户发券 | 该批次未做跨商户号的授权，请授权后再发放 | |
| REQUEST_BLOCKED | 用户被限领拦截 | 用户领取已经达到上限，请调高上限或停止发放。 | |
| 404 | RESOURCE_NOT_EXISTS | 批次不存在 | 请检查批次ID是否正确 |
| 429 | FREQUENCY_LIMIT_EXCEED | 接口限频 | 请降低调用频率 |