最近做了一个电商，其中有涉及关于支付的问题，花了点小小的时间。因此写了一个小demo，不能说完美，但是能实现下订单扫码支付功能。这里我选择的技术是J2EE中的servlet和jsp，支付环境采用的是支付宝中的沙箱环境（基于本人没有企业级或者个人营业执照，无法申请支付接口）。这里写下自己的心得笔记。
一、什么是沙箱环境
小程序沙箱环境（Beta）是协助开发者进行接口功能开发及主要功能联调的辅助环境，沙箱环境模拟了开放平台部分产品的主要功能和主要逻辑。它与线上的生产环境不同，是一套虚拟的环境，调试所需要的账户也是沙箱账户，例如在调试支付接口时候或者进行用户授权相关的操作时候，均不产生任何真实的费用，测试中产生的交易均属于虚拟交易。
二、准备工作
如果要做支付开发，前提你得了解关于支付的一些相关常理。代码中会设计到订单，所购物品金额等等，这些都得准备好。
1、进入沙箱环境
域名：
https://openhome.alipay.com/platform/appDaily.htm?tab=info （沙箱环境）
https://docs.open.alipay.com/ （扫码支付开发文档）
2、配置公钥
注意这里是使用的是RSA2的密钥，这也是官方推荐，密钥长度是2048（RSA1的是1024）
使用RSA签名验证工具
3、下载官方demo
4、将下载好的demo导入编程工具中
注意下载后是个压缩包，这里只需要导入TradePayDemo这个文件夹
这里我用的myeclipes
这里需着重关注其中的Main函数以及zfbinfo.properties配置文件
二、调试
此时运行main函数，此时会报一大堆bug，是因为没有更改配置文件，也就是zfbinfo.properties配置文件。
进入配置文件其中一些注释会让你更改其中的配置参数，而这些参数你得参考你的沙箱环境中的配置
这是源文件
# 支付宝网关名、partnerId和appId open_api_domain = https://openapi.alipay.com/gateway.do mcloud_api_domain = http://mcloudmonitor.com/gateway.do pid = 此处请填写你的PID appid = 此处请填写你当面付的APPID # RSA私钥、公钥和支付宝公钥 private_key = 此处请填写你的商户私钥且转PKCS8格式 public_key = 此处请填写你的商户公钥 #SHA1withRsa对应支付宝公钥 #alipay_public_key = MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDI6d306Q8fIfCOaTXyiUeJHkrIvYISRcc73s3vF1ZT7XN8RNPwJxo8pWaJMmvyTn9N4HQ632qJBVHf8sxHi/fEsraprwCtzvzQETrNRwVxLO5jVmRGi60j8Ue1efIlzPXV9je9mkjzOmdssymZkh2QhUrCmZYI/FCEa3/cNMW0QIDAQAB #SHA256withRsa对应支付宝公钥 alipay_public_key = MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAjrEVFMOSiNJXaRNKicQuQdsREraftDA9Tua3WNZwcpeXeh8Wrt+V9JilLqSa7N7sVqwpvv8zWChgXhX/A96hEg97Oxe6GKUmzaZRNh0cZZ88vpkn5tlgL4mH/dhSr3Ip00kvM4rHq9PwuT4k7z1DpZAf1eghK8Q5BgxL88d0X07m9X96Ijd0yMkXArzD7jg+noqfbztEKoH3kPMRJC2w4ByVdweWUT2PwrlATpZZtYLmtDvUKG/sOkNAIKEMg3Rut1oKWpjyYanzDgS7Cg3awr1KPTl9rHCazk15aNYowmYtVabKwbGVToCAGK+qQ1gT3ELhkGnf3+h53fukNqRH+wIDAQAB # 签名类型: RSA->SHA1withRsa,RSA2->SHA256withRsa sign_type = RSA2 # 当面付最大查询次数和查询间隔（毫秒） max_query_retry = 5 query_duration = 5000 # 当面付最大撤销次数和撤销间隔（毫秒） max_cancel_retry = 3 cancel_duration = 2000 # 交易保障线程第一次调度延迟和调度间隔（秒） heartbeat_delay = 5 heartbeat_duration = 900
其中
open_api_domain 对应支付宝网关
mcloud_api_domain 这个可以不用管，使用默认配置
pid 对应商户UID
即
appid 对应沙箱环境中的APPID
使用RSA签名验证工具
将形成的私钥公钥分别赋值到private key，public Key中
点击查看支付宝公钥，将密文赋值到alipay_public_key
而以下的参数设置使用默认配置就好
将应用网关设置成和支付宝网关一致
授权回调地址是自己设置的回调地址
AES密钥就用默认配置就好
都配置好后，运行主函数
若显示msg:Success说明配置成功
三、集成到开发环境
1.新建一个web项目
2.将原demo下的lib下所有jar包以及配置文件和class类拷到新建项目下的相对应的位置
3. 定义一个jsp，用于启动支付程序跳转，这里我起名为pay.jsp
<body> <h3>去支付</h3> <form action="/MyTestPay/TestPay" method="post"> <input type="hidden" name="action" value="pay"/> <input type="submit" value="前往"/> </form> </body>
4.定义一个servlet，用于处理支付业务,这里我起名为TestPay
找到源码中Main类，将其中的test_trade_pay方法中的代码拷贝到新建servlet中doGet方法中
值得注意的是，由于这里我只是个小demo，所以订单编号、金额等都是临时自定义的，项目中可视情况而定
需要修改的是
订单编号：
String outTradeNo = "sd00".concat(Math.random()+"");
这里我采用了生成随机数与自定义订单编号“sd00”进行字符串拼接，因为官方文档中说订单编号不能重复，否则会扫码失败
订单标题：
String subject = new StringBuilder().append("支付宝扫码支付,订单号:").append(outTradeNo).toString();
这里字符串我也做了处理
金额：
String totalAmount = "0.06";
订单打折金额：
卖家支付宝账号ID：
String undiscountableAmount = "0";
String sellerId = "";
这里使用默认配置
订单描述：
String body = new StringBuilder().append("订单").append(outTradeNo).append("购买商品共").append(totalAmount).append("元").toString();
商户操作员编号：
商户门店编号：
业务扩展参数：
支付超时：
String operatorId = "test_operator_id"; // (必填) 商户门店编号，通过门店号和商家后台可以配置精准到门店的折扣信息，详询支付宝技术支持 String storeId = "test_store_id"; // 业务扩展参数，目前可添加由支付宝分配的系统商编号(通过setSysServiceProviderId方法)，详情请咨询支付宝技术支持 ExtendParams extendParams = new ExtendParams(); extendParams.setSysServiceProviderId("2088100200300400500"); // 支付超时，定义为120分钟 String timeoutExpress = "120m";
这里使用默认配置
设置回调地址：
.setNotifyUrl("http://8ugw8u.natappfree.cc/MyTestPay/Return")//支付宝服务器主动通知商户服务器里指定的页面http路径,根据需要设置
注意：这里回调地址很重要
回调地址即当你扫码支付后，支付宝后台会发送给你订单支付详情状态（如支付状态等），回调地址根据自己情况而定，源码是屏蔽了
获取支付二维码url：
String path=null; String[] temp=response1.getBody().split(","); for(String demo:temp){ int num=demo.indexOf("qr_code"); if(num>0){ //获得二维码路径 path=demo.substring(demo.indexOf(":")+2,demo.lastIndexOf("}")-1); request.setAttribute("path",path); } } } System.out.println("path"+path); request.getRequestDispatcher("index.jsp").forward(request, response);
这里我拷贝了打印回调信息中的dumpResponse方法，因为从日志中我看到起方法打印出了生成二维码的url的信息
这是我运行源码main类时所生成的日志，其中qr_code就是二维码的url
我将获取到的二维码路径通过request.setAttribute()方法传到了前端
以下是我该类的源代码
public class TestPay extends HttpServlet { private static Log log = LogFactory.getLog(OrderController.class); public TestPay() { super(); } public void destroy() { super.destroy(); } public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { response.setContentType("text/html;charset=utf-8"); PrintWriter out = response.getWriter(); String param=request.getParameter("action"); System.out.println(param); if("pay".equals(param)){ pay(request,response); } } //定义支付方法 private void pay(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // (必填) 商户网站订单系统中唯一订单号，64个字符以内，只能包含字母、数字、下划线， // 需保证商户系统端不能重复，建议通过数据库sequence生成， String outTradeNo = "sd00".concat(Math.random()+""); // (必填) 订单标题，粗略描述用户的支付目的。如“xxx品牌xxx门店当面付扫码消费” String subject = new StringBuilder().append("支付宝扫码支付,订单号:").append(outTradeNo).toString(); // (必填) 订单总金额，单位为元，不能超过1亿元 // 如果同时传入了【打折金额】,【不可打折金额】,【订单总金额】三者,则必须满足如下条件:【订单总金额】=【打折金额】+【不可打折金额】 String totalAmount = "0.06"; // (可选) 订单不可打折金额，可以配合商家平台配置折扣活动，如果酒水不参与打折，则将对应金额填写至此字段 // 如果该值未传入,但传入了【订单总金额】,【打折金额】,则该值默认为【订单总金额】-【打折金额】 String undiscountableAmount = "0"; // 卖家支付宝账号ID，用于支持一个签约账号下支持打款到不同的收款账号，(打款到sellerId对应的支付宝账号) // 如果该字段为空，则默认为与支付宝签约的商户的PID，也就是appid对应的PID String sellerId = ""; // 订单描述，可以对交易或商品进行一个详细地描述，比如填写"购买商品2件共15.00元" String body = new StringBuilder().append("订单").append(outTradeNo).append("购买商品共").append(totalAmount).append("元").toString(); // 商户操作员编号，添加此参数可以为商户操作员做销售统计 String operatorId = "test_operator_id"; // (必填) 商户门店编号，通过门店号和商家后台可以配置精准到门店的折扣信息，详询支付宝技术支持 String storeId = "test_store_id"; // 业务扩展参数，目前可添加由支付宝分配的系统商编号(通过setSysServiceProviderId方法)，详情请咨询支付宝技术支持 ExtendParams extendParams = new ExtendParams(); extendParams.setSysServiceProviderId("2088100200300400500"); // 支付超时，定义为120分钟 String timeoutExpress = "120m"; // 商品明细列表，需填写购买商品详细信息， List<GoodsDetail> goodsDetailList = new ArrayList<GoodsDetail>(); GoodsDetail goods1 = GoodsDetail.newInstance("goods_id001", "xxx小面包", 1000, 1); // 创建好一个商品后添加至商品明细列表 goodsDetailList.add(goods1); // 继续创建并添加第一条商品信息，用户购买的产品为“黑人牙刷”，单价为5.00元，购买了两件 GoodsDetail goods2 = GoodsDetail.newInstance("goods_id002", "xxx牙刷", 500, 2); goodsDetailList.add(goods2); // 创建扫码支付请求builder，设置请求参数 AlipayTradePrecreateRequestBuilder builder = new AlipayTradePrecreateRequestBuilder() .setSubject(subject).setTotalAmount(totalAmount).setOutTradeNo(outTradeNo) .setUndiscountableAmount(undiscountableAmount).setSellerId(sellerId).setBody(body) .setOperatorId(operatorId).setStoreId(storeId).setExtendParams(extendParams) .setTimeoutExpress(timeoutExpress) .setNotifyUrl("http://8ugw8u.natappfree.cc/MyTestPay/Return")//支付宝服务器主动通知商户服务器里指定的页面http路径,根据需要设置 .setGoodsDetailList(goodsDetailList); /** 一定要在创建AlipayTradeService之前调用Configs.init()设置默认参数 * Configs会读取classpath下的zfbinfo.properties文件配置信息，如果找不到该文件则确认该文件是否在classpath目录 */ Configs.init("zfbinfo.properties"); /** 使用Configs提供的默认参数 * AlipayTradeService可以使用单例或者为静态成员对象，不需要反复new */ AlipayTradeService tradeService = new AlipayTradeServiceImpl.ClientBuilder().build(); AlipayF2FPrecreateResult result = tradeService.tradePrecreate(builder); switch (result.getTradeStatus()) { case SUCCESS: log.info("支付宝预下单成功: )"); AlipayTradePrecreateResponse response1 = result.getResponse(); dumpResponse(response1); // 需要修改为运行机器上的路径 String filePath = String.format("/Users/sudo/Desktop/qr-%s.png", response1.getOutTradeNo()); log.info("filePath:" + filePath); // ZxingUtils.getQRCodeImge(response.getQrCode(), 256, filePath); String path=null; String[] temp=response1.getBody().split(","); for(String demo:temp){ int num=demo.indexOf("qr_code"); if(num>0){ //获得二维码路径 path=demo.substring(demo.indexOf(":")+2,demo.lastIndexOf("}")-1); request.setAttribute("path",path); } } } System.out.println("path"+path); request.getRequestDispatcher("index.jsp").forward(request, response); break; case FAILED: log.error("支付宝预下单失败!!!"); break; case UNKNOWN: log.error("系统异常，预下单状态未知!!!"); break; default: log.error("不支持的交易状态，交易返回异常!!!"); break; } } // 简单打印应答 private void dumpResponse(AlipayResponse response) { if (response != null) { log.info(String.format("code:%s, msg:%s", response.getCode(), response.getMsg())); if (StringUtils.isNotEmpty(response.getSubCode())) { log.info(String.format("subCode:%s, subMsg:%s", response.getSubCode(), response.getSubMsg())); } log.info("body:" + response.getBody()); System.out.println(response.getBody()); String[] temp=response.getBody().split(","); for(String demo:temp){ int num=demo.indexOf("qr_code"); if(num>0){ //获得二维码路径 demo=demo.substring(demo.indexOf(":")+2,demo.lastIndexOf("}")-1); } } } }
5.定义一个用于显示二维码的页面，这里我起名为index.jsp
有些开发者是将生成的二维码上传到指定的文件夹，前端通过文件夹所在路径进行获取，定义一个ajax每隔.秒查询后台支付情况
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> <% String path = request.getContextPath(); String basePath = request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort() + path + "/"; %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <base href="<%=basePath%>"> <title>My JSP 'index.jsp' starting page</title> <meta http-equiv="pragma" content="no-cache"> <meta http-equiv="cache-control" content="no-cache"> <meta http-equiv="expires" content="0"> <meta http-equiv="keywords" content="keyword1,keyword2,keyword3"> <meta http-equiv="description" content="This is my page"> <!-- <link rel="stylesheet" type="text/css" href="styles.css"> --> </head> <script type="text/javascript" src="<%=request.getContextPath()%>/js/jquery-1.8.2.js"></script> <script type="text/javascript" src="<%=request.getContextPath()%>/js/jquery.qrcode.min.js"></script> <body> <h3>生成的二维码如下</h3> <div id="qrcode"></div> <script type="text/javascript"> window.onload = function() { jQuery('#qrcode').qrcode("${requestScope.path}"); } function hello() { $.ajax({ url : '/MyTestPay/ResultSevlet', type : 'GET', dataType : 'json', data : {}, success : function(data) { if(data){ location.href = "http://localhost:8080/MyTestPay/success.jsp"; } }, error : function() { } }) } var t1 = window.setInterval(hello, 3000); </script> </body> </html>
这里先到官网下载jquery-qrcode压缩文件(网址：https://github.com/jeromeetienne/jquery-qrcode)，这是可通过一个合格的域名生成二维码的工具，在WebRoot下新建一个js 文件夹，将解压后的文件夹的jquery.qrcode.min.js放进js文件，再另外下载好的jquery 放进js文件夹。
其用法就只有几行代码，如上图所示，将从后台传过来的path放进qrcode方法中
6、后台定义一个servlet用于响应ajax
package com.pay.controller; import java.io.IOException; import java.io.PrintWriter; import java.util.Iterator; import java.util.Map; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.http.HttpSession; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import com.alipay.api.AlipayApiException; import com.alipay.api.internal.util.AlipaySignature; import com.alipay.demo.trade.config.Configs; import com.google.common.collect.Maps; import com.pay.pojo.Const; import com.pay.pojo.User; import com.pay.service.IOrderService; public class ResultSevlet extends HttpServlet { private static Log log = LogFactory.getLog(ResultSevlet.class); private static boolean flag = false; public static boolean isFlag() { return flag; } public static void setFlag(boolean flag) { ResultSevlet.flag = flag; } public ResultSevlet() { super(); } public void destroy() { super.destroy(); } public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { response.getWriter().print(flag); } public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { this.doGet(request, response); } public void init() throws ServletException { } }
7、定义一个servlet，用于接受回调信息。这里我起名为Return
package com.pay.servlet; import java.io.IOException; import java.io.PrintWriter; import java.util.HashMap; import java.util.Iterator; import java.util.Map; import javax.servlet.ServletException; import javax.servlet.ServletOutputStream; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import com.alipay.api.AlipayApiException; import com.alipay.api.internal.util.AlipaySignature; import com.alipay.demo.trade.config.Configs; import com.google.common.collect.Maps; import com.pay.controller.ResultSevlet; public class Return extends HttpServlet { /** * Constructor of the object. */ public Return() { super(); } /** * Destruction of the servlet. <br> */ public void destroy() { super.destroy(); // Just puts "destroy" string in log // Put your code here } public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { response.setContentType("text/html;charset=utf-8"); PrintWriter out = response.getWriter(); //定义一个map用于接受回调信息 Map<String,String> params = new HashMap<String, String>(); //支付宝回调信息都存进了request请求中 Map requestParams = request.getParameterMap(); //遍历集合，详情参考开发文档 for(Iterator iter = requestParams.keySet().iterator();iter.hasNext();){ String name = (String)iter.next(); String[] values = (String[]) requestParams.get(name); String valueStr = ""; for(int i = 0 ; i <values.length;i++){ valueStr = (i == values.length -1)?valueStr + values[i]:valueStr + values[i]+","; } params.put(name,valueStr); } System.out.println("支付宝回调,sign:"+params.get("sign")+"trade_status::"+params.get("trade_status")+"参数:{}"+params.toString()); //非常重要,验证回调的正确性,是不是支付宝发的.并且呢还要避免重复通知. params.remove("sign_type");//强制移除，根据开发文档 try { boolean alipayRSACheckedV2 = AlipaySignature.rsaCheckV2(params, Configs.getAlipayPublicKey(),"utf-8",Configs.getSignType()); if(!alipayRSACheckedV2){ System.out.println("非法请求,验证不通过,再恶意请求我就报警找网警了"); } } catch (AlipayApiException e) { System.out.println("支付宝验证回调异常"); } //获取支付宝的通知返回参数，可参考技术文档中页面跳转同步通知参数列表(以下仅供参考)// String trade_no = request.getParameter("trade_no"); //支付宝交易号 String order_no = request.getParameter("out_trade_no"); //获取订单号 String total_fee = request.getParameter("total_fee"); //获取总金额 String trade_status = request.getParameter("trade_status"); boolean msg=false; //此时可以定义个方法，将订单id作为参数传入，查询该订单是否存在 if(trade_status.equals("TRADE_FINISHED") || trade_status.equals("TRADE_SUCCESS")){ //这里返回的数据必须是success，不管是否是交易成功，不然支付宝会不定时的发送请求，直至24小时 out.println("success"); //请不要修改或删除 msg=true; ResultSevlet resultSevlet = new ResultSevlet(); resultSevlet.setFlag(true); request.getSession().setAttribute("msg",msg); } else { out.println("success"); //请不要修改或删除 request.getSession().setAttribute("msg",msg); } System.out.println("状态为"+params.get("trade_status")); } public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { this.doGet(request, response); } /** * Initialization of the servlet. <br> * * @throws ServletException if an error occurs */ public void init() throws ServletException { // Put your code here } }
值得注意的是，这个回调的servlet不是手动调用，而是由支付宝后台根据之前设置的域名进行回调
而域名不能是自己定义的，因为是在本地内网，支付宝无法识别，我尝试过。
这里我使用的是NETAPP,用于开启内网穿透。域名：https://natapp.cn/
登录后进行客户端下载
配置隧道，注意：这里得指定8080端口,具体操作上面的新手快速使用文档
开启客户端
将生成的域名设置到先前写的TestPay类中的pay方法中
AlipayTradePrecreateRequestBuilder builder = new AlipayTradePrecreateRequestBuilder() .setSubject(subject).setTotalAmount(totalAmount).setOutTradeNo(outTradeNo) .setUndiscountableAmount(undiscountableAmount).setSellerId(sellerId).setBody(body) .setOperatorId(operatorId).setStoreId(storeId).setExtendParams(extendParams) .setTimeoutExpress(timeoutExpress) .setNotifyUrl("http://8ugw8u.natappfree.cc/MyTestPay/Return")//支付宝服务器主动通知商户服务器里指定的页面http路径,根据需要设置 .setGoodsDetailList(goodsDetailList);
此时代码可以运行了，在沙箱环境中的沙箱工具中下载支付宝钱包，这是基于沙箱版的钱包，用于开发者测试，所有的金额都是虚拟的
下载好后登陆沙箱环境中的买家账号，默认支付密码为111111，此时可以进行扫码支付了
前台：
961
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
