Java调用支付宝支付接口

2021-08-21 10:28:33

Java调用支付宝支付接口

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

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

Java调用支付宝支付接口

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

Java调用支付宝支付接口

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

四、实现：

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

[javascript] view plain copy
  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
  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
  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
  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
  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这篇文章，进行问题的跟踪。

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

[javascript] view plain copy
  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
  1. 参数body（商品描述）、subject（商品名称）、extra_common_param（公用回传参数）不能包含特殊字符（如：#、%、&、+）、敏感词汇，也不能使用外国文字（旺旺不支持的外文，如：韩文、泰语、藏文、蒙古文、阿拉伯语）；  

open方法中设值：

[javascript] view plain copy
  1. sParaTemp.put("extra_common_param", meetingId);  


returnUrl方法中取值，并作为重定向参数：
[javascript] view plain copy
  1. String meetingId = request.getParameter("extra_common_param");  
  2.         mv.addObject("meetingId", meetingId); 
  3. 原文地址https://blog.csdn.net/Teacher_Lee_ZZSXT/article/details/79104398
上一篇：20个优秀的前端框架


下一篇：钢铁机器人在400米外高精度击穿铁门