当前位置：首页 > news >正文

实现支付宝沙箱环境搭建

news 来源：原创 2025/7/12 19:36:51

1.介绍

在业务开发的过程中，有时会涉及到一些支付相关的功能，这个时候就需要接入第三方支付接口，而由于开发中需要不断进行测试，使用真实的账号进行支付就有些不值得，所以支付宝为我们提供了第三方SDK，供我们在虚拟的环境中实现支付功能测试。

第三方支付接口流程大同小异，与真实支付的流程完全一致。沙箱环境是支付宝开放平台为开发者提供的与生产环境完全隔离的联调测试环境，开发者在沙箱环境中完成的接口调用不会对生产环境中的数据造成任何影响。并且其具有天然的方便性，沙箱环境与正式环境的域名仅仅相差一个dev，在后续上线后只需将url进行修改即可。

2.搭建环境

首先访问支付宝开放平台：https://open.alipay.com/

点击登录（使用自己的支付宝账号）

进入控制台

点击“沙箱” ，进入沙箱环境配置页面

在左侧的“沙箱应用”中，点击查看自己的应用私钥和支付宝公钥，并保存

点击左侧沙箱账号，其中包括商家账号和用户账号。这里我们使用买家账号实现支付测试

点击左侧沙箱工具，这边建议在手机上下载沙箱APP，使用时需要保证与服务端在同一网段下，可以通过连接同一个WiFi或者内网穿透实现

编写测试代码

引入支付相关依赖

<!-- 支付宝SDK -->
<dependency><groupId>com.alipay.sdk</groupId><artifactId>alipay-sdk-java</artifactId><version>3.7.73.ALL</version>
</dependency><!-- 支付宝SDK依赖的日志 -->
<dependency><groupId>commons-logging</groupId><artifactId>commons-logging</artifactId><version>1.2</version>
</dependency>

创建一个Controller类，编写以下内容

发送请求示例代码，这里需要指定你的APP_ID、应用私钥、支付宝公钥，我已经在nacos中配置完成，你也可以选择直接硬编码到类当中

 @Value("${pay.alipay.APP_ID}")String APP_ID;@Value("${pay.alipay.APP_PRIVATE_KEY}")String APP_PRIVATE_KEY;@Value("${pay.alipay.ALIPAY_PUBLIC_KEY}")String ALIPAY_PUBLIC_KEY;@RequestMapping("/alipaytest")public void doPost(HttpServletRequest httpRequest,HttpServletResponse httpResponse) throws ServletException, IOException, AlipayApiException {AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.URL, APP_ID, APP_PRIVATE_KEY, AlipayConfig.FORMAT, AlipayConfig.CHARSET, ALIPAY_PUBLIC_KEY,AlipayConfig.SIGNTYPE);//获得初始化的AlipayClientAlipayTradeWapPayRequest alipayRequest = new AlipayTradeWapPayRequest();//创建API对应的request
//        alipayRequest.setReturnUrl("http://domain.com/CallBack/return_url.jsp");
//        alipayRequest.setNotifyUrl("http://domain.com/CallBack/notify_url.jsp");//在公共参数中设置回跳和通知地址alipayRequest.setBizContent("{" +"    \"out_trade_no\":\"202210100010101003\"," +"    \"total_amount\":456300," +"    \"subject\":\"北京奔驰汽车有限公司\"," +"    \"product_code\":\"QUICK_WAP_WAY\"" +"  }");//填充业务参数String form = alipayClient.pageExecute(alipayRequest).getBody(); //调用SDK生成表单httpResponse.setContentType("text/html;charset=" + AlipayConfig.CHARSET);httpResponse.getWriter().write(form);//直接将完整的表单html输出到页面httpResponse.getWriter().flush();}

我们使用扫码支付的方式，所以继续引入二维码相关依赖

用户在前端使用支付宝沙箱通过扫码请求下单接口，我们需要生成订单服务的下单接口的二维码。

ZXing是一个开源的类库，是用Java编写的多格式的1D / 2D条码图像处理库，使用ZXing可以生成、识别QR Code（二维码）。常用的二维码处理库还有zbar，近几年已经不再更新代码，下边介绍ZXing生成二维码的方法。

<!-- 二维码生成&识别组件 -->
<dependency><groupId>com.google.zxing</groupId><artifactId>core</artifactId><version>3.3.3</version>
</dependency><dependency><groupId>com.google.zxing</groupId><artifactId>javase</artifactId><version>3.3.3</version>
</dependency><dependency><groupId>org.apache.commons</groupId><artifactId>commons-lang3</artifactId>
</dependency>

创建一个工具类，用于根据请求信息生成对应二维码。注意，其中的启动类的访问路径改为你的本机ip以及服务端口号

