.Net版微信支付

一. 案例介紹

這里模擬一個實際業務場景，進行介紹微信支付，業務功能包括：登錄、注冊、充值、查看充值記錄。

　　

 

頁面圖：

 　　     

二. 概要設計

1.數據庫設計

　　這里數據庫包括兩張表：用戶表和訂單表。

　　用戶表： 主鍵id、用戶名、密碼、openid、注冊時間

　　訂單表： 主鍵id、用戶id，商品名稱、訂單狀態(0代表下單了未支付，1代表支付成功)、商品價錢、下單時間

　　

 

2.微信支付流程

　　這里結合該案例，來說明微信支付流程。

　　該流程中涉及到4種角色，分別是微信用戶、微信客戶端、商戶系統(自己的系統)、微信支付系統。

　　流程1：

　　①用戶登錄微信客戶端系統→②進入主頁→③去支付→④生成商戶系統訂單→⑤調用微信統一下單API，在微信支付系統里生成預支付訂單，並返回預支付訂單信息→

　　⑥商戶系統拿到返回的預支付訂單信息，進行簽名，便按照一定的格式返給微信客戶端(JSAPI頁面)→⑦微信客戶端JSAPI頁面拿到參數，請求支付，輸入密碼，進行支付→

　　⑧這時會進行2個並行處理→異步通知商戶支付結果，商戶系統接到通知后，需要修改訂單的業務邏輯(該案例修改訂單狀態0改為1)，商戶系統需要告知微信系統處理結果

　　→給微信客戶端發送支付結果，並發微信消息提示　

　　⑨微信客戶端跳轉到商戶H5頁面，查詢商戶后台支付結果

　　⑩ 這時候分兩種情況

　　　　A. 商戶后台系統，已經接到通知，進行了業務修改，直接返回成功。

　　　　B. 商戶后台系統，沒有接到通知，這時去查詢微信支付系統，如果微信支付系統成功，說明確實付款成功，只是因為網絡延遲造成商戶后台暫時沒有接到通知，如果查詢后發現未付款成功，則返回付款失敗。

微信支付業務流程圖：

       

3.代碼配置

(1).參數配置

(2).前端頁面代碼

   $(function () {
            // 當微信內置瀏覽器完成內部初始化后會觸發WeixinJSBridgeReady事件。
            document.addEventListener('WeixinJSBridgeReady', function onBridgeReady() {
                //公眾號支付
                document.getElementById("pay").onclick = function () {
                    //1.前端驗證
                    var money = $('#num').val();
                    if (money == "") {
                        alert('請將信息輸入完整');
                        return;
                    }
                    mui('#pay').button('loading');
                    //2.進行下單
                    $.ajax({
                        type: 'POST',
                        url: '/WeiXinGz/GetAPI',
                        data: { "money": money },
                        cache: false,
                        dataType: 'json',
                        success: function (jsonData) {
                            if (jsonData.status == "1") {
                                //公眾號支付
                                WeixinJSBridge.invoke('getBrandWCPayRequest', jsonData.payData, function (res) {
                                    // 使用以下方式判斷前端返回,微信團隊鄭重提示：res.err_msg將在用戶支付成功后返回ok，但並不保證它絕對可靠。
                                    //【因此微信團隊建議：】當收到ok返回時，向商戶后台詢問是否收到交易成功的通知，
                                    //若收到通知，前端展示交易成功的界面；
                                    //若此時未收到通知，商戶后台主動調用查詢訂單接口，查詢訂單的當前狀態，並反饋給前端展示相應的界面。
                                    if (res.err_msg == "get_brand_wcpay_request:ok") {
                                        //JS API的返回結果get_brand_wcpay_request：ok僅在用戶成功完成支付時返回
                                        $.ajax({
                                            type: 'POST',
                                            url: '/WeiXinGz/QueryOrder',
                                            data: {
                                                orderId: jsonData.orderId
                                            },
                                            cache: false,
                                            dataType: 'text',
                                            success: function (jsonData) {
                                                if (jsonData == "ok") {
                                                    alert("支付成功", "提示", function () {
                                                        alert("頁面跳轉等業務處理");
                                                    });
                                                    mui('#pay').button('reset');
                                                } else {
                                                    alert("支付失敗,請稍后重試！如果收到支付通知，切勿重復支付1！");
                                                    mui('#pay').button('reset');
                                                }
                                            },
                                            error: function (XMLHttpRequest, textStatus, errorThrown) {
                                                alert("支付失敗,請稍后重試！如果收到支付通知，切勿重復支付2！");
                                                mui('#pay').button('reset');
                                            }
                                        });
                                    } else if (res.err_msg == "get_brand_wcpay_request:cancel") {
                                        //由於前端交互復雜，get_brand_wcpay_request：cancel或者get_brand_wcpay_request：fail可以統一處理為用戶遇到錯誤或者主動放棄，不必細化區分。
                                        alert("您放棄了支付");
                                        mui('#pay').button('reset');
                                    } else {
                                        //由於前端交互復雜，get_brand_wcpay_request：cancel或者get_brand_wcpay_request：fail可以統一處理為用戶遇到錯誤或者主動放棄，不必細化區分。
                                        alert("支付失敗,請稍后重試！如果收到支付通知，切勿重復支付3！");
                                        mui('#pay').button('reset');
                                    }
                                });
                            } else {
                                alert(jsonData.promptInfor);
                                mui('#pay').button('reset');
                            }
                        },
                        error: function (XMLHttpRequest, textStatus, errorThrown) {
                            alert("微信訂單提交失敗,請稍后重試4！");
                            mui('#pay').button('reset');
                        }
                    });

                }
            }, false);
        });

 

