当前位置:   article > 正文

C# 实现微信退款及对帐

C# 实现微信退款及对帐

目录

需求

基础准备

关键代码

操作界面

​编辑

退款订单类及方法

退款功能实现

对帐

支付商家后台相关要点

实时交易帐单查询

精确交易帐单查询

小结

需求

在招聘报名系统里,考务费支付是其中一个环节,支付方式很多种,比如银联、微信、支付宝等等。本次我们以微信支付进行举例,在考生注册账号、编写简历、报名职位、被初审核通过等一系列基础的条件的具备下,可以进入支付考务费的环节(笔试费用),我们会为其生成一个支付二维码,考生支付后(无论成功与否),都会记录其支付结果状态。

在实际的应用中,对于支付成功的考生,我们会遇到实现退款的需求,只要包括如下场景:

1、根据政策规定,某些符合全部或部分退款条件的考生。

2、其它未知原因,重复支付订单的考生。

3、其它不可抗力,需求进行退款的考生。

基础准备

在实现功能前,做为企业,我们需要申请一个微信服务号,并成为微信支付商家。

1、申请服务号

申请成功后会获得到 AppId 和 AppSecret 用于后续开发,如关联支付商户、网页授权登录等。

具体指引请参照微信公众平台首页:https://mp.weixin.qq.com/cgi-bin/loginpage

2、成为微信支付商家

申请成功后会获得 Mchid 和 paySignKey 用于微信支付、退款等,请在商家后台务必关联申请的公众号。

具体指引请参照微信支付平台首页:https://pay.weixin.qq.com/index.php/core/home/login

上述两个平台申请成功后,请登录微信支付商家平台,进行如下图操作:

在产品中心、AppID帐号管理、关联 AppID(即申请的服务号) 

另外一个重要配置是支付目录,我们写的支付程序需要在这里设置,如下图:

关键代码

操作界面

界面上会显示最近一笔的微信订单支付情况,包括订单号、交费时间、交费金额、退款金额。其中退款金额不能大于成功交费金额,否则会返回失败。另外,还可以显示微信交易跟踪日志列表信息,如果订单号、交易价格、openid、返回信息、交易状态等。

示例界面如下:

退款订单类及方法

实现微信退款,需要在支付商家平台申请退款证书,证书文件保存到自定义的目录中,在退款时指定路径。

