社交立減金接口哪里設(shè)置（非支付渠道）
2018-01-17|HiShop
導(dǎo)讀：小程序社交立減金功能實現(xiàn)了商家快速獲取社交、裂變傳播屬性。那么在經(jīng)營小程序時如何開放社交立減金接口呢。...
小程序社交立減金功能實現(xiàn)了商家快速獲取社交、裂變傳播屬性。那么在經(jīng)營小程序時如何開放社交立減金接口呢。
社交立減金開放接口流程
除在支付完成后通過模板消息下發(fā)社交立減金活動外，還可以在公眾號圖文消息、公眾號模板消息、小程序等渠道下發(fā)社交立減金。
完成免充值模式驗收
為支持商戶免充值營銷經(jīng)費開展運營活動，提升運營效率，微信支付特開發(fā)免充值營銷產(chǎn)品功能。商戶開通該產(chǎn)品功能后，可免費使用微信支付提供的免充值代金券、立減、折扣等營銷工具。商戶配置使用免充值代金券、立減、折扣等營銷優(yōu)惠，不需要預(yù)先充值營銷經(jīng)費，當(dāng)用戶核銷優(yōu)惠時，微信支付會直接扣減商戶訂單實收金額。
開通步驟：完成6個接口的驗收 https://pay.weixin.qq.com/wiki/doc/api/jsapi_sl.php?chapter=23_15
原因：開通免充值業(yè)務(wù)功能后，“下載對賬單，刷卡支付、公眾號/APP/掃碼支付，訂單查詢，申請退款，查詢退款，支付通知”等接口均存在部分字段變更。測試驗收可以幫助商戶理解接口變更字段，以確保商戶和用戶正常使用微信支付。
3.2 創(chuàng)建代金券并設(shè)置跳轉(zhuǎn)小程序
完成免充值代金券產(chǎn)品權(quán)限開通后即可通過接口創(chuàng)建與支付打通的代金券，創(chuàng)建成功后配置社交立減金活動。
通過本接口開發(fā)者可以創(chuàng)建和支付打通的代金券，并設(shè)置代金券跳轉(zhuǎn)小程序使用，在 base_info 中新增設(shè)置字段"pay_info"，詳情參考創(chuàng)建卡券接口。
接口調(diào)用請求說明
協(xié)議：https
http請求方式: POST
請求URL：https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式：JSON
POST 數(shù)據(jù)示例
{
"card": {
"card_type": "CASH",
"cash": {
"base_info": {
"logo_url": "http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9",
"pay_info": {
"swipe_card": {
"use_mid_list": [
"1900015421"
],
"create_mid": "1900015421",
"is_swipe_card": true
}
},
"brand_name": "微信餐廳",
"code_type": "CODE_TYPE_NONE",
"color": "Color010",
"service_phone": "020-88888888",
"description": "不可與其他優(yōu)惠同享\n如需團購券發(fā)票，請在消費時向商戶 提出",
"date_info": {
"type": "DATE_TYPE_FIX_TIME_RANGE",
"begin_timestamp": 1509977220,
"end_timestamp": 1515897259
},
"can_share": false,
"can_give_friend": false,
"location_id_list": [
272981040,
400183234
],
"get_limit": 30,
"center_title": "快速核銷",
"center_sub_title": "",
"center_url": "www.xxx.com",
"custom_url_name": "立即使用",
"custom_url": "http://www.qq.com",
"custom_url_sub_title": "6個漢字tips",
"promotion_url_name": "更多優(yōu)惠",
"promotion_url": "http://www.qq.com"
},
"advanced_info": {
"use_condition": {
"accept_category": "鞋類",
"reject_category": "阿迪達斯",
"can_use_with_other_discount": false,
"least_cost": 101
},
"abstract": {
"abstract": "微信餐廳推出多種新季菜品，期待您的光臨",
"icon_url_list": [
"http://mmbiz.qpic.cn/mmbiz/p98FjXy8Lac"
]
},
"text_image_list": [
{
"image_url": "http://mmbiz.qpic.cn/mmbiz/p98FjXy8",
"text": "此菜品精選食材，以獨特的烹飪方法，最大程度地刺激食 客的味蕾"
},
{
"image_url": "http://mmbiz.qpic.cn/mmbiz/p98Fj",
"text": "此菜品迎合大眾口味，老少皆宜，營養(yǎng)均衡"
}
],
"time_limit": [
{
"type": "MONDAY",
"begin_hour": 0,
"end_hour": 10,
"begin_minute": 10,
"end_minute": 59
},
{
"type": "HOLIDAY"
}
],
"business_service": [
"BIZ_SERVICE_FREE_WIFI",
"BIZ_SERVICE_WITH_PET",
"BIZ_SERVICE_FREE_PARK",
"BIZ_SERVICE_DELIVER"
]
},
"center_title": "立即使用", //配置代金券跳轉(zhuǎn)小程序
"center_app_brand_user_name": "gh_50338e5b8c9d@app", //原始ID+@app
"center_app_brand_pass": "API/cardPage"//小程序的路徑path
}
}"reduce_cost": 10
}
}
}
}
請求數(shù)據(jù)說明
字段 是否必填 示例 說明
pay_info 是 JSON 結(jié)構(gòu)，設(shè)置刷卡類型的卡券必填
swipe_card 是 JSON 結(jié)構(gòu)，設(shè)置刷卡類型的卡券必填
zuse_mid_list 否 1219518501 適用商家商戶號列表，創(chuàng)建卡券后將發(fā)送通知至適用商戶號，待商家登錄微信支付后臺審核通過后，由制券商家激活。
create_mid 是 1219518501 創(chuàng)建朋友券的商戶號，可登錄公眾平臺-微信支付查看。待適用商家審核通過后需創(chuàng)建朋友券的商戶號登錄支付后臺進行激活。
創(chuàng)建成功后獲取卡券id，并登錄支付后臺進行卡券激活。
3.3 生成社交立減金活動
3.3.1創(chuàng)建社交立減金活動接口
接口調(diào)用說明
協(xié)議：https
http請求方式: POST
請求URL：https://api.weixin.qq.com/card/mkt/activity/create?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式：JSON
請求參數(shù)說明
字段 是否必填 說明
access_token 是 調(diào)用接口憑證
POST數(shù)據(jù) 是 JSON數(shù)據(jù)
POST數(shù)據(jù)
數(shù)據(jù)示例1（新老會員）
{
"info": {
"basic_info": {
"begin_time": 1508259270,
"end_time": 1508269270,
"max_partic_times_act": 99,
"gift_num": 3,
"activity_tinyappid": "wx3661dec4a09553f1",
"activity_bg_color": "Color010"
},
"card_info_list": [
{
"card_id": "pbLatjtZKQ0VXqyy5pW6OaHthWTg",
"priority": 2,
"membership_appid": "wxc0b84a53ed8e8d29"
},
{
"card_id": "pbLatjvsk2Fr8pfcYQagMw1ez_mk",
"priority": 2
}
],
"custom_info": {
"gen_limit": 2
}
}
}
字段說明
字段 是否必填 說明
begin_time 是 活動開始時間，精確到秒（unix時間戳）
end_time 是 活動結(jié)束時間，精確到秒（unix時間戳）
max_partic_times_act 否 每個用戶活動期間最大領(lǐng)取次數(shù),最大為50，不填默認為1
gift_num 是 單個禮包社交立減金數(shù)量（3-15個）
activity_tinyappid 是 用戶點擊鏈接后可靜默添加到列表的小程序appid；
activity_bg_color 是 活動封面的背景顏色，可參考：選取卡券背景顏色
card_id 是 卡券ID
priority 是 獎品優(yōu)先級，只支持整數(shù)
membership_appid 是 獎品指定的會員卡appid。如用戶標(biāo)簽有選擇商戶會員，則需要填寫會員卡appid，該appid需要跟所有發(fā)放商戶號有綁定關(guān)系。
gen_limit 是 生成上限
返回數(shù)據(jù)
{
"errcode": 0,
"errmsg": "ok",
"activity_id": "1_428704405"
}
字段說明
字段 說明
activity_id 活動ID
數(shù)據(jù)示例2（新老小程序用戶）
{
"info": {
"basic_info": {
"begin_time": 1508259270,
"end_time": 1508269270,
"max_partic_times_act": 99,
"gift_num": 3,
"activity_tinyappid": "wx3661dec4a09553f1",
"activity_bg_color": "Color010"
},
"card_info_list": [
{
"card_id": "pbLatjtZKQ0VXqyy5pW6OaHthWTg",
"priority": 2,
"new_tinyapp_user": true
},
{
"card_id": "pbLatjvsk2Fr8pfcYQagMw1ez_mk",
"priority": 2,
"new_tinyapp_user": false
}
],
"custom_info": {
"gen_limit": 2
}
}
}
字段說明
字段 是否必填 說明
begin_time 是 活動開始時間，精確到分
end_time 是 活動結(jié)束時間，精確到分
max_partic_times_act 否 每個用戶活動期間最大領(lǐng)取次數(shù),最大為50，不填默認為1
gift_num 是 單個禮包社交立減金數(shù)量（3-15個）
activity_tinyappid 是 用戶點擊鏈接后可靜默添加到列表的小程序appid；
activity_bg_color 是 活動封面的背景顏色，可參考：選取卡券背景顏色
card_id 是 卡券ID
priority 是 獎品優(yōu)先級，只支持整數(shù)
new_tinyapp_user 是 獎品指定的小程序新老用戶。 true：小程序新用戶 false：小程序老用戶
gen_limit 是 生成上限
返回數(shù)據(jù)
{
"errcode": 0,
"errmsg": "ok",
"activity_id": "1_428704405"
}
字段說明
字段 說明
activity_id 活動ID
3.3.2生成社交立減金活動路徑接口
通過接口將社交立減金活動生成一條小程序路徑，支持商家自助嵌入小程序流程中、模板消息、公眾號文章等渠道中。
接口調(diào)用說明
協(xié)議：https
http請求方式: POST
請求URL：https://api.weixin.qq.com/card/mkt/package/alloc?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式：JSON
請求參數(shù)說明
字段 是否必填 說明
access_token 是 調(diào)用接口憑證
POST數(shù)據(jù) 是 JSON數(shù)據(jù)
POST數(shù)據(jù)
數(shù)據(jù)示例1
{
"activity_id":"1_428705474",
"scene":"ALLOC_ONE",
"openid":"obLatjgoYejavUtHsWwrX-2GtFJE"
}
字段說明
字段 是否必填 說明
activity_id 是 活動ID
scene 是 場景值 ALLOC_ONE 生成社交立減金活動入口路徑
openid 否 若生成一個禮包則必填
返回數(shù)據(jù)
{
"errcode": 0,
"errmsg": "ok",
"wxa_username": "gh_af84e82fc39c@app",
"wxa_path": "pages/index/index?signature=dd524bc4974f280e2bb1ef57d5fb7953f0bfe609&type=1&scene=3&pack_id=NDYxMzI5OTMzXzEyMDQyNDA1NDA%3D&act_id=428705474"
}
字段說明
字段 說明
wxa_username 跳轉(zhuǎn)小程序的原始ID
wxa_path 跳轉(zhuǎn)小程序的路徑
數(shù)據(jù)示例2
{
"activity_id":"1_428705474",
"scene":"ALLOC_ENTRANCE"
}
字段說明
字段 是否必填 說明
activity_id 是 活動ID
scene 是 場景值 ALLOC_ENTRANCE 生成社交立減金活動二維碼
返回數(shù)據(jù)
{
"errcode": 0,
"errmsg": "ok",
"wxa_username": "gh_af84e82fc39c@app",
"wxa_path": "pages/index/index?signature=aba25623e78f4bc48c62d0de7aabcb8b524f122b&type=1&scene=2&act_id=428705474"
}
字段說明
字段 說明
wxa_username 跳轉(zhuǎn)小程序的原始ID
wxa_path 跳轉(zhuǎn)小程序的路徑
- 關(guān)注官方公眾號 -
提供多種電商軟件及解決方案