前言

本篇主要記錄微信支付中公衆號及H5支付全過程。

準備篇

公衆號或者服務號(並開通微信支付功能)、商戶平臺中開通JSAPI支付、H5支付。

配置篇

公衆號或者服務號中 -------開發-------開發者工具---------web開發者工具-------綁定爲開發者

公衆號或者服務號中 -------公衆號設置--------功能設置：填寫業務域名、JS安全域名、網頁授權域名示例：pay.one.com

商戶平臺中--------產品中心-------開發配置------JSAPI支付授權目錄填寫：http://pay.one.com/ http://pay.one.com/WeChatPay/PubPay/-----H5支付填寫：pay.one.com

若對配置還有疑問，可參考官方文檔：

https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140842

https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6

開發篇

JSAPI支付

本Demo是基於Payment 的SDK開發。具體詳情可參考：https://github.com/Essensoft/Payment

首先使用Nuget安裝payment：

Install-Package ：Essensoft.AspNetCore.Payment.WeChatPay -Version 2.3.2

建一個Model： WeChatPayPubPayViewModel

public class WeChatPayPubPayViewModel
    {
        [Required]
        [Display(Name = "out_trade_no")]
        public string OutTradeNo { get; set; }

        [Required]
        [Display(Name = "body")]
        public string Body { get; set; }

        [Required]
        [Display(Name = "total_fee")]
        public int TotalFee { get; set; }

        [Required]
        [Display(Name = "spbill_create_ip")]
        public string SpbillCreateIp { get; set; }

        [Required]
        [Display(Name = "notify_url")]
        public string NotifyUrl { get; set; }

        [Required]
        [Display(Name = "trade_type")]
        public string TradeType { get; set; }

        [Required]
        [Display(Name = "openid")]
        public string OpenId { get; set; }
    }

WeChatPayController：

//微信支付請求客戶端（用於處理請求與響應）
private readonly IWeChatPayClient _client;
private readonly ILogger<WeChatPayController> _logger;

 private IHttpContextAccessor _accessor;

public WeChatPayController(IWeChatPayClient client, IHttpContextAccessor accessor, ILogger<WeChatPayController> logger)
        {
            _client = client;
            _accessor = accessor;
            _logger = logger;
        }
        /// <summary>
        /// 公衆號支付
        /// </summary>
        /// <returns></returns>
        [HttpGet]
        public  IActionResult PubPay()
        {
            WeChatPayPubPayViewModel payModel=new WeChatPayPubPayViewModel()
            {
                Body = "微信公衆號支付測試",
                OutTradeNo = DateTime.Now.ToString("yyyyMMddHHmmssfff"),
                TotalFee = 1,//分 單位
                SpbillCreateIp = "127.0.0.1",
                NotifyUrl = "http://pay.one.com/notify/wechatpay/unifiedorder",
                TradeType = "JSAPI",
                OpenId = "" //此處需進行授權 獲取OpenId
            };
            return View(payModel);
        }

        /// <summary>
        /// 公衆號支付
        /// </summary>
        /// <param name="viewModel"></param>
        /// <returns></returns>
        [HttpPost]
        public async Task<IActionResult> PubPay(WeChatPayPubPayViewModel viewModel)
        {
           if(string.IsNullOrEmpty(viewModel.OpenId))
           {
               ViewData["response"] = "請返回上級重新進入此頁面以獲取最新數據";
               return View();
           }

            var request = new WeChatPayUnifiedOrderRequest
            {
                Body = viewModel.Body,
                OutTradeNo = viewModel.OutTradeNo,
                TotalFee = viewModel.TotalFee,
                SpbillCreateIp = viewModel.SpbillCreateIp,
                NotifyUrl = viewModel.NotifyUrl,
                TradeType = viewModel.TradeType,
                OpenId = viewModel.OpenId //此處需進行授權 獲取OpenId
            };
            var response = await _client.ExecuteAsync(request);if (response.ReturnCode == "SUCCESS" && response.ResultCode == "SUCCESS")
            {
                var req = new WeChatPayH5CallPaymentRequest
                {
                    Package = "prepay_id=" + response.PrepayId
                };
                var parameter = await _client.ExecuteAsync(req);
                // 將參數(parameter)給 公衆號前端 讓他在微信內H5調起支付(https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6)
                ViewData["parameter"] = JsonConvert.SerializeObject(parameter);
                ViewData["response"] = response.Body;
                return View();
            }
            ViewData["response"] = response.Body;
            return View();
        }

