微信支付.NET版开发总结(JS API)，好多坑，适当精简

前2天，做一个手机网页的微信支付的项目，费了好些周折，记录一下。接下来，按照开发步骤，细数一下，我遇到的那些坑。

【坑1】官方邮件中下载的demo只有PHP版本，其他版本没有给链接。可能让人误以为只有PHP版本，事实上，各种版本都有。

拿到了腾讯发给客户的，微信支付商户资料，邮件中提示：证书的详细使用方案，请查看微信支付开发接口文档。根据邮件微信支付开发接口文档的链接,定向到一个新的邮件附件，里面的内容：

　　3. 使用公众号发起支付请求

　　使用JS API在微信的网页中发起支付请求，详细方法见文档中有关JS API的章节。
　　微信支付接口文档及demo（公众账号）.zip点击下载

微信支付接口文档及demo（公众账号）.zip，下载以后包含

　　【微信支付】微信公众号支付接口文档V3.3.7

　　公众账号支付DEMO，只有PHP版。

之前看到别人说，为什么现在很多微信公众平台项目都用PHP开发，因为腾讯官方的Demo很多只给了PHP版本，心里暗骂，怎么微信支付这么重要的东西也只给PHP版，哎，先把PHP版本跑通吧。于是在本地配置PHP环境，修改给的demo的配置参数。运行demo，看到请在微信客户端中打开链接的提示，于是把它部署到朋友服务器，在微信中去测试，结果，报一个json扩展方法不支持，于是去搜索，怎么配置这个扩展方法。到晚上12点了，睡觉了，没搞好。临睡前想的是，PHP版本就算支付走通了，更新订单状态的代码也不好搞呀，逻辑比较复杂，用PHP再写一遍很烦人，我PHP基本不会。

这里走弯路了，其实是有.net版本的demo的，无意间在公众平台的后台点击链接看到了商户平台开发者文档，大喜过望，SDK下载->Demo下载，JAVA，.NET C#,PHP,IOS,Android都有。幸福的下载.NET版。

.NET版本Demo第一处修改：default.aspx页面里面的链接路径，居然都指向到paysdk.weixin.qq.com,改成自己的路径后，还是运行报错，因为下面的坑：

【坑2】代理服务器设置，注释就可以了，lib\HttpService.cs中get和post方法里。

　　　　　　　　　//下面设置HttpWebRequest的相关属性
                request = (HttpWebRequest)WebRequest.Create(url);

                request.Method = "POST";
                request.Timeout = timeout * +;//默认传过来是6秒，手动加了一分钟

                //设置代理服务器
                //WebProxy proxy = new WebProxy();                          //定义一个网关对象
                //proxy.Address = new Uri(WxPayConfig.PROXY_URL);              //网关服务器端口:端口
                //request.Proxy = proxy;

【坑3】redirect_url参数错误，网页授权->网页账号,填写域名。

因为我选择的的“JS API”支付，这种支付需要网页授权，先获取code，再拿code去获取openid和prepay_id。这个网页授权需要登录微信公众平台。点击左侧菜单“开发者中心”，在右侧“权限列表”中找到“网页账号”，点击最右侧的修改，把测试的域名写进去，注意不要加http。经过测试发现，域名必须完全匹配，设置顶级域名domain.com，程序是pay.domain.com的二级域名都不行。

微信公众平台登陆还要微信管理员在个人微信号上授权，要等客户公司员工上班了，才授权，增加了解决问题等待的时间。

【坑4】 数据类型要和接口文档要求的完全一致。报错:ERROR 下单失败，WxPayData字段数据类型错误

项目中的订单编号是long类型，微信接口规范是string类型，报了上面的错误，改为string类型就好了。这个属于需要注意的，严格来说，不能算坑

趟过上面的几个坑，终于支付成功了。接下来，要去完成更新订单的逻辑。

ResultNotify页面更新订单的逻辑并没有按照预料的走，查看IIS的日志，微信有发请求到ResultNotify页面，状态是500内部服务器错误。网站程序的Log中并没有记录到，一步一步用Log.Debug，记录程序走的情况，发现微信订单号应该成功获取到了，并且验证签名成功，返回的XML也正常。

INFO WxPayAPI.ResultNotify: Check sign success

DEBUG WxPayApi: OrderQuery response : <xml><return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<total_fee>10</total_fee>
...

于是，在关键代码处，添加了try catch，这一步早就应该做，就不用一步一步的试错了，走弯路了，异步通知页面的找出错误很麻烦，要支付一次，看响应的结果。接下来，有依次经历了以下几个异常。

