基于H5的微信支付开发详解

这次总结一下用户在微信内打开网页时，可以调用微信支 付完成下单功能的模块开发，也就是在微信内的H5页面通过jsApi接口实现支付功能。当然了，微信官网上的微信支付开发文档也讲解的很详细，并且有实现 代码可供参考，有的朋友直接看文档就可以自己实现此支付接口的开发了。

一、前言

为何我还写一篇微信支付接口的博文呢？第一，我们 必须知道，所谓的工作经验很多都是靠总结出来的，你只有总结了更多知识，积累了更多经验，你才能在该行业中脱颖而出，我个人觉得如今的招聘，很多都需要工 作经验（1年、3年、5年....），其实，工作时间的长久不能衡量一个人技术水平的高低，有的人一年的工作经验能拿3年工作经验的程序猿的工资，有的3 年工作经验的却有可能比别人只有一年工作经验的还低，所以说，总结才能让自己的知识体系，经验深度更牛逼更稳固（虽然写一篇博文挺花费时间的）；第二，写 博文分享给大家还是挺有成就感的，首先是能让新手从我分享的博文中能学到东西，并且能快速将博文所讲解的技术运用到实际中来，所以我写的博文基本上能让新 人快速读懂并且容易理解，另外，技术大神的话，看到博文有讲解的不对之处，还可以指出，并且可以交流，何乐而不为呢，我们需要的就是分享和交流。

扯远了，直接进入该主题的详解。

现在的微信支付方式有N种，看下图，有刷卡支付、 公众号支付、扫码支付和APP支付，另外还有支付工具的开发，本博文选择的是公众号支付借口而开发进行讲解，其他几种支付接口开发基本上思路都是一样的， 只要你能看懂我这博文所讲解的基本思路，你基本上也能独自开发其他几个支付接口。

二、思路详解

我们可以拿微信支付接口文档里的业务流程时序图看 看，如下图，基本思路是这样子：首先在后台生成一个链接，展示给用户让用户点击（例如页面上有微信支付的按钮），用户点击按钮后，网站后台会根据订单的相 关信息生成一个支付订单，此时会调用统一下单接口，对微信支付系统发起请求，而微信支付系统受到请求后，会根据请求过来的数据，生成一个 预支付交易会话标识（prepay_id，就是通过这个来识别该订单的），我们的网站收到微信支付系统的响应后，会得到prepay_id，然后通过自己 构造微信支付所需要的参数，接着将支付所需参数返回给客户端，用户此时可能会有一个订单信息页，会有一个按钮，点击支付，此时会调用JSAPI接口对微信 支付系统发起 请求支付，微信支付系统检查了请求的相关合法性之后，就会提示输入密码，用户此时输入密码确认，微信支付系统会对其进行验证，通过的话会返回支付结果，然 后微信跳转会H5页面，这其中有一步是异步通知网站支付结果，我们网站需要对此进行处理（比如说异步支付结果通过后，需要更新数据表或者订单信息，例如标 志用户已支付该订单了，同时也需要更新订单日志，防止用户重复提交订单）。

三、代码讲解

本次开发环境用的是php5.6 + MySQL + Redis + Linux + Apache，所选用的框架的CI框架（这些环境不一定需要和我的一致，框架也可以自己选择，反正自己稍微修改下代码就能移植过去了）。

微信支付接口的开发代码我已经提前写好了，在这里我对其进行分析讲解，方便大家能轻松理解，当然，假如你有一定的基础，直接看代码就能理清所有流程了，并且我的代码基本上都写上了注释（对于新手来说，这一点比微信文档所提供的代码好一点）。

1、构造一个链接展示给用户

这里我们提前需要知道一个点，那就是请求统一下单接口需要微信用户的openid（详情可看这https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1），而获取openid需要先获取code（详情可看这微信登录接口），所以我们需要构造一个获取code的URL：