注意：公衆號或者微信內支付，需要授權獲取到用戶的OpenId。所以，此處我們還需要進行微信授權，而授權方式有兩種，一種是靜默授權、一種是需要用戶同意，區別是靜默授權只能拿到Openid，而經用戶同意後可拿到微信頭像、暱稱、性別等其他信息。

具體可參閱文檔：https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140842

頁面：

@using Newtonsoft.Json
@model WeChatPayPubPayViewModel
@{
    ViewData["Title"] = "公衆號支付-統一下單";
}
<nav aria-label="breadcrumb">
    <ol class="breadcrumb">
        <li class="breadcrumb-item"><a asp-controller="WeChatPay" asp-action="Index">微信支付</a></li>
        <li class="breadcrumb-item active" aria-current="page">@ViewData["Title"]</li>
    </ol>
</nav>
<br />
<div class="card">
    <div class="card-body">
        <form asp-controller="WeChatPay" asp-action="PubPay">
            <div asp-validation-summary="All" class="text-danger"></div>
            <div class="form-group">
                <label asp-for="OutTradeNo"></label>
                <input type="text" class="form-control" asp-for="OutTradeNo" value="@Model?.OutTradeNo" />
            </div>
            <div class="form-group">
                <label asp-for="Body"></label>
                <input type="text" class="form-control" asp-for="Body" value="@Model?.Body" />
            </div>
            <div class="form-group">
                <label asp-for="TotalFee"></label>
                <input type="text" class="form-control" asp-for="TotalFee" value="@Model?.TotalFee" />
            </div>
            <div class="form-group">
                <label asp-for="SpbillCreateIp"></label>
                <input type="text" class="form-control" asp-for="SpbillCreateIp" value="@Model?.SpbillCreateIp" />
            </div>
            <div class="form-group">
                <label asp-for="NotifyUrl"></label>
                <input type="text" class="form-control" asp-for="NotifyUrl" value="@Model?.NotifyUrl" />
            </div>
            <div class="form-group">
                <label asp-for="TradeType"></label>
                <input type="text" class="form-control" asp-for="TradeType" value="@Model?.TradeType" />
            </div>
            <div class="form-group">
                <label asp-for="OpenId"></label>
                <input type="text" class="form-control" asp-for="OpenId" value="@Model?.OpenId" />
            </div>
            <button type="submit" class="btn btn-primary">提交請求</button>
            <button type="button" class="btn btn-success" id="PayNow">立即支付</button>
        </form>
        <hr />
        <form class="form-horizontal">
            <div class="form-group">
                <label>Response:</label>
                <textarea class="form-control" rows="10">@ViewData["response"]</textarea>
            </div>
            <div class="form-group">
                <label>Parameter:</label>
                <textarea class="form-control" rows="3">@ViewData["parameter"]</textarea>
            </div>
        </form>
    </div>
</div>
@section Scripts {
    @{await Html.RenderPartialAsync("_ValidationScriptsPartial"); }
}
<script src="~/lib/jquery/dist/jquery.min.js"></script>
<script type="text/javascript">
    $(function () {
        $("#PayNow").on('click', function () {
            const local = "http://pay.one.com/WeChatPay/PayBack/";  
              window.location.href ='https://open.weixin.qq.com/connect/oauth2/[email protected]&redirect_uri=' + encodeURIComponent(local)+'&response_type=code&scope=snsapi_base&state=a#wechat_redirect';
        });
   
    });

</script>

