feat: 微信支付（平台收付通）提现接口新增回调参数支持

[Copilot]

概述

根据微信支付2024年12月更新，为"平台预约提现"和"二级商户预约提现"接口新增了 notify_url 回调参数支持，并新增了提现状态变更回调处理功能。

变更内容

1. 新增回调通知地址参数

SubWithdrawRequest（二级商户预约提现）

SubWithdrawRequest request = new SubWithdrawRequest();
request.setSubMchid("1900000109");
request.setOutRequestNo("20241224001");
request.setAmount(10000);
// 新增：设置回调通知地址
request.setNotifyUrl("https://your-domain.com/notify/withdraw");

SpWithdrawRequest（平台预约提现）

SpWithdrawRequest request = new SpWithdrawRequest();
request.setOutRequestNo("20241224002");
request.setAmount(50000);
request.setAccountType("BASIC");
// 新增：设置回调通知地址
request.setNotifyUrl("https://your-domain.com/notify/sp-withdraw");

2. 新增提现状态变更回调支持

WithdrawNotifyResult（提现状态变更通知结果）

• 新增专门的回调数据处理类
• 支持所有提现状态：CREATE_SUCCESS、SUCCESS、FAILED、REFUND、CLOSE
• 包含完整的提现信息：商户单号、微信单号、金额、时间、失败原因等

EcommerceService接口扩展

// 新增方法
WithdrawNotifyResult parseWithdrawNotifyResult(String notifyData, SignatureHeader header) throws WxPayException;

使用示例

// 处理提现状态变更回调
WithdrawNotifyResult notifyResult = ecommerceService.parseWithdrawNotifyResult(notifyData, header);
String status = notifyResult.getStatus();
String outRequestNo = notifyResult.getOutRequestNo();

switch (status) {
    case "SUCCESS":
        System.out.println("提现成功：" + outRequestNo);
        break;
    case "FAILED":
        System.out.println("提现失败：" + outRequestNo + "，原因：" + notifyResult.getReason());
        break;
    // 其他状态处理...
}

3. 文档更新

更新了所有相关方法的javadoc注释，使用最新的官方文档地址：

• 平台预约提现接口：https://pay.weixin.qq.com/doc/v3/partner/4012476670
• 二级商户预约提现接口：https://pay.weixin.qq.com/doc/v3/partner/4012476652
• 商户提现状态变更回调：https://pay.weixin.qq.com/doc/v3/partner/4013049135

兼容性

• ✅ 完全向后兼容：notify_url 参数为可选，现有代码无需修改
• ✅ 遵循现有模式：回调解析方法与现有 parseRefundNotifyResult 保持一致的实现模式
• ✅ 代码质量保证：通过checkstyle检查，符合项目代码规范

相关Issue

Closes #xxx - 微信支付（平台收付通）的"平台预约提现"接口新增回调参数

Fixes #3494

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[imyzt]

@binarywang 我们@不了 @copilot

issue 提到的接口不全，建议一次性将微信支付新增的以下接口补全：

1. 查询二级商户按日终余额预约提现状态
2. 二级商户按日终余额预约提现
3. 平台查询预约提现状态（根据微信支付预约提现单号查询）

需要注意，因为 “商户提现状态变更回调” 不止 平台预约提现接口 和 二级商户预约提现接口 使用，二级商户按日终余额预约提现 也会使用，所以 WithdrawNotifyResult 需要补充字段。