社交立減金接口哪里設(shè)置(非支付渠道)
2018-01-17|HiShop
導(dǎo)讀:小程序社交立減金功能實(shí)現(xiàn)了商家快速獲取社交、裂變傳播屬性。那么在經(jīng)營(yíng)小程序時(shí)如何開放社交立減金接口呢。...
小程序社交立減金功能實(shí)現(xiàn)了商家快速獲取社交、裂變傳播屬性。那么在經(jīng)營(yíng)小程序時(shí)如何開放社交立減金接口呢。
社交立減金開放接口流程
除在支付完成后通過(guò)模板消息下發(fā)社交立減金活動(dòng)外,還可以在公眾號(hào)圖文消息、公眾號(hào)模板消息、小程序等渠道下發(fā)社交立減金。
完成免充值模式驗(yàn)收
為支持商戶免充值營(yíng)銷經(jīng)費(fèi)開展運(yùn)營(yíng)活動(dòng),提升運(yùn)營(yíng)效率,微信支付特開發(fā)免充值營(yíng)銷產(chǎn)品功能。商戶開通該產(chǎn)品功能后,可免費(fèi)使用微信支付提供的免充值代金券、立減、折扣等營(yíng)銷工具。商戶配置使用免充值代金券、立減、折扣等營(yíng)銷優(yōu)惠,不需要預(yù)先充值營(yíng)銷經(jīng)費(fèi),當(dāng)用戶核銷優(yōu)惠時(shí),微信支付會(huì)直接扣減商戶訂單實(shí)收金額。
開通步驟:完成6個(gè)接口的驗(yàn)收 https://pay.weixin.qq.com/wiki/doc/api/jsapi_sl.php?chapter=23_15
原因:開通免充值業(yè)務(wù)功能后,“下載對(duì)賬單,刷卡支付、公眾號(hào)/APP/掃碼支付,訂單查詢,申請(qǐng)退款,查詢退款,支付通知”等接口均存在部分字段變更。測(cè)試驗(yàn)收可以幫助商戶理解接口變更字段,以確保商戶和用戶正常使用微信支付。
3.2 創(chuàng)建代金券并設(shè)置跳轉(zhuǎn)小程序
完成免充值代金券產(chǎn)品權(quán)限開通后即可通過(guò)接口創(chuàng)建與支付打通的代金券,創(chuàng)建成功后配置社交立減金活動(dòng)。
通過(guò)本接口開發(fā)者可以創(chuàng)建和支付打通的代金券,并設(shè)置代金券跳轉(zhuǎn)小程序使用,在 base_info 中新增設(shè)置字段"pay_info",詳情參考創(chuàng)建卡券接口。
接口調(diào)用請(qǐng)求說(shuō)明
協(xié)議:https
http請(qǐng)求方式: POST
請(qǐng)求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如需團(tuán)購(gòu)券發(fā)票,請(qǐng)?jiān)谙M(fèi)時(shí)向商戶 提出",
"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個(gè)漢字tips",
"promotion_url_name": "更多優(yōu)惠",
"promotion_url": "http://www.qq.com"
},
"advanced_info": {
"use_condition": {
"accept_category": "鞋類",
"reject_category": "阿迪達(dá)斯",
"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": "此菜品精選食材,以獨(dú)特的烹飪方法,最大程度地刺激食 客的味蕾"
},
{
"image_url": "http://mmbiz.qpic.cn/mmbiz/p98Fj",
"text": "此菜品迎合大眾口味,老少皆宜,營(yíng)養(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
}
}
}
}
請(qǐng)求數(shù)據(jù)說(shuō)明
字段 是否必填 示例 說(shuō)明
pay_info 是 JSON 結(jié)構(gòu),設(shè)置刷卡類型的卡券必填
swipe_card 是 JSON 結(jié)構(gòu),設(shè)置刷卡類型的卡券必填
zuse_mid_list 否 1219518501 適用商家商戶號(hào)列表,創(chuàng)建卡券后將發(fā)送通知至適用商戶號(hào),待商家登錄微信支付后臺(tái)審核通過(guò)后,由制券商家激活。
create_mid 是 1219518501 創(chuàng)建朋友券的商戶號(hào),可登錄公眾平臺(tái)-微信支付查看。待適用商家審核通過(guò)后需創(chuàng)建朋友券的商戶號(hào)登錄支付后臺(tái)進(jìn)行激活。
創(chuàng)建成功后獲取卡券id,并登錄支付后臺(tái)進(jìn)行卡券激活。
3.3 生成社交立減金活動(dòng)
3.3.1創(chuàng)建社交立減金活動(dòng)接口
接口調(diào)用說(shuō)明
協(xié)議:https
http請(qǐng)求方式: POST
請(qǐng)求URL:https://api.weixin.qq.com/card/mkt/activity/create?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式:JSON
請(qǐng)求參數(shù)說(shuō)明
字段 是否必填 說(shuō)明
access_token 是 調(diào)用接口憑證
POST數(shù)據(jù) 是 JSON數(shù)據(jù)
POST數(shù)據(jù)
數(shù)據(jù)示例1(新老會(huì)員)
{
"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
}
}
}
字段說(shuō)明
字段 是否必填 說(shuō)明
begin_time 是 活動(dòng)開始時(shí)間,精確到秒(unix時(shí)間戳)
end_time 是 活動(dòng)結(jié)束時(shí)間,精確到秒(unix時(shí)間戳)
max_partic_times_act 否 每個(gè)用戶活動(dòng)期間最大領(lǐng)取次數(shù),最大為50,不填默認(rèn)為1
gift_num 是 單個(gè)禮包社交立減金數(shù)量(3-15個(gè))
activity_tinyappid 是 用戶點(diǎn)擊鏈接后可靜默添加到列表的小程序appid;
activity_bg_color 是 活動(dòng)封面的背景顏色,可參考:選取卡券背景顏色
card_id 是 卡券ID
priority 是 獎(jiǎng)品優(yōu)先級(jí),只支持整數(shù)
membership_appid 是 獎(jiǎng)品指定的會(huì)員卡appid。如用戶標(biāo)簽有選擇商戶會(huì)員,則需要填寫會(huì)員卡appid,該appid需要跟所有發(fā)放商戶號(hào)有綁定關(guān)系。
gen_limit 是 生成上限
返回?cái)?shù)據(jù)
{
"errcode": 0,
"errmsg": "ok",
"activity_id": "1_428704405"
}
字段說(shuō)明
字段 說(shuō)明
activity_id 活動(dòng)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
}
}
}
字段說(shuō)明
字段 是否必填 說(shuō)明
begin_time 是 活動(dòng)開始時(shí)間,精確到分
end_time 是 活動(dòng)結(jié)束時(shí)間,精確到分
max_partic_times_act 否 每個(gè)用戶活動(dòng)期間最大領(lǐng)取次數(shù),最大為50,不填默認(rèn)為1
gift_num 是 單個(gè)禮包社交立減金數(shù)量(3-15個(gè))
activity_tinyappid 是 用戶點(diǎn)擊鏈接后可靜默添加到列表的小程序appid;
activity_bg_color 是 活動(dòng)封面的背景顏色,可參考:選取卡券背景顏色
card_id 是 卡券ID
priority 是 獎(jiǎng)品優(yōu)先級(jí),只支持整數(shù)
new_tinyapp_user 是 獎(jiǎng)品指定的小程序新老用戶。 true:小程序新用戶 false:小程序老用戶
gen_limit 是 生成上限
返回?cái)?shù)據(jù)
{
"errcode": 0,
"errmsg": "ok",
"activity_id": "1_428704405"
}
字段說(shuō)明
字段 說(shuō)明
activity_id 活動(dòng)ID
3.3.2生成社交立減金活動(dòng)路徑接口
通過(guò)接口將社交立減金活動(dòng)生成一條小程序路徑,支持商家自助嵌入小程序流程中、模板消息、公眾號(hào)文章等渠道中。
接口調(diào)用說(shuō)明
協(xié)議:https
http請(qǐng)求方式: POST
請(qǐng)求URL:https://api.weixin.qq.com/card/mkt/package/alloc?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式:JSON
請(qǐng)求參數(shù)說(shuō)明
字段 是否必填 說(shuō)明
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"
}
字段說(shuō)明
字段 是否必填 說(shuō)明
activity_id 是 活動(dòng)ID
scene 是 場(chǎng)景值 ALLOC_ONE 生成社交立減金活動(dòng)入口路徑
openid 否 若生成一個(gè)禮包則必填
返回?cái)?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"
}
字段說(shuō)明
字段 說(shuō)明
wxa_username 跳轉(zhuǎn)小程序的原始ID
wxa_path 跳轉(zhuǎn)小程序的路徑
數(shù)據(jù)示例2
{
"activity_id":"1_428705474",
"scene":"ALLOC_ENTRANCE"
}
字段說(shuō)明
字段 是否必填 說(shuō)明
activity_id 是 活動(dòng)ID
scene 是 場(chǎng)景值 ALLOC_ENTRANCE 生成社交立減金活動(dòng)二維碼
返回?cái)?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"
}
字段說(shuō)明
字段 說(shuō)明
wxa_username 跳轉(zhuǎn)小程序的原始ID
wxa_path 跳轉(zhuǎn)小程序的路徑