前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 * 1000+60000;//默认传过来是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 <= 0) { Log.Error(this.GetType().ToString(), "This page have not get params, cannot be inited, exit..."); return; } //若传递了相关参数,则调统一下单接口,获得后续相关接口的入口参数 jsApiPay.total_fee = (int)(total_fee * 100);//单位是分,不能有小数 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>