1、准备工作

支付宝开放平台 (alipay.com)

支付文档

登录支付宝开放平台获取沙箱环境信息

image-20231015170418148

控制台

image-20231015170458437

沙箱应用信息

image-20231015170649148

密钥信息

image-20231015170923991

2、整合SpringBoot

依赖

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<dependency>
<groupId>com.alipay.sdk</groupId>
<artifactId>alipay-sdk-java</artifactId>
<version>4.22.110.ALL</version>
</dependency>


<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>

在application.yaml中配置

1
2
3
4
5
alipay:
appId: #APPID
appPrivateKey: #私钥
alipayPublicKey: #公钥
notifyUrl: #异步回调地址

配置AliPayConfig

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
@Data
@Component
@ConfigurationProperties(prefix = "alipay")
public class AliPayConfig {
/**
* APPID
*/
private String appId;
/**
* 应用私钥
*/
private String appPrivateKey;
/**
* 支付公钥
*/
private String alipayPublicKey;
/**
* 异步回调地址
*/
private String notifyUrl;


/**
* 支付宝网关地址
* 旧版地址:https://openapi.alipaydev.com/gateway.do
* 新版沙箱网关地址
*/
private final String GATEWAY_URL = "https://openapi-sandbox.dl.alipaydev.com/gateway.do";

/**
* 参数返回格式
*/
private final String FORMAT = "JSON";
/**
* 编码集,支持 GBK/UTF-8。
*/
private final String CHARSET = "UTF-8";
/**
* 生成签名字符串所使用的签名算法类型,目前支持 RSA2 算法。
*/
private final String SIGN_TYPE = "RSA2";

}

新建AliPayController

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
@Slf4j
@RestController
@RequestMapping("/alipay")
@RequiredArgsConstructor
public class AliPayController {


private final AliPayConfig aliPayConfig;


@GetMapping("/pay")
public void pay(HttpServletResponse response) throws IOException {
// 1. 创建Client,通用SDK提供的Client,负责调用支付宝的API
AlipayClient alipayClient = new DefaultAlipayClient(aliPayConfig.getGATEWAY_URL(), aliPayConfig.getAppId(),
aliPayConfig.getAppPrivateKey(), aliPayConfig.getFORMAT(), aliPayConfig.getCHARSET(), aliPayConfig.getAlipayPublicKey(), aliPayConfig.getSIGN_TYPE()); //获得初始化的AlipayClient

// 2. 创建 Request并设置Request参数
AlipayTradeWapPayRequest alipayRequest = new AlipayTradeWapPayRequest();//创建API对应的request

alipayRequest.setNotifyUrl(aliPayConfig.getNotifyUrl()); //设置异步回调地址

alipayRequest.setBizContent("{" +
" \"out_trade_no\":\"1000120\"," + //自己生成的订单编号
" \"total_amount\":11," + //订单的总金额
" \"subject\":\"iphone11\"," + //支付的名称
// " \"product_code\":\"QUICK_WAP_WAY\"" +
" \"product_code\":\"FAST_INSTANT_TRADE_PAY\"" +
" }");//填充业务参数

// 执行请求,拿到响应的结果,返回给浏览器
String form = "";
try {
form = alipayClient.pageExecute(alipayRequest).getBody(); // 调用SDK生成表单
} catch (AlipayApiException e) {
e.printStackTrace();
}
response.setContentType("text/html;charset=" + aliPayConfig.getCHARSET());
response.getWriter().write(form); //直接将完整的表单html输出到页面
response.getWriter().flush();
response.getWriter().close();
}

}

测试

访问 localhost:8881/alipay/pay

image-20231015181912442

搭建内网穿透

内网穿透是为了在沙箱支付的时候,在支付完成后,想回调自己项目的页面,支付宝不可以直接访问你本机的路径,必须要通过生成的外网来回到自己的项目页面,这个时候就需要内网穿透。这里使用natapp。

官网:https://natapp.cn/

下载natapp

image-20231015182308677

购买隧道(免费)

image-20231015182329401

配置端口和本地项目环境一致

image-20231015182939718

在natapp同级目录新建config.ini

image-20231015182555446

填写自己的authtoken

1
2
3
4
5
6
7
8
9
#将本文件放置于natapp同级目录 程序将读取 [default] 段
#在命令行参数模式如 natapp -authtoken=xxx 等相同参数将会覆盖掉此配置
#命令行参数 -config= 可以指定任意config.ini文件
[default]
authtoken= #对应一条隧道的authtoken
clienttoken= #对应客户端的clienttoken,将会忽略authtoken,若无请留空,
log=none #log 日志文件,可指定本地文件, none=不做记录,stdout=直接屏幕输出 ,默认为none
loglevel=ERROR #日志等级 DEBUG, INFO, WARNING, ERROR 默认为 DEBUG
http_proxy= #代理设置 如 http://10.123.10.10:3128 非代理上网用户请务必留空

