获取用户优惠券列表

接口调用请求说明

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