1. 程式人生 > >淺析微信支付:(餘額提現)企業付款到微信使用者零錢或銀行卡賬戶

淺析微信支付:(餘額提現)企業付款到微信使用者零錢或銀行卡賬戶

本文是【淺析微信支付】系列文章的第十二篇,主要講解在商戶存在的提現、商戶付款到微信使用者零錢或者銀行卡需求。


淺析微信支付系列已經更新十二篇了喲~,沒有看過的朋友們可以看一下哦。

淺析微信支付:支付驗收示例和驗收指引

淺析微信支付:如何使用沙箱環境測試

淺析微信支付:下載對賬單和資金賬單

淺析微信支付:申請退款、退款回撥介面、查詢退款

如果你是做電商或者某些有福利返利的系統,基本上會遇到諸如 餘額提現 這類需求,主要就是平臺向用戶返利現金,積累到某一個門檻,可以領取到自己的餘額賬號、銀行卡;或者是使用為使用者傳送現金紅包的方式。

接下來的兩篇文章,會為大家描述在微信支付中,像使用者付款的以上三種方式。

以下為三種付款方式的必要條件:

  1. 商戶號(或同主體其他非服務商商戶號)已入駐90日
  2. 商戶號(或同主體其他非服務商商戶號)有30天連續正常交易
  3. 登入微信支付商戶平臺-產品中心,開通企業付款。

企業付款到微信使用者零錢

企業付款提供由商戶直接付錢至使用者微信零錢的能力,支援平臺操作及介面呼叫兩種方式,資金到賬速度快,使用及查詢方便。主要用來解決合理的商戶對使用者付款需求,比如:保險理賠、彩票兌換等等。

如何開通?

  1. 入駐成為商戶:線上提交營業執照、身份證、銀行賬戶等基本資訊,快速提交申請;
  2. 超級管理員開通:前往商戶平臺-產品中心-企業付款到零錢-申請開通;
  3. 特殊要求:交易資金是即時入賬到商戶號基本戶的商戶,需要滿足以下要求:需入駐滿90天,連續交易30天。

所需資料:開通企業付款到零錢功能無需提供額外的材料。 費用:試用期間免費使用。

應用場景

企業付款為企業提供付款至使用者零錢的能力,支援通過API介面付款,或通過微信支付商戶平臺(pay.weixin.qq.com)網頁操作付款。

以下為官方的解釋:

https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=14_1
複製程式碼

抓重點,首先需要知道的是,開通了運營賬戶的商戶,付款時會從運營賬戶餘額中扣除,這個一定要注意,以免金額不足時付款失敗(可以使用主賬戶為運營賬戶充值,參考[交易中心]-[充值/轉入])。

以下為特別需要注意的地方,為大家標記出來,設計系統時一定要參考一下,以免入坑。

企業付款到餘額-1

介面連結

https://api.mch.weixin.qq.com/mmpaymkttransfers/promotion/transfers
複製程式碼

是否需要證書

請求需要雙向證書。

呼叫介面

注意事項: ◆ 當返回錯誤碼為“SYSTEMERROR”時,請不要更換商戶訂單號,一定要使用原商戶訂單號重試,否則可能造成重複支付等資金風險。 ◆ XML具有可擴充套件性,因此返回引數可能會有新增,而且順序可能不完全遵循此文件規範,如果在解析回包的時候發生錯誤,請商戶務必不要換單重試,請商戶聯絡客服確認付款情況。如果有新回包欄位,會更新到此API文件中。 ◆ 因為錯誤程式碼欄位err_code的值後續可能會增加,所以商戶如果遇到回包返回新的錯誤碼,請商戶務必不要換單重試,請商戶聯絡客服確認付款情況。如果有新的錯誤碼,會更新到此API文件中。 ◆ 錯誤程式碼描述欄位err_code_des只供人工定位問題時做參考,系統實現時請不要依賴這個欄位來做自動化處理。

PS:目前支援向指定微信使用者的openid付款。

官方文件如下:

https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=14_2
複製程式碼

具體的傳入引數,這裡就不一一列舉了,請大家參考一下官方文件,下面貼上具體的實現原始碼:

/**
 * [微信支付提現介面] - 儲存呼叫的相關記錄
 * @param payment 支付物件
 * @param wxPayConfig 微信支付單例物件
 * @return map
 *
 * @author yclimb
 * @date 2018/7/30
 */
