支付宝：web页面扫码支付、网站支付、支付宝即时到账 + springmvc

绝地灬酷狼 2022-06-08 10:15 569阅读 0赞

## 一、场景：公司需要在网站上进行支付宝支付。   二、API：使用支付宝开放平台的支付能力-即时到账接口。[支付宝开放平台链接   ][Link 1]三、分析： ##

1、支付宝的文档比较容易看，主要是有相应的DEMO，我这里看的DEMO是 JAVA-UTF-8版本。

![Center][]

2、导入DEMO，在com.alipay.config中填入对应的partner和key（在对应的商户后台获取）就可以直接运行了解支付流程了。

![Center 1][]

3、改写：我这边使用的是springmvc+mybatis。商品发起购买（走支付宝支付）、跳转到支付宝、支付宝回调支付状态。

## 四、实现： ##

1、商品发起购买请求（将DEMO中的页面直接拿过来用了）。

**\[javascript\]**  [view plain][]   [copy][view plain]

1.  <body>  
2.      <div **class**="header">  
3.          <div **class**="container black">  
4.              <div **class**="qrcode">  
5.                  <div **class**="littlecode">  
6.                      <img width="16px" src="img/little\_qrcode.jpg" id="licode">  
7.                      <div **class**="showqrs" id="showqrs">  
8.                          <div **class**="shtoparrow"></div>  
9.                          <div **class**="guanzhuqr">  
10.                             <img src="img/guanzhu\_qrcode.png" width="80">  
11.                             <div **class**="shmsg" style="margin-top:5px;">  
12.                             请扫码关注  
13.                             </div>  
14.                             <div **class**="shmsg" style="margin-bottom:5px;">  
15.                                 接收重要信息  
16.                             </div>  
17.                         </div>  
18.                     </div>  
19.                 </div>        
20.             </div>  
21.         </div>  
22.         <div **class**="container">  
23.             <div **class**="nav">  
24.                 <a href="https://www.alipay.com/" **class**="logo"><img src="img/alipay\_logo.png" height="30px"></a>  
25.                 <span **class**="divier"></span>  
26.                 <a href="http://open.alipay.com/platform/home.htm" **class**="open" target="\_blank">开放平台</a>  
27.                 <ul **class**="navbar">  
28.                     <li><a href="https://doc.open.alipay.com/doc2/detail?treeId=62&articleId=103566&docType=1" target="\_blank">在线文档</a></li>  
29.                     <li><a href="https://cschannel.alipay.com/portal.htm?sourceId=213" target="\_blank">技术支持</a></li>  
30.                 </ul>  
31.             </div>  
32.         </div>  
33.         <div **class**="container blue">  
34.             <div **class**="title">支付宝即时到账(create\_direct\_pay\_by\_user)</div>  
35.         </div>  
36.     </div>  
37.     <div **class**="content">  
38.         <%-- <form action="$\{ctx\}/aliPay/open" **class**="alipayform" method="POST" target="\_blank"> --%>  
39.             <div **class**="element" style="margin-top:60px;">  
40.                 <div **class**="legend">支付宝即时到账交易接口快速通道 </div>  
41.             </div>  
42.             <div **class**="element">  
43.                 <div **class**="etitle">商户订单号:</div>  
44.                 <div **class**="einput"><input type="text" name="WIDout\_trade\_no" id="out\_trade\_no"></div>  
45.                 <br>  
46.                 <div **class**="mark">注意：商户订单号(out\_trade\_no).必填(建议是英文字母和数字,不能含有特殊字符)</div>  
47.             </div>  
48.               
49.             <div **class**="element">  
50.                 <div **class**="etitle">商品名称:</div>  
51.                 <div **class**="einput"><input type="text" name="WIDsubject" id="WIDsubject" value="test商品123"></div>  
52.                 <br>  
53.                 <div **class**="mark">注意：产品名称(subject)，必填(建议中文，英文，数字，不能含有特殊字符)</div>  
54.             </div>  
55.             <div **class**="element">  
56.                 <div **class**="etitle">付款金额:</div>  
57.                 <div **class**="einput"><input type="text" name="WIDtotal\_fee" id="WIDtotal\_fee" value="0.01"></div>  
58.                 <br>  
59.                 <div **class**="mark">注意：付款金额(total\_fee)，必填(格式如：1.00,请精确到分)</div>  
60.             </div>  
61.             <div **class**="element">  
62.                 <div **class**="etitle">商品描述:</div>  
63.                 <div **class**="einput"><input type="text" name="WIDbody" id="WIDbody" value="即时到账测试"></div>  
64.                 <br>  
65.                 <div **class**="mark">注意：商品描述(body)，选填(建议中文，英文，数字，不能含有特殊字符)</div>  
66.             </div>  
67.             <div **class**="element">  
68.                 <input type="button" **class**="alisubmit" id="sbumitBtn" value ="确认支付">  
69.             </div>  
70.     </div>  
71.     <div id="returnAli"></div>  
72.     <div **class**="footer">  
73.         <p **class**="footer-sub">  
74.             <a href="http://ab.alipay.com/i/index.htm" target="\_blank">关于支付宝</a><span>|</span>  
75.             <a href="https://e.alipay.com/index.htm" target="\_blank">商家中心</a><span>|</span>  
76.             <a href="https://job.alibaba.com/zhaopin/index.htm" target="\_blank">诚征英才</a><span>|</span>  
77.             <a href="http://ab.alipay.com/i/lianxi.htm" target="\_blank">联系我们</a><span>|</span>  
78.             <a href="\#" id="international" target="\_blank">International Business</a><span>|</span>  
79.             <a href="http://ab.alipay.com/i/jieshao.htm\#en" target="\_blank">About Alipay</a>  
80.             <br>  
81.              <span>支付宝版权所有</span>  
82.             <span **class**="footer-date">2004-2016</span>  
83.             <span><a href="http://fun.alipay.com/certificate/jyxkz.htm" target="\_blank">ICP证：沪B2-20150087</a></span>  
84.         </p>  
85.   
86.              
87.     </div>  
88. </body>

