SpringBoot集成alipay-easysdk

本文介绍如何集成支付宝支付功能,包括引入Maven依赖、配置SDK属性、编写支付工具类及服务层调用等步骤。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1、引入maven依赖

	<!--支付宝-->
	<dependency>
	    <groupId>com.alipay.sdk</groupId>
	    <artifactId>alipay-easysdk</artifactId>
	    <version>2.1.2</version>
	</dependency>

2、SDK属性装配

package com.example.pay.uitls.ali;

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

import javax.annotation.PostConstruct;
import java.util.Map;

/**
 * desc: 支付宝支付属性参数
 *
 * @author: 邢阳
 * @mail: xydeveloper@126.com
 * @create 2021-04-07 14:11
 */
@Data
@Component
@ConfigurationProperties(prefix = "alipay")
public class AliPayProperties {

    @ApiModelProperty("应用ID")  // @ApiModelProperty是Swagger的注解可以不必使用
    private String appId;

    @ApiModelProperty("请求的协议")
    private String protocol;

    @ApiModelProperty("请求网关的路径")
    private String gatewayHost;

    @ApiModelProperty("应用私钥")
    private String merchantPrivateKey;

    @ApiModelProperty("支付宝公钥")
    private String alipayPublicKey;

    @ApiModelProperty("是否忽略ssl")
    private Boolean ignoreSsl;

    @ApiModelProperty("签名加密类型")
    private String signType;

    @ApiModelProperty("支付回调地址")
    private String notifyUrl;

    /**
     * 初始化工厂配置参数
     */
    @PostConstruct
    public void initOptions() {

        Config config = new Config();

        config.protocol = protocol;
        config.gatewayHost = gatewayHost;
        config.signType = signType;
        config.appId = appId;
        config.merchantPrivateKey = merchantPrivateKey;
        config.alipayPublicKey = alipayPublicKey;
        config.notifyUrl = notifyUrl;

        Factory.setOptions(config);

    }

}

3、yml

# 支付宝支付属性参数
alipay:
  appId: 用户的appId
  protocol: https
  gatewayHost: openapi.alipaydev.com
  alipayPublicKey: 支付宝公钥
  ignoreSSL: false
  signType: RSA2
  notifyUrl: 回调地址(必须外网可以调用,开发阶段建议使用内网穿透工具)
  merchantPrivateKey: 商户私钥

4、AliPayUtils工具类

package com.example.pay.uitls.ali;

import com.alipay.easysdk.factory.Factory;
import com.alipay.easysdk.kernel.util.ResponseChecker;
import com.alipay.easysdk.payment.app.models.AlipayTradeAppPayResponse;
import com.alipay.easysdk.payment.common.models.AlipayTradeCloseResponse;
import com.alipay.easysdk.payment.common.models.AlipayTradeQueryResponse;
import com.alipay.easysdk.payment.common.models.AlipayTradeRefundResponse;
import com.alipay.easysdk.payment.page.models.AlipayTradePagePayResponse;
import com.alipay.easysdk.payment.wap.models.AlipayTradeWapPayResponse;
import com.example.pay.common.*;
import org.springframework.stereotype.Component;

import java.util.Objects;

/**
 * desc: 支付宝支付工具类
 *
 * @author: 邢阳
 * @mail: xydeveloper@126.com
 * @create 2021-04-07 14:11
 */
@Component
public class AliPayUtils {

    /**
     * app支付
     *
     * @param subject     订单标题
     * @param outTradeNo  交易创建时传入的商户订单号
     * @param totalAmount 订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]
     * @return
     */
    public AlipayTradeAppPayResponse appPay(String subject, String outTradeNo, String totalAmount) {

        AlipayTradeAppPayResponse alipayTradeAppPayResponse = null;

        try {
			
			// 主要操作 Factory.Payment.App().pay(subject, outTradeNo, totalAmount); 其他代码是一些判空以及异常处理
            alipayTradeAppPayResponse = Factory.Payment.App().pay(subject, outTradeNo, totalAmount);

        } catch (Exception e) {

            e.printStackTrace();

        }

        if (Objects.isNull(alipayTradeAppPayResponse)) {

            MyRuntimeException.ThrowRunTimeException.throwException(ExceptionEnum.PAY_FAIL);

        }

        return alipayTradeAppPayResponse;

    }

    /**
     * 手机网站支付
     *
     * @param subject:     订单标题
     * @param outTradeNo:  交易创建时传入的商户订单号
     * @param totalAmount: 订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]
     * @param quitUrl:     用户付款中途退出返回商户网站的地址
     * @param returnUrl    支付成功后同步跳转的页面,是一个http/https开头的字符串
     * @return
     */
    public AlipayTradeWapPayResponse wapPay(String subject, String outTradeNo, String totalAmount,
                                            String quitUrl, String returnUrl) {

        AlipayTradeWapPayResponse alipayTradeWapPayResponse = null;

        try {
			
			// 主要操作 Factory.Payment.App().pay(subject, outTradeNo, totalAmount); 其他代码是一些判空以及异常处理
            alipayTradeWapPayResponse = Factory.Payment.Wap().pay(subject, outTradeNo, totalAmount, quitUrl, returnUrl);

        } catch (Exception e) {

            e.printStackTrace();

        }

        if (Objects.isNull(alipayTradeWapPayResponse)) {

            MyRuntimeException.ThrowRunTimeException.throwException(ExceptionEnum.PAY_FAIL);

        }

        return alipayTradeWapPayResponse;

    }

