微信卡卷总结

浅浅的花香味﹌ 2022-06-10 05:12 174阅读 0赞

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