Springboot支付宝沙箱支付---完整详细步骤

1、进入支付宝开发平台—沙箱环境

沙箱环境-支付宝文档中心

1.1、进入个人沙箱环境

点击进入沙箱环境并用支付宝登陆

沙箱管理界面如图所示

• appid，支付宝网关，自定义密钥等
• 这里是沙箱支付宝（虚拟）的账号和密码，可以用来支付

1.2、接下来进行几个密钥的生成

点击进入密钥工具
点击生成

这时我们拿到两个密钥，将它们保存，这两个密钥很重要

• 应用私钥
• 应用公钥

1.3、拿到两个密钥后，进行自定义密钥配置

进入最开始的沙箱管理界面，点击自定义密钥，点击设置（查看），我们选择的是RSA2密钥

选择“公钥”这一选项

将上一步骤生成的应用公钥填进来，会得到支付宝公钥这另一个密钥，记住并保存这个支付宝公钥

1.4、至此，我们沙箱环境的配置和基本参数都已经获取到。

2、项目端的代码配置

2.1、首先导入支付宝支付的依赖到pom.xml中

这里我用的是springboot+maven+themyleaf项目

<!--   支付宝支付的依赖     --><dependency><groupId>com.alipay.sdk</groupId><artifactId>alipay-sdk-java</artifactId><version>4.16.2.ALL</version></dependency>

2.2、创建支付的Controller类

• 将从Controller中进入支付宝支付，需完成支付宝提供的接口
• 创建PayController类，有如下代码

创建Controller类后，首先设置如下私有属性

• APP_ID （appId，从沙箱管理页面获得）
• APP_PRIVATE_KEY （应用私钥，最开始在密钥工具生成而来）
• ALIPAY_PUBLIC_KEY （支付宝公钥，上一步骤获得）
• GATEWAY_URL （支付宝网关地址，在开发平台沙箱管理页面中获得）
• SIGN_TYPE （签名类型）
• NOTIFY_URL （异步回调地址，须是公网IP，后面再解释）
• RETURN_URL （同步回调地址，可以是私网IP）

