Java基于沙箱环境实现支付宝支付

news2024/12/23 22:42:58

一、支付宝沙箱环境介绍

沙箱环境是支付宝开放平台为开发者提供的安全低门槛的测试环境，开发者在沙箱环境中调用接口无需具备所需的商业资质，无需绑定和开通产品，同时不会对生产环境中的数据造成任何影响。合理使用沙箱环境，可以让研发流程与商业流程并行，降低联调资损风险，加速项目的交付。更为详细的说明可以看官方文档：小程序文档 - 支付宝文档中心

二、沙箱环境准备

2.1 注册入驻支付宝开放平台

登录支付宝开放平台，支付宝开放平台，找到开发接入入驻为开发者。

2.2 配置沙箱环境

进入到开发者的控制台，找到最下方的开发者工具推荐，点击沙箱。

2.3 创建沙箱应用

获取支付参数信息

创建沙箱应用后，需要拿到3个参数，appId，应用私钥，支付宝公钥，用于对接支付接口使用。

买家和商家账户信息

在沙箱账号中，可以看到买家和商家的账号信息以及账号余额。当支付时填写买家对应信息，支付成功会看到买家余额减少，卖余额增加。

三、Java实现支付宝支付

支付的整体逻辑是，引入sdk依赖，配置对应的支付参数，调用支付接口支付，等待支付成功后执行回调接口逻辑。如果希望看到详细说明，也可参看官方文档：小程序文档 - 支付宝文档中心，下面主要是简化业务步骤，记录核心关键步骤。

3.1 引入SDK的Maven依赖

<!-- https://mvnrepository.com/artifact/com.alipay.sdk/alipay-easysdk -->
<dependency>
    <groupId>com.alipay.sdk</groupId>
    <artifactId>alipay-easysdk</artifactId>
    <version>2.2.2</version>
</dependency>

3.2 配置支付参数

3.3 编写支付属性配置类

import com.alipay.easysdk.factory.Factory;
import com.alipay.easysdk.kernel.Config;
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

import javax.annotation.PostConstruct;

@Component
@ConfigurationProperties(prefix = "alipay")
@Data
public class AlipayConfig {
    // 应用Id
    private String appId;
    // 应用私有 
    private String appPrivateKey;
    // 支付宝公钥 
    private String publiceKey;
    // 回调接口路径 
    private String notifyUrl;

    @PostConstruct
    public void init(){
        Config config = new Config();
        // 基础配置
        config.protocol = "https";
        config.gatewayHost = "openapi-sandbox.dl.alipaydev.com";// 新版沙箱网关地址
        config.signType = "RSA2";

        // 业务配置
        config.appId = this.appId;
        config.merchantPrivateKey = this.appPrivateKey;
        config.alipayPublicKey = this.publiceKey;
        config.notifyUrl = this.notifyUrl;

        // 将配置信息， 添加到相应的工厂类
        Factory.setOptions(config);

        System.out.println("支付宝初始化配置完成");

    }
}

3.4 编写支付接口和支付回调接口

import com.alipay.easysdk.factory.Factory;
import com.alipay.easysdk.payment.page.models.AlipayTradePagePayResponse;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletRequest;
import java.util.HashMap;
import java.util.Map;

@RestController
public class TestController {
    /**
     * 订单支付接口， 核心是调用支付宝的 Factory.Payment.Page().pay() 方法
     * @param subject  支付对象信息
     * @param outTradeNo  订单号
     * @param totalAmount 订单金额
     * @return
     */
    @GetMapping("/pay")
    public String pay(String subject, String outTradeNo, String totalAmount) {
        AlipayTradePagePayResponse response;
        try {
            response = Factory.Payment.Page().pay(subject, outTradeNo, totalAmount, "");
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
        return response.getBody();
    }


    /**
     * 支付回调接口，如果支付成功，支付宝将会请求此接口，将成功信息返回
     * @param request
     * @return
     * @throws Exception
     */
    @PostMapping("/notify")
    public String notify(HttpServletRequest request) throws Exception {
        String tradeStatus = request.getParameter("trade_status");

        if (tradeStatus.trim().equals("TRADE_SUCCESS")) {
            Map<String, String> param = new HashMap<>();
            Map<String, String[]> parameterMap = request.getParameterMap();
            for (String name : parameterMap.keySet()) {
                param.put(name, request.getParameter(name));
            }

            // 验证请求的有效性
            if (Factory.Payment.Common().verifyNotify(param)) {
                System.out.println("通过支付宝的验证");
                String orderIdStr = param.get("out_trade_no");
                System.out.println("orderIdStr = " + orderIdStr);
            }else {
                System.out.println("支付验证不通过");
            }
        }
        return "success";
    }
}