(3).統一下單接口

   /// <summary>
        /// 統一下單接口
        /// </summary>
        /// <param name="money">錢數</param>
        /// <returns></returns>
        public ActionResult GetAPI(string money)
        {
            try
            {
                //一.系統本身自有的業務處理
                //1.必要信息的初始化
                string userId = Session["userId"].ToString();    //用戶主鍵
                UserInfor userInfor = db.Set<UserInfor>().Where(a => a.id == userId).FirstOrDefault();
                string orderId = GenerateOrderNum(); //生成訂單號
                string totalFee = money;//設置默認商品費用為【1分】
                string nonceStr = TenPayV3Util.GetNoncestr();   //獲取 隨機字符串
                string openid = userInfor.openId;
                //2.自己商戶系統下單
                OrderInfor orderInfor = new OrderInfor();
                orderInfor.id = orderId;
                orderInfor.uid = userInfor.id;
                orderInfor.goodName = "測試商品";
                orderInfor.goodPrice = totalFee;
                orderInfor.addTime = DateTime.Now;
                orderInfor.status = "0";  //已經下單,但未付款
                db.Set<OrderInfor>().Add(orderInfor);
                db.SaveChanges();


                //二.微信系統下單
                //1.創建支付應答對象並初始化
                RequestHandler packageReqHandler = new RequestHandler(null);
                packageReqHandler.Init();
                //1.1設置統一下單的參數
                packageReqHandler.SetParameter("appid", ConfigHelp.AppSettings("AppId"));     //公眾賬號ID
                packageReqHandler.SetParameter("mch_id", ConfigHelp.AppSettings("MchId"));     //商戶號
                packageReqHandler.SetParameter("nonce_str", nonceStr);    //隨機字符串
                packageReqHandler.SetParameter("body", "科技-服務");    //商品描述
                packageReqHandler.SetParameter("out_trade_no", orderId);     //商戶訂單號
                packageReqHandler.SetParameter("total_fee", totalFee);     //商品金額,以分為單位
                packageReqHandler.SetParameter("spbill_create_ip", Request.UserHostAddress);   //終端IP
                packageReqHandler.SetParameter("notify_url", ConfigHelp.AppSettings("notify_url"));    //微信支付異步通知回調地址
                packageReqHandler.SetParameter("trade_type", "JSAPI");     //交易類型 代表公眾號支付
                packageReqHandler.SetParameter("openid", openid);    //用戶標識
                string sign = packageReqHandler.CreateMd5Sign("key", ConfigHelp.AppSettings("key")); //預支付簽名
                packageReqHandler.SetParameter("sign", sign);
                //1.2 下單數據格式轉換
                string data = packageReqHandler.ParseXML();
                //1.3 進行下單
                string result = TenPayV3.Unifiedorder(data);
                //2.對下單返回結果進行分析
                XDocument res = XDocument.Parse(result);
                //2.1 對返回結果進行判斷

                //2.2 成功的情況下獲取必要的參數
                string prepayId = res.Element("xml").Element("prepay_id").Value;   //獲取預支付訂單編號prepayId
                //3. 獲取支付參數並簽名
                string timeStamp = TenPayV3Util.GetTimestamp(); //獲取時間戳
                //設置支付參數
                RequestHandler paySignReqHandler = new RequestHandler(null);
                paySignReqHandler.SetParameter("appId", ConfigHelp.AppSettings("AppId"));
                paySignReqHandler.SetParameter("timeStamp", TenPayV3Util.GetTimestamp());
                paySignReqHandler.SetParameter("nonceStr", nonceStr);
                paySignReqHandler.SetParameter("package", string.Format("prepay_id={0}", prepayId));
                paySignReqHandler.SetParameter("signType", "MD5"); //簽名【MD5】
                string paySign = paySignReqHandler.CreateMd5Sign("key", ConfigHelp.AppSettings("key")); //JSAPI支付簽名
                var payData = new
                {
                    appId = ConfigHelp.AppSettings("AppId"),
                    timeStamp = timeStamp,
                    nonceStr = nonceStr,
                    package = string.Format("prepay_id={0}", prepayId),
                    signType = "MD5",
                    paySign = paySign,
                };
                return Json(new
                {
                    status = "1",
                    promptInfor = "微信下單成功",
                    payData = payData,
                    orderId = orderId
                });
            }
            catch (Exception ex)
            {
                string a = ex.Message;

                return Json(new
                {
                    status = "0",
                    promptInfor = a
                });
            }
        }