@ControllerpublicclassPayController{@AutowiredDonaItemService donaItemService;@AutowiredDonaService donaService;//appidprivatefinalString APP_ID ="2021000119625133";//应用私钥privatefinalString APP_PRIVATE_KEY ="MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCDA1Y0+IjB/z4sIhJA0sgEaNGXV9+8t0fUMhrbjHjW88tz8d7jR8ev1aFMmyDKy/cSnlsoNDLwx71GCLiNQENYTvqdcsrYLMvQkmeIYT1OWcPYSl65P0TQRDBhakVdAIXvnts7KJ/nCROGMy8qrBG8ilSlNaOkiuXgp1OPIqLe2dCkrJp1spOJ3Wfq9uyqJO5xrgx6tby3MVPLu/nJ2PtzXt62Kpcj/S9Xxxk9FXOw8cwGDStMPU471VKpEP4kMnjfpUpB9/FfQ6oDfokIaq9dehN9xSitAD6p5cFct7oG94DHai5a+ST6X+OfTv03oE2DuA7ejaJn6cDGSB4IYmZRuDGdicqmPmLEHt3Kq79+EPxBYKUcWI4zQPXlA06Kcgb8HrJntjC836svSUrewWaG32g5MlJB8e1Z+1yL75E6k6R4rBJiVW2MC5VW+p/nQiY3FLfRq4a8V+VJ9uXM1h7L8TbOHtCAQKBgQDCSljMB8VnLFMKHOrcHCZNtjnDHsRYJQYEgNhhvwx2xUIgZNhzpiDmUSwR4TOaqF+Eg5bLfC+sQboANXpP5YUyt/rqUWqQ1fmEV5US9cfiYOi5rfjETK0RAJZaqAVZ0b0PAOMoQpNSbiQKBgHtAnpTuE0QFby+7hDsnTz+qC9dyQQWH3cBOn4RQzo1DUxvyQpZjAy0Oqn/F5x6RGMQU6SrirdUQbGWcANOpp9/L3YGHUrUjlT5Ehx2nPO//yTZSTWKM+p6+XALn1DGZbTChnL/5aEZsg5R4f55wL6RYezRzhq+w4wMixTQDyFLZ";privatefinalString CHARSET ="UTF-8";// 支付宝公钥privatefinalString ALIPAY_PUBLIC_KEY ="MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA3CPgueDLkfB66s9ZsEUwyUbmkRknTFVyuBG4PkKI93OTOVC457ijEKknRYi8eKYo4Wl+75KxYO+tTr1u3XQZmjtjlqbty50DmxRCgEqJKYEu6CD+r1vi+2SXOUKnCJzsE8vHojS+Vk5oGbZYnX6Esw2TVeiCkmQ814CBwIDAQAB";//这是沙箱接口路径,正式路径为https://openapi.alipay.com/gateway.doprivatefinalString GATEWAY_URL ="https://openapi.alipaydev.com/gateway.do";privatefinalString FORMAT ="JSON";//签名方式privatefinalString SIGN_TYPE ="RSA2";//支付宝异步通知路径,付款完毕后会异步调用本项目的方法,必须为公网地址privatefinalString NOTIFY_URL ="http://127.0.0.1/notifyUrl";//支付宝同步通知路径,也就是当付款完毕后跳转本项目的页面,可以不是公网地址privatefinalString RETURN_URL ="http://localhost:8080/returnUrl";}

2.3、在Controller类中创建点击支付跳转支付宝页面的方法

//必须加ResponseBody注解，否则spring会寻找thymeleaf页面@ResponseBody@RequestMapping("/pay/alipay")publicStringalipay(HttpSession session,Model model,@RequestParam("dona_money")float dona_money,@RequestParam("dona_id")int dona_id)throwsAlipayApiException{//把dona_id项目id 放在session中
        session.setAttribute("dona_id",dona_id);//生成订单号（支付宝的要求？）String time =newSimpleDateFormat("yyyyMMddHHmmss").format(newDate());String user = UUID.randomUUID().toString().replace("-","").toUpperCase();StringOrderNum= time+user;//调用封装好的方法（给支付宝接口发送请求）returnsendRequestToAlipay(OrderNum,dona_money,"ghjk");}/*
    参数1：订单号
    参数2：订单金额
    参数3：订单名称
     *///支付宝官方提供的接口privateStringsendRequestToAlipay(String outTradeNo,Float totalAmount,String subject)throwsAlipayApiException{//获得初始化的AlipayClientAlipayClient alipayClient =newDefaultAlipayClient(GATEWAY_URL,APP_ID,APP_PRIVATE_KEY,FORMAT,CHARSET,ALIPAY_PUBLIC_KEY,SIGN_TYPE);//设置请求参数AlipayTradePagePayRequest alipayRequest =newAlipayTradePagePayRequest();
        alipayRequest.setReturnUrl(RETURN_URL);
        alipayRequest.setNotifyUrl(NOTIFY_URL);//商品描述（可空）String body="";
        alipayRequest.setBizContent("{\"out_trade_no\":\""+ outTradeNo +"\","+"\"total_amount\":\""+ totalAmount +"\","+"\"subject\":\""+ subject +"\","+"\"body\":\""+ body +"\","+"\"product_code\":\"FAST_INSTANT_TRADE_PAY\"}");//请求String result = alipayClient.pageExecute(alipayRequest).getBody();return result;}

解释，在前端页面点击支付后，将跳转Controller的==alipay（）==方法

• alipay 方法会接收一些前端的参数
• alipay方法中再调用sendRequestToAlipay方法，sendRequestToAlipay方法中有支付宝官方给出的接口，只需在其中提供一些参数（支付宝严格规定的参数）

sendRequestToAlipay方法

• 除了需要提供之前设置好的私有属性（URL，公钥，私钥，网关等等）外，还需要提供的参数
• outTradeNo，订单号，必须为String64位，不能为空且不能重复
• totalAmount，支付金额，不能为空
• subject，订单名称，不能为空
• body，商品描述，可以为空

上面三个必填参数很重要且必须遵守支付宝的规定，在扫码支付的时候能看到且有用

跳转支付宝方法设置完毕，可以进行测试，首先我们在前端form表单中填入url访问刚刚写的controller方法

图示使用thymeleaf模板引擎

• 设置完毕后，启动项目，点击提交表单

该页面访问的是支付宝官方提供的页面，至此沙箱支付已经完成了一半，接下来还要写return（）方法使我们完成支付后有响应和页面跳转。

2.4、登陆支付宝沙箱账号

由于是沙箱环境，是虚拟的，所以上面那个支付宝扫码不能用真的支付宝去扫，而是需要下载一个沙箱支付宝APP

扫码进行下载

下载完成后的登陆账号密码，也是沙箱环境的账号和密码，同时支付时使用的密码也在其中

2.5、写支付完成后同步回调的方法

• 扫码（或输入密码）支付完成后，支付宝会自动调用我们之前设置好的RETURN_URL（其实是本机调用），所以这个地址可以是私网地址

• 如图所示，RETURN_URL的值为http://localhost:8080/returnUrl，所以我们在项目中完成这个方法的书写，让其调用
• 同样，还是在Controller中完成

@RequestMapping("/returnUrl")publicStringreturnUrlMethod(HttpServletRequest request,HttpSession session,Model model)throwsAlipayApiException,UnsupportedEncodingException{System.out.println("=================================同步回调=====================================");// 获取支付宝GET过来反馈信息Map<String,String> params =newHashMap<String,String>();Map<String,String[]> requestParams = request.getParameterMap();for(Iterator<String> 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]+",";}// 乱码解决，这段代码在出现乱码时使用
            valueStr =newString(valueStr.getBytes("ISO-8859-1"),"utf-8");
            params.put(name, valueStr);}System.out.println(params);//查看参数都有哪些//验证签名（支付宝公钥）boolean signVerified =AlipaySignature.rsaCheckV1(params, ALIPAY_PUBLIC_KEY, CHARSET, SIGN_TYPE);// 调用SDK验证签名//验证签名通过if(signVerified){// 商户订单号String out_trade_no =newString(request.getParameter("out_trade_no").getBytes("ISO-8859-1"),"UTF-8");// 支付宝交易流水号String trade_no =newString(request.getParameter("trade_no").getBytes("ISO-8859-1"),"UTF-8");// 付款金额float money =Float.parseFloat(newString(request.getParameter("total_amount").getBytes("ISO-8859-1"),"UTF-8"));System.out.println("商户订单号="+out_trade_no);System.out.println("支付宝交易号="+trade_no);System.out.println("付款金额="+money);//在这里编写自己的业务代码（对数据库的操作）/*
            ################################
            *///跳转到提示页面（成功或者失败的提示页面）
            model.addAttribute("flag",1);
            model.addAttribute("msg","支持");return"common/payTips";}else{//跳转到提示页面（成功或者失败的提示页面）
            model.addAttribute("flag",0);
            model.addAttribute("msg","支持");return"common/payTips";}}

