获取优惠券

接口调用请求说明

http请求方式:POST
https://api.weixin.qq.com/product/coupon/get?access_token=xxxxxxxxx

请求参数示例

{
    "coupon_id":12639900
}

回包示例

{
    "errcode": 0,
    "coupon": {
        "coupon_id": 12639900,
        "type": 103,
        "status": 5,
        "create_time": "2020-07-16 15:43:05",
        "update_time": "2020-07-16 15:58:47",
        "coupon_info": {
            "name": "scs",
            "promote_info": {
                "promote_type": "PROMOTE_TYPE_CUSTOMIZE",
                "customize_channel": "sc"
            },
            "discount_info": {
                "discount_num": 9900
            },
            "valid_info": {
                "valid_type": "COUPON_VALID_TYPE_TIME",
                "valid_day_num": 0,
                "start_time": "2020-07-16 00:00:00",
                "end_time": "2020-07-23 00:00:00"
            }
        },
        "stock_info": {}
    }
}

请求参数说明

参数 类型 是否必填 说明
coupon_id number 优惠券id

回包参数说明

参数 类型 说明
errcode number 错误码
errmsg string 错误信息
coupon.coupon_id number 优惠券
coupon.type number 优惠券类型
coupon.status number 优惠券状态
coupon.create_time string 优惠券创建时间
coupon.update_time string 优惠券更新时间
coupon.coupon_info.name string 优惠券名称
coupon.coupon_info.valid_info.valid_type string 优惠券有效期类型, 见下表
coupon.coupon_info.valid_info.valid_day_num number 优惠券有效天数,valid_type=2时才有意义
coupon.coupon_info.valid_info.start_time string 优惠券有效期开始时间,valid_type=1时才有意义
coupon.coupon_info.valid_info.end_time string 优惠券有效期结束时间,valid_type=1时才有意义
coupon.coupon_info.promote_info.promote_type string 推广类型,见下表
coupon.coupon_info.promote_info.customize_channel string 自定义推广渠道具体内容,promote_type=2时才有意义
coupon.stock_info.issued_num number 优惠券剩余量
coupon.stock_info.receive_num number 优惠券领用量
coupon.stock_info.used_num number 优惠券已用量
coupon.coupon_info.discount_info.discount_num number 优惠券折扣数 * 1000, 例如 5.1折-> 5100
coupon.coupon_info.discount_info.discount_fee number 优惠券减少金额, 单位分, 例如0.5元-> 50
coupon.coupon_info.discount_info.discount_condition.product_cnt number 优惠券使用条件, 满x件商品可用
coupon.coupon_info.discount_info.discount_condition.product_price number 优惠券使用条件, 价格满x可用,单位分
coupon.coupon_info.discount_info.discount_condition.product_ids[] number array 优惠券使用条件, 指定商品id可用
coupon.coupon_info.ext_info.invalid_time string 优惠券失效时间
coupon.coupon_info.ext_info.jump_product_id number 商品折扣券领取后跳转的商品id
coupon.coupon_info.ext_info.notes string 备注信息
coupon.coupon_info.ext_info.valid_time string 优惠券有效时间
coupon.coupon_info.receive_info.end_time string 优惠券领用结束时间
coupon.coupon_info.receive_info.limit_num_one_person number 单人限领张数
coupon.coupon_info.receive_info.start_time string 优惠券领用开始时间
coupon.coupon_info.receive_info.total_num number 优惠券领用总数

枚举-type

枚举值 描述
1 商品条件折扣券
2 商品满减券
3 商品统一折扣券
4 商品直减券
101 店铺条件折扣券
102 店铺满减券
103 店铺统一折扣券
104 店铺直减券

枚举-promote_type

枚举字段名 枚举值 描述
PROMOTE_TYPE_SHOP 1 店铺内推广
PROMOTE_TYPE_CUSTOMIZE 2 自定义推广渠道
PROMOTE_TYPE_TARGET 3 定向优惠

枚举-valid_type

枚举字段名 枚举值 描述
COUPON_VALID_TYPE_TIME 1 商品指定时间区间
COUPON_VALID_TYPE_DAY 2 生效天数

返回码

返回码 错误类型
-1 系统异常
-2 token太长
9401020 参数有误