前幾天由於公司項目需求,要作一個用微信在線充值的功能,就是在微信的瀏覽器裏面點擊一個網頁調起微信支付,如今大體來講一下微信支付之公衆號支付的開發流程:javascript
首先你的公衆號必須是認證服務號,要開通了微信支付的權限;在開發寫代碼以前咱們要把支付相關的一些信息設置作好,以利於後續操做,開通以後微信那邊就會給你發一封郵件,裏面包含了你公衆號商戶平臺的後臺登錄相關的一些信息,登錄商戶平臺以後在->帳戶設置->API安全裏面設置密鑰,這個在後面會用到;php
帳戶參數說明html
郵件中參數 | API參數名 | 詳細說明 |
---|---|---|
APPID | appid | appid是微信公衆帳號或開放平臺APP的惟一標識,在公衆平臺申請公衆帳號或者在開放平臺申請APP帳號後,微信會自動分配對應的appid,用於標識該應用。商戶的微信支付審覈經過郵件中也會包含該字段值。 |
微信支付商戶號 | mch_id | 商戶申請微信支付後,由微信支付分配的商戶收款帳號。 |
API密鑰 | key | 交易過程生成簽名的密鑰,僅保留在商戶系統和微信支付後臺,不會在網絡中傳播。商戶妥善保管該Key,切勿在網絡中傳輸,不能在其餘客戶端中存儲,保證key不會被泄漏。商戶可根據郵件提示登陸微信商戶平臺進行設置。 |
Appsecret | secret | AppSecret是APPID對應的接口密碼,用於獲取接口調用憑證access_token時使用。在微信支付中,先經過OAuth2.0接口獲取用戶openid,此openid用於微信內網頁支付模式下單接口使用。在開發模式中獲取AppSecret(成爲開發者且賬號沒有異常狀態)。 |
這些完成以後咱們還要了解一下公衆號支付的一個業務流程:前端
商戶系統和微信支付系統主要交互:java
1.商戶server調用統一下單接口請求訂單,api參見公共api【統一下單API】;在請求預支付訂單以前咱們要調用微信OAuth2.0網頁受權獲取用戶微信OpenId,這裏就不詳細說明了,下面是預支付下單的代碼實現:node
1 string timeStamp = TenPayUtil.GetTimestamp(); 2 string nonceStr = TenPayUtil.GetNoncestr(); 3 string paySign = string.Empty; 4 5 //建立支付應答對象 6 var packageReqHandler = new RequestHandler(null); 7 8 string spbill_create_ip = Request.UserHostAddress; 9 10 //初始化 11 //packageReqHandler.Init(); 12 //packageReqHandler.SetKey(TenPayInfo.Key); 13 //設置package訂單參數 14 packageReqHandler.SetParameter("appid", appID); //公衆帳號ID 15 packageReqHandler.SetParameter("body", StrUtil.GetCutString(productName, 100)); //不能超過127個字符 16 packageReqHandler.SetParameter("mch_id", mchid); //商戶號 17 packageReqHandler.SetParameter("nonce_str", nonceStr.ToLower()); //隨機字符串 18 packageReqHandler.SetParameter("notify_url", notifyUrl); //接收財付統統知的URL 19 packageReqHandler.SetParameter("openid", openId); //openid 20 packageReqHandler.SetParameter("out_trade_no", sp_billno); //商家訂單號 21 // packageReqHandler.SetParameter("attach", ""); //附加數據 將來可用於區分不一樣微信支付業務 22 packageReqHandler.SetParameter("spbill_create_ip", spbill_create_ip); //用戶的公網ip,不是商戶服務器IP 23 packageReqHandler.SetParameter("total_fee", (onlinePayMoney * 100).ToString("0")); //商品金額,以分爲單位(money * 100).ToString() 24 packageReqHandler.SetParameter("trade_type", "JSAPI"); //交易類型 25 26 //獲取package包 27 string sign = packageReqHandler.CreateMd5Sign("key", TenPayInfo.Key); 28 packageReqHandler.SetParameter("sign", sign); //交易類型 29 string data = packageReqHandler.ParseXML(); 30 LoggerHelper.Log(data); 31 32 //調用統一下單接口請求訂單 33 var result = TenPayV3Service.Unifiedorder(data); 34 LoggerHelper.Log(result); 35 36 var res = XDocument.Parse(result); 37 38 string prepayId = string.Empty; 39 if (res.Element("xml").Element("return_code").Value == "SUCCESS") 40 { 41 prepayId = res.Element("xml").Element("prepay_id").Value; 42 } 43 44 string package = string.Format("prepay_id={0}", prepayId); 45 timeStamp = TenPayUtil.GetTimestamp(); 46 47 //設置支付參數 48 var paySignReqHandler = new RequestHandler(null); 49 paySignReqHandler.SetParameter("appId", appID); 50 paySignReqHandler.SetParameter("timeStamp", timeStamp); 51 paySignReqHandler.SetParameter("nonceStr", nonceStr); 52 paySignReqHandler.SetParameter("package", package); 53 paySignReqHandler.SetParameter("signType", "MD5"); 54 paySign = paySignReqHandler.CreateMd5Sign("key", TenPayInfo.Key); 55 56 //將信息傳遞給支付頁面 57 ViewBag.appId = appID; 58 ViewBag.timeStamp = timeStamp; 59 ViewBag.nonceStr = nonceStr; 60 ViewBag.package = package; 61 ViewBag.paySign = paySign;
下面是頁面js相關代碼:api
<script type="text/javascript"> // 當微信內置瀏覽器完成內部初始化後會觸發WeixinJSBridgeReady事件。 document.addEventListener('WeixinJSBridgeReady', function onBridgeReady() { $(function () { //公衆號支付 jQuery('#getBrandWCPayRequest').click(function (e) { WeixinJSBridge.invoke('getBrandWCPayRequest', { "appId": "@ViewBag.appId", //公衆號名稱 "timeStamp": "@ViewBag.timeStamp", //時間戳 "nonceStr": "@ViewBag.nonceStr", //隨機串 "package": "@Html.Raw(ViewBag.package.ToString())",//擴展包 "signType": "MD5", //微信簽名方式 "paySign": "@ViewBag.paySign" //微信簽名 }, function (res) { if (res.err_msg == "get_brand_wcpay_request:ok") { //alert("微信支付成功!"); window.location.href = "@WxPaySettingConfig.WmallURL/Wmall/TradePay/Success/@ViewBag.ShopId/?orderNo=@orderNoMark"; } else if (res.err_msg == "get_brand_wcpay_request:cancel") { //alert("用戶取消支付!"); } else { window.location.href = "/wxpay/jsapi/error/?isPayFail=1&csid=@ViewBag.ShopId&orderNo=@orderNoMark&biztype=1"; } // 使用以上方式判斷前端返回,微信團隊鄭重提示:res.err_msg將在用戶支付成功後返回ok,但並不保證它絕對可靠。 //所以微信團隊建議,當收到ok返回時,向商戶後臺詢問是否收到交易成功的通知,若收到通知,前端展現交易成功的界面;若此時未收到通知,商戶後臺主動調用查詢訂單接口,查詢訂單的當前狀態,並反饋給前端展現相應的界面。 }); }); }); //WeixinJSBridge.log('yo~ ready.'); }, false); </script>
2.商戶server接收支付通知,api參見公共api【支付結果通知API】瀏覽器
1 [HttpPost] 2 public void NoticeUrl() 3 { 4 string xmlString = HttpClientHelper.GetPostString(Request); 5 6 //此處應記錄日誌 7 LoggerHelper.Log(string.Format("【微支付】異步通知參數:{0}", xmlString)); 8 9 var returnMsg = new ReturnMessage() { Return_Code = "SUCCESS", Return_Msg = string.Empty }; 12 //通知消息實體 13 NotifyMessage message = null; 15 //訂單處理相關的方法內全局變量 16 bool isNeedDeal = false; //標識訂單是否須要處理 17 string orderNo = string.Empty; //訂單編號 (須要根據商家數據包字段判斷所屬訂單) 18 CorpSalesOrder saleOrder = null; 20 try 21 { 22 message = HttpClientHelper.XmlDeserialize<NotifyMessage>(xmlString); 23
26 //訂單號 得到 27 orderNo = message.Out_Trade_No; 28 29 if (string.IsNullOrEmpty(orderNo)) 30 { 31 throw new InvalidOperationException("未找到該訂單信息."); 32 } 45 var doc = new XmlDocument(); 46 doc.LoadXml(xmlString); 48 var dic = new Dictionary<string, string>(); 49 string sign = string.Empty; 50 foreach (XmlNode node in doc.FirstChild.ChildNodes) 51 { 52 if (node.Name.ToLower() != "sign") 53 dic.Add(node.Name, node.InnerText); 54 else 55 sign = node.InnerText; 56 } 57 UnifiedWxPayModel model = UnifiedWxPayModel.CreateUnifiedModel(xddAppId, xddMchid, xddWxkey); 58 if (model.ValidateMD5Signature(dic, sign)) 59 { 60 //處理通知 業務邏輯: 61 if (message.Return_Code == "SUCCESS") 62 { 63 if (message.Result_Code == "SUCCESS") 64 {
//此到處理支付成功後的業務邏輯 78 } 79 else 80 { 81 throw new InvalidOperationException(string.Format("{0}:{1}", message.Err_Code, message.Err_Code_Des)); 82 } 83 } 84 else 85 { 86 throw new InvalidOperationException(message.Return_Msg); 87 } 88 } 89 } 90 catch (InvalidOperationException e) 91 { 92 //此處記錄異常日誌 93 returnMsg.Return_Code = "FAIL"; 94 returnMsg.Return_Msg = e.Message; 95 LoggerHelper.Log("【微信支付異步通知】出錯,訂單編號:" + orderNo + ",錯誤緣由:" + e.Message); 96 } 97 catch (Exception e) 98 { 99 //此處記錄異常日誌 100 returnMsg.Return_Code = "FAIL"; 101 returnMsg.Return_Msg = e.Message; 102 LoggerHelper.Log("【微信支付異步通知】出錯,訂單編號:" + orderNo + ",錯誤緣由:" + (e.InnerException == null ? e.Message : e.InnerException.ToString())); 103 } 104 Response.Write(returnMsg.ToXmlString()); 105 Response.End(); 106 }