⽀付--退款（⽀付⾦额原路退回）
内容摘要：⽤户⽀付完成后，凭商户订单号发起退款申请，处理后，将⽀付⾦额原路退回⾄⽤户⽀付账户。
服务端开发环境：.NET MVC 开发语⾔C#；
⼀、开发前准备（此处，前提默认条件为您已开通商户平台，且成功⽀付⼀笔订单）
三、代码实现
1、主体代码（调⽤⽇志请视业务情况⾃⾏添加，本⽂不再添加⽇志）
public class Refund
{
/***
* 申请退款完整业务流程逻辑
* @param transaction_id 订单号（优先使⽤）
* @param out_trade_no 商户订单号
* @param refund_orderNo 订单退单号
* @param total_fee 订单总⾦额
* @param refund_fee 退款⾦额
* @return 退款结果（xml格式）
* @payType 2⽀付 3⼩程序⽀付
*/
public void Run(string orderNo, string refund_orderNo, float total_fee, float refund_fee, int payType)
{
try
{
WxPayData data = new WxPayData();// 服务基础数据帮助类WxPayData请参阅代码块3
data.SetValue("out_trade_no", orderNo); // ⽀付订单单号
data.SetValue("total_fee", total_fee * 100); // 订单总⾦额，⾦额单位为分
data.SetValue("refund_fee", refund_fee * 100); // 退款⾦额，⾦额单位为分
data.SetValue("out_refund_no", refund_orderNo); // 随机⽣成商户退款单号可参阅refund_orderNo = WxPayApi.GenerateOutTradeNo()⽣成唯⼀退款码 data.SetValue("op_user_id", WxPayConfig.GetConfig().GetMchID()); // 资⾦流向的商户号
WxPayData wxResult = WxPayApi.Refund(data, payType, 6);// 提交退款申请给API，接收返回数据 WxPayApi.Refund()⽅法请参阅代码块2 if (wxResult.GetValue("return_code") + "" == "SUCCESS")
{
if (wxResult.GetValue("result_code") + "" == "SUCCESS")
{
/
/ ...退款成功的操作
}
else
{
// 退款失败的操作...
// 返回的退款失败码
string return_ero_des = wxResult.GetValue("err_code_des") + "";
}
}
else
{
/
/ 退款失败的操作...
// 退款失败原因
string return_msg = wxResult.GetValue("return_msg") + "";
}
}
catch (Exception ex)
{
throw ex;
}
}
}
2、WxPayApi.Refund退款⽅法
public class WxPayApi
{
/**
* 根据当前系统时间加随机序列来⽣成订单号
* @return 订单号
*/
public static string GenerateOutTradeNo()
{
var ran = new Random();
return string.Format("{0}{1}{2}", WxPayConfig.GetConfig().GetMchID(), DateTime.Now.ToString("yyyyMMddHHmmss"), ran.Next(999));
}
public static string GenerateNonceStr()
{
RandomGenerator randomGenerator = new RandomGenerator();
return randomGenerator.GetRandomUInt().ToString();
}
/**
*
* 测速上报
* @param string interface_url 接⼝URL
* @param int timeCost 接⼝耗时
元旦主持词开场白
* @param WxPayData inputObj参数数组
*/
private static void ReportCostTime(string interface_url, int timeCost, WxPayData inputObj)
{
//如果不需要进⾏上报
if (WxPayConfig.GetConfig().GetReportLevel() == 0)
{
return;
}
//如果仅失败上报
if (WxPayConfig.GetConfig().GetReportLevel() == 1 && inputObj.IsSet("return_code") && inputObj.G
etValue("return_code").ToString() == "SUCCESS" && inputObj.IsSet("result_code") && inputObj.GetValue("result_code").ToString() == "SUCCESS")
{
return;
}
//上报逻辑
WxPayData data = new WxPayData();
data.SetValue("interface_url", interface_url);
data.SetValue("execute_time_", timeCost);
//返回状态码
if (inputObj.IsSet("return_code"))
{
data.SetValue("return_code", inputObj.GetValue("return_code"));
}
//返回信息
if (inputObj.IsSet("return_msg"))
{
data.SetValue("return_msg", inputObj.GetValue("return_msg"));
}
//业务结果
if (inputObj.IsSet("result_code"))
{
data.SetValue("result_code", inputObj.GetValue("result_code"));
}
//错误代码
if (inputObj.IsSet("err_code"))
{
data.SetValue("err_code", inputObj.GetValue("err_code"));
}
//错误代码描述
if (inputObj.IsSet("err_code_des"))
{
data.SetValue("err_code_des", inputObj.GetValue("err_code_des"));
}
/
/商户订单号
if (inputObj.IsSet("out_trade_no"))
{
data.SetValue("out_trade_no", inputObj.GetValue("out_trade_no"));
}
//设备号
if (inputObj.IsSet("device_info"))
{
data.SetValue("device_info", inputObj.GetValue("device_info"));
}
try
{
Report(data);
}
catch (WxPayException ex)
{
//不做任何处理
}
}
/**
*
* 测速上报接⼝实现
* @param WxPayData inputObj 提交给测速上报接⼝的参数
* @param int timeOut 测速上报接⼝超时时间
* @throws WxPayException
* @return 成功时返回测速上报接⼝返回的结果，其他抛异常
*/
public static WxPayData Report(WxPayData inputObj, int timeOut = 1)
{
string url = "h.weixin.qq/payitil/report";
//检测必填参数
if (!inputObj.IsSet("interface_url"))
{
throw new WxPayException("接⼝URL，缺少必填参数interface_url！");
}
if (!inputObj.IsSet("return_code"))
{
throw new WxPayException("返回状态码，缺少必填参数return_code！");
}
if (!inputObj.IsSet("result_code"))
{
throw new WxPayException("业务结果，缺少必填参数result_code！");
}
if (!inputObj.IsSet("user_ip"))
{
throw new WxPayException("访问接⼝IP，缺少必填参数user_ip！");
}
if (!inputObj.IsSet("execute_time_"))
{
throw new WxPayException("接⼝耗时，缺少必填参数execute_time_！");
}
inputObj.SetValue("appid", WxPayConfig.GetConfig().GetAppID());//公众账号ID
inputObj.SetValue("mch_id", WxPayConfig.GetConfig().GetMchID());//商户号
inputObj.SetValue("user_ip", WxPayConfig.GetConfig().GetIp());//终端ip
inputObj.SetValue("time", DateTime.Now.ToString("yyyyMMddHHmmss"));//商户上报时间
inputObj.SetValue("nonce_str", GenerateNonceStr());//随机字符串
inputObj.SetValue("sign_type", WxPayData.SIGN_TYPE_HMAC_SHA256);//签名类型
inputObj.SetValue("sign", inputObj.MakeSign());//签名
string xml = inputObj.ToXml();
string response = HttpService.Post(xml, url, false, timeOut);
WxPayData result = new WxPayData();
result.FromXml(response);
return result;
}
/**
*
六一短信祝福* 申请退款
* @param WxPayData inputObj 提交给申请退款API的参数
* @param int timeOut 超时时间
* @throws WxPayException
* @return 成功时返回接⼝调⽤结果，其他抛异常
*/
public static WxPayData Refund(WxPayData inputObj, int payType, int timeOut = 6)
{
string url = "h.weixin.qq/secapi/pay/refund";
//检测必填参数
if (!inputObj.IsSet("out_trade_no") && !inputObj.IsSet("transaction_id"))
{
throw new WxPayException("退款申请接⼝中，out_trade_no、transaction_id⾄少填⼀个！"); }
else if (!inputObj.IsSet("out_refund_no"))
{
throw new WxPayException("退款申请接⼝中，缺少必填参数out_refund_no！");
}
else if (!inputObj.IsSet("total_fee"))
{
throw new WxPayException("退款申请接⼝中，缺少必填参数total_fee！");
}
else if (!inputObj.IsSet("refund_fee"))
{
throw new WxPayException("退款申请接⼝中，缺少必填参数refund_fee！");
}
else if (!inputObj.IsSet("op_user_id"))
{
throw new WxPayException("退款申请接⼝中，缺少必填参数op_user_id！");
}
if (payType == 2)// PC扫码⽀付退款
{
inputObj.SetValue("appid", WxPayConfig.GetConfig().GetAppID());// 公众平台AppId
}
else // ⼩程序⽀付退款
{
inputObj.SetValue("appid", WxAppId);// ⼩程序appID
}
inputObj.SetValue("mch_id", WxPayConfig.GetConfig().GetMchID());// 资⾦流向商户号
inputObj.SetValue("nonce_str", Guid.NewGuid().ToString().Replace("-", ""));//随机字符串
祝所有劳动者节日快乐inputObj.SetValue("sign_type", WxPayData.SIGN_TYPE_HMAC_SHA256);//签名类型
inputObj.SetValue("sign", inputObj.MakeSign());//签名
string xml = inputObj.ToXml();
var start = DateTime.Now;
string response = HttpService.Post(xml, url, true, timeOut);//调⽤HTTP通信接⼝提交数据到API var end = DateTime.Now;
int timeCost = (int)((end - start).TotalMilliseconds);//获得接⼝耗时
//将xml格式的结果转换为对象以返回
WxPayData result = new WxPayData();
result.FromXml(response);
ReportCostTime(url, timeCost, result);//测速上报
return result;
}
}
3、退款基础数据帮助类
///<summary>
///⽀付协议接⼝数据类，所有的API接⼝通信都依赖这个数据结构，
/
//在调⽤接⼝之前先填充各个字段的值，然后进⾏接⼝通信，
///这样设计的好处是可扩展性强，⽤户可随意对协议进⾏更改⽽不⽤重新设计数据结构，
///还可以随意组合出不同的协议数据包，不⽤为每个协议设计⼀个数据包结构
///</summary>
public class WxPayData
{
public const string SIGN_TYPE_MD5 = "MD5";
public const string SIGN_TYPE_HMAC_SHA256 = "HMAC-SHA256";
public WxPayData()
{
}
/
/采⽤排序的Dictionary的好处是⽅便对数据包进⾏签名，不⽤再签名之前再做⼀次排序
private SortedDictionary<string, object> m_values = new SortedDictionary<string, object>();
/**
* 设置某个字段的值
* @param key 字段名
* @param value 字段值
*/
public void SetValue(string key, object value)
{
m_values[key] = value;
}
/
**
* 根据字段名获取某个字段的值
* @param key 字段名
* @return key对应的字段值
*/
public object GetValue(string key)
{
object o = null;
m_values.TryGetValue(key, out o);
return o;
}
/
**
* 判断某个字段是否已设置
* @param key 字段名
* @return 若字段key已被设置，则返回true，否则返回false
民事责任的归责原则*/
public bool IsSet(string key)
{
object o = null;
m_values.TryGetValue(key, out o);
if (null != o)
return true;
新还珠格格的插曲
else
return false;
}
/**
* @将Dictionary转成xml
* @return 经转换得到的xml串
* @throws WxPayException
**/
public string ToXml()
{
//数据为空时不能转化为xml格式
if (0 == m_values.Count)
{
throw new WxPayException("WxPayData数据为空!");
}
string xml = "<xml>";
foreach (KeyValuePair<string, object> pair in m_values)
{
//字段值不能为null，会影响后续流程
if (pair.Value == null)
{
throw new WxPayException("WxPayData内部含有值为null的字段!");
}
if (pair.Value.GetType() == typeof(int) || pair.Value.GetType() == typeof(float))
{
xml += "<" + pair.Key + ">" + pair.Value + "</" + pair.Key + ">";
}
else if (pair.Value.GetType() == typeof(string))
{
xml += "<" + pair.Key + ">" + "<![CDATA[" + pair.Value + "]]></" + pair.Key + ">"; }
else//除了string和int类型不能含有其他数据类型
{
领导最想听到的祝福语throw new WxPayException("WxPayData字段数据类型错误!");
}
}
xml += "</xml>";
return xml;
}
/**
* @将xml转为WxPayData对象并返回对象内部的数据
* @param string 待转换的xml串
* @return 经转换得到的Dictionary
* @throws WxPayException
*/
public SortedDictionary<string, object> FromXml(string xml)
{
if (string.IsNullOrEmpty(xml))
{
throw new WxPayException("将空的xml串转换为WxPayData不合法!");
}
SafeXmlDocument xmlDoc = new SafeXmlDocument();
xmlDoc.LoadXml(xml);
XmlNode xmlNode = xmlDoc.FirstChild;//获取到根节点<xml>
XmlNodeList nodes = xmlNode.ChildNodes;
foreach (XmlNode xn in nodes)
{
XmlElement xe = (XmlElement)xn;
m_values[xe.Name] = xe.InnerText;//获取xml的键值对到WxPayData内部的数据中
}
try
{
if (m_values["return_code"] + "" != "SUCCESS")
{
return m_values;
}
CheckSign();//验证签名，不通过会抛异常
}
catch (WxPayException ex)
{
throw new WxPayException(ex.Message);
}
return m_values;
}
/**
* @Dictionary格式转化成url参数格式
* @ return url格式串, 该串不包含sign字段值
*/
public string ToUrl()
{
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论