public class QRCodeUtil {/*** 生成二维码** @param content 二维码对应的URL* @param width   二维码图片宽度* @param height  二维码图片高度* @return*/public String createQRCode(String content, int width, int height) throws IOException {String resultImage = "";//除了尺寸，传入内容不能为空if (!StringUtils.isEmpty(content)) {ServletOutputStream stream = null;ByteArrayOutputStream os = new ByteArrayOutputStream();//二维码参数@SuppressWarnings("rawtypes")HashMap<EncodeHintType, Comparable> hints = new HashMap<>();//指定字符编码为“utf-8”hints.put(EncodeHintType.CHARACTER_SET, "utf-8");//L M Q H四个纠错等级从低到高，指定二维码的纠错等级为M//纠错级别越高，可以修正的错误就越多，需要的纠错码的数量也变多，相应的二维吗可储存的数据就会减少hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.M);//设置图片的边距hints.put(EncodeHintType.MARGIN, 1);try {//zxing生成二维码核心类QRCodeWriter writer = new QRCodeWriter();//把输入文本按照指定规则转成二维吗BitMatrix bitMatrix = writer.encode(content, BarcodeFormat.QR_CODE, width, height, hints);//生成二维码图片流BufferedImage bufferedImage = MatrixToImageWriter.toBufferedImage(bitMatrix);//输出流ImageIO.write(bufferedImage, "png", os);/*** 原生转码前面没有 data:image/png;base64 这些字段，返回给前端是无法被解析，所以加上前缀*/resultImage = new String("data:image/png;base64," + EncryptUtil.encodeBase64(os.toByteArray()));return resultImage;} catch (Exception e) {e.printStackTrace();throw new RuntimeException("生成二维码出错");} finally {if (stream != null) {stream.flush();stream.close();}}}return null;}public static void main(String[] args) throws IOException {QRCodeUtil qrCodeUtil = new QRCodeUtil();//                                           改为你的主机ip、服务端口号、路径前缀（如果存在）
System.out.println(qrCodeUtil.createQRCode("http://192.168.0.106:63030/orders/alipaytest/", 200, 200));}
}

1.启动服务

2.运行工具类的main方法

将生成的BASE64编码串进行复制，到浏览器进行访问

访问的结果会产生一张二维码，使用沙箱APP扫码

如果沙箱APP扫码的结果是无css样式的form表单，在页面点击右上角的三个点使用浏览器访问

输入账号密码进行支付

这里便支付成功

支付成功后我们需要得到回调消息，支付宝官方为我们提供了模板方法

但是你如果需要使用该功能，需要配置内网穿透，否则支付宝无法访问内网，同时将上面我提供的发送请求的方法的“alipayRequest.setNotifyUrl”一行取消注解，并将其中的路径改为这里配置的路径

//接收通知@PostMapping("/paynotify")public void paynotify(HttpServletRequest request,HttpServletResponse response) throws IOException, AlipayApiException {Map<String,String> params = new HashMap<String,String>();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] + ",";}//乱码解决，这段代码在出现乱码时使用。如果mysign和sign不相等也可以使用这段代码转化//valueStr = new String(valueStr.getBytes("ISO-8859-1"), "gbk");params.put(name, valueStr);}//获取支付宝的通知返回参数，可参考技术文档中页面跳转同步通知参数列表(以上仅供参考)////计算得出通知验证结果//boolean AlipaySignature.rsaCheckV1(Map<String, String> params, String publicKey, String charset, String sign_type)boolean verify_result = AlipaySignature.rsaCheckV1(params, ALIPAY_PUBLIC_KEY, AlipayConfig.CHARSET, "RSA2");if(verify_result) {//验证成功////请在这里加上商户的业务逻辑程序代码//商户订单号String out_trade_no = new String(request.getParameter("out_trade_no").getBytes("ISO-8859-1"),"UTF-8");//支付宝交易号String trade_no = new String(request.getParameter("trade_no").getBytes("ISO-8859-1"),"UTF-8");//交易状态String trade_status = new String(request.getParameter("trade_status").getBytes("ISO-8859-1"),"UTF-8");//——请根据您的业务逻辑来编写程序（以下代码仅作参考）——if (trade_status.equals("TRADE_FINISHED")) {//交易结束//判断该笔订单是否在商户网站中已经做过处理//如果没有做过处理，根据订单号（out_trade_no）在商户网站的订单系统中查到该笔订单的详细，并执行商户的业务程序//请务必判断请求时的total_fee、seller_id与通知时获取的total_fee、seller_id为一致的//如果有做过处理，不执行商户的业务程序//注意：//如果签约的是可退款协议，退款日期超过可退款期限后（如三个月可退款），支付宝系统发送该交易状态通知//如果没有签约可退款协议，那么付款完成后，支付宝系统发送该交易状态通知。} else if (trade_status.equals("TRADE_SUCCESS")) {//交易成功System.out.println(trade_status);//判断该笔订单是否在商户网站中已经做过处理//如果没有做过处理，根据订单号（out_trade_no）在商户网站的订单系统中查到该笔订单的详细，并执行商户的业务程序//请务必判断请求时的total_fee、seller_id与通知时获取的total_fee、seller_id为一致的//如果有做过处理，不执行商户的业务程序//注意：//如果签约的是可退款协议，那么付款完成后，支付宝系统发送该交易状态通知。}response.getWriter().write("success");}else{response.getWriter().write("fail");}}

响应结果如下

调用成功
TRADE_SUCCESS

参考文档https://opendocs.alipay.com/open/02ivbt查阅每个参数的意义。

1.介绍

2.搭建环境

相关文章：