FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

feat: 微信支付（平台收付通）提现接口新增回调参数支持及补充日终余额提现API by Copilot · Pull Request #3721 · binarywang/WxJava · GitHub

/ WxJava Public

feat: 微信支付（平台收付通）提现接口新增回调参数支持及补充日终余额提现API - #3721

Merged
binarywang merged 3 commits into
developfrom
copilot/fix-630d7860-2a00-409b-ae6e-cf5ed9ab4601
Nov 5, 2025
ConversationCommits (3)ChecksFiles changed
Merged

feat: 微信支付（平台收付通）提现接口新增回调参数支持及补充日终余额提现API#3721
binarywang merged 3 commits into
developfrom
copilot/fix-630d7860-2a00-409b-ae6e-cf5ed9ab4601

Conversation

Copilot AI commented Sep 24, 2025 •
edited
Loading

Copy link
Copy Markdown
Contributor

概述

根据微信支付2024年12月更新，为"平台预约提现"和"二级商户预约提现"接口新增了 notify_url 回调参数支持，并新增了提现状态变更回调处理功能。同时补充了日终余额提现相关API和平台按微信单号查询提现状态的接口。

变更内容

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
  • 包含完整的提现信息：商户单号、微信单号、金额、时间、失败原因等
  • 支持日终余额提现回调字段：solution、account_name、account_number、bank_name

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. 新增日终余额提现API

二级商户按日终余额预约提现

SubDayEndBalanceWithdrawRequest request = new SubDayEndBalanceWithdrawRequest();
request.setSubMchid("1900000109");
request.setOutRequestNo("20241224003");
request.setAmount(10000);
request.setAccountType("BASIC");
request.setNotifyUrl("https://your-domain.com/notify/balance-withdraw");

SubDayEndBalanceWithdrawResult result = ecommerceService.subDayEndBalanceWithdraw(request);

查询二级商户按日终余额预约提现状态

SubDayEndBalanceWithdrawStatusResult status = 
    ecommerceService.querySubDayEndBalanceWithdraw("1900000109", "20241224003");

4. 新增平台按微信单号查询提现状态

// 根据微信支付提现单号查询平台提现状态
SpWithdrawStatusResult status = ecommerceService.querySpWithdrawByWithdrawId("12321002198704230011101200");

5. 文档更新

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

兼容性

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

相关Issue

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

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.

Update WeChat Pay withdrawal APIs to support notify_url parameter and…
32779b1 
… callback

Co-authored-by: binarywang <1343140+binarywang@users.noreply.github.com>
Copilot AI changed the title [WIP] 微信支付（平台收付通）的“平台预约提现”接口新增回调参数 feat: 微信支付（平台收付通）提现接口新增回调参数支持 Sep 24, 2025
Copilot AI requested a review from binarywang September 24, 2025 15:25
binarywang added this to the 4.7.9 milestone Sep 27, 2025

imyzt commented Oct 15, 2025

Copy link
Copy Markdown
Contributor

@binarywang 我们@不了 @copilot

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

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

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

binarywang marked this pull request as ready for review October 23, 2025 03:20

binarywang commented Oct 23, 2025

Copy link
Copy Markdown
Owner

@binarywang 我们@不了 @copilot

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

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

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

@copilot 请注意下这些问题

Add missing withdrawal APIs and update WithdrawNotifyResult with addi…
41715ea 
…tional fields

Co-authored-by: binarywang <1343140+binarywang@users.noreply.github.com>

Copilot AI commented Oct 23, 2025

Copy link
Copy Markdown
Contributor Author

@binarywang 我们@不了 @copilot

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

已完成所有补充接口的实现，详见提交 41715ea：

  1. ✅ 平台查询预约提现状态（根据微信支付预约提现单号查询）- querySpWithdrawByWithdrawId()
  2. ✅ 二级商户按日终余额预约提现 - subDayEndBalanceWithdraw()
  3. ✅ 查询二级商户按日终余额预约提现状态 - querySubDayEndBalanceWithdraw()
  4. ✅ WithdrawNotifyResult 已补充字段：solution, account_name, account_number, bank_name

所有接口遵循现有代码规范，通过编译和checkstyle验证。

Copilot AI changed the title feat: 微信支付（平台收付通）提现接口新增回调参数支持 feat: 微信支付（平台收付通）提现接口新增回调参数支持及补充日终余额提现API Oct 23, 2025
binarywang merged commit d4186c4 into develop Nov 5, 2025
1 check passed
binarywang deleted the copilot/fix-630d7860-2a00-409b-ae6e-cf5ed9ab4601 branch November 5, 2025 02:45
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Show hidden characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

binarywang Awaiting requested review from binarywang

Assignees

binarywang

Copilot code review Copilot

Labels

None yet

Projects

None yet

Milestone

4.7.9

Development

Successfully merging this pull request may close these issues.

微信支付（平台收付通）的“平台预约提现”接口新增回调参数

3 participants

Back | FazBrowse Home | New Git URL