    /**
     * 扫码支付
     *
     * @param subject:     订单标题
     * @param outTradeNo:  交易创建时传入的商户订单号
     * @param totalAmount: 订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]
     * @param returnUrl    支付成功后同步跳转的页面,是一个http/https开头的字符串
     * @return
     */
    public AlipayTradePagePayResponse pagePay(String subject, String outTradeNo, String totalAmount, String returnUrl) {

        AlipayTradePagePayResponse alipayTradePagePayResponse = null;

        try {
        
			// 主要操作 Factory.Payment.App().pay(subject, outTradeNo, totalAmount); 其他代码是一些判空以及异常处理
            alipayTradePagePayResponse = Factory.Payment.Page().pay(subject, outTradeNo, totalAmount, returnUrl);

        } catch (Exception e) {

            e.printStackTrace();

        }

        if (Objects.isNull(alipayTradePagePayResponse)) {

            MyRuntimeException.ThrowRunTimeException.throwException(ExceptionEnum.PAY_FAIL);

        }

        return alipayTradePagePayResponse;

    }


    /**
     * 支付查询
     *
     * @param outTradeNo 交易创建时传入的商户订单号
     * @return
     */
    public AlipayTradeQueryResponse query(String outTradeNo) {

        AlipayTradeQueryResponse alipayTradeQueryResponse = null;

        try {
        
			// 主要操作 Factory.Payment.App().pay(subject, outTradeNo, totalAmount); 其他代码是一些判空以及异常处理
            alipayTradeQueryResponse = Factory.Payment.Common().query(outTradeNo);

        } catch (Exception e) {

            e.printStackTrace();

        }

        Assert.isTrue(ResponseChecker.success(alipayTradeQueryResponse), ExceptionEnum.SYSTEM_EXCEPTION);

        return alipayTradeQueryResponse;

    }

    /**
     * 退款
     *
     * @param outTradeNo   交易创建时传入的商户订单号
     * @param refundAmount 退款金额
     * @return
     */
    public AlipayTradeRefundResponse refund(String outTradeNo, String refundAmount) {

        AlipayTradeRefundResponse alipayTradeRefundResponse = null;

        try {

			// 主要操作 Factory.Payment.App().pay(subject, outTradeNo, totalAmount); 其他代码是一些判空以及异常处理
            alipayTradeRefundResponse = Factory.Payment.Common().refund(outTradeNo, refundAmount);

        } catch (Exception e) {

            e.printStackTrace();

        }

        Assert.isTrue(ResponseChecker.success(alipayTradeRefundResponse), ExceptionEnum.SYSTEM_EXCEPTION);

        return alipayTradeRefundResponse;

    }

    /**
     * 取消交易
     *
     * @param outTradeNo 交易创建时传入的商户订单号
     * @return
     */
    public AlipayTradeCloseResponse close(String outTradeNo) {

        AlipayTradeCloseResponse alipayTradeCloseResponse = null;

        try {

			// 主要操作 Factory.Payment.App().pay(subject, outTradeNo, totalAmount); 其他代码是一些判空以及异常处理
            alipayTradeCloseResponse = Factory.Payment.Common().close(outTradeNo);

        } catch (Exception e) {

            e.printStackTrace();

        }

        Assert.isTrue(ResponseChecker.success(alipayTradeCloseResponse), ExceptionEnum.SYSTEM_EXCEPTION);

        return alipayTradeCloseResponse;

    }

}
;

5、服务层调用

package com.example.pay.service.impl;

import cn.hutool.core.net.URLDecoder;
import com.alipay.easysdk.factory.Factory;
import com.alipay.easysdk.payment.page.models.AlipayTradePagePayResponse;
import com.example.pay.common.Constant;
import com.example.pay.common.ExceptionEnum;
import com.example.pay.common.MyRuntimeException;
import com.example.pay.config.UserMain;
import com.example.pay.entity.PayOrder;
import com.example.pay.entity.vo.QueryVo;
import com.example.pay.entity.vo.AliPagePayVo;
import com.example.pay.enums.PayEnum;
import com.example.pay.enums.PayOrderEnum;
import com.example.pay.service.PayService;
import com.example.pay.uitls.ali.AliPayUtils;
import com.example.pay.uitls.fuiou.FuiouPayUtils;
import com.example.pay.uitls.wechat.WeChatUtils;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

import javax.servlet.http.HttpServletRequest;
import java.nio.charset.StandardCharsets;
import java.util.*;

import static com.example.pay.common.Result.success;

