springboot对接支付宝沙箱提现

### Spring Boot 集成支付宝沙箱提现接口

#### 准备工作
在开始集成之前，确保已经注册并创建了支付宝开放平台账号，并申请开通了开发者权限以及获取到了应用ID（`app_id`）、商户私钥、支付宝公钥等必要信息。

#### 添加依赖项
对于Spring Boot项目来说，在`pom.xml`中加入官方提供的SDK作为Maven依赖来简化开发流程：

<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对象：

@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的一个样例实现方式：

@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]。