微信小程式支付
阿新 • • 發佈：2020-07-25
微信小程式支付
1、背景
因業務需要接入微信支付功能（客戶端是微信小程式），因公司伺服器版本較低，服務端採用.Net Framework 版本（並採用盛派微信SDK）
2、文件地址
1）小程式支付：https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_3&index=1
2）小程式調起支付API：https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_7&index=5
3）支付下單：https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=9_1
4）發起微信支付：https://developers.weixin.qq.com/miniprogram/dev/api/open-api/payment/wx.requestPayment.html
5）盛派SDK：http://sdk.weixin.senparc.com/
3、程式碼實現
小程式支付的互動圖如下：
3.1 服務端實現
1）引入包：
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條件可以忽略
{
/* 說明：
* 1、Redis 的連線字串資訊會從 Config.SenparcSetting.Cache_Redis_Configuration 自動獲取並註冊，如不需要修改，下方方法可以忽略
/* 2、如需手動修改，可以通過下方 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條件可以忽略
{
/* 說明：
* 1、Memcached 的連線字串資訊會從 Config.SenparcSetting.Cache_Memcached_Configuration 自動獲取並註冊，如不需要修改，下方方法可以忽略
/* 2、如需手動修改，可以通過下方 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.2、客戶端實現（小程式）
/**
* 支付
*/
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 類似，有何疑問也可以與我取得聯絡