/**
 * desc: 聚合支付服务实现类
 *
 * @author: 邢阳
 * @mail: xydeveloper@126.com
 * @create 2021-04-07 14:11
 */
@Slf4j
@Service
public class PayServiceImpl implements PayService {

    @Autowired
    private AliPayUtils aliPayUtils;
    
    /**
     * 手机网站支付
     *
     * @param aliPagePayVo
     * @return
     */
    @Override
    public String pagePay(AliPagePayVo aliPagePayVo, UserMain userMain) {

        String outTradeNo = String.valueOf(UUID.randomUUID());
        AlipayTradePagePayResponse alipayTradePagePayResponse = aliPayUtils.pagePay(aliPagePayVo.getSubject(),
                    outTradeNo, aliPagePayVo.getTotalAmount(), aliPagePayVo.getReturnUrl());
		
		String body = alipayTradePagePayResponse.getBody();

        return body;

    }
    
	/**
     * 回调通知
     *
     * @param httpServletRequest
     * @return
     */
    @Override
    public Map notice(HttpServletRequest httpServletRequest) {

        try {

            Map<String, String> params = getAllRequestParam(httpServletRequest);

            if (!Factory.Payment.Common().verifyNotify(params)) {

                MyRuntimeException.ThrowRunTimeException.throwException(ExceptionEnum.PARAM_PARSING_EXCPTION);

            }

            if (params.get("trade_status").equals(Constant.TRADE_SUCCESS)) {

                String orderId = URLDecoder.decode(params.get("passback_params"), StandardCharsets.UTF_8);



				// todo 业务处理...
				
                return null;

            }

        } catch (Exception e) {

            log.error(e.getMessage(), e);

        }

        return null;

    }
    
}

### Spring Boot 集成支付宝沙箱提现接口 #### 准备工作 在开始集成之前,确保已经注册并创建了支付宝开放平台账号,并申请开通了开发者权限以及获取到了应用ID(`app_id`)、商户私钥、支付宝公钥等必要信息。 #### 添加依赖项 对于Spring Boot项目来说,在`pom.xml`中加入官方提供的SDK作为Maven依赖来简化开发流程: ```xml <dependency> <groupId>com.alipay.sdk</groupId> <artifactId>alipay-easysdk-bundle-all</artifactId> <version>3.7.12.ALL</version> </dependency> ``` 此版本号可能不是最新的,请访问[Maven仓库](https://mvnrepository.com/artifact/com.alipay.sdk/alipay-easysdk-bundle-all)查询最新版次[^4]。 #### 初始化EasySDK客户端实例 通过配置文件注入参数的方式完成初始化设置。通常会把敏感数据存放到环境变量或者加密后的数据库表里而不是直接写死在代码里面;下面是一个简单的例子展示如何读取这些值用于构建AlipayClient对象: ```java @Configuration public class AlipayConfig { @Value("${alipay.app-id}") private String appId; @Value("${alipay.merchant-private-key}") private String merchantPrivateKey; @Value("${alipay.alipay-public-key}") private String alipayPublicKey; @Bean(name="defaultAlipayClient") public DefaultAopClient defaultAlipayClient() throws Exception{ return new DefaultAopClient( "https://openapi.alipaydev.com/gateway.do", // 沙盒环境网关地址 appId, merchantPrivateKey, "json", "UTF-8", alipayPublicKey, "RSA2" ); } } ``` 注意这里使用的API入口是针对测试用途的特殊URL——即沙盒环境中所提供的服务端点。 #### 编写转账业务逻辑 编写具体的提现方法,调用相应的API接口执行资金转移动作。以下是基于上述已有的DefaultAopClient Bean的一个样例实现方式: ```java @Service @Slf4j public class WithdrawService { @Autowired private DefaultAopClient client; /** * 提现至银行卡/余额账户. */ public void withdraw(String userId, BigDecimal amount){ try { AlipayFundTransToaccountTransferRequest request = new AlipayFundTransToaccountTransferRequest(); JSONObject bizContentJson = new JSONObject(); bizContentJson.put("out_biz_no", UUID.randomUUID().toString()); // 商户订单号 bizContentJson.put("trans_amount", amount.toString()); bizContentJson.put("product_code","TRANS_ACCOUNT_NO_PWD"); // 固定值 // 收款方账户类型及号码 bizContentJson.put("payee_type","ALIPAY_LOGON_ID"); bizContentJson.put("payee_account","example@domain.com"); request.setBizContent(bizContentJson.toJSONString()); log.info("发起提现请求..."); AlipayFundTransToaccountTransferResponse response = client.execute(request); if(response.isSuccess()){ log.info("提现成功!"); }else{ throw new RuntimeException("提现失败:" + response.getSubMsg()); } } catch (Exception e) { log.error(e.getMessage(),e); throw new RuntimeException("处理提现过程中发生异常!",e); } } } ``` 以上代码片段展示了向指定支付宝登录名关联的资金账户发起一笔固定金额转账的过程。实际应用场景下还需要考虑更多细节因素比如幂等问题防止重复提交、异步通知回调验证等等[^5]。
评论 5
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值