public Map<String, String> saveWxPayTransfers(Payment payment, WXPayConfig wxPayConfig) throws Exception {
    // 支付前驗證

    // 微信支付物件
    // WXPay wxPay = new WXPay(WXPayConfigImpl.getInstance());
    WXPay wxPay = new WXPay(wxPayConfig);

    // 微信退款介面
    Map<String, String> resultMap = wxPay.transfers(...);
    logger.info("saveWxPayTransfers:resultMap:" + resultMap.toString());

    // 下單失敗,進行處理
    if (WXPayConstants.FAIL.equals(resultMap.get(WXPayConstants.RETURN_CODE)) || WXPayConstants.FAIL.equals(resultMap.get(WXPayConstants.RESULT_CODE))) {

        // 處理結果返回,無需繼續執行

        // 餘額不足提醒
        if (WXPayCodeEnum.ERR_CODE_NOTENOUGH.getCode().equals(resultMap.get(WXPayConstants.ERR_CODE))) {
            // 傳送餘額不足的訊息提醒
            
        }
    }

    // 付款記錄修改 & 記錄付款日誌
    
    return resultMap;
}
複製程式碼

以上為呼叫的應用方法,下面為大家貼出微信介面呼叫程式碼 imall.weixin.sdk.WXPay

/**
 * 作用:企業向微信使用者個人付款<br>
 * 場景:企業付款為企業提供付款至使用者零錢的能力,支援通過API介面付款,或通過微信支付商戶平臺(pay.weixin.qq.com)網頁操作付款。
 * 介面文件地址:https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=14_2
 *
 * @param partner_trade_no 商戶訂單號
 * @param openid           使用者openid
 * @param amount           企業付款金額
 * @param desc             企業付款描述資訊
 * @param spbill_create_ip 該IP可傳使用者端或者服務端的IP
 * @return API返回資料
 * @throws Exception e
 */
public Map<String, String> transfers(String partner_trade_no, String openid, String amount, String desc, String spbill_create_ip) throws Exception {

    /** 構造請求引數資料 **/
    Map<String, String> data = new HashMap<>();

    // 商戶訂單號	partner_trade_no	是	10000098201411111234567890	String	商戶訂單號,需保持唯一性(只能是字母或者數字,不能包含有符號)
    data.put("partner_trade_no", partner_trade_no);
    // 使用者openid	openid	是	oxTWIuGaIt6gTKsQRLau2M0yL16E	String	商戶appid下,某使用者的openid
    data.put("openid", openid);
    // 校驗使用者姓名選項	check_name	是	FORCE_CHECK	String	NO_CHECK:不校驗真實姓名,FORCE_CHECK:強校驗真實姓名
    data.put("check_name", "NO_CHECK");
    // 金額	amount	是	10099	int	企業付款金額,單位為分
    data.put("amount", String.valueOf(new BigDecimal(amount).multiply(new BigDecimal(100)).setScale(2, BigDecimal.ROUND_HALF_UP).intValue()));
    // 企業付款描述資訊	desc	是	理賠	String	企業付款操作說明資訊。必填。
    data.put("desc", desc);
    // Ip地址	spbill_create_ip	是	192.168.0.1	String(32)	該IP同在商戶平臺設定的IP白名單中的IP沒有關聯,該IP可傳使用者端或者服務端的IP。
    data.put("spbill_create_ip", spbill_create_ip);

    /** 以下引數為非必填引數 **/

    /*// 裝置號	device_info	否	013467007045764	String(32)	微信支付分配的終端裝置號
    data.put("device_info", "xxx");
    // 收款使用者姓名	re_user_name	可選	王小王	String	收款使用者真實姓名。(如果check_name設定為FORCE_CHECK,則必填使用者真實姓名)
    data.put("re_user_name", "xxx");*/

    // 微信呼叫介面
    Map<String, String> resultMap = this.transfers(data);

    WXPayUtil.getLogger().info("wxPay.transfers:" + resultMap);

    return resultMap;
}
複製程式碼

PS:推薦資料庫中對於金額儲存為數值單位,以分為單位來儲存,1.1元可以儲存為101,這樣和微信對應,會方便很多。

對於企業付款查詢的介面,這裡就不詳細描述了,以下為具體的官方文件連結:

https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=14_3
複製程式碼

需要的朋友,根據文件進行介面查詢即可,非高頻介面。

企業付款到銀行卡

