微信公眾號(hào)支付接口開發(fā)的注意事項(xiàng)有哪些

這篇文章將為大家詳細(xì)講解有關(guān)微信公眾號(hào)支付接口開發(fā)的注意事項(xiàng)有哪些，小編覺得挺實(shí)用的，因此分享給大家做個(gè)參考，希望大家閱讀完這篇文章后可以有所收獲。

公眾號(hào)支付就是在微信里面的H5頁(yè)面喚起微信支付，不用掃碼即可付款的功能。做這個(gè)功能首先要明確的就是，只有和商戶號(hào)mch_id匹配的appid才能成功支付。商戶號(hào)在注冊(cè)成功的時(shí)候就會(huì)將相關(guān)信息發(fā)送到郵箱里面。而喚起支付的一個(gè)關(guān)鍵是靠openid拿到統(tǒng)一下單。而openid是和appid一一對(duì)應(yīng)的。也就是說如果你登錄使用的appid不是公眾號(hào)的appid，得到的openid就無(wú)法喚起公眾號(hào)內(nèi)的支付(會(huì)出現(xiàn)appid和商戶號(hào)不匹配的錯(cuò)誤)。曾經(jīng)就在這個(gè)地方繞了個(gè)彎，因?yàn)槲⑿诺拈_放平臺(tái)可以創(chuàng)建網(wǎng)站應(yīng)用，也有一個(gè)appid和appsecreat，也可以在微信里面一鍵登錄。

業(yè)務(wù)流程

下面是微信的官方流程，看似有點(diǎn)復(fù)雜，重點(diǎn)就是要拿到統(tǒng)一下單接口返回的json串，其他按照官方demo基本就能正確，下面說一下幾個(gè)細(xì)節(jié)。

創(chuàng)建訂單

在調(diào)用微信公眾號(hào)支付之前，首先我們自己要把訂單創(chuàng)建好。比如一個(gè)充值的訂單。主要是先確定下金額再進(jìn)行下一步。

  public JsonResult CreateRecharegOrder(decimal money)
        {            if (money < (decimal)0.01) return Json(new PaymentResult("充值金額非法！"));            var user = _workContext.CurrentUser;            var order = _paymentService.CreateRechargeOrder(user.Id, money);            return Json(new PaymentResult(true) {OrderId = order.OrderNumber});
        }

調(diào)用統(tǒng)一下單

訂單創(chuàng)建成功之后，頁(yè)面跳轉(zhuǎn)到支付頁(yè)面，這個(gè)時(shí)候就是按照官方的流程去拿prepay_id和paySign,微信的demo中提供了一個(gè)jsApiPay的對(duì)象。但這個(gè)對(duì)象需要一個(gè)page對(duì)象初始化。

       [LoginValid]        public ActionResult H5Pay(string orderNumber)
        {            var user = _workContext.CurrentUser;            var order = _paymentService.GetOrderByOrderNumber(orderNumber);            //判斷訂單是否存在            //訂單是否已經(jīng)支付了
            var openid = user.OpenId;            var jsApipay = new JsApiPayMvc(this.ControllerContext.HttpContext);
            jsApipay.openid = openid;
            jsApipay.total_fee = (int)order.Amount * 100;
            WxPayData unifiedOrderResult = jsApipay.GetUnifiedOrderResult();
            ViewBag.wxJsApiParam = jsApipay.GetJsApiParameters();//獲取H5調(diào)起JS API參數(shù)     
            ViewBag.unifiedOrder = unifiedOrderResult.ToPrintStr();
            ViewBag.OrderNumber = order.OrderNumber;            return View();
        }

在MVC中我們簡(jiǎn)單改一下就可以了。也就是把page對(duì)象換成httpContext即可。然后里面的方法就可以直接用了。

JsApiPayMvc：

