获取用户优惠券列表 | 微信开放文档

# 获取用户优惠券列表

# 接口调用请求说明

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	参数有误