Springboot支付宝沙箱支付（完整详细步骤）

沁禹2024-01-10 20:48

Springboot支付宝沙箱支付（完整详细步骤）

网页操作步骤

1.进入支付宝开发平台---沙箱环境

使用开发者账号登录开放平台控制平台

2.点击沙箱进入沙箱环境


说明：沙箱环境支持的产品，可以在沙箱控制台 沙箱应用 > 产品列表 中查看。

3.进入沙箱，配置接口加签方式

在沙箱进行调试前需要确保已经配置密钥/证书用于加签，支付宝提供了 系统 默认密钥 及 自定义密钥 两种方式进行配置。 这里我采取的是默认方式： 开发者如需使用系统默认密钥/证书，可在开发信息中选择系统默认密钥。注意:使用API在线调试工具调试OpenAPI必须使用系统默认密钥。

4.配置应用网关

应用网关用于接收支付宝沙箱环境的异步通知（对接 From 蚂蚁消息），如创建门店的被动通知。 注意：仅 HTTP 订阅模式的 From 蚂蚁消息才需要配置应用网关，WebSocket 订阅模式的 From 蚂蚁消息无需配置应用网关。

5.生成自己的密钥

到这，网页操作完成

IntelliJ IDEA 操作步骤

1.导入依赖

xml 复制代码 
<dependency>
   <groupId>com.alipay.sdk</groupId>
   <artifactId>alipay-sdk-java</artifactId>
   <version>4.22.110.ALL</version>
</dependency>

2.在 application.yml 里面进行配置：

yaml 复制代码 
alipay:
  appId: 
  appPrivateKey: 
  alipayPublicKey: 
  notifyUrl: （回调接口）

3.alipay的JAVA配置：AlipayConfig.java

读取yml中的配置信息，自动填充到对应的属性

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

}

4.支付接口 新建一个 AliPayController.java

  1. 在Controller中配置gateway_url（调用支付宝url的一个网关地址）、format（JSON形式）、charset（UTF-8）、sign_type（签名方式-rsa2
  2. 编写一个Get请求，（方法参数是一个AliPay的配置类里面包括自己生成的订单号、总金额、支付的名称、支付宝交易凭证号和HttpServletResponse）
  3. 创建Client（他是由通用SDK提供的Client，负责调用支付宝的API，设置参数包含网关地址、appid、密钥、公钥、format、charset、签名方式）----------------------->创建Client，他是由通用SDK提供的Client，负责调用支付宝的API
  4. 创建 AlipayTradePagePayRequest，配置notifyUrl并设置Request参数（参数包含订单号、总金额、支付的名称）（格式：JSON格式）------------------------->创建 Request并设置Request参数
  5. 通过AlipayClient执行request调用SDK生成表单，用HttpServletResponse（浏览器响应的一个流）写表单的内容，创建一个html的网页）--------------------------->执行请求，拿到响应的结果，返回给浏览器
java 复制代码 
@Data
public class AliPay {
    private String traceNo;
    private double totalAmount;
    private String subject;
    private String alipayTraceNo;
}
java 复制代码 
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();
}

5.在拦截器里面加上 忽略alipay接口的配置

踩坑：

url中有中文字符报错，更换依赖

官网提供有easy版和正式版

easy-sdk 好像不太支持中文的subject，否则 biz_content就会乱码，那我索性就用了 alipay-sdk 正式版的

6.回调接口

  1. 使用的Post接口，首先验证交易状态是否成功，获取request里面的信息

  2. 支付宝验签（使用的是AlipaySignature（通用SDK提供的类）获取一个String字符串将其与sign签名验证），通过后，使用OrderMapper更新到数据库）

    （使用的Post接口，因为官方建议处理付款成功后的操作在异步调用方法中，异步调用为post请求，异步回调方法必须为公网IP，因为支付宝是基于公网访问，访问不了localhost，需要代理，设置公网IP有两种方案，1、内网穿透，2、将项目部署到服务器，我们项目使用的是内网穿透，使用的是natapp，配置一条免费的隧道，在idea中配置notifyurl接口）

java 复制代码 
@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");

    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"));

      // 更新订单未已支付
      ordersMapper.updateState(tradeNo, "已支付", gmtPayment, alipayTradeNo);
    }
  }
  return "success";
}

退款流程

  1. 创建Client（他是由通用SDK提供的Client，负责调用支付宝的API）（参数包含网关地址、appid、密钥、公钥、format、charset、签名方式）---------------------->创建Client，通用SDK提供的Client，负责调用支付宝的API

  2. 创建 AlipayTradePagePayRequest，设置Request参数（参数包含支付宝回调的订单流水号、总金额、我的订单编号）（格式：JSON格式）---------------------------->创建 Request，设置参数

  3. 通过AlipayClient执行request获取response，通过isSuccess判断是否成功，成功后更新数据库状态------------->执行请求，更新数据库

