WeChat 공개 플랫폼 개발자 문서
/ 微信卡券投放
微信卡券投放
设置门店卡券投放信息
调用设置门店卡劵投放信息接口后,用户可在连网流程中关注商家公众号之后,领取配置的卡券。需设置卡劵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 | 卡券投放结束时间(单位是秒) |