社交立減金接口哪里設置（非支付渠道）
2018-01-17|HiShop
導讀：小程序社交立減金功能實現了商家快速獲取社交、裂變傳播屬性。那么在經營小程序時如何開放社交立減金接口呢。...
小程序社交立減金功能實現了商家快速獲取社交、裂變傳播屬性。那么在經營小程序時如何開放社交立減金接口呢。
社交立減金開放接口流程
除在支付完成后通過模板消息下發社交立減金活動外，還可以在公眾號圖文消息、公眾號模板消息、小程序等渠道下發社交立減金。
完成免充值模式驗收
為支持商戶免充值營銷經費開展運營活動，提升運營效率，微信支付特開發免充值營銷產品功能。商戶開通該產品功能后，可免費使用微信支付提供的免充值代金券、立減、折扣等營銷工具。商戶配置使用免充值代金券、立減、折扣等營銷優惠，不需要預先充值營銷經費，當用戶核銷優惠時，微信支付會直接扣減商戶訂單實收金額。
開通步驟：完成6個接口的驗收 https://pay.weixin.qq.com/wiki/doc/api/jsapi_sl.php?chapter=23_15
原因：開通免充值業務功能后，“下載對賬單，刷卡支付、公眾號/APP/掃碼支付，訂單查詢，申請退款，查詢退款，支付通知”等接口均存在部分字段變更。測試驗收可以幫助商戶理解接口變更字段，以確保商戶和用戶正常使用微信支付。
3.2 創建代金券并設置跳轉小程序
完成免充值代金券產品權限開通后即可通過接口創建與支付打通的代金券，創建成功后配置社交立減金活動。
通過本接口開發者可以創建和支付打通的代金券，并設置代金券跳轉小程序使用，在 base_info 中新增設置字段"pay_info"，詳情參考創建卡券接口。
接口調用請求說明
協議：https
http請求方式: POST
請求URL：https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
POST數據格式：JSON
POST 數據示例
{
"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": "不可與其他優惠同享\n如需團購券發票，請在消費時向商戶 提出",
"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": "更多優惠",
"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": "此菜品迎合大眾口味，老少皆宜，營養均衡"
}
],
"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": "立即使用", //配置代金券跳轉小程序
"center_app_brand_user_name": "gh_50338e5b8c9d@app", //原始ID+@app
"center_app_brand_pass": "API/cardPage"//小程序的路徑path
}
}"reduce_cost": 10
}
}
}
}
請求數據說明
字段 是否必填 示例 說明
pay_info 是 JSON 結構，設置刷卡類型的卡券必填
swipe_card 是 JSON 結構，設置刷卡類型的卡券必填
zuse_mid_list 否 1219518501 適用商家商戶號列表，創建卡券后將發送通知至適用商戶號，待商家登錄微信支付后臺審核通過后，由制券商家激活。
create_mid 是 1219518501 創建朋友券的商戶號，可登錄公眾平臺-微信支付查看。待適用商家審核通過后需創建朋友券的商戶號登錄支付后臺進行激活。
創建成功后獲取卡券id，并登錄支付后臺進行卡券激活。
3.3 生成社交立減金活動
3.3.1創建社交立減金活動接口
接口調用說明
協議：https
http請求方式: POST
請求URL：https://api.weixin.qq.com/card/mkt/activity/create?access_token=ACCESS_TOKEN
POST數據格式：JSON
請求參數說明
字段 是否必填 說明
access_token 是 調用接口憑證
POST數據 是 JSON數據
POST數據
數據示例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 是 活動結束時間，精確到秒（unix時間戳）
max_partic_times_act 否 每個用戶活動期間最大領取次數,最大為50，不填默認為1
gift_num 是 單個禮包社交立減金數量（3-15個）
activity_tinyappid 是 用戶點擊鏈接后可靜默添加到列表的小程序appid；
activity_bg_color 是 活動封面的背景顏色，可參考：選取卡券背景顏色
card_id 是 卡券ID
priority 是 獎品優先級，只支持整數
membership_appid 是 獎品指定的會員卡appid。如用戶標簽有選擇商戶會員，則需要填寫會員卡appid，該appid需要跟所有發放商戶號有綁定關系。
gen_limit 是 生成上限
返回數據
{
"errcode": 0,
"errmsg": "ok",
"activity_id": "1_428704405"
}
字段說明
字段 說明
activity_id 活動ID
數據示例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 是 活動結束時間，精確到分
max_partic_times_act 否 每個用戶活動期間最大領取次數,最大為50，不填默認為1
gift_num 是 單個禮包社交立減金數量（3-15個）
activity_tinyappid 是 用戶點擊鏈接后可靜默添加到列表的小程序appid；
activity_bg_color 是 活動封面的背景顏色，可參考：選取卡券背景顏色
card_id 是 卡券ID
priority 是 獎品優先級，只支持整數
new_tinyapp_user 是 獎品指定的小程序新老用戶。 true：小程序新用戶 false：小程序老用戶
gen_limit 是 生成上限
返回數據
{
"errcode": 0,
"errmsg": "ok",
"activity_id": "1_428704405"
}
字段說明
字段 說明
activity_id 活動ID
3.3.2生成社交立減金活動路徑接口
通過接口將社交立減金活動生成一條小程序路徑，支持商家自助嵌入小程序流程中、模板消息、公眾號文章等渠道中。
接口調用說明
協議：https
http請求方式: POST
請求URL：https://api.weixin.qq.com/card/mkt/package/alloc?access_token=ACCESS_TOKEN
POST數據格式：JSON
請求參數說明
字段 是否必填 說明
access_token 是 調用接口憑證
POST數據 是 JSON數據
POST數據
數據示例1
{
"activity_id":"1_428705474",
"scene":"ALLOC_ONE",
"openid":"obLatjgoYejavUtHsWwrX-2GtFJE"
}
字段說明
字段 是否必填 說明
activity_id 是 活動ID
scene 是 場景值 ALLOC_ONE 生成社交立減金活動入口路徑
openid 否 若生成一個禮包則必填
返回數據
{
"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 跳轉小程序的原始ID
wxa_path 跳轉小程序的路徑
數據示例2
{
"activity_id":"1_428705474",
"scene":"ALLOC_ENTRANCE"
}
字段說明
字段 是否必填 說明
activity_id 是 活動ID
scene 是 場景值 ALLOC_ENTRANCE 生成社交立減金活動二維碼
返回數據
{
"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 跳轉小程序的原始ID
wxa_path 跳轉小程序的路徑
- 關注官方公眾號 -
提供多種電商軟件及解決方案