Springboot整合支付宝沙箱支付，保姆级教程。

Springboot整合支付宝沙箱支付

官方文档
https://opendocs.alipay.com/open/270/01didh

申请支付宝沙箱支付账号

https://open.alipay.com/develop/sandbox/app

这里开启公钥和私钥

查看自己的公钥和私钥，这个后面要在项目里配置的

在pom文件中导入alipay的依赖

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

hutool工具

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.7.20</version>
</dependency>

在 application 里面进行配置

appId在沙箱支付应用首页输入自己的appID
appPrivateKey是复制自己的私钥
alipayPublicKey是复制公钥
notifyUrl是回调页面后面的内网穿透会说
yml

alipay:
    appId: 
    appPrivateKey: 
    alipayPublicKey: 
    notifyUrl: 

properties

alipay.appId=
alipay.appPrivateKey=
alipay.alipayPublicKey=
alipay.notifyUrl=  

在Config中添加类AlipayConfig.java

只需要获取配置alipay的参数即可，为了和配置文件的同步

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Data
@Component
@ConfigurationProperties(prefix = "alipay")
public class AliPayConfig {
    private String appId;
    private String appPrivateKey;
    private String alipayPublicKey;
    private String notifyUrl;

}

在Bean中添加类AliPay.java

import lombok.Data;

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

在Controller中添加类AliPayController.java

*只需要复制即可：唯一要注意的是如果你项目有JWT验证的话记得要把alipay的路径放开，不然会被拦截
有两个请求一个是pay：是支付请求，基本不用改照抄就可以。
还有一个是notify：是支付宝沙箱支付完成后回调请求，这个回调在内网穿透可以实现，里面要修改自己项目的业务逻辑例如更新订单状态等。

import cn.hutool.json.JSONObject;
import com.alipay.api.AlipayApiException;
import com.alipay.api.AlipayClient;
import com.alipay.api.DefaultAlipayClient;
import com.alipay.api.internal.util.AlipaySignature;
import com.alipay.api.request.AlipayTradePagePayRequest;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.example.alipay.common.AliPayConfig;
import com.example.alipay.dao.OrdersMapper;
import com.example.alipay.entity.Orders;
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.Date;
import java.util.HashMap;
import java.util.Map;

// [email protected]
// 9428521.24 - 30 = 9428491.24 + 30 = 9428521.24
@RestController
@RequestMapping("/alipay")
public class AliPayController {

    private static final String GATEWAY_URL = "https://openapi.alipaydev.com/gateway.do";
    private static final String FORMAT = "JSON";
    private static final String CHARSET = "UTF-8";
    //签名方式
    private static final String SIGN_TYPE = "RSA2";

    @Resource
    private AliPayConfig aliPayConfig;

    @Resource
    private OrdersMapper ordersMapper;

    @GetMapping("/pay") // &subject=xxx&traceNo=xxx&totalAmount=xxx
    public void pay(AliPay aliPay, HttpServletResponse httpResponse) throws Exception {
        // 1. 创建Client，通用SDK提供的Client，负责调用支付宝的API
        AlipayClient alipayClient = new DefaultAlipayClient(GATEWAY_URL, aliPayConfig.getAppId(),
                aliPayConfig.getAppPrivateKey(), FORMAT, CHARSET, aliPayConfig.getAlipayPublicKey(), SIGN_TYPE);

        // 2. 创建 Request并设置Request参数
        AlipayTradePagePayRequest request = new AlipayTradePagePayRequest();  // 发送请求的 Request类
        request.setNotifyUrl(aliPayConfig.getNotifyUrl());
        JSONObject bizContent = new JSONObject();
        bizContent.set("out_trade_no", aliPay.getTraceNo());  // 我们自己生成的订单编号
        bizContent.set("total_amount", aliPay.getTotalAmount()); // 订单的总金额
        bizContent.set("subject", aliPay.getSubject());   // 支付的名称
        bizContent.set("product_code", "FAST_INSTANT_TRADE_PAY");  // 固定配置
        request.setBizContent(bizContent.toString());

        // 执行请求，拿到响应的结果，返回给浏览器
        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();
    }


	//这个接口是支付完成以后支付宝沙箱回调接口
    @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 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"));


				// 根据自己的业务逻辑完成下面的订单更新
                // 查询订单
                QueryWrapper<Orders> queryWrapper = new QueryWrapper<>();
                queryWrapper.eq("orderid", outTradeNo);
                Orders orders = ordersMapper.selectOne(queryWrapper);
				//如果订单不为空就更新订单状态变成已支付同时更新订单支付时间
                if (orders != null) {
                    orders.setAlipayNo(alipayTradeNo);
                    orders.setPayTime(new Date());
                    orders.setState("已支付");
                    ordersMapper.updateById(orders);
                }
            }
        }
        return "success";
    }
}

开始使用

直接用pay的路径进行测试，因为notify还没有设置回调路径，在下面内网穿透实现。
测试格式：&subject=xxx&traceNo=xxx&totalAmount=xxx
例如：我的端口是9099 然后随便输入一个商品名称、随便输入一个traceNo也就是订单编号，输入一个价格
localhost:9099/alipay/pay?&subject=香蕉&traceNo=20230111120609&totalAmount=6.99
一个traceNo只能支付一次，订单编号可以根据自己业务的情况定，一定要是唯一的！
例如我在下单的时候我的订单编号格式

    	  Date date = new Date();
          String orderon=new SimpleDateFormat("yyyyMMddhhmmss").format(date) ;

输入沙箱支付的邮箱和密码

支付完成，这个时候是没有回调页面的，也不能来写我们自己的业务逻辑，比如支付完订单后我们要更新订单状态和支付时间，这个时候就要进行下一步内网穿透

内网穿透

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

下载natapp

选择自己的客户端版本

购买隧道（免费）

一个账号可以购买两次免费的隧道

配置隧道

配置隧道主要配置端口和后端项目路径一致，例如我的是9099。
authtoken在下面要用到，在终端中获取外网网址。

获取外网

注意不要用校园网！！！！
打开终端，来到下载natapp的路径
输入：./natapp -authtoken=23*******748
这个token是在申请完隧道后可以查看自己的token

这个就是生成的外网

将生成的外网写到配置文件中

将获取到的外网路径放到配置文件中，每次启动项目都要获取一次，因为这个是会变的。
格式
alipay.notifyUrl= http://u726k7.natappfree.cc/alipay/notify
然后再加入回调页面的路径，就是你前端支付完成后要去的页面路径
例如我的：alipay.returnUrl=http://localhost:8080/appoint/waitplayment

查看自己的端口是不是在线了

在AlipayConfig.java 加一个属性：returnUrl

AliPayController.java的pay接口设置回调的url：request.setReturnUrl(aliPayConfig.getReturnUrl());

前端页面调用

格式
window.open(‘http://localhost:9090/alipay/pay?traceNo=’ + XXX + “&totalAmount=” + XXX + ‘&subject=’ + XXX)
例如我在支付按钮绑定函数pay

在支付完成后，等待几秒他会自动跳转会设置的URL