# 获取用户优惠券列表
# 接口调用请求说明
http请求方式：POST
https://api.weixin.qq.com/product/coupon/get_user?access_token=xxxxxxxxx
# 请求参数示例
{
"openid": "I_AM_JUST_AN_EXAMPLE",
"status": 100
}
# 回包示例
{
"errcode": 0,
"user_coupon_list":
[
{
"coupon_id": 12639900,
"status": "COUPON_USER_STATUS_VALID",
"create_time": "2020-05-30 00:00:00",
"update_time": "2020-05-30 12:00:00",
"start_time": "2020-05-30 18:00:00",
"end_time": "2020-05-30 20:00:00",
"ext_info":
{
"use_time": "2020-05-30 19:00:00"
},
"order_id": 123,
"discount_fee": 123
}
]
}
# 请求参数说明
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| openid | string | 是 | 用户openid |
| status | number | 否 | 优惠券状态，不填时获取所有优惠券，填时获取特定状态优惠券 |
# 回包参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息，errcode为0不返回 |
| user_coupon_list[].coupon_id | number | 优惠券 |
| user_coupon_list[].status | string | 优惠券状态 |
| user_coupon_list[].create_time | string | 优惠券派发时间 |
| user_coupon_list[].update_time | string | 优惠券更新时间 |
| user_coupon_list[].start_time | string | 优惠券生效时间 |
| user_coupon_list[].end_time | string | 优惠券失效时间 |
| user_coupon_list[].ext_info.use_time | string | 优惠券核销时间 |
| user_coupon_list[].order_id | number | 优惠券使用的订单id |
| user_coupon_list[].discount_fee | number | 优惠券金额 |
# 枚举-status
| 枚举字段 | 枚举值 | 描述 |
|---|---|---|
| COUPON_USER_STATUS_VALID | 100 | 生效中 |
| COUPON_USER_STATUS_EXPIRED | 101 | 已过期 |
| COUPON_USER_STATUS_USED | 102 | 已使用 |
# 返回码
| 返回码 | 错误类型 |
|---|---|
| -1 | 系统异常 |
| -2 | token太长 |
| 109137 | openid 格式有误或不合法 |
| 9401020 | 参数有误 |