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"
}
  
  
  
GitHub 加速计划 / li / linux-dash
10.39 K
1.2 K
下载
A beautiful web dashboard for Linux
最近提交(Master分支:1 个月前 )
186a802e added ecosystem file for PM2 4 年前
5def40a3 Add host customization support for the NodeJS version 4 年前
Logo

旨在为数千万中国开发者提供一个无缝且高效的云端环境,以支持学习、使用和贡献开源项目。

更多推荐