微信公众平台开发者文档 / 微信卡券投放

微信卡券投放

设置门店卡券投放信息

1475897626347314.jpg

 调用设置门店卡劵投放信息接口后,用户可在连网流程中关注商家公众号之后,领取配置的卡券。需设置卡劵ID,投放的有效时间等。

  注:需要先创建卡劵后,才能获取卡劵ID。创建并获取的方法有:

     1、在公众平台创建。登录公众平台,在卡券功能插件中创建卡券,再在优惠券列表中选择卡券点击详情,在详情页中可获取到卡券ID。

     2、调用微信卡劵“创建卡劵”接口,设置卡劵信息,获取卡券ID。

  接口调用说明

协议:https
http请求方式: POST
请求URL: https://api.weixin.qq.com/bizwifi/couponput/set?access_token=ACCESS_TOKEN    
POST数据格式:JSON

请求参数说明

参数是否必须说明
access_token调用接口凭证
POST数据JSON数据

POST数据

数据示例:

{
  "shop_id":429620
  "card_id":"pBnTrjvZJXkZsPGwfq9F0Hl0WqE",
  "card_describe":"10元代金券",
  "start_time":1457280000,
  "end_time":1457712000,
  "card_quantity":10
}

字段说明:

字段是否必填说明
shop_id门店ID,可设置为0,表示所有门店
card_id卡券ID
card_describe卡券描述,不能超过18个字符
start_time卡券投放开始时间(单位是秒)
end_time

卡券投放结束时间(单位是秒)

注:不能超过卡券的有效期时间

card_quantity卡券库存

返回数据说明 

正确返回JSON数据示例:

{
  "errcode": 0, }

查询门店卡券投放信息

  通过此接口查询某一门店的详细卡券投放信息,包括卡券投放状态,卡券ID,卡券的投放时间等信息。

  接口调用说明

协议:https
http请求方式: POST
请求URL: https://api.weixin.qq.com/bizwifi/couponput/get?access_token=ACCESS_TOKEN
POST数据格式:JSON

请求参数说明

参数是否必须说明
access_token调用接口凭证
POST数据JSON数据

POST数据

数据示例:

{
  "shop_id":429620
}

字段说明:

字段是否必填说明
shop_id门店ID,可设置为0,表示所有门店

返回数据说明 

正确返回JSON数据示例:

{
   "errcode": 0,
   "data": {
      "shop_id": 429620,
      "card_status": 1,
      "card_id": "pBnTrjqf95sZLOxN5gf_EkHwyxiw",
      "card_describe": "10元代金券",
      "start_date": 1457712000,
      "end_date": 1457712000
    }
 }

字段说明:

start_time字段说明
shop_id门店ID
card_id卡券ID
card_status卡券投放状态(0表示生效中,1表示未生效,2表示已过期)
card_describe卡券描述
start_time卡券投放开始时间(单位是秒)
end_time卡券投放结束时间(单位是秒)