.NET Core 微信小程序退款——（統一退款）

繼上一篇".NET Core 微信小程序支付——（統一下單）後"，本文將實現統一退款功能，能支付就應該能退款嘛，通常涉及到錢的東西都會比較敏感，因此在設計退款流程時必定要嚴謹，不能出一點差錯，不然你將會面臨本身掏腰包的可能，下面咱們來說一講退款的實現步驟。

 

目錄

一、退款應該場景及規則

二、實現統一退款流程

三、退款統一回調處理

四、總結

退款應該場景及規則

當交易發生以後一段時間內，因爲買家或者賣家的緣由須要退款時，賣家能夠經過退款接口將支付款退還給買家，微信支付將在收到退款請求而且驗證成功以後，按照退款規則將支付款按原路退到買家賬號上。

 

規則

一、交易時間超過一年的訂單沒法提交退款；

二、微信支付退款支持單筆交易分屢次退款，屢次退款須要提交原支付訂單的商戶訂單號和設置不一樣的退款單號。申請退款總金額不能超過訂單金額。 一筆退款失敗後從新提交，請不要更換退款單號，請使用原商戶退款單號。

三、請求頻率限制：150qps，即每秒鐘正常的申請退款請求次數不超過150次

    錯誤或無效請求頻率限制：6qps，即每秒鐘異常或錯誤的退款申請請求不超過6次

四、每一個支付訂單的部分退款次數不能超過50次

 

接口地址

接口連接：https://api.mch.weixin.qq.com/secapi/pay/refund

 

相關參數

 

官方退款文檔
文檔地址：https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=9_4&index=6

實現統一退款流程

若是業務有多處退款流程，能夠將退款流程進行封裝，方便多位置調用；若是公司有同主體下的不一樣小程序，都須要退款功能，也是能夠進行封裝，針對不一樣的小程序進行退款。

去商戶後臺先下載證書，退款時須要，下圖是商戶後臺下載證書的界面：

 

引用包：

Senparc.Weixin.WxOpen

Senparc.Weixin.TenPay

 

註冊公衆號，小程序信息

services.AddSenparcGlobalServices(Configuration)
.AddSenparcWeixinServices(Configuration);

IRegisterService register = RegisterService.Start(env, senparcSetting.Value).UseSenparcGlobal(false, null);
register.UseSenparcWeixin(senparcWeixinSetting.Value, senparcSetting.Value)
  .RegisterTenpayV3(senparcWeixinSetting.Value, "appid");

 

統一退款代碼實現

publicbool RefundProduct(OrdOrderProduct ordOrderProduct, PayOrderMstParam payOrderMstParam, OrdOrderPayItem ordOrderPayItem, string appID, DateTime thisTime, ref string errMsg)
{
    try
    {
        OrdOrderPayMst refPay = null;
        if (!PayOrderManager.CreatePayOrderMST(payOrderMstParam, thisTime, ref refPay, ref errMsg))
        {
            errMsg = "生成退款單出錯!" + errMsg;
            return false;
        }

        var PayInfo = Senparc.Weixin.Config.SenparcWeixinSetting.Items[appID];
        string AppID = PayInfo.WxOpenAppId;
        string AppSecret = PayInfo.WxOpenAppSecret;
        string Mch_id = PayInfo.TenPayV3_MchId;//商戶號
        string Mch_key = PayInfo.TenPayV3_Key;//商戶密鑰
        string notifyUrl = string.Format(PayInfo.TenPayV3_TenpayNotify, "RefundNotifyUrl");
        var timeStamp = TenPayV3Util.GetTimestamp();
        var nonceStr = TenPayV3Util.GetNoncestr();



        //支付源單號
        string outTradeNo = ordOrderPayItem.PayNo;//商戶訂單號/支付單號
        refPay.PayNoSource = ordOrderPayItem.PayNo;

        //退款單號
        string outRefundNo = refPay.PayNo;//新退款單號

        //支付時的總金額
        int totalFee = (int)(ordOrderPayItem.PayPrice * 100);
        //退款金額
        int refundFee = (int)(refPay.PayPrice * 100);

        string opUserId = PayInfo.TenPayV3_MchId;

        var dataInfo = new TenPayV3RefundRequestData(AppID, Mch_id, Mch_key,
            null, nonceStr, null, outTradeNo, outRefundNo, totalFee, refundFee, opUserId, null, notifyUrl: notifyUrl);

        //Logger.Info($"PayInfo={PayInfo.SerializeObject()}");
        //Logger.Info($"dataInfo={dataInfo.SerializeObject()}");
        //var basePath = AppContext.BaseDirectory;
        //var certPath = Path.Combine(basePath, "Config/apiclient_cert.p12");
        //var cert = @"D:\projects\orderapi.trydou.com\Config\apiclient_cert.p12";//根據本身的證書位置修改
        //var password = Mch_id;//默認爲商戶號，建議修改
        //配置好證書地址，V3自動識別
        var result = TenPayV3.Refund(dataInfo);

        refPay.PayResult = result.SerializeObject();
        //Logger.Info("提交退款申請：" + refPay.PayResult);
        if (result.return_code.ToUpper() == "SUCCESS" && result.result_code.ToUpper() == "SUCCESS")
        {
            using (TransactionScope scope = new TransactionScope(TransactionScopeAsyncFlowOption.Enabled))
            {
                //業務處理
                //提交事務
                scope.Complete();
            }


            return true;
        }
        else
        {
            errMsg = result.err_code_des;
            Logger.Error(string.Format("提交退款失敗，退款單號={0},關聯訂單號={1},關聯產品={2},退款result={3}",
                refPay.PayNo, refPay.RelationNo, refPay.RelationNos, refPay.PayResult));
        }
    }
    catch (Exception ex)
    {
        errMsg = ex.Message;
        Logger.Error(string.Format("提交退款異常：Message={0}，StackTrace={1}", ex.Message, ex.StackTrace));
            }
            return false;
    }

 