退款示例代码如下:

  1. const string RefundOrderUrl = "https://api.mch.weixin.qq.com/secapi/pay/refund"; //退款申请API地址
  2. const string RefundQueryUrl = "https://api.mch.weixin.qq.com/pay/refundquery"; //退款查询API地址
  3. //退款订单明细类
  4. public class RefundOrderDetail
  5. {
  6. /// <summary>
  7. /// 返回状态码,SUCCESS/FAIL 此字段是通信标识,非交易标识,交易是否成功需要查看trade_state来判断
  8. /// </summary>
  9. public string return_code = "";
  10. /// <summary>
  11. /// 返回信息返回信息,如非空,为错误原因 签名失败 参数格式校验错误
  12. /// </summary>
  13. public string return_msg = "";
  14. /// <summary>
  15. /// 业务结果,SUCCESS/FAIL
  16. /// </summary>
  17. public string result_code = "";
  18. /// <summary>
  19. /// 错误代码
  20. /// </summary>
  21. public string err_code = "";
  22. /// <summary>
  23. /// 错误代码描述
  24. /// </summary>
  25. public string err_code_des = "";
  26. /// <summary>
  27. /// 公众号ID(微信分配的公众账号 ID)
  28. /// </summary>
  29. public string appid = "";
  30. /// <summary>
  31. /// 商户号(微信支付分配的商户号)
  32. /// </summary>
  33. public string mch_id = "";
  34. /// <summary>
  35. /// 微信支付分配的终端设备号
  36. /// </summary>
  37. public string device_info = "";
  38. /// <summary>
  39. /// 随机字符串,不长于32位
  40. /// </summary>
  41. public string nonce_str = "";
  42. /// <summary>
  43. /// 签名
  44. /// </summary>
  45. public string sign = "";
  46. /// <summary>
  47. /// 微信支付订单号
  48. /// </summary>
  49. public string transaction_id = "";
  50. /// <summary>
  51. /// 商户系统的订单号,与请求一致。
  52. /// </summary>
  53. public string out_trade_no = "";
  54. public string out_refund_no = "";
  55. public string refund_id = "";
  56. public string refund_fee = "";
  57. public string settlement_refund_fee = "";
  58. /// <summary>
  59. /// 订单总金额,单位为分
  60. /// </summary>
  61. public string total_fee = "";
  62. /// </summary>
  63. public string settlement_total_fee = "";
  64. public string fee_type = "";
  65. public string cash_fee = "";
  66. public string cash_fee_type = "";
  67. public string cash_refund_fee = "";
  68. public string coupon_type_0 = "";
  69. public string coupon_refund_fee = "";
  70. public string coupon_refund_fee_0 = "";
  71. public string coupon_refund_count = "";
  72. public string coupon_refund_id_0 = "";
  73. }
  74. //退款订单类
  75. public class RefundOrder
  76. {
  77. /// <summary>
  78. /// 公众号ID(微信分配的公众账号 ID)
  79. /// </summary>
  80. public string appid = "";
  81. /// <summary>
  82. /// 商户号(微信支付分配的商户号)
  83. /// </summary>
  84. public string mch_id = "";
  85. /// <summary>
  86. /// 微信支付分配的终端设备号
  87. /// </summary>
  88. public string device_info = "";
  89. /// <summary>
  90. /// 随机字符串,不长于 32 位
  91. /// </summary>
  92. public string nonce_str = "";
  93. /// <summary>
  94. /// 签名
  95. public string sign = "";
  96. public string sign_type = "";
  97. /// <summary>
  98. /// 商户系统内部的订单号,32个字符内、可包含字母,确保在商户系统唯一,详细说明
  99. /// </summary>
  100. public string transaction_id = "";
  101. public string out_trade_no = "";
  102. public string out_refund_no = "";
  103. /// <summary>
  104. /// 订单总金额,单位为分,不能带小数点
  105. /// </summary>
  106. public int total_fee = 0;
  107. public int refund_fee = 0;
  108. public string refund_fee_type = "";
  109. public string op_user_id = "";
  110. /// <summary>
  111. public string refund_account = "";
  112. /// <summary>
  113. }
  114. //查询对帐订单类
  115. public class QueryOrder
  116. {
  117. /// <summary>
  118. /// 公共号ID(微信分配的公众账号 ID)
  119. /// </summary>
  120. public string appid = "";
  121. /// <summary>
  122. /// 商户号(微信支付分配的商户号)
  123. /// </summary>
  124. public string mch_id = "";
  125. /// <summary>
  126. /// 微信订单号,优先使用
  127. /// </summary>
  128. public string transaction_id = "";
  129. /// <summary>
  130. /// 商户系统内部订单号
  131. /// </summary>
  132. public string out_trade_no = "";
  133. /// <summary>
  134. /// 随机字符串,不长于 32 位
  135. /// </summary>
  136. public string nonce_str = "";
  137. /// <summary>
  138. /// 签名,参与签名参数:appid,mch_id,transaction_id,out_trade_no,nonce_str,key
  139. /// </summary>
  140. public string sign = "";
  141. }
  142. //申请退款方法,返回退款订单明细类
  143. //参数refundorder为退款订单类, key 为支付签名KEY,cert为证书地址,password 为证书密码
  144. public RefundOrderDetail getRefundOrderDetail(RefundOrder refundorder, string key,string cert,string password)
  145. {
  146. string post_data = getRefundOrderXml(refundorder, key);
  147. string request_data = PostXmlAndCertToUrl(RefundOrderUrl, post_data,cert,password);
  148. RefundOrderDetail orderdetail = new RefundOrderDetail();
  149. SortedDictionary<string, string> requestXML = GetInfoFromXml(request_data);
  150. foreach (KeyValuePair<string, string> k in requestXML)
  151. {
  152. switch (k.Key)
  153. {
  154. case "retuen_code":
  155. orderdetail.result_code = k.Value;
  156. break;
  157. case "return_msg":
  158. orderdetail.return_msg = k.Value;
  159. break;
  160. case "result_code":
  161. orderdetail.result_code = k.Value;
  162. break;
  163. case "err_code":
  164. orderdetail.err_code = k.Value;
  165. break;
  166. case "err_code_des":
  167. orderdetail.err_code_des = k.Value;
  168. break;
  169. case "appid":
  170. orderdetail.appid = k.Value;
  171. break;
  172. case "mch_id":
  173. orderdetail.mch_id = k.Value;
  174. break;
  175. case "device_info":
  176. orderdetail.device_info = k.Value;
  177. break;
  178. case "nonce_str":
  179. orderdetail.nonce_str = k.Value;
  180. break;
  181. case "sign":
  182. orderdetail.sign = k.Value;
  183. break;
  184. case "transaction_id":
  185. orderdetail.transaction_id = k.Value;
  186. break;
  187. case "out_trade_no":
  188. orderdetail.out_trade_no = k.Value;
  189. break;
  190. case "out_refund_no":
  191. orderdetail.out_refund_no = k.Value;
  192. break;
  193. case "refund_id":
  194. orderdetail.refund_id = k.Value;
  195. break;
  196. case "refund_fee":
  197. orderdetail.refund_fee = k.Value;
  198. break;
  199. case "total_fee":
  200. orderdetail.total_fee = k.Value;
  201. break;
  202. case "settlement_refund_fee":
  203. orderdetail.settlement_refund_fee = k.Value;
  204. break;
  205. case "settlement_total_fee":
  206. orderdetail.settlement_total_fee = k.Value;
  207. break;
  208. case "fee_type":
  209. orderdetail.fee_type = k.Value;
  210. break;
  211. case "cash_fee":
  212. orderdetail.cash_fee = k.Value;
  213. break;
  214. case "cash_fee_type ":
  215. orderdetail.cash_fee_type = k.Value;
  216. break;
  217. case "cash_refund_fee":
  218. orderdetail.cash_refund_fee = k.Value;
  219. break;
  220. case "coupon_type_0":
  221. orderdetail.coupon_type_0 = k.Value;
  222. break;
  223. case "coupon_refund_fee":
  224. orderdetail.coupon_refund_fee = k.Value;
  225. break;
  226. case "coupon_refund_fee_0":
  227. orderdetail.coupon_refund_fee_0 = k.Value;
  228. break;
  229. case "coupon_refund_count":
  230. orderdetail.coupon_refund_count = k.Value;
  231. break;
  232. case "coupon_refund_id_0":
  233. orderdetail.coupon_refund_id_0 = k.Value;
  234. break;
  235. default:
  236. break;
  237. }
  238. }
  239. return orderdetail;
  240. }
  241. protected string getRefundOrderXml(RefundOrder refundorder, string key)
  242. {
  243. string return_string = string.Empty;
  244. SortedDictionary<string, string> sParams = new SortedDictionary<string, string>();
  245. sParams.Add("appid", refundorder.appid);
  246. sParams.Add("mch_id", refundorder.mch_id);
  247. // sParams.Add("transaction_id", refundorder.transaction_id);
  248. sParams.Add("out_trade_no", refundorder.out_trade_no);
  249. sParams.Add("nonce_str", refundorder.nonce_str);
  250. sParams.Add("out_refund_no", refundorder.out_refund_no);
  251. sParams.Add("total_fee", refundorder.total_fee.ToString());
  252. sParams.Add("refund_fee", refundorder.refund_fee.ToString());
  253. sParams.Add("op_user_id", refundorder.op_user_id);
  254. refundorder.sign = getsign(sParams, key);
  255. sParams.Add("sign", refundorder.sign);
  256. //拼接成XML请求数据
  257. StringBuilder sbPay = new StringBuilder();
  258. foreach (KeyValuePair<string, string> k in sParams)
  259. {
  260. if (k.Key == "attach" || k.Key == "body" || k.Key == "sign")
  261. {
  262. sbPay.Append("<" + k.Key + "><![CDATA[" + k.Value + "]]></" + k.Key + ">");
  263. }
  264. else
  265. {
  266. sbPay.Append("<" + k.Key + ">" + k.Value + "</" + k.Key + ">");
  267. }
  268. }
  269. return_string = string.Format("<xml>{0}</xml>", sbPay.ToString().TrimEnd(','));
  270. return return_string;
  271. }
  272. public string PostXmlAndCertToUrl(string url, string postData,string cert,string password)
  273. {
  274. string resp = string.Empty;
  275. ServicePointManager.ServerCertificateValidationCallback = new System.Net.Security.RemoteCertificateValidationCallback(CheckValidationResult);
  276. //调用证书
  277. System.Security.Cryptography.X509Certificates.X509Certificate2 cer = new System.Security.Cryptography.X509Certificates.X509Certificate2(cert, password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.PersistKeySet | System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.MachineKeySet);
  278. HttpWebRequest webrequest = (HttpWebRequest)HttpWebRequest.Create(url);
  279. webrequest.ClientCertificates.Add(cer);
  280. webrequest.Method = "post";
  281. webrequest.ContentType = "application/x-www-form-urlencoded";
  282. webrequest.ContentLength = postData.Length;
  283. //webrequest.ContentType = "text/xml";
  284. //byte[] data = System.Text.Encoding.UTF8.GetBytes(postData);
  285. //webrequest.ContentLength = data.Length;
  286. HttpWebResponse response = null;
  287. try
  288. {
  289. StreamWriter swRequestWriter = new StreamWriter(webrequest.GetRequestStream());
  290. swRequestWriter.Write(postData);
  291. if (swRequestWriter != null)
  292. swRequestWriter.Close();
  293. response = (HttpWebResponse)webrequest.GetResponse();
  294. using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
  295. {
  296. resp = reader.ReadToEnd();
  297. }
  298. }
  299. catch (Exception exp)
  300. {
  301. throw exp;
  302. }
  303. finally
  304. {
  305. if (response != null)
  306. response.Close();
  307. }
  308. return resp;
  309. }
  310. public string getNoncestr()
  311. {
  312. Random random = new Random();
  313. return GetMD5(random.Next(1000).ToString(), "GBK").ToLower().Replace("s", "S");
  314. }