(4).微信異步通知接口

  public ActionResult PayNotifyUrl()
        {
            //獲取當前http請求
            HttpContext httpContext = System.Web.HttpContext.Current;
            ResponseHandler notifyDataHandler = new ResponseHandler(httpContext);
            //返回狀態碼【SUCCESS/FAIL】此字段是通信標識
            string return_code = notifyDataHandler.GetParameter("return_code");
            //返回信息【如非空，為錯誤原因】
            string return_msg = notifyDataHandler.GetParameter("return_msg");
            //表示通信成功
            if (return_code == "SUCCESS")
            {
                //獲取業務結果【交易是否成功(SUCCESS/FAIL)】
                string result_code = notifyDataHandler.GetParameter("result_code");
                //表示業務結果成功
                if (result_code == "SUCCESS")
                {
                    //設置簽名密鑰
                    notifyDataHandler.SetKey(ConfigHelp.AppSettings("key"));
                    //驗證請求是否從微信發過來（安全）【驗證簽名】
                    if (notifyDataHandler.IsTenpaySign())
                    {
                        //獲取訂單編號
                        string out_trade_no = notifyDataHandler.GetParameter("out_trade_no");
                        //檢查是否返回商戶訂單號
                        if (!string.IsNullOrEmpty(out_trade_no))
                        {
                            try
                            {
                                OrderInfor orderInfor = db.Set<OrderInfor>().Where(a => a.id == out_trade_no).FirstOrDefault();
                                if (orderInfor != null)
                                {
                                    //這里需要根據訂單號更改系統的業務
                                    //這里模擬測試記錄訂單號
                                    orderInfor.status = "1"; //表示付款成功，成功回調
                                    db.Entry(orderInfor).State = EntityState.Modified;
                                    db.SaveChanges();

                                    return_code = "SUCCESS";
                                    return_msg = "OK";
                                }
                                else
                                {
                                    return_code = "FAIL";
                                    return_msg = "商戶系統中不存在該訂單";
                                }
                            }
                            catch (Exception ex)
                            {
                                //系統異常
                                return_code = "FAIL";
                                return_msg = ex.Message;
                            }
                        }
                        else
                        {
                            //支付結果中商戶訂單號不存在
                            return_code = "FAIL";
                            return_msg = "支付結果中商戶訂單號不存在";
                        }
                    }
                    else
                    {
                        //簽名失敗
                        return_code = "FAIL";
                        return_msg = "簽名失敗";
                    }
                }
                else
                {
                    //交易失敗
                    return_code = "FAIL";
                    return_msg = "交易失敗";
                }
            }
            //商戶處理后同步返回給微信參數
            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");
        }

