Springboot集成支付宝沙箱支付（完整版）

ゝ一世哀愁。 2023-09-30 14:19 7阅读 0赞

### 开发前准备 ###

easy支付官方文档：[https://opendocs.alipay.com/open/009ys9][https_opendocs.alipay.com_open_009ys9]  
通用版文档：[https://opendocs.alipay.com/open/02np94][https_opendocs.alipay.com_open_02np94]

### 支付宝沙箱的配置 ###

注册支付宝开发者账户，进入开发者控制台  
[https://openhome.alipay.com/platform/developerIndex.htm][https_openhome.alipay.com_platform_developerIndex.htm]

进入沙箱：  
![img][]  
沙箱的界面：  
![img][img 1]

### Java集成沙箱支付 ###

下载依赖

<dependency>
        <groupId>com.alipay.sdk</groupId>
        <artifactId>alipay-easysdk</artifactId>
        <version>2.2.0</version>
    </dependency>

在 application.yml 里面进行配置：

alipay:
      appId: 
      appPrivateKey: 
      alipayPublicKey: 
      notifyUrl:

alipay的java配置：AplipayConfig.java

import com.alipay.easysdk.factory.Factory;
    import com.alipay.easysdk.kernel.Config;
    import lombok.Data;
    import org.springframework.boot.context.properties.ConfigurationProperties;
    import org.springframework.stereotype.Component;
    
    import javax.annotation.PostConstruct;
    
    @Data
    @Component
    @ConfigurationProperties(prefix = "alipay")
    public class AliPayConfig {
        
        private String appId;
        private String appPrivateKey;
        private String alipayPublicKey;
        private String notifyUrl;
    
    
        @PostConstruct
        public void init() {
        
            // 设置参数（全局只需设置一次）
            Config config = new Config();
            config.protocol = "https";
            config.gatewayHost = "openapi.alipaydev.com";
            config.signType = "RSA2";
            config.appId = this.appId;
            config.merchantPrivateKey = this.appPrivateKey;
            config.alipayPublicKey = this.alipayPublicKey;
            config.notifyUrl = this.notifyUrl;
            Factory.setOptions(config);
            System.out.println("=======支付宝SDK初始化成功=======");
        }
    
    }

#### 支付接口 ####

新建一个 AliPayController.java

参数 Alipay.java

import lombok.Data;
    
    @Data
    public class AliPay {
        
        private String traceNo;
        private double totalAmount;
        private String subject;
        private String alipayTraceNo;
    }

`**注意：在拦截器里面加上 忽略alipay接口的配置，这很重要！**`  
![img][img 2]

#### 接口测试 ####

然后我们访问URL进行测试，测试的url格式：`http://localhost:9090/alipay/pay?subject=xxx&traceNo=xxx&totalAmount=1000`

**大坑!!!：url中文问题**

错误截图：  
![img][img 3]  
类似这样的url：`http://localhost:9090/alipay/pay?subject=中文&traceNo=121313123&totalAmount=1000`  
在请求后就会出现上面的错误！

解决方式：暂时替换url中的中文字符，换成这样的：  
`http://localhost:9090/alipay/pay?subject=112233&traceNo=121313123&totalAmount=1000`

这样就正常了：  
![在这里插入图片描述][1da6f99d09e84bd8a53161aa88215b5e.png]

然后使用沙箱账号登录，支付就可以  
https://open.alipay.com/platform/appDaily.htm?tab=account  
![img][img 4]

### 回调接口 ###

import com.alipay.easysdk.factory.Factory;
    import com.alipay.easysdk.payment.page.models.AlipayTradePagePayResponse;
    import com.example.springboot.controller.dto.AliPay;
    import com.example.springboot.mapper.OrdersMapper;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.PostMapping;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    import javax.annotation.Resource;
    import javax.servlet.http.HttpServletRequest;
    import java.util.HashMap;
    import java.util.Map;
    
    @RestController
    @RequestMapping("/alipay")
    public class AliPayController {
        
    
        @PostMapping("/notify")  // 注意这里必须是POST接口
        public String payNotify(HttpServletRequest request) throws Exception {
        
            if (request.getParameter("trade_status").equals("TRADE_SUCCESS")) {
        
                System.out.println("=========支付宝异步回调========");
    
                Map<String, String> params = new HashMap<>();
                Map<String, String[]> requestParams = request.getParameterMap();
                for (String name : requestParams.keySet()) {
        
                    params.put(name, request.getParameter(name));
                    // System.out.println(name + " = " + request.getParameter(name));
                }
    
                String tradeNo = params.get("out_trade_no");
                String gmtPayment = params.get("gmt_payment");
                String alipayTradeNo = params.get("trade_no");
                // 支付宝验签
                if (Factory.Payment.Common().verifyNotify(params)) {
        
                    // 验签通过
                    System.out.println("交易名称: " + params.get("subject"));
                    System.out.println("交易状态: " + params.get("trade_status"));
                    System.out.println("支付宝交易凭证号: " + params.get("trade_no"));
                    System.out.println("商户订单号: " + params.get("out_trade_no"));
                    System.out.println("交易金额: " + params.get("total_amount"));
                    System.out.println("买家在支付宝唯一id: " + params.get("buyer_id"));
                    System.out.println("买家付款时间: " + params.get("gmt_payment"));
                    System.out.println("买家付款金额: " + params.get("buyer_pay_amount"));
    
                    // 更新订单未已支付
                    ordersMapper.updateState(tradeNo, "已支付", gmtPayment, alipayTradeNo);
                }
            }
            return "success";
        }
    
    
    }

#### 内网穿透：https://natapp.cn/ ####

配置免费的隧道，端口：9090：  
![img][img 5]  
软件下载地址：  
https://pan.baidu.com/s/192MYFg0Gh3P87wW-Tj4ivQ?pwd=uuqu

下载好软件后，打开配置下authtoken：  
![在这里插入图片描述][4403bf72804841f3b4d663cc5bd96fa1.png]  
![img][img 6]  
然后双击启动 **start.bat** 即可。

看到这个表示你启动成功了：  
![img][img 7]

#### idea里面配置notify接口并测试 ####

更改 application.yml 里的配置：  
![img][img 8]  
我们可以在 idea里面对回调的notifyUrl进行debug测试，看看支付成功之后会不会回调：  
![在这里插入图片描述][cf53cab7c79e4ea8b8e0e63193c1852d.png]

附：AlipayController完整代码

import com.alipay.easysdk.factory.Factory;
    import com.alipay.easysdk.payment.page.models.AlipayTradePagePayResponse;
    import com.example.springboot.controller.dto.AliPay;
    import com.example.springboot.mapper.OrdersMapper;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.PostMapping;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    import javax.annotation.Resource;
    import javax.servlet.http.HttpServletRequest;
    import java.net.URLEncoder;
    import java.util.HashMap;
    import java.util.Map;
    
    @RestController
    @RequestMapping("/alipay")
    public class AliPayController {
        
    
        @Resource
        private OrdersMapper ordersMapper;
    
        @GetMapping("/pay") // &subject=xxx&traceNo=xxx&totalAmount=xxx
        public String pay(AliPay aliPay) {
        
            AlipayTradePagePayResponse response;
            try {
        
                //  发起API调用（以创建当面付收款二维码为例）
                response = Factory.Payment.Page()
                        .pay(URLEncoder.encode(aliPay.getSubject(), "UTF-8"), aliPay.getTraceNo(), aliPay.getTotalAmount(), "");
            } catch (Exception e) {
        
                System.err.println("调用遭遇异常，原因：" + e.getMessage());
                throw new RuntimeException(e.getMessage(), e);
            }
            return response.getBody();
        }
    
        @PostMapping("/notify")  // 注意这里必须是POST接口
        public String payNotify(HttpServletRequest request) throws Exception {
        
            if (request.getParameter("trade_status").equals("TRADE_SUCCESS")) {
        
                System.out.println("=========支付宝异步回调========");
    
                Map<String, String> params = new HashMap<>();
                Map<String, String[]> requestParams = request.getParameterMap();
                for (String name : requestParams.keySet()) {
        
                    params.put(name, request.getParameter(name));
                    // System.out.println(name + " = " + request.getParameter(name));
                }
    
                String tradeNo = params.get("out_trade_no");
                String gmtPayment = params.get("gmt_payment");
                String alipayTradeNo = params.get("trade_no");
                // 支付宝验签
                if (Factory.Payment.Common().verifyNotify(params)) {
        
                    // 验签通过
                    System.out.println("交易名称: " + params.get("subject"));
                    System.out.println("交易状态: " + params.get("trade_status"));
                    System.out.println("支付宝交易凭证号: " + params.get("trade_no"));
                    System.out.println("商户订单号: " + params.get("out_trade_no"));
                    System.out.println("交易金额: " + params.get("total_amount"));
                    System.out.println("买家在支付宝唯一id: " + params.get("buyer_id"));
                    System.out.println("买家付款时间: " + params.get("gmt_payment"));
                    System.out.println("买家付款金额: " + params.get("buyer_pay_amount"));
    
                    // 更新订单未已支付
                    ordersMapper.updateState(tradeNo, "已支付", gmtPayment, alipayTradeNo);
                }
            }
            return "success";
        }
    }

至此，集成完毕！撒花！坑太多了！@！！

\------------------------------------更新--------------------------------------------

**解决subject中文问题**

貌似这是 easy-sdk 本身的问题，它不支持中文的subject，否则 biz\_content就会乱码，那我索性就用了 alipay-sdk 完整版的

pom:

<dependency>
       <groupId>com.alipay.sdk</groupId>
       <artifactId>alipay-sdk-java</artifactId>
       <version>4.22.110.ALL</version>
    </dependency>

我们把AplipayController.java 改造下：

import com.alipay.api.AlipayApiException;
    import com.alipay.api.AlipayClient;
    import com.alipay.api.DefaultAlipayClient;
    import com.alipay.api.request.AlipayTradePagePayRequest;
    import com.alipay.easysdk.factory.Factory;
    import com.example.springboot.config.AliPayConfig;
    import com.example.springboot.controller.dto.AliPay;
    import com.example.springboot.mapper.OrdersMapper;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.PostMapping;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    import javax.annotation.Resource;
    import javax.servlet.http.HttpServletRequest;
    import javax.servlet.http.HttpServletResponse;
    import java.util.HashMap;
    import java.util.Map;
    
    // 完整版 sdk 解决了  subject中文乱码问题
    @RestController
    @RequestMapping("/alipay")
    public class AliPayController {
        
    
    	@GetMapping("/pay") // &subject=xxx&traceNo=xxx&totalAmount=xxx
        public void pay(AliPay aliPay, HttpServletResponse httpResponse) throws Exception {
        
            AlipayClient alipayClient = new DefaultAlipayClient(GATEWAY_URL, aliPayConfig.getAppId(),
                    aliPayConfig.getAppPrivateKey(), FORMAT, CHARSET, aliPayConfig.getAlipayPublicKey(), SIGN_TYPE);
            AlipayTradePagePayRequest request = new AlipayTradePagePayRequest();
            request.setNotifyUrl(aliPayConfig.getNotifyUrl());
            request.setBizContent("{\"out_trade_no\":\"" + aliPay.getTraceNo() + "\","
                    + "\"total_amount\":\"" + aliPay.getTotalAmount() + "\","
                    + "\"subject\":\"" + aliPay.getSubject() + "\","
                    + "\"product_code\":\"FAST_INSTANT_TRADE_PAY\"}");
            String form = "";
            try {
        
                form = alipayClient.pageExecute(request).getBody(); // 调用SDK生成表单
            } catch (AlipayApiException e) {
        
                e.printStackTrace();
            }
            httpResponse.setContentType("text/html;charset=" + CHARSET);
            httpResponse.getWriter().write(form);// 直接将完整的表单html输出到页面
            httpResponse.getWriter().flush();
            httpResponse.getWriter().close();
        }
        
    }

然后再重启，试试：  
![img][img 9]  
可以看到 url 中的中文已经正常了，并且支付页面出来了：  
![img][img 10]

[https_opendocs.alipay.com_open_009ys9]: https://opendocs.alipay.com/open/009ys9
[https_opendocs.alipay.com_open_02np94]: https://opendocs.alipay.com/open/02np94
[https_openhome.alipay.com_platform_developerIndex.htm]: https://openhome.alipay.com/platform/developerIndex.htm
[img]: https://img-blog.csdnimg.cn/3147eee6a65842129c19ce49dcc70584.png
[img 1]: https://img-blog.csdnimg.cn/692a21898c364186b5ef33d32cba8b05.png
[img 2]: https://img-blog.csdnimg.cn/a2d236d6a343422082510940e66c47d1.png
[img 3]: https://img-blog.csdnimg.cn/6db00ae9a6ea4402843d34a837f6f207.png
[1da6f99d09e84bd8a53161aa88215b5e.png]: https://img-blog.csdnimg.cn/1da6f99d09e84bd8a53161aa88215b5e.png
[img 4]: https://img-blog.csdnimg.cn/425e77c892994aa0bcb05fedeb35507f.png
[img 5]: https://img-blog.csdnimg.cn/1ccb65661df74df38fc5f757138b20ba.png
[4403bf72804841f3b4d663cc5bd96fa1.png]: https://img-blog.csdnimg.cn/4403bf72804841f3b4d663cc5bd96fa1.png
[img 6]: https://img-blog.csdnimg.cn/f2c384937aff49dc8b464aedb2741831.png
[img 7]: https://img-blog.csdnimg.cn/c9620001c76b4f26894d773fd303436b.png
[img 8]: https://img-blog.csdnimg.cn/91dc94dc5afe497080fc02c79685fcad.png
[cf53cab7c79e4ea8b8e0e63193c1852d.png]: https://img-blog.csdnimg.cn/cf53cab7c79e4ea8b8e0e63193c1852d.png
[img 9]: https://img-blog.csdnimg.cn/23becaf2bc264862a78f5381834b46bb.png
[img 10]: https://img-blog.csdnimg.cn/9fed97a71ab2460b85e3f1f6c81d681d.png