企業付款到銀行卡提供由商戶直接付錢至指定銀行卡賬戶的能力,支援平臺操作及介面呼叫兩種方式,資金到賬速度快,使用及查詢方便。主要用來解決合理的商戶對使用者付款需求,比如:保險理賠、彩票兌換等等。

開通流程:

  1. 入駐成為商戶:線上提交營業執照、身份證、銀行賬戶等基本資訊,快速提交申請;
  2. 超級管理員開通:前往商戶平臺-產品中心-企業付款到銀行卡-申請開通;
  3. 特殊要求:交易資金是即時入賬到商戶號基本戶的商戶,需要滿足以下要求:需入駐滿90天,連續交易30天。

所需資料:開通企業付款到銀行卡功能無需提供額外的材料。 費用:此功能需收取手續費,按照單筆金額收取,每筆收取0.1%,最低1元,最高25元。

應用場景

微信支付已上線企業付款至銀行卡功能。商戶可以將商戶號餘額付款至指定的收款銀行賬戶。通過指定收款銀行賬戶戶名、卡號,以及收款銀行資訊即可實現付款。

官方文件地址:

https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=24_1&index=1
複製程式碼

功能說明:

  1. 企業付款至銀行卡只支援新資金流型別賬戶
  2. 目前企業付款到銀行卡支援17家銀行,更多銀行逐步開放中
  3. 付款到賬實效為1-3日,最快次日到賬
  4. 每筆按付款金額收取手續費,按金額0.1%收取,最低1元,最高25元,如果商戶開通了運營賬戶,手續費和付款的金額都從運營賬戶出。如果沒有開通,則都從基本戶出。
  5. 每個商戶號每天可以出款100萬,單商戶給同一銀行卡付款每天限額5萬
  6. 發票:在賬戶中心-發票資訊頁面申請開票的商戶會按月收到發票(已申請的無需重複申請)。 企業付款到銀行卡發票與交易手續費發票為拆分單獨開具。

需要注意的是,微信支援的銀行有限,具體的支援銀行見如下連結:

https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=24_4&index=5
複製程式碼

所以肯定會出現不支援的銀行,小夥伴們在開發的時候,可以在前後端控制使用者選擇提現銀行來解決。

平臺上手動付款流程:

  1. 在產品中心,開通企業付款到個人銀行卡功能
  2. 進入交易中心-企業付款到銀行卡頁面進行付款
  3. 指定收款銀行賬號、戶名、收款方開戶行,及付款金額資訊,即可實現付款

介面連結

https://api.mch.weixin.qq.com/mmpaysptrans/pay_bank
複製程式碼

是否需要證書

請求需要雙向證書。

呼叫介面

介面介紹: 用於企業向微信使用者銀行卡付款 目前支援介面API的方式向指定微信使用者的銀行卡付款。

介面呼叫規則: ◆ 單商戶日限額——單日100w ◆ 單次限額——單次5w ◆ 單商戶給同一銀行卡單日限額——單日5w

注意:重點來了,首先,收款方銀行卡號enc_bank_no、收款方使用者名稱enc_true_name 這兩個入參是需要 採用標準RSA演算法,公鑰由微信側提供 得到的,所以還需要先拿到這個金鑰,下面是官方文件地址:

https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=24_7&index=4
複製程式碼

以上文件詳細介紹瞭如何得到具體的金鑰方式,如果有看不明白的小夥伴,可以直接百度 獲取RSA加密公鑰API,可以得到很多示例,這裡我就不講了。

除入參和企業付款到微信使用者零錢有所不一致之外,其他方面都差不多,小夥伴們可以參考上面付款到零錢的介面來實現付款到銀行卡介面。

結語

以上為微信餘額提現相關的解釋和原始碼,小夥伴們一定要注意看看官方文件哦,具體的原始碼可以看作者的github,裡面對每個方法有詳細的註釋。

如果小夥伴有遇到解決不了的問題,可以關注作者微信公眾號,加入討論群中發出疑問,和小夥伴們一起解決哦~

預告:下一篇文章會講發放獎勵的另一種方式 商戶平臺-現金紅包,敬請期待!!!

​如果想要提前一覽原始碼的小夥伴,可以先看看我的 github,地址如下: ​ ​​https://github.com/YClimb/wxpay-sdk/blob/master/README.md ​

關注作者微信公眾號,點選下方討論群,掃碼即可加入微信支付討論群與小夥伴一起探討哦~

到此本文就結束了,關注公眾號檢視更多推送!!!


關注我的公眾號