C#開發微信門戶及應用(35)--微信支付之企業付款封裝操做

時間 2019-11-18

標籤 c# 開發微信門戶應用支付企業付款封裝欄目 C# 简体版

原文原文鏈接

在前面幾篇隨筆，都是介紹微信支付及紅包相關的內容，其實支付部分的內容還有不少，例如企業付款、公衆號支付或刷卡支付、搖一搖紅包、代金券等方面的內容，這些都是微信接口支持的內容，本篇繼續微信支付這一主題，繼續介紹微信支付中的企業付款的操做，實現對企業付款API的接口C#代碼的封裝，以及測試效果。php

一、企業付款的介紹

所謂企業付款指的是，在功能開放後諸如保險行業的客戶理賠、退保、商品退款、發放徵集活動獎金、抽獎互動等操做均可以經過企業付款完成。而此前，微信支付只能提供客戶向企業單向付款。html

商戶若是須要給用戶付款，能夠直接將錢打入用戶的「微信零錢」中，微信支付將作零錢入帳消息通知，零錢收支明細會展現相應記錄。針對無零錢帳戶的歷史客戶端版本，資金將進入用戶的紅包帳戶，微信支付無消息通知用戶，企業可選擇自行觸達用戶。json

經過認證的企業號能夠開通微信支付功能。經過認證的企業號能夠管理平臺的「服務中心」的「微信支付」入口裏進行微信支付功能申請。而開通微信支付功能後，企業號將擁有兩項功能：收款和付款。若是是用戶號對企業號付款，款項將會進入企業號所關聯的商戶號中。同時，企業號能夠經過微信紅包或微信轉帳的形式對用戶號付款。api

企業付款，提供企業向用戶付款的功能，支持企業經過API接口付款，或經過微信支付商戶平臺網頁功能操做付款。安全

涉及資金操做的功能，安全性要求較高，須要操做員安裝證書（商戶平臺-帳戶設置-密碼安全-操做證書）；經過API或網頁操做，付款至目標用戶（企業可根據APPID+OpenID鎖定目標用戶）。針對已實名認證的用戶，微信支付可提供校驗真實姓名一致性的可選功能。服務器

企業付款提示：微信

◆ 給同一個實名用戶付款，單筆單日限額2W/2Wapp

◆ 給同一個非實名用戶付款，單筆單日限額2000/2000post

◆ 一個商戶同一日付款總額限額100W測試

◆僅支持商戶號已綁定的APPID；

◆針對付款的目標用戶，已微信支付實名認證的用戶可提供校驗真實姓名的功能，未實名認證的用戶沒法校驗，企業可根據自身業務的安全級別選擇驗證類型；

◆付款金額必須小於或等於商戶當前可用餘額的金額；

◆ 已付款的記錄，企業可經過企業付款查詢查看相應數據。

二、企業付款API

企業付款業務是基於微信支付商戶平臺的資金管理能力，爲了協助商戶方便地實現企業向我的付款，針對部分有開發能力的商戶，提供經過API完成企業付款的功能。
好比目前的保險行業向客戶退保、給付、理賠。

企業付款將使用商戶的可用餘額，需確保可用餘額充足。查看可用餘額、充值、提現請登陸商戶平臺「資金管理」進行操做。

接口地址

接口連接：https://api.mch.weixin.qq.com/mmpaymkttransfers/promotion/transfers

是否須要證書

請求須要雙向證書。詳見證書使用

請求參數

提交數據示例：

<xml>
<mch_appid>wxe062425f740c30d8</mch_appid>
<mchid>10000098</mchid>
<nonce_str>3PG2J4ILTKCH16CQ2502SI8ZNMTM67VS</nonce_str>
<partner_trade_no>100000982014120919616</partner_trade_no>
<openid>ohO4Gt7wVPxIT1A9GjFaMYMiZY1s</openid>
<check_name>OPTION_CHECK</check_name>
<re_user_name>張三</re_user_name>
<amount>100</amount>
<desc>節日快樂!</desc>
<spbill_create_ip>10.2.3.10</spbill_create_ip>
<sign>C97BDBACF37622775366F38B629F45E3</sign>
</xml>

成功返回的數據示例：

<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[]]></return_msg>
<mch_appid><![CDATA[wxec38b8ff840bd989]]></mch_appid>
<mchid><![CDATA[10013274]]></mchid>
<device_info><![CDATA[]]></device_info>
<nonce_str><![CDATA[lxuDzMnRjpcXzxLx0q]]></nonce_str>
<result_code><![CDATA[SUCCESS]]></result_code>
<partner_trade_no><![CDATA[10013574201505191526582441]]></partner_trade_no>
<payment_no><![CDATA[1000018301201505190181489473]]></payment_no>
<payment_time><![CDATA[2015-05-19 15：26：59]]></payment_time>
</xml>

根據上面的接口描述，以及輸入，返回參數，咱們能夠構建對應的C#代碼的接口

