C#實現(xiàn)微信退款及對賬功能的示例詳解
更新時間：2023年11月29日 09:11:19 作者：初九之潛龍勿用
在招聘報名系統(tǒng)里,考務(wù)費支付是其中一個環(huán)節(jié),支付方式很多種,比如銀聯(lián)、微信、支付寶等等,本次我們以微信支付進行舉例,在實際的應(yīng)用中,對于支付成功的考生,我們會遇到實現(xiàn)退款的需求,所以本文給大家介紹了使用C#實現(xiàn)微信退款及對賬,需要的朋友可以參考下
需求
在招聘報名系統(tǒng)里，考務(wù)費支付是其中一個環(huán)節(jié)，支付方式很多種，比如銀聯(lián)、微信、支付寶等等。本次我們以微信支付進行舉例，在考生注冊賬號、編寫簡歷、報名職位、被初審核通過等一系列基礎(chǔ)的條件的具備下，可以進入支付考務(wù)費的環(huán)節(jié)（筆試費用），我們會為其生成一個支付二維碼，考生支付后（無論成功與否），都會記錄其支付結(jié)果狀態(tài)。
在實際的應(yīng)用中，對于支付成功的考生，我們會遇到實現(xiàn)退款的需求，只要包括如下場景：
1、根據(jù)政策規(guī)定，某些符合全部或部分退款條件的考生。
2、其它未知原因，重復(fù)支付訂單的考生。
3、其它不可抗力，需求進行退款的考生。
基礎(chǔ)準(zhǔn)備
在實現(xiàn)功能前，做為企業(yè)，我們需要申請一個微信服務(wù)號，并成為微信支付商家。
1、申請服務(wù)號
申請成功后會獲得到 AppId 和 AppSecret 用于后續(xù)開發(fā)，如關(guān)聯(lián)支付商戶、網(wǎng)頁授權(quán)登錄等。
具體指引請參照微信公眾平臺首頁：https://mp.weixin.qq.com/cgi-bin/loginpage
2、成為微信支付商家
申請成功后會獲得 Mchid 和 paySignKey 用于微信支付、退款等，請在商家后臺務(wù)必關(guān)聯(lián)申請的公眾號。
具體指引請參照微信支付平臺首頁：https://pay.weixin.qq.com/index.php/core/home/login
上述兩個平臺申請成功后，請登錄微信支付商家平臺，進行如下圖操作：
在產(chǎn)品中心、AppID帳號管理、關(guān)聯(lián) AppID（即申請的服務(wù)號）
另外一個重要配置是支付目錄，我們寫的支付程序需要在這里設(shè)置，如下圖：
關(guān)鍵代碼
操作界面
界面上會顯示最近一筆的微信訂單支付情況，包括訂單號、交費時間、交費金額、退款金額。其中退款金額不能大于成功交費金額，否則會返回失敗。另外，還可以顯示微信交易跟蹤日志列表信息，如果訂單號、交易價格、openid、返回信息、交易狀態(tài)等。
示例界面如下：
退款訂單類及方法
實現(xiàn)微信退款，需要在支付商家平臺申請退款證書，證書文件保存到自定義的目錄中，在退款時指定路徑。
退款示例代碼如下：
const string RefundOrderUrl = "https://api.mch.weixin.qq.com/secapi/pay/refund"; //退款申請API地址
const string RefundQueryUrl = "https://api.mch.weixin.qq.com/pay/refundquery"; //退款查詢API地址
//退款訂單明細(xì)類
public class RefundOrderDetail
{
/// <summary>
/// 返回狀態(tài)碼，SUCCESS/FAIL 此字段是通信標(biāo)識，非交易標(biāo)識，交易是否成功需要查看trade_state來判斷
/// </summary>
public string return_code = "";
/// <summary>
/// 返回信息返回信息，如非空，為錯誤原因 簽名失敗 參數(shù)格式校驗錯誤
/// </summary>
public string return_msg = "";
/// <summary>
/// 業(yè)務(wù)結(jié)果,SUCCESS/FAIL
/// </summary>
public string result_code = "";
/// <summary>
/// 錯誤代碼
/// </summary>
public string err_code = "";
/// <summary>
/// 錯誤代碼描述
/// </summary>
public string err_code_des = "";
/// <summary>
/// 公眾號ID(微信分配的公眾賬號 ID)
/// </summary>
public string appid = "";
/// <summary>
/// 商戶號(微信支付分配的商戶號)
/// </summary>
public string mch_id = "";
/// <summary>
/// 微信支付分配的終端設(shè)備號
/// </summary>
public string device_info = "";
/// <summary>
/// 隨機字符串，不長于32位
/// </summary>
public string nonce_str = "";
/// <summary>
/// 簽名
/// </summary>
public string sign = "";
/// <summary>
/// 微信支付訂單號
/// </summary>
public string transaction_id = "";
/// <summary>
/// 商戶系統(tǒng)的訂單號，與請求一致。
/// </summary>
public string out_trade_no = "";
public string out_refund_no = "";
public string refund_id = "";
public string refund_fee = "";
public string settlement_refund_fee = "";
/// <summary>
/// 訂單總金額，單位為分
/// </summary>
public string total_fee = "";
/// </summary>
public string settlement_total_fee = "";
public string fee_type = "";
public string cash_fee = "";
public string cash_fee_type = "";
public string cash_refund_fee = "";
public string coupon_type_0 = "";
public string coupon_refund_fee = "";
public string coupon_refund_fee_0 = "";
public string coupon_refund_count = "";
public string coupon_refund_id_0 = "";
}
//退款訂單類
public class RefundOrder
{
/// <summary>
/// 公眾號ID(微信分配的公眾賬號 ID)
/// </summary>
public string appid = "";
/// <summary>
/// 商戶號(微信支付分配的商戶號)
/// </summary>
public string mch_id = "";
/// <summary>
/// 微信支付分配的終端設(shè)備號
/// </summary>
public string device_info = "";
/// <summary>
/// 隨機字符串，不長于 32 位
/// </summary>
public string nonce_str = "";
/// <summary>
/// 簽名
public string sign = "";
public string sign_type = "";
/// <summary>
/// 商戶系統(tǒng)內(nèi)部的訂單號,32個字符內(nèi)、可包含字母,確保在商戶系統(tǒng)唯一,詳細(xì)說明
/// </summary>
public string transaction_id = "";
public string out_trade_no = "";
public string out_refund_no = "";
/// <summary>
/// 訂單總金額，單位為分，不能帶小數(shù)點
/// </summary>
public int total_fee = 0;
public int refund_fee = 0;
public string refund_fee_type = "";
public string op_user_id = "";
/// <summary>
public string refund_account = "";
/// <summary>
}
//查詢對帳訂單類
public class QueryOrder
{
/// <summary>
/// 公共號ID(微信分配的公眾賬號 ID)
/// </summary>
public string appid = "";
/// <summary>
/// 商戶號(微信支付分配的商戶號)
/// </summary>
public string mch_id = "";
/// <summary>
/// 微信訂單號，優(yōu)先使用
/// </summary>
public string transaction_id = "";
/// <summary>
/// 商戶系統(tǒng)內(nèi)部訂單號
/// </summary>
public string out_trade_no = "";
/// <summary>
/// 隨機字符串，不長于 32 位
/// </summary>
public string nonce_str = "";
/// <summary>
/// 簽名，參與簽名參數(shù)：appid，mch_id，transaction_id，out_trade_no，nonce_str，key
/// </summary>
public string sign = "";
}
//申請退款方法，返回退款訂單明細(xì)類
//參數(shù)refundorder為退款訂單類, key 為支付簽名KEY,cert為證書地址,password 為證書密碼
public RefundOrderDetail getRefundOrderDetail(RefundOrder refundorder, string key,string cert,string password)
{
string post_data = getRefundOrderXml(refundorder, key);
string request_data = PostXmlAndCertToUrl(RefundOrderUrl, post_data,cert,password);
RefundOrderDetail orderdetail = new RefundOrderDetail();
SortedDictionary<string, string> requestXML = GetInfoFromXml(request_data);
foreach (KeyValuePair<string, string> k in requestXML)
{
switch (k.Key)
{
case "retuen_code":
orderdetail.result_code = k.Value;
break;
case "return_msg":
orderdetail.return_msg = k.Value;
break;
case "result_code":
orderdetail.result_code = k.Value;
break;
case "err_code":
orderdetail.err_code = k.Value;
break;
case "err_code_des":
orderdetail.err_code_des = k.Value;
break;
case "appid":
orderdetail.appid = k.Value;
break;
case "mch_id":
orderdetail.mch_id = k.Value;
break;
case "device_info":
orderdetail.device_info = k.Value;
break;
case "nonce_str":
orderdetail.nonce_str = k.Value;
break;
case "sign":
orderdetail.sign = k.Value;
break;
case "transaction_id":
orderdetail.transaction_id = k.Value;
break;
case "out_trade_no":
orderdetail.out_trade_no = k.Value;
break;
case "out_refund_no":
orderdetail.out_refund_no = k.Value;
break;
case "refund_id":
orderdetail.refund_id = k.Value;
break;
case "refund_fee":
orderdetail.refund_fee = k.Value;
break;
case "total_fee":
orderdetail.total_fee = k.Value;
break;
case "settlement_refund_fee":
orderdetail.settlement_refund_fee = k.Value;
break;
case "settlement_total_fee":
orderdetail.settlement_total_fee = k.Value;
break;
case "fee_type":
orderdetail.fee_type = k.Value;
break;
case "cash_fee":
orderdetail.cash_fee = k.Value;
break;
case "cash_fee_type ":
orderdetail.cash_fee_type = k.Value;
break;
case "cash_refund_fee":
orderdetail.cash_refund_fee = k.Value;
break;
case "coupon_type_0":
orderdetail.coupon_type_0 = k.Value;
break;
case "coupon_refund_fee":
orderdetail.coupon_refund_fee = k.Value;
break;
case "coupon_refund_fee_0":
orderdetail.coupon_refund_fee_0 = k.Value;
break;
case "coupon_refund_count":
orderdetail.coupon_refund_count = k.Value;
break;
case "coupon_refund_id_0":
orderdetail.coupon_refund_id_0 = k.Value;
break;
default:
break;
}
}
return orderdetail;
}
protected string getRefundOrderXml(RefundOrder refundorder, string key)
{
string return_string = string.Empty;
SortedDictionary<string, string> sParams = new SortedDictionary<string, string>();
sParams.Add("appid", refundorder.appid);
sParams.Add("mch_id", refundorder.mch_id);
// sParams.Add("transaction_id", refundorder.transaction_id);
sParams.Add("out_trade_no", refundorder.out_trade_no);
sParams.Add("nonce_str", refundorder.nonce_str);
sParams.Add("out_refund_no", refundorder.out_refund_no);
sParams.Add("total_fee", refundorder.total_fee.ToString());
sParams.Add("refund_fee", refundorder.refund_fee.ToString());
sParams.Add("op_user_id", refundorder.op_user_id);
refundorder.sign = getsign(sParams, key);
sParams.Add("sign", refundorder.sign);
//拼接成XML請求數(shù)據(jù)
StringBuilder sbPay = new StringBuilder();
foreach (KeyValuePair<string, string> k in sParams)
{
if (k.Key == "attach" || k.Key == "body" || k.Key == "sign")
{
sbPay.Append("<" + k.Key + "><![CDATA[" + k.Value + "]]></" + k.Key + ">");
}
else
{
sbPay.Append("<" + k.Key + ">" + k.Value + "</" + k.Key + ">");
}
}
return_string = string.Format("<xml>{0}</xml>", sbPay.ToString().TrimEnd(','));
return return_string;
}
public string PostXmlAndCertToUrl(string url, string postData,string cert,string password)
{
string resp = string.Empty;
ServicePointManager.ServerCertificateValidationCallback = new System.Net.Security.RemoteCertificateValidationCallback(CheckValidationResult);
//調(diào)用證書
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);
HttpWebRequest webrequest = (HttpWebRequest)HttpWebRequest.Create(url);
webrequest.ClientCertificates.Add(cer);
webrequest.Method = "post";
webrequest.ContentType = "application/x-www-form-urlencoded";
webrequest.ContentLength = postData.Length;
//webrequest.ContentType = "text/xml";
//byte[] data = System.Text.Encoding.UTF8.GetBytes(postData);
//webrequest.ContentLength = data.Length;
HttpWebResponse response = null;
try
{
StreamWriter swRequestWriter = new StreamWriter(webrequest.GetRequestStream());
swRequestWriter.Write(postData);
if (swRequestWriter != null)
swRequestWriter.Close();
response = (HttpWebResponse)webrequest.GetResponse();
using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
{
resp = reader.ReadToEnd();
}
}
catch (Exception exp)
{
throw exp;
}
finally
{
if (response != null)
response.Close();
}
return resp;
}
public string getNoncestr()
{
Random random = new Random();
return GetMD5(random.Next(1000).ToString(), "GBK").ToLower().Replace("s", "S");
}退款功能實現(xiàn)
假設(shè)點擊退款按鈕事件
protected void Button_Click(object sender, EventArgs e)
{
string appId = “”； //服務(wù)號的appId
string paySignKey = “”； //申請的支付簽名KEY;
string mch_id = “”; //申請的支付商戶ID
string OrderID = ""; //支付訂單號
string OrderAmount = (Convert.ToInt32((float.Parse(Amount.Text) * 100))).ToString(); //訂單支付金額，Amount.Text 支付金額
string RefundOrderAmount = (Convert.ToInt32((float.Parse(Amount.Text) * 100))).ToString(); //退款金額（Amount.Text）這里表示全額退款
string RefundOrderID = Guid.NewGuid().ToString().Replace("-", ""); //生成退款訂單號
//創(chuàng)建退款訂單
RefundOrder order = new RefundOrder();
order.appid = appId;
order.mch_id = mch_id;
order.out_trade_no = OrderID;
order.nonce_str = tenpay.getNoncestr();
order.out_refund_no = RefundOrderID;
order.total_fee = int.Parse(OrderAmount);
order.refund_fee = int.Parse(RefundOrderAmount);
order.op_user_id = mch_id;
string cert = “d:\\apiclient_cert.p12"; //退款證書路徑
//私鑰（在安裝證書時設(shè)置）
string password =""; //證書密碼
//創(chuàng)建訂單明細(xì)類，調(diào)用getRefundOrderDetail方法進行退款
RefundOrderDetail orderdetail = getRefundOrderDetail(order, paySignKey, cert, password);
string rv = ("退款訂單號:" + RefundOrderID + "<br>");
try
{
rv += ("退款金額:" + (double.Parse(orderdetail.total_fee) / 100).ToString() + "<br>");
}
catch (Exception eee)
{
rv += ("退款金額:<br>");
}
rv += ("<b>交易狀態(tài): " + (orderdetail.result_code == "SUCCESS" ? "退款申請成功" : "退款申請失敗") + "(" + orderdetail.result_code + ")" + "</b><br>");
rv += ("可能的錯誤描述:" + orderdetail.err_code_des);
}對賬
退款申請成功后，僅為申請狀態(tài)，需要通過查詢退款情況以確定是否完成，該功能可以在考生方進行實現(xiàn)，考生可隨時查詢自己的對帳情況。
以下是參考代碼，該代碼可實現(xiàn)支付與退款的查詢：
protected void queryOrder(object sender, EventArgs e)
{
string OrderID =”“; //訂單號
string paytype = ”“； //查詢類型，支付消費或退款
string appId = ""; //服務(wù)號 appid
string paySignKey = ""; //支付簽名key
string mch_id = ""; //支付商戶號
if (paytype == "消費")
{
try
{
string openid = ”“;
QueryOrder order = new QueryOrder();
order.appid = appId;
order.mch_id = mch_id;
order.out_trade_no = OrderID;
order.nonce_str = getNoncestr();
OrderDetail orderdetail = getOrderDetail(order, paySignKey);
string rv = ("訂單號:" + OrderID + "<br>");
rv += ("付款人ID比對識別:" + (openid == orderdetail.openid ? "成功" : "失敗") + "<br>");
rv += ("交易金額:" + (double.Parse(orderdetail.total_fee) / 100).ToString() + "<br>");
rv += ("<b>交易狀態(tài): " + (orderdetail.trade_state == "SUCCESS" ? "成功" : "失敗") + "(" + orderdetail.trade_state + ")" + "</b><br>");
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>");
}
catch (Exception ex)
{
return;
}
}
else if (paytype == "退款")
{
try
{
RefundOrder order = new RefundOrder();
order.appid = appId;
order.mch_id = mch_id;
order.out_trade_no = OrderID;
order.nonce_str = getNoncestr();
RefundOrderDetail orderdetail = getRefundQueryOrderDetail(order, paySignKey);
string rv = ("<b>交易狀態(tài): " + (orderdetail.result_code == "SUCCESS" ? "成功" : "失敗") + "(" + orderdetail.result_code + ")" + "</b><br>");
rv += ("其它說明:" + orderdetail.err_code_des);
}
catch (Exception ex)
{
}
}
}支付商家后臺相關(guān)要點
實時交易帳單查詢
登錄后臺后，該操作可以進行實時交易的帳單對帳功能，以備在爭議的時候進行查詢，基本操作如下圖：
點擊交易中心、交易訂單、批量訂單查詢、查詢即可下載EXCEL格式的訂單。
精確交易帳單查詢
登錄后臺后，可查詢精確交易帳單，該帳單每天10：00更新前一天的數(shù)據(jù)交易，我們可以進行CSV格式的下載，操作如下圖：
點擊交易中心、交易帳單、打包下載即可，請注意圖中圈注的提示。
小結(jié)
文章提供的代碼僅供參考，在實際的應(yīng)用中，我們還可以根據(jù)業(yè)務(wù)需要編寫其它功能，如下載微信官方對帳單，導(dǎo)入到應(yīng)用系統(tǒng)中，與業(yè)務(wù)數(shù)據(jù)進行對帳，以排查爭議數(shù)據(jù)；查詢訂單結(jié)果狀態(tài)以更新業(yè)務(wù)爭議狀態(tài)信息等。
以上就是C#實現(xiàn)微信退款及對賬功能的示例詳解的詳細(xì)內(nèi)容，更多關(guān)于C#實現(xiàn)微信退款及對賬的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
本文詳細(xì)講解了C#中List用法介紹，文中通過示例代碼介紹的非常詳細(xì)。對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2021-12-12
WPF中的ProgressBar控件用于表示任務(wù)進度,適用于文件下載、數(shù)據(jù)處理等場景,本文將通過XAML和C#代碼展示如何創(chuàng)建一個基本的WPF進度條,并演示如何通過事件處理程序更新進度條的值來模擬耗時操作,感興趣的小伙伴跟著小編一起來看看吧2024-12-12
Unity Shader實現(xiàn)動態(tài)過場切換圖片效果
這篇文章主要為大家詳細(xì)介紹了Unity Shader實現(xiàn)動態(tài)過場切換圖片效果，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2021-07-07
.Net WInform開發(fā)筆記(二)Winform程序運行結(jié)構(gòu)圖及TCP協(xié)議在Winform中的應(yīng)用
中午沒事，把去年剛畢業(yè)那會畫的幾張圖翻出來了，大概介紹Winform應(yīng)用程序運行的過程，以及TCP協(xié)議在Winform中的應(yīng)用。感興趣的朋友可以了解下；如果有Windows消息機制等基礎(chǔ)，很好理解這兩張2013-01-01
C# IEnumerable和IEnumerator接口淺析
本文主要介紹了C#中IEnumerable和IEnumerator接口的相關(guān)知識，具有很好的參考價值，下面跟著小編一起來看下吧2017-02-02
這篇文章主要介紹了c# 字段和方法設(shè)計建議，幫助大家更好的理解和使用c#編程語言，感興趣的朋友可以了解下2020-11-11
C#作為一種強類型語言,具有豐富的泛型支持,允許開發(fā)者編寫可以應(yīng)對不同數(shù)據(jù)類型的通用代碼,這篇文章主要介紹了C# 泛型編譯特性對性能的影響 ,需要的朋友可以參考下2023-11-11
下面小編就為大家分享一篇秒表計時器以及STOPWATCH(實例講解)，具有很好的參考價值，希望對大家有所幫助2017-11-11
這篇文章主要介紹了C# 中GUID生成格式的四種方法,需要的朋友可以參考下2017-02-02
這篇文章主要介紹了C#獲得文件屬性信息的實現(xiàn)方法,對于C#初學(xué)者了解與學(xué)習(xí)應(yīng)用程序設(shè)計有一定的借鑒價值,需要的朋友可以參考下2014-07-07