2、点击确认支付之后，这里通过ajax请求后台，将返回的一段html代码直接放到上面的<div id="returnALi"></div>中，这个表单会自动提交。

**\[javascript\]**  [view plain][]   [copy][view plain]

1.  $(**function** ()\{  
2.      $("\#sbumitBtn").on('click', **function**()\{  
3.          $.ajax(\{  
4.              type : "post",  
5.              data : \{  
6.                  WIDout\_trade\_no : $('\#out\_trade\_no').val(),  
7.                  WIDsubject : $('\#WIDsubject').val(),  
8.                  WIDtotal\_fee : $('\#WIDtotal\_fee').val(),  
9.                  WIDbody : $('\#WIDbody').val()  
10.             \},  
11.             url : "$\{ctx\}/aliPay/open",  
12.             success : **function**(data) \{  
13.                 $('\#returnAli').append(data.sHtmlText);  
14.             \},  
15.             error : **function**(da)\{  
16.             \}  
17.         \});  
18.     \})  
19.       
20. \});

3、后台controller中，基本是将demo中的alipayapi.jsp直接拿来用了，不同的是，参数的传递是自己定义的，返回方式符合apringmvc要求，并且根据业务需求保存了状态为未支付的订单信息。

**\[javascript\]**  [view plain][]   [copy][view plain]