根據上面的接口定義，咱們能夠定義接口信息以下所示

    /// <summary>
    /// 微信支付接口
    /// </summary>
    public interface ITenPayApi
    {  

        /// <summary>
        /// 企業付款(請求須要雙向證書)
        /// 企業付款業務是基於微信支付商戶平臺的資金管理能力，爲了協助商戶方便地實現企業向我的付款，
        /// 針對部分有開發能力的商戶，提供經過API完成企業付款的功能。 好比目前的保險行業向客戶退保、給付、理賠。
        /// 企業付款將使用商戶的可用餘額，需確保可用餘額充足。查看可用餘額、充值、提現請登陸商戶平臺「資金管理」進行操做。https://pay.weixin.qq.com/ 
        /// 注意：與商戶微信支付收款資金並不是同一帳戶，須要單獨充值。
        /// </summary>
        /// <param name="json">企業支付數據</param>
        /// <returns></returns>
        CorpPayResult CorpPay(CorpPayJson json);

        ..............

其中上面的CorpPayJson 和CorpPayResult 分別是傳入參數和獲取的結果內容，二者的對象信息根據參數進行定義便可。

    /// <summary>
    /// 企業付款的數據信息
    /// </summary>
    public class CorpPayJson
    {
        public CorpPayJson()
        {
            this.check_name = "FORCE_CHECK";
        }

        /// <summary>
        /// 微信支付分配的終端設備號
        /// </summary>
        public string device_info { get; set; }

        /// <summary>
        /// 用戶openid
        /// </summary>
        public string openid { get; set; }

        /// <summary>
        /// 校驗用戶姓名選項,可使用 PayCheckName枚舉對象獲取名稱
        /// NO_CHECK：不校驗真實姓名 
        /// FORCE_CHECK：強校驗真實姓名（未實名認證的用戶會校驗失敗，沒法轉帳） 
        /// OPTION_CHECK：針對已實名認證的用戶才校驗真實姓名（未實名認證用戶不校驗，能夠轉帳成功）
        /// </summary>
        public string check_name { get; set; }

        /// <summary>
        /// 收款用戶真實姓名。 
        /// 若是check_name設置爲FORCE_CHECK或OPTION_CHECK，則必填用戶真實姓名
        /// </summary>
        public string re_user_name { get; set; }

        /// <summary>
        /// 企業付款金額，單位爲分
        /// </summary>
        public int amount { get; set; }

        /// <summary>
        /// 企業付款操做說明信息。必填。
        /// </summary>
        public string desc { get; set; }

        /// <summary>
        /// 調用接口的機器Ip地址
        /// </summary>
        public string spbill_create_ip { get; set; }
    }

    /// <summary>
    /// 企業付款操做的返回結果
    /// </summary>
    public class CorpPayResult : PayResult
    {    
        /// <summary>
        /// 微信分配的公衆帳號ID（企業號corpid即爲此appId）
        /// </summary>
        public string mch_appid { get; set; }

        /// <summary>
        /// 微信支付分配的終端設備號
        /// </summary>
        public string device_info { get; set; }

        /// <summary>
        /// 商戶使用查詢API填寫的單號的原路返回. 
        /// </summary>
        public string partner_trade_no { get; set; }

        /// <summary>
        /// 企業付款成功，返回的微信訂單號
        /// </summary>
        public string payment_no { get; set; }

        /// <summary>
        /// 企業付款成功時間
        /// </summary>
        public string payment_time { get; set; }
    }

企業付款的API實現和前面兩種紅包的處理方式差很少，一個是傳入常規的帳號信息，一個是傳入業務參數，而後提交獲取結果便可，具體代碼以下所示。

        /// <summary>
        /// 企業付款(請求須要雙向證書)
        /// 企業付款業務是基於微信支付商戶平臺的資金管理能力，爲了協助商戶方便地實現企業向我的付款，
        /// 針對部分有開發能力的商戶，提供經過API完成企業付款的功能。 好比目前的保險行業向客戶退保、給付、理賠。
        /// 企業付款將使用商戶的可用餘額，需確保可用餘額充足。查看可用餘額、充值、提現請登陸商戶平臺「資金管理」進行操做。https://pay.weixin.qq.com/ 
        /// 注意：與商戶微信支付收款資金並不是同一帳戶，須要單獨充值。
        /// </summary>
        /// <param name="json">企業支付數據</param>
        /// <returns></returns>
        public CorpPayResult CorpPay(CorpPayJson json)
        {
            CheckAccount();//檢查AccountInfo的對象屬性值

            WxPayData data = new WxPayData();
            data.SetValue("mch_appid", AccountInfo.UniteAppId);//公衆帳號appid， 注意是mch_appid，而非wxappid
            data.SetValue("mchid", AccountInfo.MchID);//商戶號, 注意是mchid而非mch_id
            data.SetValue("nonce_str", data.GenerateNonceStr());//隨機字符串
            data.SetValue("spbill_create_ip", NetworkUtil.GetIPAddress());//終端ip      
            data.SetValue("partner_trade_no", data.GenerateOutTradeNo(AccountInfo.MchID));//隨機字符串

            data.SetValue("device_info", json.device_info);//終端ip            
            data.SetValue("openid", json.openid);
            data.SetValue("check_name", json.check_name);
            data.SetValue("re_user_name", json.re_user_name);
            data.SetValue("amount", json.amount);
            data.SetValue("desc", json.desc);

            data.SetValue("sign", data.MakeSign(AccountInfo.PayAPIKey));//最後生成簽名

            var url = string.Format("https://api.mch.weixin.qq.com/mmpaymkttransfers/promotion/transfers");
            return Helper.GetPayResultWithCert<CorpPayResult>(data, url, AccountInfo.CertPath, AccountInfo.CertPassword);
        }

接口定義及實現好後，咱們能夠在項目中對API進行調用測試，具體代碼以下所示

CorpPayJson json = new CorpPayJson()
            {
                amount = 100,
                check_name = PayCheckName.FORCE_CHECK.ToString(),
                desc = "測試退款",
                openid = this.openId,
                device_info = "",
                re_user_name = "伍華聰",
                spbill_create_ip = NetworkUtil.GetIPAddress()
            };

            var result = api.CorpPay(json);
            var message = string.Format("企業直接付款:{0} {1}", result.Success ? "成功" : "失敗", result.Message);
            Console.WriteLine(message);
            Console.WriteLine(result.ToJson());