Spring Boot 3.4 實(shí)現(xiàn)支付寶支付集成，輕松搞定支付功能
支付寶支付集成是電商應(yīng)用中常見的功能之一，今天我們將通過 Spring Boot 3.4 來實(shí)現(xiàn)這一功能，包括支付寶沙箱環(huán)境配置、內(nèi)網(wǎng)穿透配置、支付請(qǐng)求參數(shù)的設(shè)置等步驟，確保你能快速上手并完成支付功能的集成。
支付寶沙箱環(huán)境配置
為了進(jìn)行支付功能的測(cè)試，我們需要使用支付寶提供的沙箱環(huán)境。這是一個(gè)虛擬的支付環(huán)境，專門用于測(cè)試和調(diào)試。訪問沙箱環(huán)境：支付寶沙箱 https://openhome.alipay.com/platform/appDaily.htm。使用沙箱時(shí)，可以采用默認(rèn)的密鑰進(jìn)行測(cè)試，我們只需要獲取以下幾個(gè)關(guān)鍵數(shù)據(jù)：
- 支付寶的公鑰和私鑰
- 支付的網(wǎng)關(guān)地址
- 支付的APP ID
內(nèi)網(wǎng)穿透配置
在本地開發(fā)時(shí)，我們通常會(huì)遇到接口請(qǐng)求的問題：如果外部系統(tǒng)需要調(diào)用我們的接口（比如支付寶返回支付結(jié)果），那么我們需要一個(gè)公網(wǎng)地址來接收這些回調(diào)請(qǐng)求。此時(shí)，內(nèi)網(wǎng)穿透技術(shù)便派上了用場(chǎng)，它可以幫助我們將本地服務(wù)器暴露到公網(wǎng)。
通過使用如 Ngrok https://ngrok.com/ 或 Natapp https://natapp.cn 等工具，你可以為本地服務(wù)配置一個(gè)公網(wǎng)地址。免費(fèi)版通常會(huì)提供一個(gè)隨機(jī)生成的地址，這樣你就能在外網(wǎng)測(cè)試接口了。
配置支付寶支付 SDK
在集成支付寶支付前，我們需要引入支付寶的 SDK。以下是添加依賴的 Maven 配置：
<dependency>
<groupId>com.alipay.sdk</groupId>
<artifactId>alipay-sdk-java</artifactId>
<version>4.9.28.ALL</version>
</dependency>接下來，我們?cè)?nbsp;application.yml 文件中配置支付寶相關(guān)信息：
server:
port: 9090
alipay:
appId: 9021000135634074
appPrivateKey: <your-app-private-key>
alipayPublicKey: <your-alipay-public-key>
notifyUrl: http://v6tqyw.natappfree.cc/alipay/notify支付請(qǐng)求參數(shù)對(duì)象
為了創(chuàng)建支付請(qǐng)求，我們需要準(zhǔn)備支付訂單的基本信息，如訂單號(hào)、金額、商品描述等。這些信息會(huì)通過支付寶的 API 發(fā)起請(qǐng)求。
定義一個(gè)支付請(qǐng)求對(duì)象 PayVO：
package com.icoderoad.dto;
import java.math.BigDecimal;
@Data
public class PayVO {
private String outTradeNo; // 商戶訂單號(hào)
private String subject; // 訂單名稱
private BigDecimal totalAmount; // 付款金額
private String body; // 商品描述
}支付接口實(shí)現(xiàn)
接下來，我們需要通過支付寶 SDK 創(chuàng)建支付客戶端并發(fā)送支付請(qǐng)求。以下是實(shí)現(xiàn)的關(guān)鍵步驟：
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 {
// 創(chuàng)建支付客戶端
AlipayClient alipayClient = new DefaultAlipayClient(
GATEWAY_URL,
aliPayConfig.getAppId(),
aliPayConfig.getAppPrivateKey(),
"JSON",
CHARSET,
aliPayConfig.getAlipayPublicKey(),
SIGN_TYPE
);
// 創(chuàng)建支付請(qǐng)求對(duì)象
AlipayTradePagePayRequest request = new AlipayTradePagePayRequest();
request.setNotifyUrl(aliPayConfig.getNotifyUrl());
// 設(shè)置請(qǐng)求參數(shù)
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\"}");
// 設(shè)置回調(diào)接口
request.setReturnUrl("http://localhost:9090/hello/pay");
// 執(zhí)行支付請(qǐng)求
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();
}
}
}支付回調(diào)接口
支付寶支付成功后，會(huì)調(diào)用我們?cè)?nbsp;notifyUrl 中配置的回調(diào)接口。這時(shí)，我們需要在回調(diào)接口中處理支付結(jié)果，確認(rèn)支付狀態(tài)。
package com.icoderoad.controller;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/alipay")
public class AliPayCallbackController {
@PostMapping("/notify")
public void handleNotify(@RequestBody String notifyData) {
// 處理支付結(jié)果通知
// 例如：驗(yàn)證簽名、更新訂單狀態(tài)等
}
}測(cè)試支付
在集成完成后，你可以通過訪問以下 URL 來測(cè)試支付流程：
http://localhost:9090/alipay/pay?subject=測(cè)試商品&total_amount=1000在支付寶沙箱環(huán)境中，輸入測(cè)試賬號(hào)和支付密碼完成支付。支付成功后，支付寶將會(huì)回調(diào)我們的 notifyUrl，我們可以通過此接口接收支付結(jié)果并更新訂單狀態(tài)。
總結(jié)
通過上述步驟，我們成功地將支付寶支付集成到 Spring Boot 3.4 項(xiàng)目中，完成了支付功能的實(shí)現(xiàn)。這些操作不僅可以應(yīng)用于本地開發(fā)環(huán)境，還可以通過內(nèi)網(wǎng)穿透技術(shù)進(jìn)行公網(wǎng)測(cè)試，確保支付寶支付功能在實(shí)際環(huán)境中的順利運(yùn)行。