1.  @RequestMapping("open")  
2.  **public** ResponseEntity<HttpEntity> open(Model model, String WIDout\_trade\_no, String WIDsubject, String WIDtotal\_fee,  
3.          String WIDbody) \{  
4.    
5.       请求参数//  
6.    
7.      // 商户订单号，商户网站订单系统中唯一订单号，必填  
8.      String out\_trade\_no = WIDout\_trade\_no;  
9.      // 订单名称，必填  
10.     String subject = WIDsubject;  
11.     // 付款金额，必填  
12.     String total\_fee = WIDtotal\_fee;  
13.     // 商品描述，可空  
14.     String body = WIDbody;  
15.   
16.     // 把请求参数打包成数组  
17.     Map<String, String> sParaTemp = **new** HashMap<String, String>();  
18.     sParaTemp.put("service", AlipayConfig.service);  
19.     sParaTemp.put("partner", AlipayConfig.partner);  
20.     sParaTemp.put("seller\_id", AlipayConfig.seller\_id);  
21.     sParaTemp.put("\_input\_charset", AlipayConfig.input\_charset);  
22.     sParaTemp.put("payment\_type", AlipayConfig.payment\_type);  
23.     sParaTemp.put("notify\_url", AlipayConfig.notify\_url);  
24.     sParaTemp.put("return\_url", AlipayConfig.return\_url);  
25.     sParaTemp.put("anti\_phishing\_key", AlipayConfig.anti\_phishing\_key);  
26.     sParaTemp.put("exter\_invoke\_ip", AlipayConfig.exter\_invoke\_ip);  
27.     sParaTemp.put("out\_trade\_no", out\_trade\_no);  
28.     sParaTemp.put("subject", subject);  
29.     sParaTemp.put("total\_fee", total\_fee);  
30.     sParaTemp.put("body", body);  
31.     // 其他业务参数根据在线开发文档，添加参数.文档地址:https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.O9yorI&treeId=62&articleId=103740&docType=1  
32.     // 如sParaTemp.put("参数名","参数值");  
33.   
34.     // 建立请求  
35.     String sHtmlText = AlipaySubmit.buildRequest(sParaTemp, "get", "确认");  
36.     model.addAttribute("sHtmlText", sHtmlText);  
37.   
38.     // 保存支付记录  
39.     hysWebMeetingAliService.insertSelective(sParaTemp);  
40.     **return** **new** ResponseEntity(model, HttpStatus.OK);  
41. \}

4、回调：也是直接将DEMO中的notify\_url.jsp中的java代码拿来稍微做了修改和加上业务代码（修改状态等）；

**\[javascript\]**  [view plain][]   [copy][view plain]

