新增微工卡批量转账API支持

[Copilot]

补充微信支付官方微工卡批量转账接口 /v3/payroll-card/transfer-batches，该接口在 4.8.0 及之前版本中缺失。

变更内容

• 新增请求/响应模型

  • PayrollTransferBatchesRequest: 批量转账请求参数，支持最多 1000 笔明细
  • PayrollTransferBatchesResult: 批次状态、金额统计等返回信息

• 扩展 PayrollService

  • 新增 payrollCardTransferBatches() 方法
  • 使用 RsaCryptoUtil.encryptFields() 自动处理 @SpecEncrypt 注解字段加密，与 TransferService 实现保持一致

• 单元测试

  • 在 PayrollServiceImplTest 中新增测试用例

使用示例

PayrollTransferBatchesRequest request = PayrollTransferBatchesRequest.builder()
  .subMchid("1111111")
  .outBatchNo("batch_" + System.currentTimeMillis())
  .batchName("2024年1月工资")
  .totalAmount(200000L)
  .totalNum(1)
  .transferDetailList(Collections.singletonList(
    PayrollTransferBatchesRequest.TransferDetail.builder()
      .outDetailNo("detail_001")
      .transferAmount(200000L)
      .transferRemark("工资")
      .openid("o-MYE42l80oelYMDE34nYD456Xoy")
      .userName("张三")  // 自动加密
      .build()
  ))
  .build();

PayrollTransferBatchesResult result = 
  wxPayService.getPayrollService().payrollCardTransferBatches(request);

Original prompt

---

This section details on the original issue you should resolve

<issue_title>微工卡批量转账</issue_title>
<issue_description>原始需求来自：https://gitee.com/binary/weixin-java-tools/issues/IDJWCT

官方的微工卡是有批量转账这个功能接口的，但截止到4.8.0版本一直未增加此批量转账功能，接口地址为：“/v3/payroll-card/transfer-batches”。

</issue_description>

Comments on the Issue (you are @copilot in this section)

Custom agent used: 全部用中文
需要用中文，包括PR标题和分析总结过程

• Fixes 微工卡批量转账 #3855

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[augmentcode]

🤖 Augment PR Summary

Summary: 本 PR 为微信支付 V3「微工卡」补充了此前缺失的批量转账接口支持，覆盖服务商场景下的 /v3/payroll-card/transfer-batches 调用。

Changes:

• 新增请求模型 PayrollTransferBatchesRequest：包含批次信息与 transfer_detail_list 明细（文档标注最多 1000 笔）。
• 新增响应模型 PayrollTransferBatchesResult：返回批次号、状态、金额/笔数统计以及创建/更新时间等字段。
• 扩展 PayrollService 接口，新增 payrollCardTransferBatches 方法对外暴露能力。
• 在 PayrollServiceImpl 中实现接口：组装 V3 URL，按明细对标注 @SpecEncrypt 的敏感字段进行加密后发起请求。
• 在 PayrollServiceImplTest 中新增对应测试用例，提供请求构造与调用示例。

Technical Notes: 敏感字段（如明细中的 user_name）通过 RsaCryptoUtil.encryptFields 配合平台证书进行加密，并使用 postV3WithWechatpaySerial 发送带证书序列号的请求。

_{🤖 Was this summary useful? React with 👍 or 👎}

[augmentcode]

Review completed. No suggestions at this time.

Comment augment review to trigger a new review at any time.

[Copilot]

Pull request overview

此 PR 为微信支付 SDK 新增了微工卡批量转账 API 支持，补充了官方文档中存在但在 4.8.0 版本及之前缺失的 /v3/payroll-card/transfer-batches 接口。

Changes:

• 新增 PayrollTransferBatchesRequest 和 PayrollTransferBatchesResult 两个数据模型类，支持批量转账请求和响应
• 在 PayrollService 接口和 PayrollServiceImpl 实现类中添加 payrollCardTransferBatches 方法
• 添加相应的单元测试用例到 PayrollServiceImplTest

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
PayrollTransferBatchesRequest.java	新增批量转账请求模型，包含批次信息和转账明细列表，userName 字段使用 @SpecEncrypt 注解支持自动加密
PayrollTransferBatchesResult.java	新增批量转账响应模型，包含批次状态、金额统计等完整的返回字段
PayrollService.java	在服务接口中新增 payrollCardTransferBatches 方法定义
PayrollServiceImpl.java	实现批量转账方法，包含敏感信息加密处理和 V3 API 调用
PayrollServiceImplTest.java	新增测试用例验证批量转账功能

[Copilot]

在 PayrollServiceImpl.payrollCardTransferBatches 方法中，对 userName 的 null/empty 检查是冗余的。RsaCryptoUtil.encryptFields 方法内部已经处理了 null 和空字符串的检查（参见 RsaCryptoUtil.java 第 66-72 行）。

建议简化代码，与 TransferServiceImpl.transferBatches 保持一致的模式（第 33-34 行），直接对所有 detail 调用 encryptFields，无需额外的 null 检查：

for (PayrollTransferBatchesRequest.TransferDetail detail : request.getTransferDetailList()) {
  RsaCryptoUtil.encryptFields(detail, payService.getConfig().getVerifier().getValidCertificate());
}

这样可以提高代码一致性并减少不必要的检查。

Suggested change

	if (StringUtils.isNotEmpty(detail.getUserName())) {
	RsaCryptoUtil.encryptFields(detail, payService.getConfig().getVerifier().getValidCertificate());
	}
	RsaCryptoUtil.encryptFields(detail, payService.getConfig().getVerifier().getValidCertificate());