获取用户优惠券详情 | 微信开放文档

# 获取用户优惠券详情

# 接口说明

通过此接口可获取用户优惠券详情。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/coupon/get_user_coupon?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	描述
openid	string	是	用户openid
user_coupon_id	string	是	用户优惠券ID

# 请求参数示例

{
    "openid": "OPENID",
    "user_coupon_id": "109694341"
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息，errcode为0不返回
openid	string	用户openid
unionid	string	用户unionid，小店接入open平台后生成的用户券会返回
user_coupon_list[].user_coupon_id	string	用户优惠券ID
user_coupon_list[].coupon_id	string	优惠券ID
user_coupon_list[].status	number	优惠券状态，枚举值详情请参考status
user_coupon_list[].create_time	number	优惠券派发时间
user_coupon_list[].update_time	number	优惠券更新时间
user_coupon_list[].start_time	number	优惠券生效时间
user_coupon_list[].end_time	number	优惠券失效时间
user_coupon_list[].ext_info.use_time	number	优惠券核销时间
user_coupon_list[].order_id	string	优惠券使用的订单id
user_coupon_list[].discount_fee	number	优惠券金额

# 返回参数示例

{
    "errcode": 0,
    "openid": "OPENID",
    "unionid": "UNIONID",
    "user_coupon": {
        "user_coupon_id": "109694341",
        "coupon_id": "12639900",
        "status": 100,
        "create_time": 1590768000,
        "update_time": 1590811200,
        "start_time": 1590832800,
        "end_time": 1590840000,
        "ext_info": {
            "use_time": 1590836400
        },
        "order_id": "123",
        "discount_fee": 123
    }
}

# 错误码

错误码	错误描述
公共错误码	-
40003	OpenID不正确
10021037	优惠券不存在

# 枚举值

# status

优惠券状态

枚举字段	枚举值	描述
COUPON_USER_STATUS_VALID	100	生效中
COUPON_USER_STATUS_EXPIRED	101	已过期
COUPON_USER_STATUS_USED	102	已使用