注：注意退款接口的參數，如：金額，退款地址等，確保參數正確，通常微信會收到退款的請求指令，微信處理成功後，會異步回調退款的接口給服務器。

退款統一回調處理

直接上代碼以下：

/// <summary>
/// 退款回調
/// </summary>
[HttpPost("RefundNotifyUrl")]
public ActionResult RefundNotifyUrl()
{
    ResponseResult result = new ResponseResult();

    ResponseHandler resHandler = new ResponseHandler(HttpContext);
    string return_code = resHandler.GetParameter("return_code");
    string return_msg = resHandler.GetParameter("return_msg");

    try
    {
        var mch_key = Senparc.Weixin.Config.SenparcWeixinSetting.TenPayV3_Key;
       
        if (return_code.ToUpper() == "SUCCESS")
        {
            //string result_code = resHandler.GetParameter("result_code");
            //string appId = resHandler.GetParameter("appid");
            //string mch_id = resHandler.GetParameter("mch_id");
            //string nonce_str = resHandler.GetParameter("nonce_str");
            string req_info = resHandler.GetParameter("req_info");

            var decodeReqInfo = TenPayV3Util.DecodeRefundReqInfo(req_info, mch_key);
            var decodeDoc = XDocument.Parse(decodeReqInfo);
            var refundNotifyXml = decodeDoc.SerializeObject();


            //獲取接口中須要用到的信息
            string out_trade_no = decodeDoc.Root.Element("out_trade_no").Value;
            string out_refund_no = decodeDoc.Root.Element("out_refund_no").Value;
            string transaction_id = decodeDoc.Root.Element("transaction_id").Value;
            string refund_id = decodeDoc.Root.Element("refund_id").Value;
            int total_fee = int.Parse(decodeDoc.Root.Element("total_fee").Value);
            int refund_fee = int.Parse(decodeDoc.Root.Element("refund_fee").Value);

            RefundNotifyParam param = new RefundNotifyParam()
            {
                PayNo = out_trade_no,//商戶訂單號
                PayPrice = ((float)refund_fee.ToInt() / 100).ToDecimal(),//退款金額
                Out_refund_no = out_refund_no,//商戶退款單號  
                TransactionNo = transaction_id,//微信訂單號
                Refund_id = refund_id, //微信退款單號   
            };

            Logger.Info(string.Format("退款回調參數，return_code={0},return_msg={1},refundNotifyXml={2}", return_code, return_msg, refundNotifyXml));

            result = Service.RefundNotifyUrl(param);
            if (result.errno != 0)
            {
                //回調處理邏輯失敗
                Logger.Error(string.Format("退款回調業務處理失敗：退款單號{0}，{1}", param.Out_refund_no, result.errmsg));
            }
            else
            {
                Logger.Info(string.Format("退款回調業務處理成功,退款單號：{0}", param.Out_refund_no));
                string xml = string.Format(@"<xml>
                            <return_code><![CDATA[{0}]]></return_code>
                            <return_msg><![CDATA[{1}]]></return_msg>
                            </xml>", return_code, return_msg);

                return Content(xml, "text/xml");
            }
        }
        else
        {
            //錯誤的訂單處理
            Logger.Error(string.Format("退款回調失敗，return_code={0},return_msg={1}", return_code, return_msg));

        }
    }
    catch (Exception ex)
    {
        Logger.Error(string.Format("退款回調異常：Message={0}，StackTrace={1}", ex.Message, ex.StackTrace));
    }

    return Content("fail", "text/xml");
}

 

注：若是業務處理退款成功後，請返回結果告訴微信SUCCESS，不然微信也會按規則不停發送退款回調給服務器，直到次數用完爲止，具體查看上面規則文檔。

總結

以上就是微信退款的流程及相關知識的介紹，若有在實際中遇到問題的可與我聯繫，一塊兒討論學習，下一篇會繼續推出公衆號與小程序的相關文章。