• 图示框住的部分代码都是支付宝官方给出的一些回调操作，所以最好不要进行更改，个别参数的名称可以更改

• 对数据库进行操作的代码可以在该方法中进行，也可以在异步回调方法中进行
• 最后返回部分我返回的是thymeleaf页面，如果想直接返回String字符串或者其他类型数据库，可以在方法前面加上@ResponseBody注解

2.6、异步回调方法

• 上面为支付宝同步调用处理,但是官方建议应在异步调用方法中处理付款成功后的操作,但因异步调用的路径必须为公网地址,支付宝才可以发送请求给我们,故这里不写异步调用的方法了,需要注意的是,异步调用为post请求,且传递来的参数会多一些,但基本与同步调用的操作一致
• 异步回调方法必须为公网IP，因为这个URL地址是支付宝官方来调用我们本机的，是我们完成支付操作后，支付宝需要进行一些金额的处理（与银行对接）所以需要几秒的时间，当支付宝处理完成后异步的调用我们的notify方法（一般在这个方法中进行数据库的操作），这个过程异步进行，所以用户一般感觉不到（用户感觉到的是同步调用的方法）。
• 设置公网IP有两种方案，1、内网穿透，2、将项目部署到服务器，这里就不说了

• 如图为支付宝官方调用的图解

源码

这是一个比较老的基于springboot+thymeleaf的项目

项目源码