此時：PayBack Action如下：

 [HttpGet]
        public async  Task<IActionResult> PayBack()
        {
            var code = Request.Query["code"];
            var state = Request.Query["state"];
            OAuthToken tokenModel = new OAuthToken();
            //通過code換取token
            if (!string.IsNullOrEmpty(code))
            {
                _logger.LogWarning("授權成功");
                ViewBag.Code = code;
                tokenModel = OauthApi.GetAuthToken(code, wechatAppId);
            }

            var request = new WeChatPayUnifiedOrderRequest
            {
                Body = "微信公衆號支付測試",
                OutTradeNo = DateTime.Now.ToString("yyyyMMddHHmmssfff"),
                TotalFee = 1,//分 單位
                SpbillCreateIp = "127.0.0.1",
                NotifyUrl = "http://pay.one.com/notify/wechatpay/unifiedorder",
                TradeType = "JSAPI",
                OpenId = tokenModel.Openid //此處需進行授權 獲取OpenId
            };
            var response = await _client.ExecuteAsync(request);
            _logger.LogWarning($"統一下單接口返回：{response.ReturnCode}");

            if (response.ReturnCode == "SUCCESS" && response.ResultCode == "SUCCESS")
            {
                var req = new WeChatPayH5CallPaymentRequest
                {
                    Package = "prepay_id=" + response.PrepayId
                };
                var parameter = await _client.ExecuteAsync(req);
                // 將參數(parameter)給 公衆號前端 讓他在微信內H5調起支付(https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6)
                ViewData["parameter"] = JsonConvert.SerializeObject(parameter);
                _logger.LogWarning($"統一下單成功，即將調起微信支付：{ViewData["parameter"].ToString()}");
                ViewData["response"] = response.Body;
                return View();
            }
            ViewData["response"] = response.Body;

            
            return View();
        }

其中：OAuthToken是網頁授權返回的實體：

/// 獲取網頁授權token時，返回的實體
    /// </summary>
    public class OAuthToken : BaseRes
    {
        /// <summary>
        /// 網頁授權接口調用憑證。注意：此access_token與基礎支持的access_token不同
        /// </summary>
        [JsonProperty("access_token")]
        public string AccessToken { get; set; }
        private int _expiresIn;
        /// <summary>
        /// access_token接口調用憑證超時時間，單位（秒）
        /// </summary>
        [JsonProperty("expires_in")]
        public int ExpiresIn
        {
            get { return _expiresIn; }
            set
            {
                ExpiresTime = DateTime.Now.AddSeconds(value);
                _expiresIn = value;
            }
        }
        /// <summary>
        /// 用於刷新access_token
        /// </summary>
        [JsonProperty("refresh_token")]
        public string RefreshToken { get; set; }
        /// <summary>
        /// 用戶唯一標識。請注意，在未關注公衆號時，用戶訪問公衆號的網頁，也會產生一個用戶和公衆號唯一的openid
        /// </summary>
        [JsonProperty("openid")]
        public string Openid { get; set; }
        /// <summary>
        /// 用戶授權的作用域，使用逗號（,）分隔
        /// </summary>
        [JsonProperty("scope")]
        public string Scope { get; set; }
        [JsonProperty("expires_time")]
        public DateTime ExpiresTime { get; set; }
        /// <summary>
        /// 只有在用戶將公衆號綁定到微信開放平臺賬號後，纔會出現該字段
        /// </summary>
        [JsonProperty("unionid")]
        public string Unionid { get; set; }
    }

View Code

最後貼一下支付成功後的回調函數：

[Route("notify/wechatpay")]
    public class WeChatPayNotifyController : Controller
    {
        private readonly IWeChatPayNotifyClient _client;
        private readonly ILogger<WeChatPayNotifyController> _logger;
        public WeChatPayNotifyController(IWeChatPayNotifyClient client,ILogger<WeChatPayNotifyController> logger)
        {
            _client = client;
            _logger = logger;
        }

        /// <summary>
        /// 統一下單支付結果通知
        /// </summary>
        /// <returns></returns>
        [Route("unifiedorder")]
        [HttpPost]
        public async Task<IActionResult> Unifiedorder()
        {
            try
            {
                _logger.LogWarning($"進入回調");
                var payconfig = OpenApi.GetPayConfig();
                var notify = await _client.ExecuteAsync<WeChatPayUnifiedOrderNotify>(Request);
                _logger.LogWarning($"返回狀態碼：{notify.ReturnCode}");

                if (notify.ReturnCode == "SUCCESS")
                {
                    _logger.LogWarning($"業務結果碼：{notify.ResultCode}");

                    if (notify.ResultCode == "SUCCESS")
                    {
                        _logger.LogWarning($"支付方式：{notify.TradeType}");
                        _logger.LogWarning($"商戶訂單號：{notify.OutTradeNo}");
                        _logger.LogWarning($"微信支付訂單號：{notify.TransactionId}");
                        _logger.LogWarning($"支付金額：{notify.TotalFee}");
                        return WeChatPayNotifyResult.Success;
                    }
                }
                return NoContent();
            }
            catch(Exception ex)
            {
                _logger.LogWarning($"回調失敗：{ex.Message}");
                return NoContent();
            }
        }
}

