微信卡卷总结
2016-01-04 17:11
501 查看
1、上传LOGO测试方法，在linux服务器ssh中执行：
curl -F buffer=@logo.png "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=TOKEN"
logo.png：图片名称
Token：服务号AccessToken
2、创建卡卷：
接口地址：https://api.weixin.qq.com/card/create?access_token=TOKEN
报文内容：
{
"card": {
"card_type": "GENERAL_COUPON",
"general_coupon": { //注，此节点名称必须与上面card_type值相同，也TM是个坑
"base_info": {
"logo_url": "http://mmbiz.qpic.cn/mmbiz/lprtsiabGHGz8DfXbIXKhqBuLcuv2SvkguEBBXVwQCI3khyv3IicCxyo0a843ryXwjxicmiaTpGdzyVBUznPzvxKZQ/0",
"brand_name": "我们爱健康",
"code_type": "CODE_TYPE_TEXT",
"title": "和田红枣卷",
"sub_title": "购买只需0.1元",
"color": "Color010",
"notice": "购买时请录入优惠码",
"description": "需要自负邮费，消费金额到达79元可免邮费",
"date_info": {
"type": "DATE_TYPE_FIX_TIME_RANGE",
"begin_timestamp": 1420041600,
"end_timestamp": 1451577599
},
"sku": {
"quantity": 0
},
"get_limit": 1,
"use_custom_code": true,
"get_custom_code_mode":"GET_CUSTOM_CODE_MODE_DEPOSIT", //填入该字段后，自定义code卡券方可进行导入code并投放的动作。坑，狗日的文档里在后面一个地方才标出来
"bind_openid": false,
"can_share": false,
"can_give_friend": false,
"center_title": "快速购买",
"center_sub_title": "立刻把和田枣带回家",
"center_url": "www.j1.com",
"custom_url_name": "立即使用",
"custom_url": "http://www.j1.com",
"custom_url_sub_title": "去键一网购买",
"promotion_url_name": "更多活动",
"promotion_url": "http://www.ijkang.com.",
"source": "我们爱健康"
},
"default_detail": "1分钱购买" //注：当前节点名称根本不同卡卷类型会有所不同
}
}
}
自定义卡卷导入注意事项：
步骤一：创建预存模式卡券，将库存quantity初始值设置为0(一定要设置为0，不然后面投放时会报错，腾讯这垃圾文档埋坑)，并填入get_custom_code_mode字段；
步骤二：待卡券通过审核后，调用导入code接口并核查code；
步骤三：调用修改库存接口，须令卡券库存小于或等于导入code的数目。（为了避免混乱建议设置为相等）
参数备注：
card_type:团购卷：GROUPON；代金券：CASH；折扣券：DISCOUNT；礼品券：GIFT；优惠券：GENERAL_COUPON
团购券节点参数：
base_info：
deal_detail：团购券专用，团购详情。
代金券节点参数：
base_info：
least_cost：代金券专用，表示起用金额（单位为分）,如果无起用门槛则填0
reduce_cost：代金券专用，表示减免金额。（单位为分）
折扣券：
base_info：
discount：折扣券专用，表示打折额度（百分比）。填30就是七折。
礼品券：
base_info：
gift：礼品券专用，填写礼品的名称。如： 可兑换音乐木盒一个。
优惠券：
base_info：
default_detail：优惠券专用，填写优惠详情。音乐木盒。
base_info节点参数：
logo_url(必填):卡券的商户logo，建议像素为300*300。如：http://mmbiz.qpic.cn/
code_type(必填):CODE_TYPE_TEXT，Code展示类型，"CODE_TYPE_TEXT"，文本；"CODE_TYPE_BARCODE"，一维码 ；"CODE_TYPE_QRCODE"，二维码；"CODE_TYPE_ONLY_QRCODE",二维码无code显示；"CODE_TYPE_ONLY_BARCODE",一维码无code显示；CODE_TYPE_NONE，不显示code和条形码类型，须开发者传入"立即使用"自定义cell完成线上券核销。
brand_name(必填):商户名字,字数上限为12个汉字。如：海底捞
title(必填):卡券名，字数上限为9个汉字。(建议涵盖卡券属性、服务及金额)。如：双人套餐100元兑换券
sub_title(非必填):券名，字数上限为18个汉字。如：鸳鸯锅底+牛肉1份+土豆一份
color(必填):券颜色。按色彩规范标注填写Color010-Color100。详情见获取颜色列表接口，如：Color010
notice(必填):卡券使用提醒，字数上限为16个汉字。如：请出示二维码核销卡券
description(必填):卡券使用说明，字数上限为1024个汉字。如：不可与其他优惠同享/n如需团购券发票，请向店员提出要求。
sku(必填):商品信息。Json结构,见上述示例。
use_custom_code：是否指定卷码（自定义卷码），true：是，仅支持API创建，false：否，支持API创建、公众平台创建（默认为非自定义Code码）
bind_openid(非必填):是否指定用户领取，填写true或false。默认为false。通常指定特殊用户群体投放卡券或防止刷券时选择指定用户领取。
can_share：卡券领取页面是否可分享。参数：true：可分享，false：不可分享。
can_give_friend：卡券是否可转赠。true：可转赠，false：不可转赠
get_limit（非必填）：每人可领券的数量限制,不填写默认为50。如：1
quantity(必填):卡券库存的数量，上限为100000000。如：100000
date_info(必填):使用日期，有效期的信息。Json结构,见上述示例。
type(必填):DATE_TYPE_FIX_TERM表示固定时长（自领取后按天算。使用时间的类型，旧文档采用的1和2依然生效。DATE_TYPE_FIX_TIME_RANGE 表示固定日期区间，
begin_timestamp(必填):表示起用时间。从1970年1月1日00:00:00至起用时间的秒数，最终需转换为字符串形态传入。（东八区时间，单位为秒）type为DATE_TYPE_FIX_TIME_RANGE时专用，如：14300000
end_timestamp(必填):表示结束时间，建议设置为截止日期的23:59:59过期。（东八区时间，单位为秒）如：15300000
fixed_term(必填):type为DATE_TYPE_FIX_TERM时专用，表示自领取后多少天内有效，不支持填写0。
fixed_begin_term(必填): type为DATE_TYPE_FIX_TERM时专用，表示自领取后多少天开始生效，领取后当天生效填写0。（单位为天）如：0
end_timestamp(非必填):可用于DATE_TYPE_FIX_TERM时间类型，表示卡券统一过期时间，建议设置为截止日期的23:59:59过期。（东八区时间，单位为秒），设置了fixed_term卡券，当时间达到end_timestamp时卡券统一过期。如：15300000
source:第三方来源名，如：大众点评
3、卡卷导入：
接口地址：http://api.weixin.qq.com/card/code/deposit?access_token=TOKEN
核查导入卡卷：http://api.weixin.qq.com/card/code/checkcode?access_token=TOKEN
报文格式
{
"card_id": "p-yZQwiiz3Be8hdf_15xKtXM2HJc", //创建时的卡卷号
"code": [ //导入的自定义编码
"11111",
"22222",
"33333",
"44444",
"55555"
]
}
4、修改卡卷库存：
https://api.weixin.qq.com/card/modifystock?access_token=TOKEN
{
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc", //卡卷ID
"increase_stock_value": 1231231, //增加多少存存，非必填，不可填0
"reduce_stock_value": 1231231 //减少多少库存，非必填，不可填0
}
cardid：需要进行导入code的卡券ID。
code：需导入微信卡券后台的自定义code，上限为100个。
4、卡卷核销：
通过卡卷跳转到外部链接会拼上参数：
card_id=p-yZQwrZrQemMhqVYQLtkoYktA-E
encrypt_code=pd0vTUHSHc9tMUCL2gXABcUmINm6yxqJh0y9Phsy63E%3D
openid=o-yZQwhCG1_x9bM52-y4pF69Fwgc
如：http://m.j1.com/?card_id=p-yZQwrZrQemMhqVYQLtkoYktA-E&encrypt_code=pd0vTUHSHc9tMUCL2gXABcUmINm6yxqJh0y9Phsy63E%3D&openid=o-yZQwhCG1_x9bM52-y4pF69Fwgc
在线解密卡卷接口：https://api.weixin.qq.com/card/code/decrypt?access_token=TOKEN
参数(注：直接从URL中拷贝出来记得进行DECODE解码)：
{
"encrypt_code":"pd0vTUHSHc9tMUCL2gXABcUmINm6yxqJh0y9Phsy63E="
}
返回：
{
"errcode":0,
"errmsg":"ok",
"code":"751234212312" //解密后真实CODE
}
核销接口：
https://api.weixin.qq.com/card/code/consume?access_token=TOKEN
{
"code": "ZYF670F61E",
"card_id": "p-yZQwhITydjFEBGnbJUA37uPy7A"
}
curl -F buffer=@logo.png "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=TOKEN"
logo.png：图片名称
Token：服务号AccessToken
2、创建卡卷：
接口地址：https://api.weixin.qq.com/card/create?access_token=TOKEN
报文内容：
{
"card": {
"card_type": "GENERAL_COUPON",
"general_coupon": { //注，此节点名称必须与上面card_type值相同，也TM是个坑
"base_info": {
"logo_url": "http://mmbiz.qpic.cn/mmbiz/lprtsiabGHGz8DfXbIXKhqBuLcuv2SvkguEBBXVwQCI3khyv3IicCxyo0a843ryXwjxicmiaTpGdzyVBUznPzvxKZQ/0",
"brand_name": "我们爱健康",
"code_type": "CODE_TYPE_TEXT",
"title": "和田红枣卷",
"sub_title": "购买只需0.1元",
"color": "Color010",
"notice": "购买时请录入优惠码",
"description": "需要自负邮费，消费金额到达79元可免邮费",
"date_info": {
"type": "DATE_TYPE_FIX_TIME_RANGE",
"begin_timestamp": 1420041600,
"end_timestamp": 1451577599
},
"sku": {
"quantity": 0
},
"get_limit": 1,
"use_custom_code": true,
"get_custom_code_mode":"GET_CUSTOM_CODE_MODE_DEPOSIT", //填入该字段后，自定义code卡券方可进行导入code并投放的动作。坑，狗日的文档里在后面一个地方才标出来
"bind_openid": false,
"can_share": false,
"can_give_friend": false,
"center_title": "快速购买",
"center_sub_title": "立刻把和田枣带回家",
"center_url": "www.j1.com",
"custom_url_name": "立即使用",
"custom_url": "http://www.j1.com",
"custom_url_sub_title": "去键一网购买",
"promotion_url_name": "更多活动",
"promotion_url": "http://www.ijkang.com.",
"source": "我们爱健康"
},
"default_detail": "1分钱购买" //注：当前节点名称根本不同卡卷类型会有所不同
}
}
}
自定义卡卷导入注意事项：
步骤一：创建预存模式卡券，将库存quantity初始值设置为0(一定要设置为0，不然后面投放时会报错，腾讯这垃圾文档埋坑)，并填入get_custom_code_mode字段；
步骤二：待卡券通过审核后，调用导入code接口并核查code；
步骤三：调用修改库存接口，须令卡券库存小于或等于导入code的数目。（为了避免混乱建议设置为相等）
参数备注：
card_type:团购卷：GROUPON；代金券：CASH；折扣券：DISCOUNT；礼品券：GIFT；优惠券：GENERAL_COUPON
团购券节点参数：
base_info：
deal_detail：团购券专用，团购详情。
代金券节点参数：
base_info：
least_cost：代金券专用，表示起用金额（单位为分）,如果无起用门槛则填0
reduce_cost：代金券专用，表示减免金额。（单位为分）
折扣券：
base_info：
discount：折扣券专用，表示打折额度（百分比）。填30就是七折。
礼品券：
base_info：
gift：礼品券专用，填写礼品的名称。如： 可兑换音乐木盒一个。
优惠券：
base_info：
default_detail：优惠券专用，填写优惠详情。音乐木盒。
base_info节点参数：
logo_url(必填):卡券的商户logo，建议像素为300*300。如：http://mmbiz.qpic.cn/
code_type(必填):CODE_TYPE_TEXT，Code展示类型，"CODE_TYPE_TEXT"，文本；"CODE_TYPE_BARCODE"，一维码 ；"CODE_TYPE_QRCODE"，二维码；"CODE_TYPE_ONLY_QRCODE",二维码无code显示；"CODE_TYPE_ONLY_BARCODE",一维码无code显示；CODE_TYPE_NONE，不显示code和条形码类型，须开发者传入"立即使用"自定义cell完成线上券核销。
brand_name(必填):商户名字,字数上限为12个汉字。如：海底捞
title(必填):卡券名，字数上限为9个汉字。(建议涵盖卡券属性、服务及金额)。如：双人套餐100元兑换券
sub_title(非必填):券名，字数上限为18个汉字。如：鸳鸯锅底+牛肉1份+土豆一份
color(必填):券颜色。按色彩规范标注填写Color010-Color100。详情见获取颜色列表接口，如：Color010
notice(必填):卡券使用提醒，字数上限为16个汉字。如：请出示二维码核销卡券
description(必填):卡券使用说明，字数上限为1024个汉字。如：不可与其他优惠同享/n如需团购券发票，请向店员提出要求。
sku(必填):商品信息。Json结构,见上述示例。
use_custom_code：是否指定卷码（自定义卷码），true：是，仅支持API创建，false：否，支持API创建、公众平台创建（默认为非自定义Code码）
bind_openid(非必填):是否指定用户领取，填写true或false。默认为false。通常指定特殊用户群体投放卡券或防止刷券时选择指定用户领取。
can_share：卡券领取页面是否可分享。参数：true：可分享，false：不可分享。
can_give_friend：卡券是否可转赠。true：可转赠，false：不可转赠
get_limit（非必填）：每人可领券的数量限制,不填写默认为50。如：1
quantity(必填):卡券库存的数量，上限为100000000。如：100000
date_info(必填):使用日期，有效期的信息。Json结构,见上述示例。
type(必填):DATE_TYPE_FIX_TERM表示固定时长（自领取后按天算。使用时间的类型，旧文档采用的1和2依然生效。DATE_TYPE_FIX_TIME_RANGE 表示固定日期区间，
begin_timestamp(必填):表示起用时间。从1970年1月1日00:00:00至起用时间的秒数，最终需转换为字符串形态传入。（东八区时间，单位为秒）type为DATE_TYPE_FIX_TIME_RANGE时专用，如：14300000
end_timestamp(必填):表示结束时间，建议设置为截止日期的23:59:59过期。（东八区时间，单位为秒）如：15300000
fixed_term(必填):type为DATE_TYPE_FIX_TERM时专用，表示自领取后多少天内有效，不支持填写0。
fixed_begin_term(必填): type为DATE_TYPE_FIX_TERM时专用，表示自领取后多少天开始生效，领取后当天生效填写0。（单位为天）如：0
end_timestamp(非必填):可用于DATE_TYPE_FIX_TERM时间类型，表示卡券统一过期时间，建议设置为截止日期的23:59:59过期。（东八区时间，单位为秒），设置了fixed_term卡券，当时间达到end_timestamp时卡券统一过期。如：15300000
source:第三方来源名，如：大众点评
3、卡卷导入：
接口地址：http://api.weixin.qq.com/card/code/deposit?access_token=TOKEN
核查导入卡卷：http://api.weixin.qq.com/card/code/checkcode?access_token=TOKEN
报文格式
{
"card_id": "p-yZQwiiz3Be8hdf_15xKtXM2HJc", //创建时的卡卷号
"code": [ //导入的自定义编码
"11111",
"22222",
"33333",
"44444",
"55555"
]
}
4、修改卡卷库存：
https://api.weixin.qq.com/card/modifystock?access_token=TOKEN
{
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc", //卡卷ID
"increase_stock_value": 1231231, //增加多少存存，非必填，不可填0
"reduce_stock_value": 1231231 //减少多少库存，非必填，不可填0
}
cardid：需要进行导入code的卡券ID。
code：需导入微信卡券后台的自定义code，上限为100个。
4、卡卷核销：
通过卡卷跳转到外部链接会拼上参数：
card_id=p-yZQwrZrQemMhqVYQLtkoYktA-E
encrypt_code=pd0vTUHSHc9tMUCL2gXABcUmINm6yxqJh0y9Phsy63E%3D
openid=o-yZQwhCG1_x9bM52-y4pF69Fwgc
如：http://m.j1.com/?card_id=p-yZQwrZrQemMhqVYQLtkoYktA-E&encrypt_code=pd0vTUHSHc9tMUCL2gXABcUmINm6yxqJh0y9Phsy63E%3D&openid=o-yZQwhCG1_x9bM52-y4pF69Fwgc
在线解密卡卷接口：https://api.weixin.qq.com/card/code/decrypt?access_token=TOKEN
参数(注：直接从URL中拷贝出来记得进行DECODE解码)：
{
"encrypt_code":"pd0vTUHSHc9tMUCL2gXABcUmINm6yxqJh0y9Phsy63E="
}
返回：
{
"errcode":0,
"errmsg":"ok",
"code":"751234212312" //解密后真实CODE
}
核销接口：
https://api.weixin.qq.com/card/code/consume?access_token=TOKEN
{
"code": "ZYF670F61E",
"card_id": "p-yZQwhITydjFEBGnbJUA37uPy7A"
}
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 
相关文章推荐
- android类似微信朋友圈评论效果，listview定位，item总在输入法上面的位置
- JEECG社区 一个微信教育站点案例源代码分享
- 微信现金红包开发(java)
- 第八篇 ：微信公众平台开发实战Java版之如何网页授权获取用户基本信息
- [Android实例] 仿微信通讯录，A~Z拼音侧边检索
- 使用微信内置浏览器点击下拉框出现页面乱跳转现象（iphone），该怎么办
- 微信内置浏览器中，点击下拉框出现页面乱跳转现象（iphone）
- 微信素材上传
- 微信支付 - V3退款
- iOS 微信支付 跳转到微信 只有一个"确定"按钮的解决办法
- 微信分享时注册为空
- 微信公众平台修改服务器配置时token验证失败
- weiphp微信公众平台授权设置
- 微信红包发放类封装【DEMO】
- 微信测试订阅号开发总结
- 微信测试订阅号开发错误总结
- java微信公众号开发01 - 微信服务器的接入和验证
- weiphp微信公众平台授权设置
- 使用PHP实现微信摇一摇周边红包
- Android 自定义seekbar【仿微信联系人】