java 复制代码 
@GetMapping("/return")
public Result returnPay(AliPay aliPay) throws AlipayApiException {
  // 7天无理由退款
  String now = DateUtil.now();
  Orders orders = ordersMapper.getByNo(aliPay.getTraceNo());
  if (orders != null) {
    // hutool工具类，判断时间间隔
    long between = DateUtil.between(
      DateUtil.parseDateTime(orders.getPaymentTime()),
      DateUtil.parseDateTime(now),
      DateUnit.DAY
    );
    if (between > 7) {
      return Result.error("-1", "该订单已超过7天，不支持退款");
    }
  }
  // 1. 创建Client，通用SDK提供的Client，负责调用支付宝的API
  AlipayClient alipayClient = new DefaultAlipayClient(
    GATEWAY_URL,
    aliPayConfig.getAppId(),
    aliPayConfig.getAppPrivateKey(),
    FORMAT,
    CHARSET,
    aliPayConfig.getAlipayPublicKey(),
    SIGN_TYPE
  );
  // 2. 创建 Request，设置参数
  AlipayTradeRefundRequest request = new AlipayTradeRefundRequest();
  JSONObject bizContent = new JSONObject();
  bizContent.set("trade_no", aliPay.getAlipayTraceNo()); // 支付宝回调的订单流水号
  bizContent.set("refund_amount", aliPay.getTotalAmount()); // 订单的总金额
  bizContent.set("out_request_no", aliPay.getTraceNo()); //  我的订单编号

  // 返回参数选项，按需传入
  //JSONArray queryOptions = new JSONArray();
  //queryOptions.add("refund_detail_item_list");
  //bizContent.put("query_options", queryOptions);

  request.setBizContent(bizContent.toString());

  // 3. 执行请求
  AlipayTradeRefundResponse response = alipayClient.execute(request);
  if (response.isSuccess()) { // 退款成功，isSuccess 为true
    System.out.println("调用成功");

    // 4. 更新数据库状态
    ordersMapper.updatePayState(aliPay.getTraceNo(), "已退款", now);
    return Result.success();
  } else { // 退款失败，isSuccess 为false
    System.out.println(response.getBody());
    return Result.error(response.getCode(), response.getBody());
  }
}

订单三十分钟未支付自动取消

使用消息队列

我们可以采用rabbitMQ的延时队列。RabbitMQ具有以下两个特性，可以实现延迟队列。

  1. RabbitMQ可以针对Queue和Message设置 x-message-tt，来控制消息的生存时间，如果超时，则消息变为dead letter

  2. RabbitMQ的Queue可以配置x-dead-letter-exchange 和x-dead-letter-routing-key（可选）两个参数，用来控制队列内出现了deadletter，则按照这两个参数重新路由。结合以上两个特性，就可以模拟出延迟消息的功能

优缺点

优点: 高效,可以利用rabbitmq的分布式特性轻易的进行横向扩展,消息支持持久化增加了可靠性。

缺点：本身的易用度要依赖于rabbitMq的运维.因为要引用rabbitMq,所以复杂度和成本变高。

  1. 用户下单之后，投递一个msg消息存放在msg服务器daunt，该消息msg消息过期时间为30分钟，一直未被订单消费者消费，消息会转移到死信交换机路由到死信队列中，被我们的死信消费者30分钟后消息。

  2. 死信消费者在根据订单号码查询支付订单状态，如果是未支付情况下，则将该订单设置未超时。 对筛选出来的订单号码进行核对校验:

    1.订单中是否存在 > 2.携带订单号码调用支付宝查询订单支付状态是否为待支付 > 3.更新该订单号码状态

相关推荐
长栎10 分钟前
写 for 循环写了十年，你却从没用过迭代器模式最狠的那一面
后端
LiaCode14 分钟前
Redis 在生产项目的使用
前端·后端
用户5598224812218 分钟前
Docker Compose Down 导致容器数据误删——ext4 日志恢复全记录
后端
LiaCode19 分钟前
一天学完 redis 的爽翻版核心知识总结
前端·后端
大刚测试开发实战20 分钟前
如何内网穿透访问本地私有化部署的TestHub
前端·后端·github
xiaodaoluanzha39 分钟前
迄今為止，最簡單的編程語言 Nolang
前端·后端
Csvn39 分钟前
Docker 容器管理入门 — 从镜像到容器编排
后端
用户7623524259144 分钟前
ShardingJDBC
后端
行者全栈架构师1 小时前
IDEA 中 Maven 项目的 15 个红色报错快速解决方法
java·后端
令人头秃的代码0_01 小时前
mac(m5)平台编译openjdk
java
热门推荐
012026年6月AI行业全景：从百模大战到Agent元年，这30天发生了什么？022026年6月AI大模型全景报告：GPT-5.6、Claude Opus 4.8、Gemini 3.5，中美AI三足鼎立谁主沉浮？032026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf04【AI】2026 年具身智能模型和世界模型总结05GitHub 镜像站点06AI科技热点日报 | 2026年6月1日072026 AI 编程工具终极实战指南：Cursor vs Claude Code vs Copilot，开发者该怎么选？08AI一周事件 · 2026-06-03 至 2026-06-0909上线仅72小时被强制下架：Claude Fable 5 的短命10Claude Code、Codex、Cursor三分天下：2026年AI编程Agent生态全景剖析