【坑5】ERROR WxPayAPI.ResultNotify: 更新订单的时候发生异常:该字符串未被识别为有效的 DateTime

<time_end><![CDATA[20150803230817]]></time_end>

这一步，我直接写DateTime.Parse转换的，抛异常，后来改写为DateTime.ParseExact方法，解决问题，注意format是yyyyMMddHHmmss，不明白为什么HH也要大写，不然也报错。

DateTime payDate = notifyData.IsSet("time_end") ? DateTime.ParseExact(notifyData.GetValue("time_end").ToString(), "yyyyMMddHHmmss", System.Globalization.CultureInfo.CurrentCulture) : DateTime.MinValue;

改了以后，抛出的异常是 更新订单的时候发生异常:正在中止线程在 System.Threading.Thread.AbortInternal()，这个百思不得琪姐。百度搜索一般是Response.Redirect和Server.Transfer导致线程终止，也没找到类似的问题。一行一行过代码发现以下Bug.

【坑6】微信支付的单位是分，一般网站单位是元。而且微信的total_fee不能接收小数点,不能是0.1分钱。

我的更新订单程序有一行if (orderAmount == payAmount){}一个是微信获取到的单位是分，一个是网站的，单位是元，这个坑也浪费了好久时间，一行一行过代码才发现，因为是逻辑错误。幸好有这个判断，否则钱相差100倍，天大的BUG。

这个BUG改好以后，订单状态被成功的更新了。

微信做的比较人性化的是，设置测试目录以及微信号白名单，测试期间，只有白名单中的微信号才能支付。部署到demo.domain.com给客户测试，测试没有问题后，部署到m.domain.com的时候，居然又报redirect_url参数错误，看到微信提示说，测试目录不能喝正式目录意义，否则会支付失败，我测试目录是http://demo.domain.com/wxpay/,正式目录是http://m.domain.com/wxpay/，难道wxpay的文件夹名称也不能一样？没道理呀，把测试目录改成其他的，还是不对。搜索了一下，恍然大悟，是【坑3】导致的。之前把网页账号的域名改为demo.domain.com了，改为m.domain.com，成功支付。注意：域名要完全匹配，程序在m.domain.com,网页账号设置domain.com一样报redirect_url参数错误。

至此，微信支付JS API调用整个流程完成，相对于支付宝Wap支付来说，花的时间更多。

总结：

1.对于第一个坑，是否有.net版，一般各种版本都会有，如果没有及时的发现.net版，用PHP去开发，那对于我来说，工作量就更大了。应该仔细的看官方各种帮助文档，也许它藏的比较深。

其实支付接口的主要逻辑，官方都做好了，重点是配置。

这里不得不说，腾讯随邮件发送的Demo下载包含各种版本网页路径，不是更好吗？

2.仔细看接口文档，先过一遍程序，自己去找潜在的问题，有利于提升分析问题的能力，如果时间紧急，请看3。

3.如果自己确定应该没有什么问题了，而没有预期工作，那么要去找出问题。

3.1 判断是不是微信端的error，在关键位置加日志，微信的demo中，可以设置输入Log的级别，测试的时候输出debug,Info,error,正式环境可以设置只输出error，这一点很赞。

3.2 自己代码的BUG: 整段代码加try...catch，把异常信息保存到日志中去,这样能快速的找出问题。try catch不用多说了，标配。

3.3 异常容易捕获，如果是逻辑错误，需要细心的过代码。

主要精简:

官方demo，先跳转到example/ProductPage.aspx，这个页面主要是调用【网页授权获取用户信息】接口获取用户的openid，点击按钮的时候，跳转到JsApiPayPage.aspx页面，传递openid和total_fee支付金额过去，其中用ViewState保存openid是个槽点，web app尽量不要用ViewState和服务器控件，它们会生成臃肿的HTML，增加网络流量，影响加载速度，你要知道，手机如果是在GSM网络下访问站点，多一些文本都是压力，尽可能精简。

直接把获取openid的逻辑写到JsApiPayPage页面就好了，省的多跳转一个页面，后台代码是要验证授权，然后获取到前台JS API调用需要的参数wxJsApiParam。

