欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

.NET Core 微信小程序退款步骤——(统一退款)

程序员文章站 2022-09-04 13:45:05
继上一篇".net core 微信小程序支付——(统一下单)后",本文将实现统一退款功能,能支付就应该能退款嘛,一般涉及到钱的东西都会比较敏感,所以在设计退款流程时一定要严谨,不能出一...

继上一篇".net core 微信小程序支付——(统一下单)后",本文将实现统一退款功能,能支付就应该能退款嘛,一般涉及到钱的东西都会比较敏感,所以在设计退款流程时一定要严谨,不能出一点差错,否则你将会面临自己掏腰包的可能,下面我们来讲一讲退款的实现步骤。

退款应该场景及规则

当交易发生之后一段时间内,由于买家或者卖家的原因需要退款时,卖家可以通过退款接口将支付款退还给买家,微信支付将在收到退款请求并且验证成功之后,按照退款规则将支付款按原路退到买家帐号上。

规则

1、交易时间超过一年的订单无法提交退款;

2、微信支付退款支持单笔交易分多次退款,多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。 一笔退款失败后重新提交,请不要更换退款单号,请使用原商户退款单号。

3、请求频率限制:150qps,即每秒钟正常的申请退款请求次数不超过150次

    错误或无效请求频率限制:6qps,即每秒钟异常或错误的退款申请请求不超过6次

4、每个支付订单的部分退款次数不能超过50次

接口地址

接口链接:

相关参数

.NET Core 微信小程序退款步骤——(统一退款)

.NET Core 微信小程序退款步骤——(统一退款)

官方退款文档

文档地址:

实现统一退款流程

如果业务有多处退款流程,可以将退款流程进行封装,方便多位置调用;如果公司有同主体下的不同小程序,都需要退款功能,也是可以进行封装,针对不同的小程序进行退款。

去商户后台先下载证书,退款时需要,下图是商户后台下载证书的界面:

引用包:

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,否则微信也会按规则不停发送退款回调给服务器,直到次数用完为止,具体查看上面规则文档。

总结

以上所述是小编给大家介绍的.net core 微信小程序退款步骤——(统一退款),希望对大家有所帮助