using System;using System.Collections.Generic;using System.Web;using System.Web.UI;using System.Web.UI.WebControls;using System.Runtime.Serialization;using System.IO;using System.Text;using System.Net;using System.Web.Security;using LitJson;namespace WxPayAPI
{    public class JsApiPayMvc
    {        /// <summary>
        /// 保存頁(yè)面對(duì)象，因?yàn)橐陬惖姆椒ㄖ惺褂肞age的Request對(duì)象        /// </summary>
        public HttpContextBase context { get; set; }        /// <summary>
        /// openid用于調(diào)用統(tǒng)一下單接口        /// </summary>
        public string openid { get; set; }        /// <summary>
        /// access_token用于獲取收貨地址js函數(shù)入口參數(shù)        /// </summary>
        public string access_token { get; set; }        /// <summary>
        /// 商品金額，用于統(tǒng)一下單        /// </summary>
        public int total_fee { get; set; }        /// <summary>
        /// 統(tǒng)一下單接口返回結(jié)果        /// </summary>
        public WxPayData unifiedOrderResult { get; set; }        public JsApiPayMvc(HttpContextBase _context)
        {
            context = _context;
        }        /**
        * 
        * 網(wǎng)頁(yè)授權(quán)獲取用戶基本信息的全部過程
        * 詳情請(qǐng)參看網(wǎng)頁(yè)授權(quán)獲取用戶基本信息：http://mp.weixin.qq.com/wiki/17/c0f37d5704f0b64713d5d2c37b468d75.html
        * 第一步：利用url跳轉(zhuǎn)獲取code
        * 第二步：利用code去獲取openid和access_token
        * 
        */
        public void GetOpenidAndAccessToken(string code)
        {            if (!string.IsNullOrEmpty(code))
            {                //獲取code碼，以獲取openid和access_token
                Log.Debug(this.GetType().ToString(), "Get code : " + code);
                GetOpenidAndAccessTokenFromCode(code);
            }            else
            {                //構(gòu)造網(wǎng)頁(yè)授權(quán)獲取code的URL
                string host = context.Request.Url.Host;                string path = context.Request.Path;                string redirect_uri = HttpUtility.UrlEncode("http://" + host + path);
                WxPayData data = new WxPayData();
                data.SetValue("appid", WxPayConfig.APPID);
                data.SetValue("redirect_uri", redirect_uri);
                data.SetValue("response_type", "code");
                data.SetValue("scope", "snsapi_base");
                data.SetValue("state", "STATE" + "#wechat_redirect");                string url = "https://open.weixin.qq.com/connect/oauth3/authorize?" + data.ToUrl();
                Log.Debug(this.GetType().ToString(), "Will Redirect to URL : " + url);                try
                {                    //觸發(fā)微信返回code碼         
                    context.Response.Redirect(url);//Redirect函數(shù)會(huì)拋出ThreadAbortException異常，不用處理這個(gè)異常                }                catch(System.Threading.ThreadAbortException ex)
                {
                }
            }
        }        /**
        * 
        * 通過code換取網(wǎng)頁(yè)授權(quán)access_token和openid的返回?cái)?shù)據(jù)，正確時(shí)返回的JSON數(shù)據(jù)包如下：
        * {
        *  "access_token":"ACCESS_TOKEN",
        *  "expires_in":7200,
        *  "refresh_token":"REFRESH_TOKEN",
        *  "openid":"OPENID",
        *  "scope":"SCOPE",
        *  "unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL"
        * }
        * 其中access_token可用于獲取共享收貨地址
        * openid是微信支付jsapi支付接口統(tǒng)一下單時(shí)必須的參數(shù)
        * 更詳細(xì)的說明請(qǐng)參考網(wǎng)頁(yè)授權(quán)獲取用戶基本信息：http://mp.weixin.qq.com/wiki/17/c0f37d5704f0b64713d5d2c37b468d75.html
        * @失敗時(shí)拋異常WxPayException        */
        public void GetOpenidAndAccessTokenFromCode(string code)
        {            try
            {                //構(gòu)造獲取openid及access_token的url
                WxPayData data = new WxPayData();
                data.SetValue("appid", WxPayConfig.APPID);
                data.SetValue("secret", WxPayConfig.APPSECRET);
                data.SetValue("code", code);
                data.SetValue("grant_type", "authorization_code");                string url = "https://api.weixin.qq.com/sns/oauth3/access_token?" + data.ToUrl();                //請(qǐng)求url以獲取數(shù)據(jù)
                string result = HttpService.Get(url);
                Log.Debug(this.GetType().ToString(), "GetOpenidAndAccessTokenFromCode response : " + result);                //保存access_token，用于收貨地址獲取
                JsonData jd = JsonMapper.ToObject(result);
                access_token = (string)jd["access_token"];                //獲取用戶openid
                openid = (string)jd["openid"];
                Log.Debug(this.GetType().ToString(), "Get openid : " + openid);
                Log.Debug(this.GetType().ToString(), "Get access_token : " + access_token);
            }            catch (Exception ex)
            {
                Log.Error(this.GetType().ToString(), ex.ToString());                throw new WxPayException(ex.ToString());
            }
        }        /**
         * 調(diào)用統(tǒng)一下單，獲得下單結(jié)果
         * @return 統(tǒng)一下單結(jié)果
         * @失敗時(shí)拋異常WxPayException         */
        public WxPayData GetUnifiedOrderResult()
        {            //統(tǒng)一下單
            WxPayData data = new WxPayData();
            data.SetValue("body", "test");
            data.SetValue("attach", "test");
            data.SetValue("out_trade_no", WxPayApi.GenerateOutTradeNo());
            data.SetValue("total_fee", total_fee);
            data.SetValue("time_start", DateTime.Now.ToString("yyyyMMddHHmmss"));
            data.SetValue("time_expire", DateTime.Now.AddMinutes(10).ToString("yyyyMMddHHmmss"));
            data.SetValue("goods_tag", "test");
            data.SetValue("trade_type", "JSAPI");
            data.SetValue("openid", openid);
            WxPayData result = WxPayApi.UnifiedOrder(data);            if (!result.IsSet("appid") || !result.IsSet("prepay_id") || result.GetValue("prepay_id").ToString() == "")
            {
                Log.Error(this.GetType().ToString(), "UnifiedOrder response error!");                throw new WxPayException("UnifiedOrder response error!");
            }
            unifiedOrderResult = result;            return result;
        }        /**
        *  
        * 從統(tǒng)一下單成功返回的數(shù)據(jù)中獲取微信瀏覽器調(diào)起jsapi支付所需的參數(shù)，
        * 微信瀏覽器調(diào)起JSAPI時(shí)的輸入?yún)?shù)格式如下：
        * {
        *   "appId" : "wx2421b1c4370ec43b",     //公眾號(hào)名稱，由商戶傳入     
        *   "timeStamp":" 1395712654",         //時(shí)間戳，自1970年以來的秒數(shù)     
        *   "nonceStr" : "e61463f8efa94090b1f366cccfbbb444", //隨機(jī)串     
        *   "package" : "prepay_id=u802345jgfjsdfgsdg888",     
        *   "signType" : "MD5",         //微信簽名方式:    
        *   "paySign" : "70EA570631E4BB79628FBCA90534C63FF7FADD89" //微信簽名 
        * }
        * @return string 微信瀏覽器調(diào)起JSAPI時(shí)的輸入?yún)?shù)，json格式可以直接做參數(shù)用
        * 更詳細(xì)的說明請(qǐng)參考網(wǎng)頁(yè)端調(diào)起支付API：http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7
        * 
        */
        public string GetJsApiParameters()
        {
            Log.Debug(this.GetType().ToString(), "JsApiPay::GetJsApiParam is processing...");
            WxPayData jsApiParam = new WxPayData();
            jsApiParam.SetValue("appId", unifiedOrderResult.GetValue("appid"));
            jsApiParam.SetValue("timeStamp", WxPayApi.GenerateTimeStamp());
            jsApiParam.SetValue("nonceStr", WxPayApi.GenerateNonceStr());
            jsApiParam.SetValue("package", "prepay_id=" + unifiedOrderResult.GetValue("prepay_id"));
            jsApiParam.SetValue("signType", "MD5");
            jsApiParam.SetValue("paySign", jsApiParam.MakeSign());            string parameters = jsApiParam.ToJson();
            Log.Debug(this.GetType().ToString(), "Get jsApiParam : " + parameters);            return parameters;
        }        /**
        * 
        * 獲取收貨地址js函數(shù)入口參數(shù),詳情請(qǐng)參考收貨地址共享接口：http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_9
        * @return string 共享收貨地址js函數(shù)需要的參數(shù)，json格式可以直接做參數(shù)使用        */
        public string GetEditAddressParameters()
        {            string parameter = "";            try
            {                string host = context.Request.Url.Host;                string path = context.Request.Path;                string queryString = context.Request.Url.Query;                //這個(gè)地方要注意，參與簽名的是網(wǎng)頁(yè)授權(quán)獲取用戶信息時(shí)微信后臺(tái)回傳的完整url
                string url = "http://" + host + path + queryString;                //構(gòu)造需要用SHA1算法加密的數(shù)據(jù)
                WxPayData signData = new WxPayData();
                signData.SetValue("appid",WxPayConfig.APPID);
                signData.SetValue("url", url);
                signData.SetValue("timestamp",WxPayApi.GenerateTimeStamp());
                signData.SetValue("noncestr",WxPayApi.GenerateNonceStr());
                signData.SetValue("accesstoken",access_token);                string param = signData.ToUrl();
                Log.Debug(this.GetType().ToString(), "SHA1 encrypt param : " + param);                //SHA1加密
                string addrSign = FormsAuthentication.HashPasswordForStoringInConfigFile(param, "SHA1");
                Log.Debug(this.GetType().ToString(), "SHA1 encrypt result : " + addrSign);                //獲取收貨地址js函數(shù)入口參數(shù)
                WxPayData afterData = new WxPayData();
                afterData.SetValue("appId",WxPayConfig.APPID);
                afterData.SetValue("scope","jsapi_address");
                afterData.SetValue("signType","sha1");
                afterData.SetValue("addrSign",addrSign);
                afterData.SetValue("timeStamp",signData.GetValue("timestamp"));
                afterData.SetValue("nonceStr",signData.GetValue("noncestr"));                //轉(zhuǎn)為json格式
                parameter = afterData.ToJson();
                Log.Debug(this.GetType().ToString(), "Get EditAddressParam : " + parameter);
            }            catch (Exception ex)
            {
                Log.Error(this.GetType().ToString(), ex.ToString());                throw new WxPayException(ex.ToString());
            }            return parameter;
        }
    }
}

View Code

這個(gè)頁(yè)面可以在本地調(diào)試，可以比較方便的確認(rèn)參數(shù)是否ok。

喚起支付

官方頁(yè)面的示例如下：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6 但主要的參數(shù)(mark部分)是由后臺(tái)生成的，也就是上一個(gè)步驟的ViewBag.wxJsApiParam

function onBridgeReady(){
   WeixinJSBridge.invoke(
       'getBrandWCPayRequest', {           "appId" ： "wx2421b1c4370ec43b",     //公眾號(hào)名稱，由商戶傳入     
           "timeStamp"：" 1395712654",         //時(shí)間戳，自1970年以來的秒數(shù)     
           "nonceStr" ： "e61463f8efa94090b1f366cccfbbb444", //隨機(jī)串     
           "package" ： "prepay_id=u802345jgfjsdfgsdg888",     
           "signType" ： "MD5",         //微信簽名方式：     
           "paySign" ： "70EA570631E4BB79628FBCA90534C63FF7FADD89" //微信簽名 
       },
       function(res){     
           if(res.err_msg == "get_brand_wcpay_request：ok" ) {}     // 使用以上方式判斷前端返回,微信團(tuán)隊(duì)鄭重提示：res.err_msg將在用戶支付成功后返回    ok，但并不保證它絕對(duì)可靠。 
       }
   ); 
}

所以在MVC中要這樣寫：

@{
    ViewBag.Title = "微信支付";
    Layout = "~/Views/Shared/_Layout.cshtml";
}<p class="page" id="Wxpayment">
    <p class="content">
        <p>訂單詳情：@Html.Raw(ViewBag.unifiedOrder)</p>
        <button id="h6pay" onclick="callpay()">支付</button>
    </p>
    <input type="hidden" value="@ViewBag.OrderNumber" id="ordernum"/></p>
 <script type="text/javascript">
    //調(diào)用微信JS api 支付
    function jsApiCall() {
        WeixinJSBridge.invoke(            'getBrandWCPayRequest',            @Html.Raw(ViewBag.wxJsApiParam),//josn串
            function (res)
            {
                WeixinJSBridge.log(res.err_msg);                //alert(res.err_code + res.err_desc + res.err_msg);
                if (res.err_msg == "get_brand_wcpay_request:ok") {                   var num = $("#ordernum").val();
                    $.post("/payment/WeiXinPaySuccess", { ordernumber: num }, function(data) {                        if (data.IsSuccess === true) {
                            alert("支付成功");
                            location.href = document.referrer;
                        } else {
                            
                        }
                    });
                } 
                if (res.err_msg == 'get_brand_wcpay_request:cancel') {
                      $('.button').removeAttr('submitting');
                      alert('取消支付');
                } 
            }
        );
    }    function callpay()
    {        if (typeof WeixinJSBridge == "undefined")
        {
            alert("WeixinJSBridge =");            if (document.addEventListener)
            {
                document.addEventListener('WeixinJSBridgeReady', jsApiCall, false);
            }            else if (document.attachEvent)
            {
                document.attachEvent('WeixinJSBridgeReady', jsApiCall);
                document.attachEvent('onWeixinJSBridgeReady', jsApiCall);
            }
        }        else
        {
            jsApiCall();
        }
    }</script>

必須要用Html.Raw，不然json解析不對(duì)，無(wú)法支付。這個(gè)時(shí)候點(diǎn)擊頁(yè)面，會(huì)出現(xiàn)微信的加載效果，但別高興的太早，還是會(huì)出錯(cuò)，出現(xiàn)一個(gè)“3當(dāng)前的URL未注冊(cè)”

原因就在于，需要在公眾號(hào)中設(shè)置支付目錄。而這個(gè)支付目錄是大小寫敏感的，所以你得多試幾次。直到彈出輸入密碼的窗口才是真的流程正確了。然后支付成功之后馬上就可以收到j(luò)s中的回調(diào)，這個(gè)時(shí)候你可以去處理你的訂單和業(yè)務(wù)邏輯。

小結(jié)

如果是生產(chǎn)環(huán)境，我們需要再多個(gè)地方調(diào)用，需要再封裝一下。

function jsApiCall(json, success, fail) {
    WeixinJSBridge.invoke(        'getBrandWCPayRequest',
        json,//josn串
        function (res)
        {
            WeixinJSBridge.log(res.err_msg);            //alert(res.err_code + res.err_desc + res.err_msg);
            if (res.err_msg == "get_brand_wcpay_request:ok") {                //充值進(jìn)去 要區(qū)分是出題充值 還是購(gòu)買懸賞 前者沖到他的錢包
                //后者直接沖到系統(tǒng)賬戶
                if (success) success();
            } 
            if (res.err_msg == 'get_brand_wcpay_request:cancel') {                // alert('取消支付');
                if (fail)fail();
            } 
        }
    );
}function callpay(json,success,fail)
{    if (typeof WeixinJSBridge == "undefined")
    {
        alert("請(qǐng)?jiān)谖⑿胖写蜷_!");        if (document.addEventListener)
        {
            document.addEventListener('WeixinJSBridgeReady', jsApiCall, false);
        }        else if (document.attachEvent)
        {
            document.attachEvent('WeixinJSBridgeReady', jsApiCall);
            document.attachEvent('onWeixinJSBridgeReady', jsApiCall);
        }
    }    else
    {
        jsApiCall(json, success, fail);
    }
}

View Code

  [LoginValid]        public ActionResult H5PayJson(string orederId)
        {            var user = _workContext.CurrentUser;            var order = _paymentService.GetOrderByOrderNumber(orederId);            //判斷訂單是否存在            //訂單是否已經(jīng)支付了
            var openid = user.OpenId;            var jsApipay = new JsApiPayMvc(ControllerContext.HttpContext)
            {
                openid = openid,
                total_fee = (int) order.Amount*100
            };            try
            {
                jsApipay.GetUnifiedOrderResult();                return Json(jsApipay.GetJsApiParameters());//實(shí)際還是字符串
            }            catch (Exception e)
            {                //統(tǒng)一下單失敗
                return Json(new PortalResult(false, e.Message));
            }
        }

調(diào)用的時(shí)候這樣直接喚起支付了。 但如果傳入的json不是json對(duì)象，微信加載動(dòng)畫會(huì)一直卡在哪兒。

 $.post("/Checkout/H5PayJson", { orederId: orderId }, function (jsondata) {                                var jdata = JSON.parse(jsondata);                                if (jdata.appId) {
                                    callpay(jdata, function () {
                                        $.post("/payment/WeiXinPaySuccess", { ordernumber: orderId }, function (paymentdata) {                                            if (paymentdata.IsSuccess === true) {
                                                submitQuestion();
                                            } else {
                                                $.alert(paymentdata.Message);
                                            }
                                        });
                                    }, function () {
                                        $.alert("你已取消支付!");
                                    });
                                } else {
                                    alert("統(tǒng)一下單失敗!");
                                }
                            });

關(guān)于“微信公眾號(hào)支付接口開發(fā)的注意事項(xiàng)有哪些”這篇文章就分享到這里了，希望以上內(nèi)容可以對(duì)大家有一定的幫助，使各位可以學(xué)到更多知識(shí)，如果覺得文章不錯(cuò)，請(qǐng)把它分享出去讓更多的人看到。