public partial class JsApiPayPage : BaseOnlineSend
    {
        public static string wxJsApiParam {get;set;} //H5调起JS API参数
        protected void Page_Load(object sender, EventArgs e)
        {
            Log.Info(this.GetType().ToString(), "page load");
            if (!IsPostBack)
            {
                JsApiPay jsApiPay = new JsApiPay(this);
                jsApiPay.GetOpenidAndAccessToken();

                string openid = jsApiPay.openid; ;

                OrderDetail = this.Detail;
                //付款金额
                decimal total_fee = OrderDetail.TotalOrderAmount + OrderDetail.TotalLogisticsFee + OrderDetail.OrderAmountRevise + OrderDetail.LogisticsFeeRevise;
                //检测是否给当前页面传递了相关参数
                if (string.IsNullOrEmpty(openid) || total_fee <= )
                {
                    Log.Error(this.GetType().ToString(), "This page have not get params, cannot be inited, exit...");
                    return;
                }

                //若传递了相关参数，则调统一下单接口，获得后续相关接口的入口参数
                jsApiPay.total_fee = (int)(total_fee * );//单位是分，不能有小数
                jsApiPay.orderId = this.OrderID.ToString();
                jsApiPay.siteName = this.GetConfig("SiteName");

                //JSAPI支付预处理
                try
                {
                    WxPayData unifiedOrderResult = jsApiPay.GetUnifiedOrderResult();

                    wxJsApiParam = jsApiPay.GetJsApiParameters();//获取H5调起JS API参数
                    Log.Debug(this.GetType().ToString(), "wxJsApiParam : " + wxJsApiParam);

                }
                catch(Exception ex)
                {
                    Response.Write("<span style='color:#FF0000;font-size:20px'>" + "下单失败，请返回重试" + "</span>");
                    Log.Error(this.GetType().ToString(), "下单失败，" + ex.Message +";" +ex.StackTrace);
                }
            }
        }

其中，主要需要注意的是jsApiPay.total_fee，单位是分，要和自己项目的单位进行换算一些，否则会出错。

前台，页面加载之后，直接调用微信JS api 支付，支付完成后，直接在本页面显示支付结果。如果支付失败，让人家可以点击按钮尝试重新支付。

    <script type="text/javascript">

               //调用微信JS api 支付
               function jsApiCall()
               {
                   WeixinJSBridge.invoke(
                   'getBrandWCPayRequest',
                   <%=wxJsApiParam%>,//josn串
                    function (res)
                    {
                        WeixinJSBridge.log(res.err_msg);
                        if(res.err_msg == "get_brand_wcpay_request:ok" ) {
                            document.getElementById("payFail").style.display="none";
                            document.getElementById("paySuccess").style.display="block";
                        }
                        else{
                            document.getElementById("payFail").style.display="block";
                        }
                     }
                    );
               }

               function callpay()
               {
                   //官方代码，不贴了
               }
               callpay();
     </script>

<body>
    <dl class="item_desc" id="dlPayInfo">
        <dt class="item_title"><span class="txt">支付信息</span></dt>
        <dd class="item_panel pl1">
            <span class="title"><%=this.OrderDetail.ProductNames %></span>
        </dd>
        <dd class="item_panel pl1">
            <span class="title">订单号：</span><span class="selected com_c4"><%=this.OrderID %></span>
        </dd>
        <dd class="item_select item_last">
            <div class="title">
                <strong>应付金额： </strong><span class="com_c4"><%=OrderDetail.TotalOrderAmount + OrderDetail.TotalLogisticsFee + OrderDetail.OrderAmountRevise + OrderDetail.LogisticsFeeRevise %> 元</span>
            </div>
        </dd>
    </dl>
    <br />
    <dd class="item_select" id="paySuccess" style="display:none">
        <div class="title" style="padding-left:3rem">
            <img src="/images/onSuccess.gif" title="支付成功" />
            <span class="selected"><b class="big">支付成功!</b><br />
                系统正在处理收款，订单状态可能会有1-5分钟的滞后，感谢您的耐心等待。<br />
                <a href="/member/order/info1/">查看订单</a><br /><br />
                您还可以：<a href="/">继续购物</a><br /><br />
                <br /><br />
            </span>
        </div>
    </dd>
    <dd class="item_select"id="payFail" style="display:none">
        <div class="title item" style="padding-left:2.0rem">
            <span class="selected"><b class="big">支付失败!</b></span>
            <div class="btns" style="margin-top:10px"><a class="com_btn_7" style="padding:1px;cursor:pointer;" onclick="callpay()">重新支付</a></div>
        </div>
        <div class="title item" style="padding-left:2.0rem">
            <span class="selected">
                您可以查看微信交易记录。如果没有扣费，可以稍后尝试重新支付。如果已经扣费，请拨打客服电话联系我们
                <br /><br />
                如果多次重新支付还是遇到了问题，稍后您可以在登陆状态下，访问个人中心-><a href="/member/order/">我的订单</a>，为编号为<%=this.OrderID %>的订单付款，有多种支付方式供您选择
                ...
            </span>
        </div>
    </dd>
</body>