(5).JSAPI接口請求

 //公眾號支付
                                WeixinJSBridge.invoke('getBrandWCPayRequest', jsonData.payData, function (res) {
                                    // 使用以下方式判斷前端返回,微信團隊鄭重提示：res.err_msg將在用戶支付成功后返回ok，但並不保證它絕對可靠。
                                    //【因此微信團隊建議：】當收到ok返回時，向商戶后台詢問是否收到交易成功的通知，
                                    //若收到通知，前端展示交易成功的界面；
                                    //若此時未收到通知，商戶后台主動調用查詢訂單接口，查詢訂單的當前狀態，並反饋給前端展示相應的界面。
                                    if (res.err_msg == "get_brand_wcpay_request:ok") {
                                        //JS API的返回結果get_brand_wcpay_request：ok僅在用戶成功完成支付時返回
                                        $.ajax({
                                            type: 'POST',
                                            url: '/WeiXinGz/QueryOrder',
                                            data: {
                                                orderId: jsonData.orderId
                                            },
                                            cache: false,
                                            dataType: 'text',
                                            success: function (jsonData) {
                                                if (jsonData == "ok") {
                                                    alert("支付成功", "提示", function () {
                                                        alert("頁面跳轉等業務處理");
                                                    });
                                                    mui('#pay').button('reset');
                                                } else {
                                                    alert("支付失敗,請稍后重試！如果收到支付通知，切勿重復支付1！");
                                                    mui('#pay').button('reset');
                                                }
                                            },
                                            error: function (XMLHttpRequest, textStatus, errorThrown) {
                                                alert("支付失敗,請稍后重試！如果收到支付通知，切勿重復支付2！");
                                                mui('#pay').button('reset');
                                            }
                                        });
                                    } else if (res.err_msg == "get_brand_wcpay_request:cancel") {
                                        //由於前端交互復雜，get_brand_wcpay_request：cancel或者get_brand_wcpay_request：fail可以統一處理為用戶遇到錯誤或者主動放棄，不必細化區分。
                                        alert("您放棄了支付");
                                        mui('#pay').button('reset');
                                    } else {
                                        //由於前端交互復雜，get_brand_wcpay_request：cancel或者get_brand_wcpay_request：fail可以統一處理為用戶遇到錯誤或者主動放棄，不必細化區分。
                                        alert("支付失敗,請稍后重試！如果收到支付通知，切勿重復支付3！");
                                        mui('#pay').button('reset');
                                    }
                                });

 

(6).微信訂單查詢接口

 

 /// <summary>
        /// 微信訂單查詢接口
        /// </summary>
        /// <param name="orderId">訂單編號id</param>
        /// <returns></returns>
        //[WeixinInternalRequest("無法訪問！")]
        public ActionResult QueryOrder(string orderId)
        {
            try
            {
                //一.先查商戶后台的訂單狀態，判斷微信端是否異步通知商戶后台了！！！
                OrderInfor orderInfor = db.Set<OrderInfor>().Where(a => a.id == orderId).FirstOrDefault();
                //判斷訂單狀態
                if (orderInfor.status == "1")
                {
                    //表示查詢成功
                    return Content("ok");
                }
                else if (orderInfor == null || orderInfor.status != "1")
                {
                    //二.進行調用下面的微信查詢api進行查詢
                    //生成隨機字符串
                    string nonceStr = TenPayV3Util.GetNoncestr();
                    RequestHandler packageReqHandler = new RequestHandler(null);
                    //設置package訂單參數
                    packageReqHandler.SetParameter("appid", ConfigHelp.AppSettings("AppId")); //公眾賬號ID
                    packageReqHandler.SetParameter("mch_id", ConfigHelp.AppSettings("MchId"));    //商戶號 
                    packageReqHandler.SetParameter("out_trade_no", orderId);  //填入商家訂單號
                    packageReqHandler.SetParameter("nonce_str", nonceStr); //隨機字符串
                    string sign = packageReqHandler.CreateMd5Sign("key", ConfigHelp.AppSettings("key"));//參數進行簽名
                    packageReqHandler.SetParameter("sign", sign); //參數中添加簽名字符串                        
                    string data = packageReqHandler.ParseXML(); //將傳的參數轉化為XML格式字符串
                    var result = TenPayV3.OrderQuery(data); //調用訂單查詢接口
                    var res = XDocument.Parse(result);
                    //返回狀態碼【SUCCESS/FAIL】此字段是通信標識
                    string return_code = res.Element("xml").Element("return_code").Value;
                    if (return_code == "SUCCESS")
                    {
                        //獲取業務結果【交易是否成功(SUCCESS/FAIL)】
                        string result_code = res.Element("xml").Element("result_code").Value;
                        if (result_code == "SUCCESS")
                        {
                            //交易狀態 
                            /**SUCCESS—支付成功 
                              *REFUND—轉入退款 
                              *NOTPAY—未支付 
                              *CLOSED—已關閉 
                              *REVOKED—已撤銷（刷卡支付） 
                              *USERPAYING--用戶支付中 
                              *PAYERROR--支付失敗(其他原因，如銀行返回失敗)
                            */
                            string trade_state = res.Element("xml").Element("trade_state").Value;
                            if (return_code == "SUCCESS")
                            {
                                return Content("ok");
                            }
                        }
                    }

                }
                //未查詢到該訂單或者該訂單交易狀態不相符
                return Content("error");
            }
            catch (Exception ex)
            {
                //拋異常信息，返回異常消息
                return Content(ex.Message);
            }
        }

 

上述代碼中，用到的openid，需要事先獲取

 親測好用,如有問題，可聯系QQ 604649488