微信卡卷总结

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