淺析微信支付：開通社交立減金活動、建立立減金及領取使用的相關文件和原始碼
本文是【淺析微信支付】系列文章的第十七篇，主要講解在在微信平臺中，如何建立優惠券，開通社交立減金，併為使用者配置傳送立減金。
上篇文章已經為大家講解了如何在微信公眾平臺建立優惠券併為使用者發券，這片文章是優惠券的一個進階，講解微信平臺上的社交立減金用法，希望可以幫助到大家。
應用場景
小程式社交立減金是一款幫助商家快速生成具備裂變傳播屬性的小程式經營工具，使用者通過支付、掃碼等場景可以參與社交立減金活動，將社交立減金禮包分享至朋友後自己可獲取一份，朋友在會話中可隨機獲取社交立減金，並直達商家小程式使用。
產品優勢
- 打通“小程式+支付+優惠”，支付成功頁分發社交立減金，支付時抵扣使用；
- 通過聊天分享和裂變，觸達更多潛在使用者，降低拉新成本；
- 根據使用者標籤屬性，可配置分發不同金額的社交立減金，如新老使用者、是否會員等；
- 結合使用者偏好興趣，可配置個性化商品推薦，提高轉化。
官方文件地址：
https://mp.weixin.qq.com/wiki?t=resource/res_main&id=21515658940X5pIn
複製程式碼接入流程
進入上面文件地址，文中有開通公眾號活動配置許可權，這個許可權必須開啟，開啟指南如下：
社交立減金可通過微信支付後向使用者下發訊息領取，在配置活動時需要登入發起支付的商戶號開通許可權。
Q:在微信支付平臺開通“公眾號活動配置”許可權
A:使用管理員帳號（管理員為申請商戶號時給使用者分配的登入賬號）登入微信支付商戶平臺pay.weixin.qq.com，進入“產品中心－我的產品－運營工具”，進入並開通“公眾號活動配置”許可權。
複製程式碼 開通許可權之後，還需要完成免充值模式驗收，這個驗收在我的前幾篇文章中已經講過，下面貼上對應的連結檢視： 淺析微信支付：開通免充值產品功能及如何進行介面升級指引
完成免充值模式驗收後，即可通過介面建立與支付打通的代金券，為配置立減金活動做準備。
若已完成免充值模式驗收，可直接呼叫建立代金券並設定跳轉小程式，下面是建立的流程和對應程式碼。
建立社交立減金的步驟說明
首先，我們來理解一下社交立減金的構成和建立流程，這樣才能不被微信給弄迷糊了，下面是幾個步驟的說明：
- 開通微信公眾平臺中的
微信卡券功能 - 開通微信商戶平臺中的
公眾號活動配置功能 - 開通微信商戶平臺中的
免充值相關產品功能 - 完成免充值模式驗收
- 在
微信商戶平臺建立或者通過介面建立微信代金券 - 登陸
微信支付商戶平臺 -營銷中心-管理代金券-草稿箱中啟用對應卡券 - 通過
建立支付後領取立減金活動介面建立活動 - 登陸
微信支付商戶平臺 -營銷中心-營銷活動-滿額送-管理-草稿箱啟用活動。 - 下單購買某個商品後，在
服務通知訊息中可以領取或者轉發社交立減金 - 領取，結束
上面的步驟，缺一不可，需要小夥伴一步步的除錯和試錯，幸運的是，我已經都試過錯，所以把經驗總結一下，希望小夥伴們不會再次趟坑，建立社交立減金活動的原始碼也是有的哦～
好了，話不多說，對於上面的10步，前4步不需要講，不清楚的小夥伴可以看看我的歷史文章，有對應的講解，下面從第5步開始說起。
建立代金券並設定跳轉小程式
下面先講解介面的方式，完成配置社交立減金活動獎品準備環節，通過本介面開發者可以建立和支付打通的代金券，並設定代金券跳轉小程式使用，在 base_info 中新增設定欄位"pay_info"，詳情參考建立卡券介面。
協議：https
http請求方式: POST
請求URL：https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN
POST資料格式：JSON
複製程式碼對於POST的資料可以參考我的歷史文章微信卡券建立，或者檢視以下官方文件：
https://mp.weixin.qq.com/wiki?t=resource/res_main&id=21515658940X5pIn
複製程式碼注意：
- 卡券提交前需檢查是否有傳："pay_info"、"is_swipe_card": true 欄位；
- 卡券的起止時間應大於當前時間；如當前時間為：2018/1/17 0:0:0，起止時間需大於當前時間：2018/1/17 13:30:03 （時間精確到秒）；
- 需設定最低消費門檻，如：5元代金券，滿10元可用。 "reduce_cost": 5 ,"least_cost":10 。
推薦檢視我的文章，裡面有一些欄位的注意事項，這裡就不細講了，下面說一下第二種方式，就是直接通過微信商戶平臺建立代金券，建立完成後，需要在“微信支付商戶平臺 -營銷中心-管理代金券-草稿箱”中啟用對應卡券，獲取卡券id後，可繼續建立立減金活動。
建立支付後領取立減金活動介面
重頭戲來了，可以通過此介面建立立減金活動。將已建立的代金券cardid、跳轉小程式appid、發起支付的商戶號等資訊通過此介面建立立減金活動，成功返回活動id即為建立成功。
協議：https
http請求方式: POST
請求URL：https://api.weixin.qq.com/card/mkt/activity/create?access_token=ACCESS_TOKEN
POST資料格式：JSON
複製程式碼大白話解釋一下，上面的代金券cardid就是通過介面返回的卡券ID，或者是通過手動建立後的卡包ID，就是亂七八糟一串英文的那一個，例如：pX2-vjpU_MT1gFDsP8lNl15PdaFS，官方的POST示例可以檢視文件：
https://mp.weixin.qq.com/wiki?t=resource/res_main&id=21515658940X5pIn
複製程式碼好訊息來了，這個介面我已經封裝在sdk中了，封裝為方法便於大家使用，下面是呼叫方法和具體方法的程式碼。
呼叫方法：
/**
* 建立支付後領取立減金活動介面
*
* @author yclimb
* @date 2018/9/18
*/
private void createCardActivity() {
WXUtils wxUtils = new WXUtils();
wxUtils.createCardActivity("2018-09-18 18:00:00", "2018-09-18 19:59:59", 3, 1,
1, "pX2-vjpU_MT1gFDsP8lNl15PdaZE", "100",
null, false);
}
複製程式碼方法原始碼：
/**
* 建立支付後領取立減金活動介面
* 通過此介面建立立減金活動。
* 將已建立的代金券cardid、跳轉小程式appid、發起支付的商戶號等資訊通過此介面建立立減金活動，成功返回活動id即為建立成功。
* 介面地址：https://mp.weixin.qq.com/wiki?t=resource/res_main&id=21515658940X5pIn
*
* @param begin_time 活動開始時間，精確到秒
* @param end_time 活動結束時間，精確到秒
* @param gift_num 單個禮包社交立減金數量（3-15個）
* @param max_partic_times_act 每個使用者活動期間最大領取次數,最大為50，預設為1
* @param max_partic_times_one_day 每個使用者活動期間單日最大領取次數,最大為50，預設為1
* @param card_id 卡券ID
* @param min_amt 最少支付金額，單位是元
* @param membership_appid 獎品指定的會員卡appid。如使用者標籤有選擇商戶會員，則需要填寫會員卡appid，該appid需要跟所有發放商戶號有繫結關係。
* @param new_tinyapp_user 可以指定為是否小程式新使用者（membership_appid為空、new_tinyapp_user為false時，指定為所有使用者）
* @return json
* @author yclimb
* @date 2018/9/18
*/
public JSONObject createCardActivity(String begin_time, String end_time, int gift_num, int max_partic_times_act,
int max_partic_times_one_day, String card_id, String min_amt,
String membership_appid, boolean new_tinyapp_user) {
try {
// 建立活動介面之前的驗證
String msg = checkCardActivity(begin_time, end_time, gift_num, max_partic_times_act, max_partic_times_one_day, min_amt);
if (null != msg) {
JSONObject resultJson = new JSONObject(2);
resultJson.put("errcode", "1");
resultJson.put("errmsg", msg);
return resultJson;
}
// 獲取[商戶名稱]公眾號的 access_token
String accessToken = this.getAccessToken(WXConstants.WX_MINI_PROGRAM_CODE);
// 呼叫介面傳入引數
JSONObject paramJson = new JSONObject(1);
// info 包含 basic_info、card_info_list、custom_info
JSONObject info = new JSONObject(3);
// 基礎資訊物件
JSONObject basic_info = new JSONObject(8);
// activity_bg_color 是 活動封面的背景顏色，可參考：選取卡券背景顏色
basic_info.put("activity_bg_color", CardBgColorEnum.COLOR_090.getBgName());
// activity_tinyappid 是 使用者點選連結後可靜默新增到列表的小程式appid；
basic_info.put("activity_tinyappid", WXPayConstants.APP_ID);
// mch_code 是 支付商戶號
basic_info.put("mch_code", WXPayConstants.MCH_ID);
// begin_time 是 活動開始時間，精確到秒（unix時間戳）
basic_info.put("begin_time", DateTimeUtil.getTenTimeByDate(begin_time));
// end_time 是 活動結束時間，精確到秒（unix時間戳）
basic_info.put("end_time", DateTimeUtil.getTenTimeByDate(end_time));
// gift_num 是 單個禮包社交立減金數量（3-15個）
basic_info.put("gift_num", gift_num);
// max_partic_times_act 否 每個使用者活動期間最大領取次數,最大為50，不填預設為1
basic_info.put("max_partic_times_act", max_partic_times_act);
// max_partic_times_one_day 否 每個使用者活動期間單日最大領取次數,最大為50，不填預設為1
basic_info.put("max_partic_times_one_day", max_partic_times_one_day);
// card_info_list 是 可以配置兩種發放規則：小程式新老使用者、新老會員
JSONArray card_info_list = new JSONArray(1);
JSONObject card_info = new JSONObject(3);
// card_id 是 卡券ID
card_info.put("card_id", card_id);
// min_amt 是 最少支付金額，單位是分
card_info.put("min_amt", String.valueOf(new BigDecimal(min_amt).multiply(new BigDecimal(100)).setScale(2, BigDecimal.ROUND_HALF_UP).intValue()));
/*
* membership_appid 是 獎品指定的會員卡appid。如使用者標籤有選擇商戶會員，則需要填寫會員卡appid，該appid需要跟所有發放商戶號有繫結關係。
* new_tinyapp_user 是 可以指定為是否小程式新使用者
* total_user 是 可以指定為所有使用者
* membership_appid、new_tinyapp_user、total_user以上欄位3選1，未選擇請勿填，不必故意填寫false
*/
if (StringUtils.isNotBlank(membership_appid)) {
card_info.put("membership_appid", membership_appid);
} else {
if (new_tinyapp_user) {
card_info.put("new_tinyapp_user", true);
} else {
card_info.put("total_user", true);
}
}
card_info_list.add(card_info);
// 自定義欄位，表示支付後領券
JSONObject custom_info = new JSONObject(1);
custom_info.put("type", "AFTER_PAY_PACKAGE");
// 拼裝json物件
info.put("basic_info", basic_info);
info.put("card_info_list", card_info_list);
info.put("custom_info", custom_info);
paramJson.put("info", info);
// 請求微信介面，得到返回結果[json]
HttpEntity<JSONObject> entity = new HttpEntity<>(paramJson, this.getHttpHeadersUTF8JSON());
JSONObject resultJson = restTemplate.postForObject(WXURL.WX_CARD_ACTIVITY_CREATE_URL, entity, JSONObject.class, accessToken);
// {"errcode":0,"errmsg":"ok","activity_id":"4728935"}
System.out.println(resultJson.toJSONString());
return resultJson;
} catch (Exception e) {
WXPayUtil.getLogger().error(e.getMessage(), e);
}
return null;
}
/**
* 建立活動介面之前的驗證
*
* @param begin_time 活動開始時間，精確到秒
* @param end_time 活動結束時間，精確到秒
* @param gift_num 單個禮包社交立減金數量（3-15個）
* @param max_partic_times_act 每個使用者活動期間最大領取次數,最大為50，預設為1
* @param max_partic_times_one_day 每個使用者活動期間單日最大領取次數,最大為50，預設為1
* @param min_amt 最少支付金額，單位是元
* @return msg str
* @author yclimb
* @date 2018/9/18
*/
public String checkCardActivity(String begin_time, String end_time, int gift_num, int max_partic_times_act,
int max_partic_times_one_day, String min_amt) {
// 開始時間不能小於結束時間
if (DateTimeUtil.latterThan(end_time, begin_time, DateTimeUtil.TIME_FORMAT_NORMAL)) {
return "活動開始時間不能小於活動結束時間";
}
// 單個禮包社交立減金數量（3-15個）
if (gift_num < 3 || gift_num > 15) {
return "單個禮包社交立減金數量（3-15個）";
}
// 每個使用者活動期間最大領取次數,最大為50，預設為1
if (max_partic_times_act <= 0 || max_partic_times_act > 50) {
return "每個使用者活動期間最大領取次數,最大為50，預設為1";
}
// 每個使用者活動期間單日最大領取次數,最大為50，預設為1
if (max_partic_times_one_day <= 0 || max_partic_times_one_day > 50) {
return "每個使用者活動期間單日最大領取次數,最大為50，預設為1";
}
// 最少支付金額，單位是元
if (BigDecimal.ONE.compareTo(new BigDecimal(min_amt)) > 0) {
return "最少支付金額必須大於1元";
}
return null;
}
複製程式碼對應的全部程式碼，可以檢視我的github，地址如下：
https://github.com/YClimb/wxpay-sdk/blob/master/src/main/java/com/weixin/pay/util/WXUtils.java
複製程式碼建立成功後，會返回一個 "activity_id": "123456" 的json資料，也就是立減金活動id咯，如果建立失敗，也不要著急，檢視上面說到的官方文件，建立介面下有對應的返回碼說明， 已知是足夠解決問題了。
活動建立成功後，需要登陸“微信支付商戶平臺 -營銷中心-營銷活動-滿額送-管理-草稿箱”啟用活動，啟用後，社交立減金投放成功。可以通過支付行為進行驗證。
PS：啟用活動後，活動是通過滿額送行為傳送給使用者的，而且是自動發放，如果你在平臺上購買的商品價格滿足規則，則會在服務通知中顯示社交立減金的資訊，此活動需要使用者主動領取才行，使用者領取的券最終就是咋們最初建立的代金券，此代金券使用規則和正常代金券一樣。
PPS：社交立減金可以分享轉發給朋友，這個是他的特點，對於每個活動的代金券規則和份數，大家一定要注意，根據場景投放。
結語
以上為社交立減金相關的解釋和原始碼，小夥伴們一定要注意看看官方文件哦，具體的原始碼可以看我的github，裡面對每個方法有詳細的註釋。
如果小夥伴有遇到解決不了的問題，可以關注作者微信公眾號，加入討論群中發出疑問，和小夥伴們一起解決哦～
如果想要提前一覽原始碼的小夥伴，可以先看看我的 github，地址如下： https://github.com/YClimb/wxpay-sdk/blob/master/README.md
關注作者微信公眾號，點選下方討論群，掃碼即可加入微信支付討論群與小夥伴一起探討哦～
到此本文就結束了，關注公眾號檢視更多推送！！！