微信小程序支付
一、背景
因業務須要接入微信支付功能(客戶端是微信小程序),因公司服務器版本較低,服務端採用.Net Framework 版本(並採用盛派微信SDK)php
二、文檔地址
1)小程序支付:https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_3&index=1html
2)小程序調起支付API:https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_7&index=5git
3)支付下單:https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=9_1github
4)發起微信支付:https://developers.weixin.qq.com/miniprogram/dev/api/open-api/payment/wx.requestPayment.htmlredis
5)盛派SDK:http://sdk.weixin.senparc.com/小程序
三、代碼實現
小程序支付的交互圖以下:微信小程序
3.1 服務端實現
1)引入包:api
2)註冊:在 Global.asmx 裏進行註冊緩存
/* * CO2NET 全局註冊開始 * 建議按照如下順序進行註冊 */ /* * CO2NET 是從 Senparc.Weixin 分離的底層公共基礎模塊,通過了長達 6 年的迭代優化。 * 關於 CO2NET 在全部項目中的通用設置可參考 CO2NET 的 Sample: * https://github.com/Senparc/Senparc.CO2NET/blob/master/Sample/Senparc.CO2NET.Sample.netcore/Startup.cs */ //設置全局 Debug 狀態 var isGLobalDebug = true; //全局設置參數,將被儲存到 Senparc.CO2NET.Config.SenparcSetting var senparcSetting = SenparcSetting.BuildFromWebConfig(isGLobalDebug); //也能夠經過這種方法在程序任意位置設置全局 Debug 狀態: //Senparc.CO2NET.Config.IsDebug = isGLobalDebug; //CO2NET 全局註冊,必須!! IRegisterService register = RegisterService.Start(senparcSetting).UseSenparcGlobal(); #region 全局緩存配置(按需) #region 配置和使用 Redis -- DPBMARK Redis //配置全局使用Redis緩存(按需,獨立) var redisConfigurationStr = senparcSetting.Cache_Redis_Configuration; var useRedis = !string.IsNullOrEmpty(redisConfigurationStr) && redisConfigurationStr != "Redis配置"; if (useRedis)//這裏爲了方便不一樣環境的開發者進行配置,作成了判斷的方式,實際開發環境通常是肯定的,這裏的if條件能夠忽略 { /* 說明: * 一、Redis 的鏈接字符串信息會從 Config.SenparcSetting.Cache_Redis_Configuration 自動獲取並註冊,如不須要修改,下方方法能夠忽略 /* 二、如需手動修改,能夠經過下方 SetConfigurationOption 方法手動設置 Redis 連接信息(僅修改配置,不當即啓用) */ Senparc.CO2NET.Cache.Redis.Register.SetConfigurationOption(redisConfigurationStr); //如下會當即將全局緩存設置爲 Redis Senparc.CO2NET.Cache.Redis.Register.UseKeyValueRedisNow();//鍵值對緩存策略(推薦) //Senparc.CO2NET.Cache.Redis.Register.UseHashRedisNow();//HashSet儲存格式的緩存策略 //也能夠經過如下方式自定義當前須要啓用的緩存策略 //CacheStrategyFactory.RegisterObjectCacheStrategy(() => RedisObjectCacheStrategy.Instance);//鍵值對 //CacheStrategyFactory.RegisterObjectCacheStrategy(() => RedisHashSetObjectCacheStrategy.Instance);//HashSet } //若是這裏不進行Redis緩存啓用,則目前仍是默認使用內存緩存 #endregion // DPBMARK_END #region 配置和使用 Memcached -- DPBMARK Memcached //配置Memcached緩存(按需,獨立) var memcachedConfigurationStr = senparcSetting.Cache_Memcached_Configuration; var useMemcached = !string.IsNullOrEmpty(memcachedConfigurationStr) && memcachedConfigurationStr != "Memcached配置"; if (useMemcached) //這裏爲了方便不一樣環境的開發者進行配置,作成了判斷的方式,實際開發環境通常是肯定的,這裏的if條件能夠忽略 { /* 說明: * 一、Memcached 的鏈接字符串信息會從 Config.SenparcSetting.Cache_Memcached_Configuration 自動獲取並註冊,如不須要修改,下方方法能夠忽略 /* 二、如需手動修改,能夠經過下方 SetConfigurationOption 方法手動設置 Memcached 連接信息(僅修改配置,不當即啓用) */ Senparc.CO2NET.Cache.Memcached.Register.SetConfigurationOption(memcachedConfigurationStr); //如下會當即將全局緩存設置爲 Memcached Senparc.CO2NET.Cache.Memcached.Register.UseMemcachedNow(); //也能夠經過如下方式自定義當前須要啓用的緩存策略 CacheStrategyFactory.RegisterObjectCacheStrategy(() => MemcachedObjectCacheStrategy.Instance); } #endregion // DPBMARK_END #endregion #region 註冊日誌(按需,建議) register.RegisterTraceLog(ConfigWeixinTraceLog);//配置TraceLog #endregion /* 微信配置開始 * 建議按照如下順序進行註冊 */ //設置微信 Debug 狀態 var isWeixinDebug = true; //全局設置參數,將被儲存到 Senparc.Weixin.Config.SenparcWeixinSetting var senparcWeixinSetting = SenparcWeixinSetting.BuildFromWebConfig(isWeixinDebug); //也能夠經過這種方法在程序任意位置設置微信的 Debug 狀態: //Senparc.Weixin.Config.IsDebug = isWeixinDebug; //微信全局註冊,必須!! register.UseSenparcWeixin(senparcWeixinSetting, senparcSetting) #region 註冊公衆號或小程序(按需) //註冊公衆號(可註冊多個) -- DPBMARK MP .RegisterMpAccount(senparcWeixinSetting, "【盛派網絡小助手】公衆號")// DPBMARK_END //註冊多個公衆號或小程序(可註冊多個) -- DPBMARK MiniProgram .RegisterWxOpenAccount(senparcWeixinSetting, "小程序名稱")// DPBMARK_END //除此之外,仍然能夠在程序任意地方註冊公衆號或小程序: //AccessTokenContainer.Register(appId, appSecret, name);//命名空間:Senparc.Weixin.MP.Containers #endregion // DPBMARK_END #region 註冊微信支付(按需) -- DPBMARK TenPay //註冊舊微信支付版本(V2)(可註冊多個) .RegisterTenpayOld(senparcWeixinSetting, "標記名稱")//這裏的 name 和第一個 RegisterMpAccount() 中的一致,會被記錄到同一個 SenparcWeixinSettingItem 對象中 //註冊最新微信支付版本(V3)(可註冊多個) .RegisterTenpayV3(senparcWeixinSetting, "標記名稱")//記錄到同一個 SenparcWeixinSettingItem 對象中 #endregion // DPBMARK_END // DPBMARK_END ; /* 微信配置結束 */
/// <summary> /// 配置微信跟蹤日誌 /// </summary> private void ConfigWeixinTraceLog() { //Senparc.CO2NET.Config.IsDebug = false; //這裏設爲Debug狀態時,/App_Data/WeixinTraceLog/目錄下會生成日誌文件記錄全部的API請求日誌,正式發佈版本建議關閉 Senparc.Weixin.WeixinTrace.SendCustomLog("系統日誌", "系統啓動");//只在Senparc.Weixin.Config.IsDebug = true的狀況下生效 //自定義日誌記錄回調 Senparc.Weixin.WeixinTrace.OnLogFunc = () => { //加入每次觸發Log後須要執行的代碼 }; //當發生基於WeixinException的異常時觸發 Senparc.Weixin.WeixinTrace.OnWeixinExceptionFunc = ex => { //加入每次觸發WeixinExceptionLog後須要執行的代碼 //發送模板消息給管理員 var eventService = new EventService(); eventService.ConfigOnWeixinExceptionFunc(ex); }; }
3)統一下單:服務器
*** 因實際代碼設計隱私問題,所以剔除了,若有問題請聯繫我。
public async Task<ActionResult> GetWxOpenPrepayid(string sessionId,string cost) { try { var sessionBag = SessionContainer.GetSession(sessionId); var openId = sessionBag.OpenId; //生成訂單10位序列號,此處用時間和隨機數生成,商戶根據本身調整,保證惟一 var sp_billno = string.Format("{0}{1}{2}", "商戶號" /*10位*/, SystemTime.Now.ToString("yyyyMMddHHmmss"), TenPayV3Util.BuildRandomStr(6)); var timeStamp = TenPayV3Util.GetTimestamp(); var nonceStr = TenPayV3Util.GetNoncestr(); var price = Convert.ToInt32(Convert.ToDecimal(cost) * 100);//單位:分 var xmlDataInfo = new TenPayV3UnifiedorderRequestData( "小程序AppId", "小程序商戶號", body, sp_billno, price, "127.0.0.1", "回調地址", TenPayV3Type.JSAPI, openId, "小程序商戶key", nonceStr, attach: "附加數據"); var result = TenPayV3.Unifiedorder(xmlDataInfo);//調用統一訂單接口 // WeixinTrace.SendCustomLog("統一訂單接口調用結束", "請求:" + xmlDataInfo.ToJson() + "\r\n\r\n返回結果:" + result.ToJson()); var packageStr = "prepay_id=" + result.prepay_id; //var cacheStrategy = CacheStrategyFactory.GetObjectCacheStrategyInstance(); //cacheStrategy.Set($"WxOpenUnifiedorderRequestData-{openId}", xmlDataInfo, TimeSpan.FromDays(4));//3天內能夠發送模板消息 //cacheStrategy.Set($"WxOpenUnifiedorderResultData-{openId}", result, TimeSpan.FromDays(4));//3天內能夠發送模板消息 return ToSuccess(data: new { result.prepay_id, appId = "小程序AppId", timeStamp, nonceStr, tradeId = sp_billno, package = packageStr, //signType = "MD5", paySign = TenPayV3.GetJsPaySign("小程序AppId", timeStamp, nonceStr, packageStr, "小程序支付key") }); } catch (Exception ex) { return ToError(msg: ex.Message); }
*** 這個接口 在什麼地方用呢(A:在小程序客戶端調用微信支付的時候須要用到【並且是必須的】,也就是下午的 小程序客戶端調用:wx.requestPayment 的時候)
4)回調地址(支付結果通知):
*** 須要注意的地方已 標出了。(值得注意的就是這個地址必須是外網能訪問到的)
代碼實現:
public ActionResult InquiryNotify() { try { var resHandler = new ResponseHandler(null); var return_code = resHandler.GetParameter("return_code"); var return_msg = resHandler.GetParameter("return_msg"); if (return_code != "SUCCESS") return PayResultNotify(); var attach = resHandler.GetParameter("attach"); if (string.IsNullOrEmpty(attach)) return PayResultNotify(); //這裏請簽名驗證,並校驗返回的訂單金額是否與商戶側的訂單金額一致 var cost = resHandler.GetParameter("total_fee");//金額 var tradeId = resHandler.GetParameter("out_trade_no");//商戶訂單號 //驗證支付狀態與金額 //業務邏輯處理,採用異步回調 return PayResultNotify("SUCCESS", "OK"); } catch (Exception ex) { return PayResultNotify(); } } private ActionResult PayResultNotify(string returnCode = "FAIL", string returnMsg = "wrong") { var xml = $@"<xml> <return_code><![CDATA[{returnCode}]]></return_code> <return_msg><![CDATA[{returnMsg}]]></return_msg> </xml>"; return Content(xml, "text/xml"); }
3.二、客戶端實現(小程序)
/** * 支付 */ bindPay: function(e) { let that = this let url = wx.getStorageSync(config.domainName) url += '服務端接口地址' let data = { sessionId: wx.getStorageSync(config.sessionId), cost: "支付金額", } wxRequest.getRequest(url, data).then((res) => { if (res.data.success) { let payInfo = res.data.data wx.requestPayment({ timeStamp: payInfo.timeStamp, nonceStr: payInfo.nonceStr, package: payInfo.package, paySign: payInfo.paySign, signType: 'MD5', success: function(res) { /*這裏必定要注意,這裏的方法有可能會不執行(支付完成後 用戶在不點擊 支付完成頁面底部的「完成」按鈕時 這裏的方法是不會執行到的,所以這裏請不要寫業務邏輯代碼)*/ that.queryPayResult(payInfo.tradeId) }, fail: function(res) {
/*用戶取消支付後 會執行這裏的方面*/ that.payCancel(payInfo.tradeId) } }) } else { app.showToast(res.data.msg) } }) }
至此,小程序的支付就完成了。感謝 盛派網絡 對微信相關接口的封裝,用起來很方便
說明:
1:若有疑問,能夠與我取得聯繫
2:已官方文檔爲主,頗有可能過些時間後文檔及SDK會發生變化
3:官方文檔已在上文中給出
4:文章首發於公衆號
5:服務端使用的小程序包是盛派的SDK(https://weixin.senparc.com)GitHub:https://github.com/Senparc/WeiXinMPSDK
6:.Net Core 相似,有何疑問也能夠與我取得聯繫
若是對您有幫助,點個推薦唄!