退款功能实现

假设点击退款按钮事件

  1. protected void Button_Click(object sender, EventArgs e)
  2. {
  3. string appId = “”; //服务号的appId
  4. string paySignKey = “”; //申请的支付签名KEY;
  5. string mch_id = “”; //申请的支付商户ID
  6. string OrderID = ""; //支付订单号
  7. string OrderAmount = (Convert.ToInt32((float.Parse(Amount.Text) * 100))).ToString(); //订单支付金额,Amount.Text 支付金额
  8. string RefundOrderAmount = (Convert.ToInt32((float.Parse(Amount.Text) * 100))).ToString(); //退款金额(Amount.Text)这里表示全额退款
  9. string RefundOrderID = Guid.NewGuid().ToString().Replace("-", ""); //生成退款订单号
  10. //创建退款订单
  11. RefundOrder order = new RefundOrder();
  12. order.appid = appId;
  13. order.mch_id = mch_id;
  14. order.out_trade_no = OrderID;
  15. order.nonce_str = tenpay.getNoncestr();
  16. order.out_refund_no = RefundOrderID;
  17. order.total_fee = int.Parse(OrderAmount);
  18. order.refund_fee = int.Parse(RefundOrderAmount);
  19. order.op_user_id = mch_id;
  20. string cert = “d:\\apiclient_cert.p12"; //退款证书路径
  21. //私钥(在安装证书时设置)
  22. string password =""; //证书密码
  23. //创建订单明细类,调用getRefundOrderDetail方法进行退款
  24. RefundOrderDetail orderdetail = getRefundOrderDetail(order, paySignKey, cert, password);
  25. string rv = ("退款订单号:" + RefundOrderID + "<br>");
  26. try
  27. {
  28. rv += ("退款金额:" + (double.Parse(orderdetail.total_fee) / 100).ToString() + "<br>");
  29. }
  30. catch (Exception eee)
  31. {
  32. rv += ("退款金额:<br>");
  33. }
  34. rv += ("<b>交易状态:&nbsp;" + (orderdetail.result_code == "SUCCESS" ? "退款申请成功" : "退款申请失败") + "(" + orderdetail.result_code + ")" + "</b><br>");
  35. rv += ("可能的错误描述:" + orderdetail.err_code_des);
  36. }