1.  @RequestMapping("notify")  
2.  @ResponseBody  
3.  **public** String notify(HttpServletRequest request)\{  
4.      //获取支付宝POST过来反馈信息  
5.      Map<String,String> params = **new** HashMap<String,String>();  
6.      Map requestParams = request.getParameterMap();  
7.      **for** (Iterator iter = requestParams.keySet().iterator(); iter.hasNext();) \{  
8.          String name = (String) iter.next();  
9.          String\[\] values = (String\[\]) requestParams.get(name);  
10.         String valueStr = "";  
11.         **for** (**int** i = 0; i < values.length; i++) \{  
12.             valueStr = (i == values.length - 1) ? valueStr + values\[i\]  
13.                     : valueStr + values\[i\] + ",";  
14.         \}  
15.         //乱码解决，这段代码在出现乱码时使用。如果mysign和sign不相等也可以使用这段代码转化  
16.         //valueStr = new String(valueStr.getBytes("ISO-8859-1"), "gbk");  
17.         params.put(name, valueStr);  
18.     \}  
19.       
20.     //获取支付宝的通知返回参数，可参考技术文档中页面跳转同步通知参数列表(以下仅供参考)//  
21.     //商户订单号  
22.   
23.     String out\_trade\_no = request.getParameter("out\_trade\_no");  
24.   
25.     //支付宝交易号  
26.   
27.     String trade\_no = request.getParameter("trade\_no");  
28.   
29.     //交易状态  
30.     String trade\_status = request.getParameter("trade\_status");  
31.   
32.     //获取支付宝的通知返回参数，可参考技术文档中页面跳转同步通知参数列表(以上仅供参考)//  
33.   
34.     **if**(AlipayNotify.verify(params))\{ //验证成功  
35.         //  
36.         //请在这里加上商户的业务逻辑程序代码  
37.   
38.         //——请根据您的业务逻辑来编写程序（以下代码仅作参考）——  
39.         **boolean** flg = **false**;  
40.         **if**(trade\_status.equals("TRADE\_FINISHED"))\{  
41.             //判断该笔订单是否在商户网站中已经做过处理  
42.                 //如果没有做过处理，根据订单号（out\_trade\_no）在商户网站的订单系统中查到该笔订单的详细，并执行商户的业务程序  
43.                 //请务必判断请求时的total\_fee、seller\_id与通知时获取的total\_fee、seller\_id为一致的  
44.                 //如果有做过处理，不执行商户的业务程序  
45.                   
46.             //注意：  
47.             //退款日期超过可退款期限后（如三个月可退款），支付宝系统发送该交易状态通知  
48.         \} **else** **if** (trade\_status.equals("TRADE\_SUCCESS"))\{  
49.             //判断该笔订单是否在商户网站中已经做过处理  
50.                 //如果没有做过处理，根据订单号（out\_trade\_no）在商户网站的订单系统中查到该笔订单的详细，并执行商户的业务程序  
51.                 //请务必判断请求时的total\_fee、seller\_id与通知时获取的total\_fee、seller\_id为一致的  
52.                 //如果有做过处理，不执行商户的业务程序  
53.                   
54.             //注意：  
55.             //付款完成后，支付宝系统发送该交易状态通知  
56.               
57.             //根据订单号将订单状态和支付宝记录表中状态都改为已支付  
58.             flg = hysWebMeetingAliService.changeOrderAndAliStatusSuccess(out\_trade\_no);  
59.               
60.         \}  
61.   
62.         //——请根据您的业务逻辑来编写程序（以上代码仅作参考）——  
63.               
64.         //out.print("success"); //请不要修改或删除  
65.         **if**(flg)\{  
66.             **return** "success";  
67.         \}**else**\{  
68.             **return** "fail";  
69.         \}  
70.   
71.         //  
72.     \}**else**\{ //验证失败  
73.         //out.print("fail");  
74.         **return** "fail";  
75.     \}  
76. \}

5、return\_url:页面跳转同步通知页面路径,就是支付成功后，支付宝回跳的一个页面。“需http://格式的完整路径，不能加?id=123这类自定义参数，必须外网可以正常访问”，支付宝明确规定了回跳的页面后面不能自定义参数，那么有的我们就是根据一些类型去判断跳转的就有点麻烦了。我这里做了一个取巧的做法：先把return\_url.jsp中的java代码也直接搬过来，略做修改（换成springmvc的方式），我的回跳地址就是IP/aliPay/returnUrl，然后再new ModelAndView("redirect:/meeting/info")进行重定向到我们想到的url中，（参数问题看下文总结第4点吧）。

**\[javascript\]**  [view plain][]   [copy][view plain]

