Spring Boot 3.4 实现支付宝支付集成，轻松搞定支付功能-51CTO.COM

支付宝支付集成是电商应用中常见的功能之一，今天我们将通过 Spring Boot 3.4 来实现这一功能，包括支付宝沙箱环境配置、内网穿透配置、支付请求参数的设置等步骤，确保你能快速上手并完成支付功能的集成。

支付宝沙箱环境配置

为了进行支付功能的测试，我们需要使用支付宝提供的沙箱环境。这是一个虚拟的支付环境，专门用于测试和调试。访问沙箱环境：支付宝沙箱 https://openhome.alipay.com/platform/appDaily.htm。使用沙箱时，可以采用默认的密钥进行测试，我们只需要获取以下几个关键数据：

支付宝的公钥和私钥
支付的网关地址
支付的APP ID

内网穿透配置

在本地开发时，我们通常会遇到接口请求的问题：如果外部系统需要调用我们的接口（比如支付宝返回支付结果），那么我们需要一个公网地址来接收这些回调请求。此时，内网穿透技术便派上了用场，它可以帮助我们将本地服务器暴露到公网。

通过使用如 Ngrok https://ngrok.com/ 或 Natapp https://natapp.cn 等工具，你可以为本地服务配置一个公网地址。免费版通常会提供一个随机生成的地址，这样你就能在外网测试接口了。

配置支付宝支付 SDK

在集成支付宝支付前，我们需要引入支付宝的 SDK。以下是添加依赖的 Maven 配置：

<dependency>
    <groupId>com.alipay.sdk</groupId>
    <artifactId>alipay-sdk-java</artifactId>
    <version>4.9.28.ALL</version>
</dependency>1.
2.
3.
4.
5.

接下来，我们在 application.yml 文件中配置支付宝相关信息：

server:
  port: 9090

alipay:
  appId: 9021000135634074
  appPrivateKey: <your-app-private-key>
  alipayPublicKey: <your-alipay-public-key>
  notifyUrl: http://v6tqyw.natappfree.cc/alipay/notify1.
2.
3.
4.
5.
6.
7.
8.

支付请求参数对象

为了创建支付请求，我们需要准备支付订单的基本信息，如订单号、金额、商品描述等。这些信息会通过支付宝的 API 发起请求。

定义一个支付请求对象 PayVO：

package com.icoderoad.dto;


import java.math.BigDecimal;


@Data
public class PayVO {
    private String outTradeNo; // 商户订单号
    private String subject;    // 订单名称
    private BigDecimal totalAmount; // 付款金额
    private String body;      // 商品描述
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.

支付接口实现

接下来，我们需要通过支付宝 SDK 创建支付客户端并发送支付请求。以下是实现的关键步骤：

package com.icoderoad.controller;


import com.icoderoad.config.AliPayConfig;
import com.icoderoad.dto.PayVO;
import com.alipay.api.DefaultAlipayClient;
import com.alipay.api.AlipayClient;
import com.alipay.api.request.AlipayTradePagePayRequest;
import com.alipay.api.AlipayApiException;
import com.alipay.api.response.AlipayTradePagePayResponse;
import org.springframework.web.bind.annotation.*;
import org.springframework.beans.factory.annotation.Autowired;


import javax.servlet.http.HttpServletResponse;
import java.util.UUID;


@RestController
@RequestMapping("/alipay")
public class AliPayController {


    @Autowired
    private AliPayConfig aliPayConfig;


    private static final String GATEWAY_URL = "https://openapi-sandbox.dl.alipaydev.com/gateway.do";
    private static final String CHARSET = "utf-8";
    private static final String SIGN_TYPE = "RSA2";


    @GetMapping("/pay")
    public void pay(PayVO payVO, HttpServletResponse response) throws Exception {
        // 创建支付客户端
        AlipayClient alipayClient = new DefaultAlipayClient(
            GATEWAY_URL,
            aliPayConfig.getAppId(),
            aliPayConfig.getAppPrivateKey(),
            "JSON",
            CHARSET,
            aliPayConfig.getAlipayPublicKey(),
            SIGN_TYPE
        );


        // 创建支付请求对象
        AlipayTradePagePayRequest request = new AlipayTradePagePayRequest();
        request.setNotifyUrl(aliPayConfig.getNotifyUrl());


        // 设置请求参数
        payVO.setOutTradeNo(UUID.randomUUID().toString());
        request.setBizContent("{\"out_trade_no\":\"" + payVO.getOutTradeNo() + "\","
                             + "\"total_amount\":\"" + payVO.getTotalAmount() + "\","
                             + "\"subject\":\"" + payVO.getSubject() + "\","
                             + "\"body\":\"" + payVO.getBody() + "\","
                             + "\"product_code\":\"FAST_INSTANT_TRADE_PAY\"}");


        // 设置回调接口
        request.setReturnUrl("http://localhost:9090/hello/pay");


        // 执行支付请求
        try {
            String form = alipayClient.pageExecute(request).getBody();
            response.setContentType("text/html;charset=" + CHARSET);
            response.getWriter().write(form);
            response.getWriter().flush();
            response.getWriter().close();
        } catch (AlipayApiException e) {
            e.printStackTrace();
        }
    }
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.

支付回调接口

支付宝支付成功后，会调用我们在 notifyUrl 中配置的回调接口。这时，我们需要在回调接口中处理支付结果，确认支付状态。

package com.icoderoad.controller;


import org.springframework.web.bind.annotation.*;


@RestController
@RequestMapping("/alipay")
public class AliPayCallbackController {


    @PostMapping("/notify")
    public void handleNotify(@RequestBody String notifyData) {
        // 处理支付结果通知
        // 例如：验证签名、更新订单状态等
    }
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.

测试支付

在集成完成后，你可以通过访问以下 URL 来测试支付流程：

http://localhost:9090/alipay/pay?subject=测试商品&total_amount=10001.

在支付宝沙箱环境中，输入测试账号和支付密码完成支付。支付成功后，支付宝将会回调我们的 notifyUrl，我们可以通过此接口接收支付结果并更新订单状态。

总结

通过上述步骤，我们成功地将支付宝支付集成到 Spring Boot 3.4 项目中，完成了支付功能的实现。这些操作不仅可以应用于本地开发环境，还可以通过内网穿透技术进行公网测试，确保支付宝支付功能在实际环境中的顺利运行。