.NET Core 微信小程序退款步驟——(統(tǒng)一退款)
繼上一篇".NET Core 微信小程序支付——(統(tǒng)一下單)后",本文將實現(xiàn)統(tǒng)一退款功能,能支付就應(yīng)該能退款嘛,一般涉及到錢的東西都會比較敏感,所以在設(shè)計退款流程時一定要嚴(yán)謹(jǐn),不能出一點差錯,否則你將會面臨自己掏腰包的可能,下面我們來講一講退款的實現(xiàn)步驟。
退款應(yīng)該場景及規(guī)則
當(dāng)交易發(fā)生之后一段時間內(nèi),由于買家或者賣家的原因需要退款時,賣家可以通過退款接口將支付款退還給買家,微信支付將在收到退款請求并且驗證成功之后,按照退款規(guī)則將支付款按原路退到買家?guī)ぬ柹稀?/p>
規(guī)則
1、交易時間超過一年的訂單無法提交退款;
2、微信支付退款支持單筆交易分多次退款,多次退款需要提交原支付訂單的商戶訂單號和設(shè)置不同的退款單號。申請退款總金額不能超過訂單金額。 一筆退款失敗后重新提交,請不要更換退款單號,請使用原商戶退款單號。
3、請求頻率限制:150qps,即每秒鐘正常的申請退款請求次數(shù)不超過150次
錯誤或無效請求頻率限制:6qps,即每秒鐘異?;蝈e誤的退款申請請求不超過6次
4、每個支付訂單的部分退款次數(shù)不能超過50次
接口地址
接口鏈接:https://api.mch.weixin.qq.com/secapi/pay/refund
相關(guān)參數(shù)
官方退款文檔
文檔地址:https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=9_4&index=6
實現(xiàn)統(tǒng)一退款流程
如果業(yè)務(wù)有多處退款流程,可以將退款流程進行封裝,方便多位置調(diào)用;如果公司有同主體下的不同小程序,都需要退款功能,也是可以進行封裝,針對不同的小程序進行退款。
去商戶后臺先下載證書,退款時需要,下圖是商戶后臺下載證書的界面:
引用包:
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");
統(tǒng)一退款代碼實現(xiàn)
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";//根據(jù)自己的證書位置修改 //var password = Mch_id;//默認(rèn)為商戶號,建議修改 //配置好證書地址,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)) { //業(yè)務(wù)處理 //提交事務(wù) scope.Complete(); } return true; } else { errMsg = result.err_code_des; Logger.Error(string.Format("提交退款失敗,退款單號={0},關(guān)聯(lián)訂單號={1},關(guān)聯(lián)產(chǎn)品={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; }
注:注意退款接口的參數(shù),如:金額,退款地址等,確保參數(shù)正確,一般微信會收到退款的請求指令,微信處理成功后,會異步回調(diào)退款的接口給服務(wù)器。
退款統(tǒng)一回調(diào)處理
直接上代碼如下:
/// <summary> /// 退款回調(diào) /// </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("退款回調(diào)參數(shù),return_code={0},return_msg={1},refundNotifyXml={2}", return_code, return_msg, refundNotifyXml)); result = Service.RefundNotifyUrl(param); if (result.errno != 0) { //回調(diào)處理邏輯失敗 Logger.Error(string.Format("退款回調(diào)業(yè)務(wù)處理失?。和丝顔翁杮0},{1}", param.Out_refund_no, result.errmsg)); } else { Logger.Info(string.Format("退款回調(diào)業(yè)務(wù)處理成功,退款單號:{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("退款回調(diào)失敗,return_code={0},return_msg={1}", return_code, return_msg)); } } catch (Exception ex) { Logger.Error(string.Format("退款回調(diào)異常:Message={0},StackTrace={1}", ex.Message, ex.StackTrace)); } return Content("fail", "text/xml"); }
注:如果業(yè)務(wù)處理退款成功后,請返回結(jié)果告訴微信SUCCESS,否則微信也會按規(guī)則不停發(fā)送退款回調(diào)給服務(wù)器,直到次數(shù)用完為止,具體查看上面規(guī)則文檔。
總結(jié)
以上所述是小編給大家介紹的.NET Core 微信小程序退款步驟——(統(tǒng)一退款),希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復(fù)大家的。在此也非常感謝大家對腳本之家網(wǎng)站的支持!
如果你覺得本文對你有幫助,歡迎轉(zhuǎn)載,煩請注明出處,謝謝!
相關(guān)文章
(asp.net c#)DropDownList綁定后顯示對應(yīng)的項的兩種方法
(asp.net c#)DropDownList綁定后顯示對應(yīng)的項的兩種方法 其實兩個方法的思路都是一樣,都是拿id去配對2011-04-04asp.net XMLHttpRequest實現(xiàn)用戶注冊前的驗證
用戶注冊前的驗證,提高用戶體驗。2009-10-10詳細(xì)說明asp.net中datareader 和 dataset 的區(qū)別
asp.net中datareader 和 dataset的區(qū)別主要是在獲取數(shù)據(jù)的機制和獲取數(shù)據(jù)的方式方面,下面我們來看教程2013-08-08asp.net通過js實現(xiàn)Cookie創(chuàng)建以及清除Cookie數(shù)組的代碼
asp.net Cookie創(chuàng)建以及清除Cookie數(shù)組2010-03-03詳解Asp.net web.config customErrors 如何設(shè)置
這篇文章主要介紹了詳解Asp.net web.config customErrors 如何設(shè)置,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2018-02-02Asp.net實現(xiàn)選擇性的保留DataTable中的列
選擇性的保留DataTable中的列(移除列/保留列不移除/移除不需要的列),很多新手朋友們都想實現(xiàn)這樣的功能,本文總結(jié)了一些可行方法,感興趣的朋友可以了解下哦2013-01-01