1.      @RequestMapping("returnUrl")  
2.      **public** ModelAndView returnUrl(HttpServletRequest request)\{  
3.          ModelAndView mv = **new** ModelAndView("redirect:/meeting/info");  
4.            
5.          //获取支付宝GET过来反馈信息  
6.          Map<String,String> params = **new** HashMap<String,String>();  
7.          Map requestParams = request.getParameterMap();  
8.          **for** (Iterator iter = requestParams.keySet().iterator(); iter.hasNext();) \{  
9.              String name = (String) iter.next();  
10.             String\[\] values = (String\[\]) requestParams.get(name);  
11.             String valueStr = "";  
12.             **for** (**int** i = 0; i < values.length; i++) \{  
13.                 valueStr = (i == values.length - 1) ? valueStr + values\[i\]  
14.                         : valueStr + values\[i\] + ",";  
15.             \}  
16.             //乱码解决，这段代码在出现乱码时使用。如果mysign和sign不相等也可以使用这段代码转化  
17.             //valueStr = new String(valueStr.getBytes("ISO-8859-1"), "utf-8");  
18.             params.put(name, valueStr);  
19.         \}  
20.           
21.         //获取支付宝的通知返回参数，可参考技术文档中页面跳转同步通知参数列表(以下仅供参考)//  
22.         //商户订单号  
23.   
24.         String out\_trade\_no = request.getParameter("out\_trade\_no");  
25.   
26.         //支付宝交易号  
27.   
28.         String trade\_no = request.getParameter("trade\_no");  
29.   
30.         //交易状态  
31.         String trade\_status = request.getParameter("trade\_status");  
32.           
33.         <span style="color:\#ff0000;">String meetingId = request.getParameter("extra\_common\_param");  
34.         mv.addObject("meetingId", meetingId);</span>  
35.   
36.         //获取支付宝的通知返回参数，可参考技术文档中页面跳转同步通知参数列表(以上仅供参考)//  
37.           
38.         //计算得出通知验证结果  
39.         **boolean** verify\_result = AlipayNotify.verify(params);  
40.           
41.         **if**(verify\_result)\{ //验证成功  
42.             //  
43.             //请在这里加上商户的业务逻辑程序代码  
44.   
45.             //——请根据您的业务逻辑来编写程序（以下代码仅作参考）——  
46.             **if**(trade\_status.equals("TRADE\_FINISHED") || trade\_status.equals("TRADE\_SUCCESS"))\{  
47.                 //判断该笔订单是否在商户网站中已经做过处理  
48.                     //如果没有做过处理，根据订单号（out\_trade\_no）在商户网站的订单系统中查到该笔订单的详细，并执行商户的业务程序  
49.                     //如果有做过处理，不执行商户的业务程序  
50.             \}  
51.               
52.             //该页面可做页面美工编辑  
53. //          out.println("验证成功<br />");  
54.             //——请根据您的业务逻辑来编写程序（以上代码仅作参考）——  
55.   
56.             //  
57.         \}**else**\{  
58.             //该页面可做页面美工编辑  
59. //          out.println("验证失败");  
60.         \}  
61.           
62.         **return** mv;  
63.     \}

## 五、总结： ##

1、支付宝集成比较简答，稍微看下DEMO，跑一下了解了流程就比较容易了。

2、调试的时候，特别是回调，要把项目部署到能够外网访问的服务器上。

3、我没有遇到上面莫名其妙的问题，如果遇到了的话，可以联系我，或者看下[Eclipse远程debug][Eclipse_debug]这篇文章，进行问题的跟踪。

4、做页面跳转同步通知页面路径时，需要传递参数怎么办，我一开始是自定义了一个参数，可是没有取到，然后我看到DEMO中有一句注释是这么写的：

**\[javascript\]**  [view plain][]   [copy][view plain]

1.  // 其他业务参数根据在线开发文档，添加参数.文档地址:https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.O9yorI&treeId=62&articleId=103740&docType=1

所以我打开看了之后，选择了公用回传参数extra\_common\_param，我自己知道这个字段对于我来说是什么含义。不过也要注意，人家说明了：

**\[javascript\]**  [view plain][]   [copy][view plain]

1.  参数body（商品描述）、subject（商品名称）、extra\_common\_param（公用回传参数）不能包含特殊字符（如：\#、%、&、+）、敏感词汇，也不能使用外国文字（旺旺不支持的外文，如：韩文、泰语、藏文、蒙古文、阿拉伯语）；

open方法中设值：

**\[javascript\]**  [view plain][]   [copy][view plain]

1.  sParaTemp.put("extra\_common\_param", meetingId);

returnUrl方法中取值，并作为重定向参数：

**\[javascript\]**  [view plain][]   [copy][view plain]

1.  String meetingId = request.getParameter("extra\_common\_param");  
2.          mv.addObject("meetingId", meetingId);

[Link 1]: https://open.alipay.com/platform/home.htm
[Center]: /images/20220608/11e59cd103a647c890fd4cb62783d521.png
[Center 1]: /images/20220608/9e7397217e494f89973053eea7d068dc.png
[view plain]: http://blog.csdn.net/u010246789/article/details/51516511#
[Eclipse_debug]: http://blog.csdn.net/u010246789/article/details/51329782