歡迎留言、轉發
微信極速開發系列文章：點擊這里
此文來聊聊微信商戶中的支付工具----現金紅包
現金紅包.png
準備工作
一、開通現金紅包權限
在使用現金紅包之前，請前往開通現金紅包功能。操作路徑：【登錄微信支付商戶平臺——>產品中心——>現金紅包——>開通】。
二、下載API證書
商戶調用微信紅包接口時，服務器會進行證書驗證，請在商戶平臺下載證書
現金紅包-下載證書.png
現金紅包-下載之后的文件.png
有人要問這么多證書到底使用那個呢？跟開發語言有關系嗎？
什么語言使用什么證書,以及如何使用可以參考截圖中的證書說明.txt
內容如下：
歡迎使用微信支付！
微信支付API共四份（證書pkcs12格式、證書pem格式、證書密鑰pem格式、CA證書）,為接口中強制要求時需攜帶的證書文件。
證書屬于敏感信息，請妥善保管不要泄露和被他人復制。
不同開發語言下的證書格式不同，以下為說明指引：
證書pkcs12格式（apiclient_cert.p12）
包含了私鑰信息的證書文件，為p12(pfx)格式，由微信支付簽發給您用來標識和界定您的身份
部分安全性要求較高的API需要使用該證書來確認您的調用身份
windows上可以直接雙擊導入系統，導入過程中會提示輸入證書密碼，證書密碼默認為您的商戶ID（如：10010000）
證書pem格式（apiclient_cert.pem）
從apiclient_cert.p12中導出證書部分的文件，為pem格式，請妥善保管不要泄漏和被他人復制
部分開發語言和環境，不能直接使用p12文件，而需要使用pem，所以為了方便您使用，已為您直接提供
您也可以使用openssl命令來自己導出：openssl pkcs12 -clcerts -nokeys -in apiclient_cert.p12 -out apiclient_cert.pem
證書密鑰pem格式（apiclient_key.pem）
從apiclient_cert.p12中導出密鑰部分的文件，為pem格式
部分開發語言和環境，不能直接使用p12文件，而需要使用pem，所以為了方便您使用，已為您直接提供
您也可以使用openssl命令來自己導出：openssl pkcs12 -nocerts -in apiclient_cert.p12 -out apiclient_key.pem
CA證書（rootca.pem）
微信支付api服務器上也部署了證明微信支付身份的服務器證書，您在使用api進行調用時也需要驗證所調用服務器及域名的真實性
該文件為簽署微信支付證書的權威機構的根證書，可以用來驗證微信支付服務器證書的真實性
某些環境和工具已經內置了若干權威機構的根證書，無需引用該證書也可以正常進行驗證，這里提供給您在未內置所必須根證書的環境中載入使用
三、充值
在發放現金紅包之前，請確保你的資金充足。如若不足，請充值。操作路徑：【登錄商戶平臺——>賬戶中心——>資金管理——>充值】
每個紅包的平均金額必須在1.00元到200.00元之間
現金紅包-充值.png
四、獲取openid
目前支持向指定微信用戶的openid發放指定金額紅包。（獲取openid參見之前寫的文章：極速開發微信公眾號之授權獲取用戶信息
五、相關參數設置
和紅包相關的參數【主要是安全方面：綁定IP、防止用戶盜刷】，你可以在頁面上自主設置和更改。
操作路徑如下：【登錄商戶平臺——>產品中心——>現金紅包——>產品設置】（注：“產品設置”操作按鈕僅當你開通現金紅包功能之后才會出現）。
你可以設置和更改以下參數：
現金紅包-設置參數.png
說明：
1、 調用IP地址：設置之后，僅有已設置的IP地址可以調用，其余的IP調用會報錯；
2、用戶領取上限：限制同一openid同一日領取的個數
3、防刷等級：防刷是指微信風控針對微信小號、僵尸號、機器號等的攔截，你可以通過更改防刷等級控制防刷的強度。
4、 同時，你也可以申請更改紅包額度。但是需要經過微信支付的審核，審核通過之后才會生效。
現金紅包類別
兩者部分參數不同
發送現金紅包
1、發送普通紅包接口 com.javen.weixin.api.RedPackApi.java
private static String sendRedPackUrl = "https://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack";
/**
* 發送紅包
* @param params 請求參數
* @param certPath 證書文件目錄
* @param partner 證書密碼
* @return {String}
*/
public static String sendRedPack(Map<String, String> params, String certPath, String partner) {
return HttpUtils.postSSL(sendRedPackUrl, PaymentKit.toXml(params), certPath, partner);
}
2、發送裂變紅包接口 com.javen.weixin.api.RedPackApi.java
private static String sendGroupRedPackUrl = "https://api.mch.weixin.qq.com/mmpaymkttransfers/sendgroupredpack";
/**
* 發送裂變紅包
* @param params 請求參數
* @param certPath 證書文件目錄
* @param partner 證書密碼
* @return {String}
*/
public static String sendGroupRedPack(Map<String, String> params, String certPath, String partner) {
return HttpUtils.postSSL(sendGroupRedPackUrl, PaymentKit.toXml(params), certPath, partner);
}
具體實現封裝 com.javen.utils.ReadPackUtils.java
1、普通紅包
/**
* 發送普通紅包
* @param request 獲取IP
* @param total_amount 付款現金(單位分)
* @param total_num 紅包發放總人數
* @param wishing 紅包祝福語
* @param act_name 活動名稱
* @param remark 備注
* @param reOpenid 用戶openid
* @param partner 商戶號
* @param wxappid 公眾賬號appid
* @param sendName 商戶名稱
* @param paternerKey 商戶簽名key
* @param certPath 證書路徑
* @return
*/
public static boolean sendredpack(HttpServletRequest request,String total_amount,String total_num,String wishing,String act_name,String remark,String reOpenid,String partner,String wxappid,String sendName,String paternerKey,String certPath) {
// 商戶訂單號
String mchBillno = System.currentTimeMillis() + "";
String ip = IpKit.getRealIp(request);
Map<String, String> params = new HashMap<String, String>();
// 隨機字符串
params.put("nonce_str", System.currentTimeMillis() / 1000 + "");
// 商戶訂單號
params.put("mch_billno", mchBillno);
// 商戶號
params.put("mch_id", partner);
// 公眾賬號ID
params.put("wxappid", wxappid);
// 商戶名稱
params.put("send_name", sendName);
// 用戶OPENID
params.put("re_openid", reOpenid);
// 付款現金(單位分)
params.put("total_amount", total_amount);
// 紅包發放總人數
params.put("total_num", total_num);
// 紅包祝福語
params.put("wishing", wishing);
// 終端IP
params.put("client_ip", ip);
// 活動名稱
params.put("act_name", act_name );
// 備注
params.put("remark", remark);
//創建簽名
String sign = PaymentKit.createSign(params, paternerKey);
params.put("sign", sign);
String xmlResult = RedPackApi.sendRedPack(params, certPath, partner);
Map<String, String> result = PaymentKit.xmlToMap(xmlResult);
log.warn(JsonKit.toJson(result));
//此字段是通信標識，非交易標識，交易是否成功需要查看result_code來判斷
String return_code = result.get("return_code");
//業務結果
String result_code = result.get("result_code");
if (StrKit.isBlank(return_code) || !"SUCCESS".equals(return_code)) {
return false;
}
if (StrKit.notBlank(result_code) && "SUCCESS".equals(result_code)) {
return true;
}
return false;
}
2、裂變紅包
/**
* 發送裂變紅包
* @param partner
* @param wxappid
* @param sendName
* @param reOpenid
* @param total_amount
* @param total_num
* @param wishing
* @param act_name
* @param remark
* @param paternerKey
* @param certPath
* @return
*/
public static boolean sendGroupRedPack(String partner, String wxappid, String sendName, String reOpenid, String total_amount, String total_num, String wishing, String act_name, String remark, String paternerKey, String certPath){
// 商戶訂單號
String mchBillno = System.currentTimeMillis() + "";
Map<String, String> params = new HashMap<String, String>();
// 隨機字符串
params.put("nonce_str", System.currentTimeMillis() / 1000 + "");
// 商戶訂單號
params.put("mch_billno", mchBillno);
// 商戶號
params.put("mch_id", partner);
// 公眾賬號ID
params.put("wxappid", wxappid);
// 商戶名稱
params.put("send_name", sendName);
// 用戶OPENID
params.put("re_openid", reOpenid);
// 付款現金(單位分)
params.put("total_amount", total_amount);
// 紅包發放總人數
params.put("total_num", total_num);
//紅包金額設置方式
params.put("amt_type", "ALL_RAND");
// 紅包祝福語
params.put("wishing", wishing);
// 活動名稱
params.put("act_name", act_name );
// 備注
params.put("remark", remark);
//創建簽名
String sign = PaymentKit.createSign(params, paternerKey);
params.put("sign", sign);
String xmlResult = RedPackApi.sendGroupRedPack(params, certPath, partner);
Map<String, String> result = PaymentKit.xmlToMap(xmlResult);
log.warn(JsonKit.toJson(result));
//此字段是通信標識，非交易標識，交易是否成功需要查看result_code來判斷
String return_code = result.get("return_code");
//業務結果
String result_code = result.get("result_code");
if (StrKit.isBlank(return_code) || !"SUCCESS".equals(return_code)) {
return false;
}
if (StrKit.notBlank(result_code) && "SUCCESS".equals(result_code)) {
return true;
}
return false;
}
發送紅包Demo
/**
* 微信紅包demo
* @author Javen
* 2016年5月28日
*/
public class RedPackApiController extends Controller {
private static String sendName = "Javen205";
//微信證書路徑
private static String certPath = "/Users/Javen/Downloads/cert/apiclient_cert.p12";
//商戶相關資料
String wxappid = PropKit.get("appId");
// 微信支付分配的商戶號
String partner = PropKit.get("mch_id");
//API密鑰
String paternerKey = PropKit.get("paternerKey");
/**
* 發送普通紅包
*/
public void sendredpack() {
boolean isSend = ReadPackUtils.sendredpack(getRequest(), "100", "1", "感謝您參加猜燈謎活動，祝您元宵節快樂！",
"猜燈謎搶紅包活動", "猜越多得越多，快來搶！", "o_pncsidC-pRRfCP4zj98h6slREw",
partner, wxappid, sendName, paternerKey, certPath);
renderJson(isSend);
}
/**
* 發送裂變紅包
*/
public void sendGroupRedPack() {
boolean isSend = ReadPackUtils.sendGroupRedPack(partner, wxappid, "天虹百貨", "o_pncsidC-pRRfCP4zj98h6slREw",
"100", "10", "感謝您參加猜燈謎活動，祝您元宵節快樂！", "猜燈謎搶紅包活動",
"猜越多得越多，快來搶", paternerKey, certPath);
renderJson(isSend);
}
public void query() {
String query = ReadPackUtils.query("10000098201411111234567890", partner, wxappid, paternerKey, certPath);
renderJson(query);
}
}
查詢紅包記錄
接口封裝com.javen.weixin.api.RedPackApi.java
private static String getHBInfo = "https://api.mch.weixin.qq.com/mmpaymkttransfers/gethbinfo ";
/**
* 根據商戶訂單號查詢信息
* @param params 請求參數
* @param certPath 證書文件目錄
* @param partner 證書密碼
* @return {String}
*/
public static String getHbInfo(Map<String, String> params, String certPath, String partner) {
return HttpUtils.postSSL(getHBInfo, PaymentKit.toXml(params), certPath, partner);
}
具體實現封裝 com.javen.utils.ReadPackUtils.java
/**
* 根據商戶訂單號查詢紅包
* @param mch_billno 商戶訂單號
* @param partner 商戶號
* @param wxappid 公眾賬號ID
* @param paternerKey 商戶簽名Key
* @param certPath 證書路徑
* @return
*/
public static String query(String mch_billno,String partner,String wxappid,String paternerKey,String certPath) {
Map<String, String> params = new HashMap<String, String>();
// 隨機字符串
params.put("nonce_str", System.currentTimeMillis() / 1000 + "");
// 商戶訂單號
params.put("mch_billno", mch_billno);
// 商戶號
params.put("mch_id", partner);
// 公眾賬號ID
params.put("appid", wxappid);
params.put("bill_type", "MCHT");
//創建簽名
String sign = PaymentKit.createSign(params, paternerKey);
params.put("sign", sign);
String xmlResult = RedPackApi.getHbInfo(params, certPath, partner);
Map<String, String> result = PaymentKit.xmlToMap(xmlResult);
System.out.println(result);
return JsonKit.toJson(result);
}
碼字完畢，以上就是微信發送現金紅包的詳細介紹。
歡迎留言、轉發
微信極速開發系列文章：http://www.lxweimin.com/p/a172a1b69fdd
此文章項目開源地址：極速開發微信公眾號-Start支持項目發展
