微信卡卷總結

阿新 • • 發佈：2019-01-16

1、上傳LOGO測試方法，在linux伺服器ssh中執行：
curl -F [email protected] "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"
}

微信卡卷總結

微信卡卷總結

酷客多小程序新版發布：與微信卡券、小票打印等無縫對接

Java企業微信開發_07_總結一下企業微信的配置

微信卡券添加（微擎系統）

最近i學習微信卡券中的會員卡功能，弄清楚不容易，分享一下。

微信卡券領用

微信卡券---建立卡券---上傳圖片logo

微信開發學習總結（四）——自定義選單（5）——個性化選單介面

微信開發學習總結（四）——自定義選單（4）——自定義選單事件推送

微信開發學習總結（四）——自定義選單（3）——自定義選單刪除介面

微信開發學習總結（四）——自定義選單（2）——自定義選單查詢介面

微信開發學習總結（四）——自定義選單（1）——自定義選單建立介面

微信開發學習總結（五）——素材管理（1）—獲取臨時素材和新增永久素材

微信開發學習總結（三）——訊息管理（2）-接受普通訊息和被動回覆使用者訊息

微信開發學習總結（三）——訊息管理（1）

微信開發學習總結（四）——自定義選單——自定義選單建立介面

微信開發學習總結（二）——微信開發入門（轉載）

微信開發學習總結（一）——微信開發環境搭建（轉載）

微信卡券---第一步:上傳卡券圖片素材

微信小程式總結

微信卡卷總結

相關推薦