1. Wxpay.php文件：
2. <?php
3. defined('BASEPATH')ORexit('NodirectscriptAccessallowed');
5. classWxpayextendsMY_Controller{
6. publicfunction__construct(){
7. parent::__construct();
8. $this->load->model('wxpay_model');
9. //$this->load->model('wxpay
11. }
13. publicfunctionindex(){
14. //微信支付
15. $this->smarty['wxPayUrl']=$this->wxpay_model->retWxPayUrl();
16. $this->displayView('wxpay/index.tpl');
17. }
18. }

在这先看看model里所写的几个类：model里有几个类：微信支付类、统一下单接口类、响应型接口基类、请求型接口基类、所有接口基类、配置类。为何要分那么多类而不在一个类里实现所有的方法的，因为，这样看起来代码逻辑清晰，哪个类该干嘛就干嘛。

这里我直接附上model的代码了,里面基本上每一个类每一个方法甚至每一行代码都会有解释的了，这里我就不对其展开一句句分析了：

1. <?php
2. defined('BASEPATH')ORexit('Nodirectscriptaccessallowed');
4. classWxpay_modelextendsCI_Model{
5. publicfunction__construct(){
6. parent::__construct();
7. }
9. /**
10. *返回可以获得微信code的URL（用以获取openid）
11. *@return[type][description]
12. */
13. publicfunctionretWxPayUrl(){
14. $jsApi=newJsApi_handle();
15. return$jsApi->createOauthUrlForCode();
16. }
18. /**
19. *微信jsapi点击支付
20. *@param[type]$data[description]
21. *@return[type][description]
22. */
23. publicfunctionwxPayJsApi($data){
24. $jsApi=newJsApi_handle();
25. //统一下单接口所需数据
26. $payData=$this->returnData($data);
27. //获取code码，用以获取openid
28. $code=$_GET['code'];
29. $jsApi->setCode($code);
30. //通过code获取openid
31. $openid=$jsApi->getOpenId();
33. $unifiedOrderResult=null;
34. if($openid!=null){
35. //取得统一下单接口返回的数据
36. $unifiedOrderResult=$this->getResult($payData,'JSAPI',$openid);
37. //获取订单接口状态
38. $returnMessage=$this->returnMessage($unifiedOrder,'prepay_id');
39. if($returnMessage['resultCode']){
40. $jsApi->setPrepayId($retuenMessage['resultField']);
41. //取得wxjsapi接口所需要的数据
42. $returnMessage['resultData']=$jsApi->getParams();
43. }
45. return$returnMessage;
46. }
47. }
49. /**
50. *统一下单接口所需要的数据
51. *@param[type]$data[description]
52. *@return[type][description]
53. */
54. publicfunctionreturnData($data){
55. $payData['sn']=$data['sn'];
56. $payData['body']=$data['goods_name'];
57. $payData['out_trade_no']=$data['order_no'];
58. $payData['total_fee']=$data['fee'];
59. $payData['attach']=$data['attach'];
61. return$payData;
62. }
64. /**
65. *返回统一下单接口结果（参考https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1）
66. *@param[type]$payData[description]
67. *@param[type]$trade_type[description]
68. *@param[type]$openid[description]
69. *@return[type][description]
70. */
71. publicfunctiongetResult($payData,$trade_type,$openid=null){
72. $unifiedOrder=newUnifiedOrder_handle();
74. if($opneid!=null){
75. $unifiedOrder->setParam('openid',$openid);
76. }
77. $unifiedOrder->setParam('body',$payData['body']);//商品描述
78. $unifiedOrder->setParam('out_trade_no',$payData['out_trade_no']);//商户订单号
79. $unifiedOrder->setParam('total_fee',$payData['total_fee']);//总金额
80. $unifiedOrder->setParam('attach',$payData['attach']);//附加数据
81. $unifiedOrder->setParam('notify_url',base_url('/Wxpay/pay_callback'));//通知地址
82. $unifiedOrder->setParam('trade_type',$trade_type);//交易类型
84. //非必填参数，商户可根据实际情况选填
85. //$unifiedOrder->setParam("sub_mch_id","XXXX");//子商户号
86. //$unifiedOrder->setParam("device_info","XXXX");//设备号
87. //$unifiedOrder->setParam("time_start","XXXX");//交易起始时间
88. //$unifiedOrder->setParam("time_expire","XXXX");//交易结束时间
89. //$unifiedOrder->setParam("goods_tag","XXXX");//商品标记
90. //$unifiedOrder->setParam("product_id","XXXX");//商品ID
92. return$unifiedOrder->getResult();
93. }
95. /**
96. *返回微信订单状态
97. */
98. publicfunctionreturnMessage($unifiedOrderResult,$field){
99. $arrMessage=array("resultCode"=>0,"resultType"=>"获取错误","resultMsg"=>"该字段为空");
100. if($unifiedOrderResult==null){
101. $arrMessage["resultType"]="未获取权限";
102. $arrMessage["resultMsg"]="请重新打开页面";
103. }elseif($unifiedOrderResult["return_code"]=="FAIL")
104. {
105. $arrMessage["resultType"]="网络错误";
106. $arrMessage["resultMsg"]=$unifiedOrderResult['return_msg'];
107. }
108. elseif($unifiedOrderResult["result_code"]=="FAIL")
109. {
110. $arrMessage["resultType"]="订单错误";
111. $arrMessage["resultMsg"]=$unifiedOrderResult['err_code_des'];
112. }
113. elseif($unifiedOrderResult[$field]!=NULL)
114. {
115. $arrMessage["resultCode"]=1;
116. $arrMessage["resultType"]="生成订单";
117. $arrMessage["resultMsg"]="OK";
118. $arrMessage["resultField"]=$unifiedOrderResult[$field];
119. }
120. return$arrMessage;
121. }
123. /**
124. *微信回调接口返回验证签名并回应微信
125. *@param[type]$xml[description]
126. *@return[type][description]
127. */
128. publicfunctionwxPayNotify($xml){
129. $notify=newWxpay_server();
130. $notify->saveData($xml);
131. //验证签名，并回复微信
132. //对后台通知交互时，如果微信收到商户的应答不是成功或者超时，微信认为通知失败
133. //微信会通过一定的策略（如30分钟共8次），定期重新发起通知
134. if($notify->checkSign()==false){
135. $notify->setReturnParameter("return_code","FAIL");//返回状态码
136. $notify->setReturnParameter("return_msg","签名失败");//返回信息
137. }else{
138. $notify->checkSign=TRUE;
139. $notify->setReturnParameter("return_code","SUCCESS");//设置返回码
140. }
142. return$notify;
143. }
144. }
146. /**
147. *JSAPI支付——H5网页端调起支付接口
148. */
149. classJsApi_handleextendsJsApi_common{
150. public$code;//code码，用以获取openid
151. public$openid;//用户的openid
152. public$parameters;//jsapi参数，格式为json
153. public$prepay_id;//使用统一支付接口得到的预支付id
154. public$curl_timeout;//curl超时时间
156. function__construct()
157. {
158. //设置curl超时时间
159. $this->curl_timeout=WxPayConf::CURL_TIMEOUT;
160. }
162. /**
163. *生成获取code的URL
164. *@return[type][description]
165. */
166. publicfunctioncreateOauthUrlForCode(){
167. //重定向URL
168. $redirectUrl="http://www.itcen.cn/wxpay/confirm/".$orderId."?showwxpaytitle=1";
169. $urlParams['appid']=WxPayConf::APPID;
170. $urlParams['redirect_uri']=$redirectUrl;
171. $urlParams['response_type']='code';
172. $urlParams['scope']='snsapi_base';
173. $urlParams['state']="STATE"."#wechat_redirect";
174. //拼接字符串
175. $queryString=$this->ToUrlParams($urlParams,false);
176. return"https://open.weixin.qq.com/connect/oauth2/authorize?".$queryString;
177. }
179. /**
180. *设置code
181. *@param[type]$code[description]
182. */
183. publicfunctionsetCode($code){
184. $this->code=$code;
185. }
187. /**
188. *作用：设置prepay_id
189. */
190. publicfunctionsetPrepayId($prepayId)
191. {
192. $this->prepay_id=$prepayId;
193. }
195. /**
196. *作用：获取jsapi的参数
197. */
198. publicfunctiongetParams()
199. {
200. $jsApiObj["appId"]=WxPayConf::APPID;
201. $timeStamp=time();
202. $jsApiObj["timeStamp"]="$timeStamp";
203. $jsApiObj["nonceStr"]=$this->createNoncestr();
204. $jsApiObj["package"]="prepay_id=$this->prepay_id";
205. $jsApiObj["signType"]="MD5";
206. $jsApiObj["paySign"]=$this->getSign($jsApiObj);
207. $this->parameters=json_encode($jsApiObj);
209. return$this->parameters;
210. }
212. /**
213. *通过curl向微信提交code用以获取openid
214. *@return[type][description]
215. */
216. publicfunctiongetOpenId(){
217. //创建openid的链接
218. $url=$this->createOauthUrlForOpenid();
219. //初始化
220. $ch=curl_init();
221. curl_setopt($ch,CURL_TIMEOUT,$this->curl_timeout);
222. curl_setopt($ch,CURL_URL,$url);
223. curl_setopt($ch,CURL_SSL_VERIFYPEER,FALSE);
224. curl_setopt($ch,CURL_SSL_VERIFYHOST,FALSE);
225. curl_setopt($ch,CURL_HEADER,FALSE);
226. curl_setopt($ch,CURL_RETURNTRANSFER,TRUE);
227. //执行curl
228. $res=curl_exec($ch);
229. curl_close($ch);
230. //取出openid
231. $data=json_decode($res);
232. if(isset($data['openid'])){
233. $this->openid=$data['openid'];
234. }else{
235. returnnull;
236. }
238. return$this->openid;
240. }
242. /**
243. *生成可以获取openid的URL
244. *@return[type][description]
245. */
246. publicfunctioncreateOauthUrlForOpenid(){
247. $urlParams['appid']=WxPayConf::APPID;
248. $urlParams['secret']=WxPayConf::APPSECRET;
249. $urlParams['code']=$this->code;
250. $urlParams['grant_type']="authorization_code";
251. $queryString=$this->ToUrlParams($urlParams,false);
252. return"https://api.weixin.qq.com/sns/oauth2/access_token?".$queryString;
253. }
254. }
256. /**
257. *统一下单接口类
258. */
259. classUnifiedOrder_handleextendsWxpay_client_handle{
260. publicfunction__construct(){
261. //设置接口链接
262. $this->url="https://api.mch.weixin.qq.com/pay/unifiedorder";
263. //设置curl超时时间
264. $this->curl_timeout=WxPayConf::CURL_TIMEOUT;
265. }
267. }
269. /**
270. *响应型接口基类
271. */
272. classWxpay_server_handleextendsJsApi_common{
273. public$data;//接收到的数据，类型为关联数组
274. public$returnParams;//返回参数，类型为关联数组
276. /**
277. *将微信请求的xml转换成关联数组
278. *@param[type]$xml[description]
279. *@return[type][description]
280. */
281. publicfunctionsaveData($xml){
282. $this->data=$this->xmlToArray($xml);
283. }
286. /**
287. *验证签名
288. *@return[type][description]
289. */
290. publicfunctioncheckSign(){
291. $tmpData=$this->data;
292. unset($temData['sign']);
293. $sign=$this->getSign($tmpData);
294. if($this->data['sign']==$sign){
295. returntrue;
296. }
297. returnfalse;
298. }
301. /**
302. *设置返回微信的xml数据
303. */
304. functionsetReturnParameter($parameter,$parameterValue)
305. {
306. $this->returnParameters[$this->trimString($parameter)]=$this->trimString($parameterValue);
307. }
309. /**
310. *将xml数据返回微信
311. */
312. functionreturnXml()
313. {
314. $returnXml=$this->createXml();
315. return$returnXml;
316. }
318. }
320. /**
321. *请求型接口的基类
322. */
323. classWxpay_client_handleextendsJsApi_common{
324. public$params;//请求参数，类型为关联数组
325. public$response;//微信返回的响应
326. public$result;//返回参数，类型类关联数组
327. public$url;//接口链接
328. public$curl_timeout;//curl超时时间
330. /**
331. *设置请求参数
332. *@param[type]$param[description]
333. *@param[type]$paramValue[description]
334. */
335. publicfunctionsetParam($param,$paramValue){
336. $this->params[$this->tirmString($param)]=$this->trimString($paramValue);
337. }
339. /**
340. *获取结果，默认不使用证书
341. *@return[type][description]
342. */
343. publicfunctiongetResult(){
344. $this->postxml();
345. $this->result=$this->xmlToArray($this->response);
347. return$this->result;
348. }
350. /**
351. *post请求xml
352. *@return[type][description]
353. */
354. publicfunctionpostxml(){
355. $xml=$this->createXml();
356. $this->response=$this->postXmlCurl($xml,$this->curl,$this->curl_timeout);
358. return$this->response;
359. }
361. publicfunctioncreateXml(){
362. $this->params['appid']=WxPayConf::APPID;//公众号ID
363. $this->params['mch_id']=WxPayConf::MCHID;//商户号
364. $this->params['nonce_str']=$this->createNoncestr();//随机字符串
365. $this->params['sign']=$this->getSign($this->params);//签名
367. return$this->arrayToXml($this->params);
368. }
372. }
374. /**
375. *所有接口的基类
376. */
377. classJsApi_common{
378. function__construct(){
380. }
382. publicfunctiontrimString($value){
383. $ret=null;
384. if(null!=$value){
385. $ret=trim($value);
386. if(strlen($ret)==0){
387. $ret=null;
388. }
389. }
390. return$ret;
391. }
393. /**
394. *产生随机字符串，不长于32位
395. *@paraminteger$length[description]
396. *@return[type][description]
397. */
398. publicfunctioncreateNoncestr($length=32){
399. $chars="abcdefghijklmnopqrstuvwxyz0123456789";
400. $str='';
401. for($i=0;$i<$length;$i++){
402. $str.=substr($chars,mt_rand(0,strlen($chars)-1),1);
403. }
405. return$str;
406. }
408. /**
409. *格式化参数拼接字符串，签名过程需要使用
410. *@param[type]$urlParams[description]
411. *@param[type]$needUrlencode[description]
412. */
413. publicfunctionToUrlParams($urlParams,$needUrlencode){
414. $buff="";
415. ksort($urlParams);
417. foreach($urlParamsas$k=>$v){
418. if($needUrlencode)$v=urlencode($v);
419. $buff.=$k.'='.$v.'&';
420. }
422. $reqString='';
423. if(strlen($buff)>0){
424. $reqString=substr($buff,0,strlen($buff)-1);
425. }
427. return$reqString;
428. }
430. /**
431. *生成签名
432. *@param[type]$params[description]
433. *@return[type][description]
434. */
435. publicfunctiongetSign($obj){
436. foreach($objas$k=>$v){
437. $params[$k]=$v;
438. }
439. //签名步骤一：按字典序排序参数
440. ksort($params);
441. $str=$this->ToUrlParams($params,false);
442. //签名步骤二：在$str后加入key
443. $str=$str."$key=".WxPayConf::KEY;
444. //签名步骤三：md5加密
445. $str=md5($str);
446. //签名步骤四：所有字符转为大写
447. $result=strtoupper($str);
449. return$result;
450. }
452. /**
453. *array转xml
454. *@param[type]$arr[description]
455. *@return[type][description]
456. */
457. publicfunctionarrayToXml($arr){
458. $xml="<xml>";
459. foreach($arras$k=>$v){
460. if(is_numeric($val)){
461. $xml.="<".$key.">".$key."</".$key.">";
462. }else{
463. $xml.="<".$key."><![CDATA[".$val."]]></".$key.">";
464. }
465. }
466. $xml.="</xml>";
467. return$xml;
468. }
470. /**
471. *将xml转为array
472. *@param[type]$xml[description]
473. *@return[type][description]
474. */
475. publicfunctionxmlToArray($xml){
476. $arr=json_decode(json_encode(simplexml_load_string($xml,'SinpleXMLElement',LIBXML_NOCDATA)),true);
478. return$arr;
479. }
481. /**
482. *以post方式提交xml到对应的接口
483. *@param[type]$xml[description]
484. *@param[type]$url[description]
485. *@paraminteger$second[description]
486. *@return[type][description]
487. */
488. publicfunctionpostXmlCurl($xml,$url,$second=30){
489. //初始化curl
490. $ch=curl_init();
491. //设置超时
492. curl_setopt($ch,CURL_TIMEOUT,$second);
493. curl_setopt($ch,CURL_URL,$url);
494. //这里设置代理，如果有的话
495. //curl_setopt($ch,CURLOPT_PROXY,'8.8.8.8
496. //curl_setopt($ch,CURLOPT_PROXYPORT,8080);
497. curl_setopt($ch,CURL_SSL_VERIFYHOST,FALSE);
498. curl_setopt($ch,CURL_SSL_VERIFYPEER,FALSE);
499. //设置header
500. curl_setopt($ch,CURL_HEADER,FALSE);
501. //要求结果为字符串且输出到屏幕上
502. curl_setopt($ch,CURL_RETURNTRANSFER,TRUE);
503. //以post方式提交
504. curl_setopt($ch,CURL_POST,TRUE);
505. curl_setopt($ch,CURL_POSTFIELDS,$xml);
506. //执行curl
507. $res=curl_exec($ch);
509. if($res){
510. curl_close($ch);
511. return$res;
512. }else{
513. $error=curl_errno($ch);
514. echo"curl出错，错误码:$error"."<br>";
515. echo"<ahref='http://curl.haxx.se/libcurl/c/libcurl-errors.html'>错误原因查询</a></br>";
516. curl_close($ch);
517. returnfalse;
518. }
519. }
520. }
522. /**
523. *配置类
524. */
525. classWxPayConf{
526. //微信公众号身份的唯一标识。
527. constAPPID='wx654a22c6423213b7';
528. //受理商ID，身份标识
529. constMCHID='10043241';
530. constMCHNAME='KellyCen的博客';
532. //商户支付密钥Key。
533. constKEY='0000000000000000000000000000000';
534. //JSAPI接口中获取openid
535. constAPPSECRET='000000000000000000000000000';
537. //证书路径,注意应该填写绝对路径
538. constSSLCERT_PATH='/home/WxPayCacert/apiclient_cert.pem';
539. constSSLKEY_PATH='/home/WxPayCacert/apiclient_key.pem';
540. constSSLCA_PATH='/home/WxPayCacert/rootca.pem';
542. //本例程通过curl使用HTTPPOST方法，此处可修改其超时时间，默认为30秒
543. constCURL_TIMEOUT=30;
544. }
546. Wxpay_model.php

获取到code的URL后，将其分配到页面去，让用户去点击，用户进行点击后，就会从微信服务器获取到code，然后回调到redirect_uri所指的地址去。