# Get a coupon

# Dxplaination of Interface Call Request

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

# Example of request parameters

{
    "coupon_id":12639900
}

# Examples of back-up

{
    "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": {}
    }
}

# Dxplaination of request parameters

参数 type Is it compulsory? Introductions
coupon_id number yes Coupon id

# Dxplaination of callback parameters

参数 type Introductions
errcode number Error code
errmsg string Error message
coupon.coupon_id number Coupon
coupon.type number Types of coupons
coupon.status number Coupon Status
coupon.create_time string Coupon creation time
coupon.update_time string Coupon updated when
coupon.coupon_info.name string Coupon Name
coupon.coupon_info.valid_info.valid_type string For the type of coupon validity period, see the table below
coupon.coupon_info.valid_info.valid_day_num number The number of days the coupon is valid, valid_type = 2 is meaningful
coupon.coupon_info.valid_info.start_time string Coupon validity start time, valid_type = 1 is meaningful
coupon.coupon_info.valid_info.end_time string Valid_type = 1.
coupon.coupon_info.promote_info.promote_type string For the type of promotion, see the table below
coupon.coupon_info.promote_info.customize_channel string Custom promotion channel specific content, promote_type = 2 when it makes sense
coupon.stock_info.issued_num number Coupon surplus
coupon.stock_info.receive_num number Amount of coupons received
coupon.stock_info.used_num number Coupons have been used
coupon.coupon_info.discount_info.discount_num number Number of coupon discounts * 1000, e.g. 5.1 off - 5100
coupon.coupon_info.discount_info.discount_fee number The coupon reduces the amount, in units, such as 0.5 yuan - > 50
coupon.coupon_info.discount_info.discount_condition.product_cnt number Coupon conditions, full x items available
coupon.coupon_info.discount_info.discount_condition.product_price number Coupon conditions of use, price full x available, unit points
coupon.coupon_info.discount_info.discount_condition.product_ids[] number array Voucher conditions of use, specified product id available
coupon.coupon_info.ext_info.invalid_time string Expiry time of coupon
coupon.coupon_info.ext_info.jump_product_id number The product id of the jump after receiving the discount coupon
coupon.coupon_info.ext_info.notes string Note information
coupon.coupon_info.ext_info.valid_time string When the coupon is valid
coupon.coupon_info.receive_info.end_time string Coupon Acceptance End Time
coupon.coupon_info.receive_info.limit_num_one_person number Limit on number of tickets per person
coupon.coupon_info.receive_info.start_time string Coupon Acceptance Start Time
coupon.coupon_info.receive_info.total_num number Total number of coupons received

# Enumeration - type

枚举值 describe
1 Product conditions discount coupons
2 Product full coupons reduced
3 Uniform discount coupons for goods
4 Product direct coupons
101 Shop conditions Discount vouchers
102 Shops are full of coupons.
103 Uniform store discount coupons
104 Shop direct discount coupons

# Enumeration - promote_type

枚举字段名 The enumeration value describe
PROMOTE_TYPE_SHOP 1 In-store promotion
PROMOTE_TYPE_CUSTOMIZE 2 Custom Promotion Channels
PROMOTE_TYPE_TARGET 3 Targeted Offers

# Enumeration - valid_type

枚举字段名 The enumeration value describe
COUPON_VALID_TYPE_TIME 1 Specify a time period for a product
COUPON_VALID_TYPE_DAY 2 Number of days in effect

# Return code

返回码 Error Type
-1 System exceptions
-2 Token too long
9401020 The parameter is incorrect.