双击natapp.exe运行

image-20231015183031245

配置notify异步回调

支付完成后第三方支付系统会主动通知支付结果,要实现主动通知需要在请求支付系统下单时传入NotifyUrl,这里有两个url:NotifyUrl和ReturnUrl,ReturnUrl是支付完成后支付系统携带支付结果重定向到ReturnUrl地址,NotifyUrl是支付完成后支付系统在后台定时去通知,使用NotifyUrl比使用ReturnUrl有保证。

1
2
3
4
alipay:                
notifyUrl: http://wf5mtk.natappfree.cc/alipay/notify

#returnUrl: http://localhost:8080/appoint/waitplayment #可选配置 前端支付完成后要去的页面路径

编写回调接口(被动接收支付结果)

image-20231015184149002

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
@PostMapping("/notify")  // 注意这里必须是POST接口
public String payNotify(HttpServletRequest request) throws AlipayApiException {
if (request.getParameter("trade_status").equals("TRADE_SUCCESS")) {
log.info("=========支付宝异步回调============");
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 outTradeNo = params.get("out_trade_no");
String gmtPayment = params.get("gmt_payment");
//支付宝交易号
String alipayTradeNo = params.get("trade_no");
String sign = params.get("sign");
String content = AlipaySignature.getSignCheckContentV1(params);
boolean checkSignature = AlipaySignature.rsa256CheckContent(content, sign, aliPayConfig.getAlipayPublicKey(), "UTF-8"); // 验证签名

// 支付宝验签
if (checkSignature) {
// 验签通过
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"));


// 根据自己的业务逻辑完成下面的订单更新
// 查询订单
}
}

return "success";
}

测试回调

访问 localhost:8881/alipay/pay

主动查询支付结果

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
AlipayClient alipayClient = new DefaultAlipayClient(GATEWAY_URL, aliPayConfig.getAppId(),
aliPayConfig.getAppPrivateKey(), FORMAT, CHARSET, aliPayConfig.getAlipayPublicKey(), SIGN_TYPE);
AlipayTradeQueryRequest request = new AlipayTradeQueryRequest();
JSONObject bizContent = new JSONObject();
bizContent.put("out_trade_no", 10001230); //根据订单编号查询
//bizContent.put("trade_no", "2014112611001004680073956707");
request.setBizContent(bizContent.toString());
AlipayTradeQueryResponse response = null;
try {
response = alipayClient.execute(request);
if (!response.isSuccess()) {
XczxPlusException.cast("请求支付查询查询失败");
} else {
System.out.println("调用成功");
}

} catch (AlipayApiException e) {
// e.printStackTrace();
log.error("请求支付宝查询支付结果异常:{}", e.getMessage(), e);
XczxPlusException.cast("请求支付查询支付结果异常");
}
String body = response.getBody();

Map resultMap = JSON.parseObject(body, Map.class);
Map map = (Map) resultMap.get("alipay_trade_query_response");

//解析支付结果
//(String) map.get("trade_no")

项目工程结构

image-20231015191354074

4、附

生成二维码组件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<!-- 二维码生成&识别组件 -->
<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>

工具类

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
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();
// http://192.168.101.1:63030/orders/apipaytest
//支付宝支付地址 http://n2x659.natappfree.cc/orders/apipaytest
System.out.println(qrCodeUtil.createQRCode("http://n2x659.natappfree.cc/orders/apipaytest", 200, 200));
}

}

运行会得到一个base63串

1
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAMgAAADIAQAAAACFI5MzAAABQElEQVR42u2YPZKDMAyF5aFIuUfIUThafDSOwhEoUzC8fZKMySSbrVI8ZuICBX8uIvtZPxjeDfuSf8liPi7LFSgrzRTvV3XCKawXYLptFobviz6ZzB2xEfTjhyS9OwXB3A7jbMSngLOQ0I4v2AZf96wqTWJ9+9/dYEHSx2RYqfg/oqUgiX3nFBVfcCepcSbiJP67iwZ1G+5+Am7kyTzW9OcW/kRAX+QJ953+uCl8zO5PV5UsaffUp8rqP5+jiySJU8jtNxcNrysetCNK6A/V4lEQeU+xa0eZREE1tOTpFYod0VKXsKCqvRqMkW5pkza8Ggy3WgEuTvZcz0dcUBc+9MneL1DqkXjQz0eaZA1LqVtmzcMffTKPiPwz1mh2zkGyNwtT9kguTVI7LWv6ul7DCpOjX9iaGV66HDny/ZL1WfILfc/hMHLUpekAAAAASUVORK5CYII=

参数AliPay.java

1
2
3
4
5
6
7
@Data
public class AliPay {
private String traceNo;
private double totalAmount;
private String subject;
private String alipayTraceNo;
}