对帐

退款申请成功后,仅为申请状态,需要通过查询退款情况以确定是否完成,该功能可以在考生方进行实现,考生可随时查询自己的对帐情况。

以下是参考代码,该代码可实现支付与退款的查询:

  1. protected void queryOrder(object sender, EventArgs e)
  2. {
  3. string OrderID =”“; //订单号
  4. string paytype = ”“; //查询类型,支付消费或退款
  5. string appId = ""; //服务号 appid
  6. string paySignKey = ""; //支付签名key
  7. string mch_id = ""; //支付商户号
  8. if (paytype == "消费")
  9. {
  10. try
  11. {
  12. string openid = ”“;
  13. QueryOrder order = new QueryOrder();
  14. order.appid = appId;
  15. order.mch_id = mch_id;
  16. order.out_trade_no = OrderID;
  17. order.nonce_str = getNoncestr();
  18. OrderDetail orderdetail = getOrderDetail(order, paySignKey);
  19. string rv = ("订单号:" + OrderID + "<br>");
  20. rv += ("付款人ID比对识别:" + (openid == orderdetail.openid ? "成功" : "失败") + "<br>");
  21. rv += ("交易金额:" + (double.Parse(orderdetail.total_fee) / 100).ToString() + "<br>");
  22. rv += ("<b>交易状态:&nbsp;" + (orderdetail.trade_state == "SUCCESS" ? "成功" : "失败") + "(" + orderdetail.trade_state + ")" + "</b><br>");
  23. rv += ("支付交易时间:" + (orderdetail.time_end != "" && orderdetail.time_end.Length == 14 ? orderdetail.time_end.Substring(0, 4) + "-" + orderdetail.time_end.Substring(4, 2) + "-" + orderdetail.time_end.Substring(6, 2) + " " + orderdetail.time_end.Substring(8, 2) + ":" + orderdetail.time_end.Substring(10, 2) + ":" + orderdetail.time_end.Substring(12, 2) : "") + "<br>");
  24. }
  25. catch (Exception ex)
  26. {
  27. return;
  28. }
  29. }
  30. else if (paytype == "退款")
  31. {
  32. try
  33. {
  34. RefundOrder order = new RefundOrder();
  35. order.appid = appId;
  36. order.mch_id = mch_id;
  37. order.out_trade_no = OrderID;
  38. order.nonce_str = getNoncestr();
  39. RefundOrderDetail orderdetail = getRefundQueryOrderDetail(order, paySignKey);
  40. string rv = ("<b>交易状态:&nbsp;" + (orderdetail.result_code == "SUCCESS" ? "成功" : "失败") + "(" + orderdetail.result_code + ")" + "</b><br>");
  41. rv += ("其它说明:" + orderdetail.err_code_des);
  42. }
  43. catch (Exception ex)
  44. {
  45. }
  46. }
  47. }

支付商家后台相关要点

实时交易帐单查询

登录后台后,该操作可以进行实时交易的帐单对帐功能,以备在争议的时候进行查询,基本操作如下图:

点击交易中心、交易订单、批量订单查询、查询即可下载EXCEL格式的订单。

精确交易帐单查询

登录后台后,可查询精确交易帐单,该帐单每天10:00更新前一天的数据交易,我们可以进行CSV格式的下载,操作如下图:

点击交易中心、交易帐单、打包下载即可,请注意图中圈注的提示。 

小结

以上提供的代码仅供参考,在实际的应用中,我们还可以根据业务需要编写其它功能,如下载微信官方对帐单,导入到应用系统中,与业务数据进行对帐,以排查争议数据;查询订单结果状态以更新业务争议状态信息等。

以上就是自己的一些分享,时间仓促,不妥之处还请大家批评指正!

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/article/detail/30123
推荐阅读
相关标签
  

闽ICP备14008679号