然後測試一下支付,查看服務器Log如下：

H5支付

H5支付是指再除開微信瀏覽器以外的移動端瀏覽器上進行微信回覆操作。

和上面步驟大體一致，有幾個地方需要注意

1：客戶端IP問題：H5支付的時候，微信支付系統會根據客戶端調起的當前Ip 作爲支付Ip，若發現發起支付請求時，ip有問題，則會支付失敗，或者提示系統繁忙。這裏貼一下我獲取IP的代碼：

Utils.GetUserIp(_accessor.HttpContext)；//頁面上調用


        /// <summary>
        /// 穿過代理服務器獲取真實IP
        /// </summary>
        /// <returns></returns>
        public static string GetUserIp(this HttpContext context)
        {
            var ip = context.Request.Headers["X-Forwarded-For"].FirstOrDefault();
            if (string.IsNullOrEmpty(ip))
            {
                ip = context.Connection.RemoteIpAddress.ToString();
            }
            return ip;
            
        }

2:TradeType類型應該是：MWEB

3：若調起微信支付成功後，默認回調到支付首頁，若需要設置回調頁面，則可以再URl中拼接：

        /// <summary>
        /// H5支付
        /// </summary>
        /// <param name="viewModel"></param>
        /// <returns></returns>
        [HttpPost]
        public async Task<IActionResult> H5Pay(WeChatPayH5PayViewModel viewModel)
        {
            var request = new WeChatPayUnifiedOrderRequest
            {
                Body = viewModel.Body,
                OutTradeNo = viewModel.OutTradeNo,
                TotalFee = viewModel.TotalFee,
                SpbillCreateIp = viewModel.SpbillCreateIp,
                NotifyUrl = viewModel.NotifyUrl,
                TradeType = viewModel.TradeType
            };
            var response = await _client.ExecuteAsync(request);

            // mweb_url爲拉起微信支付收銀臺的中間頁面，可通過訪問該url來拉起微信客戶端，完成支付,mweb_url的有效期爲5分鐘。
            if (response.MwebUrl == null)
            {
                ViewData["response"] = response.ReturnMsg;
                return View();
            }
            return Redirect(response.MwebUrl);
        }

更多詳細可參考文檔：https://pay.weixin.qq.com/wiki/doc/api/H5.php?chapter=15_4

4：支付結果通知：

注意：

1、同樣的通知可能會多次發送給商戶系統。商戶系統必須能夠正確處理重複的通知。

2、後臺通知交互時，如果微信收到商戶的應答不符合規範或超時，微信會判定本次通知失敗，重新發送通知，直到成功爲止（在通知一直不成功的情況下，微信總共會發起10次通知，通知頻率爲15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 總計 24h4m），但微信不保證通知最終一定能成功。

3、在訂單狀態不明或者沒有收到微信支付結果通知的情況下，建議商戶主動調用微信支付【查詢訂單API】確認訂單狀態。

特別提醒：

1、商戶系統對於支付結果通知的內容一定要做簽名驗證,並校驗返回的訂單金額是否與商戶側的訂單金額一致，防止數據泄漏導致出現“假通知”，造成資金損失。

2、當收到通知進行處理時，首先檢查對應業務數據的狀態，判斷該通知是否已經處理過，如果沒有處理過再進行處理，如果處理過直接返回結果成功。在對業務數據進行狀態檢查和處理之前，要採用數據鎖進行併發控制，以避免函數重入造成的數據混亂。

最後可以測試下H5支付，查看返回的Log：

本文只是拋磚引玉，更多具體支付場景和代碼，還需各位看官結合自己項目量身定做。

更多示例Demo可入羣獲取。

.NET Core之微信支付之公衆號、H5支付篇

前言

準備篇

配置篇

開發篇

JSAPI支付

H5支付

DAPPER 事務 TRANSACTION

Java中線程的創建方式

一鍵自動化博客發佈工具,chrome和firfox詳細配置

時隔近一年半，《在線客服系統2.0》它終於來了～

(原創)用.NET Core實現一個在線客服系統(上篇)

物流一站式單號查詢之快遞鳥API接口（附Demo源碼）

C# MVC權限驗證

如何實現一個微信自動回覆消息的工具？

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結