完善电子回单接口文档注释并处理审查反馈

Agent-Logs-Url: https://github.com/binarywang/WxJava/sessions/8e47db93-4c11-4263-a22d-8823b3f7d2b8

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

Author: Copilot

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/MerchantTransferService.java

@@ -110,11 +110,11 @@ public interface MerchantTransferService {
    * 请求URL：https://api.mch.weixin.qq.com/v3/fund-app/mch-transfer/elecsign/out-bill-no/{out_bill_no}
    * 请求方式：GET
    *
-   * @param outBatchNo the out batch no
+   * @param outBillNo 商户转账单号
    * @return electronic bill result
    * @throws WxPayException the wx pay exception
    */
-  ElectronicBillResult queryElectronicBill(String outBatchNo) throws WxPayException;
+  ElectronicBillResult queryElectronicBill(String outBillNo) throws WxPayException;
 
   /**
    * 转账明细电子回单受理API

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/PartnerTransferService.java

@@ -118,11 +118,11 @@ public interface PartnerTransferService {
    * 请求URL：https://api.mch.weixin.qq.com/v3/fund-app/mch-transfer/elecsign/out-bill-no/{out_bill_no}
    * 请求方式：GET
    *
-   * @param outBatchNo 商家批次单号
+   * @param outBillNo 商户转账单号
    * @return 返回数据 fund balance result
    * @throws WxPayException the wx pay exception
    */
-  BillReceiptResult queryBillReceipt(String outBatchNo) throws WxPayException;
+  BillReceiptResult queryBillReceipt(String outBillNo) throws WxPayException;
 
   /**
    * 转账明细电子回单受理API

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/MerchantTransferServiceImpl.java

@@ -98,8 +98,8 @@ public ElectronicBillResult applyElectronicBill(ElectronicBillApplyRequest reque
   }
 
   @Override
-  public ElectronicBillResult queryElectronicBill(String outBatchNo) throws WxPayException {
-    String url = String.format("%s/v3/fund-app/mch-transfer/elecsign/out-bill-no/%s", this.wxPayService.getPayBaseUrl(), outBatchNo);
+  public ElectronicBillResult queryElectronicBill(String outBillNo) throws WxPayException {
+    String url = String.format("%s/v3/fund-app/mch-transfer/elecsign/out-bill-no/%s", this.wxPayService.getPayBaseUrl(), outBillNo);
     String response = wxPayService.getV3(url);
     return GSON.fromJson(response, ElectronicBillResult.class);
   }

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/PartnerTransferServiceImpl.java

@@ -206,17 +206,17 @@ public BillReceiptResult receiptBill(ReceiptBillRequest request) throws WxPayExc
    * 查询转账电子回单API
    * 接口说明
    * 适用对象：直连商户 服务商
-   * 文档详见: https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/pay/transfer/chapter4_2.shtml
-   * 请求URL：https://api.mch.weixin.qq.com/v3/transfer/bill-receipt/{out_batch_no}
+   * 文档详见: https://pay.weixin.qq.com/doc/v3/merchant/4012716436
+   * 请求URL：https://api.mch.weixin.qq.com/v3/fund-app/mch-transfer/elecsign/out-bill-no/{out_bill_no}
    * 请求方式：GET
    *
-   * @param outBatchNo 商家批次单号
+   * @param outBillNo 商户转账单号
    * @return 返回数据 fund balance result
    * @throws WxPayException the wx pay exception
    */
   @Override
-  public BillReceiptResult queryBillReceipt(String outBatchNo) throws WxPayException {
-    String url = String.format("%s/v3/fund-app/mch-transfer/elecsign/out-bill-no/%s", this.payService.getPayBaseUrl(), outBatchNo);
+  public BillReceiptResult queryBillReceipt(String outBillNo) throws WxPayException {
+    String url = String.format("%s/v3/fund-app/mch-transfer/elecsign/out-bill-no/%s", this.payService.getPayBaseUrl(), outBillNo);
     String response = this.payService.getV3(url);
     return GSON.fromJson(response, BillReceiptResult.class);
   }

weixin-java-pay/src/test/java/com/github/binarywang/wxpay/service/impl/TransferReceiptApiCompatibilityTest.java

@@ -19,6 +19,9 @@ public class TransferReceiptApiCompatibilityTest {
 
   private static final String BASE_URL = "https://api.mch.weixin.qq.com";
 
+  /**
+   * 验证直连商户电子回单接口已切换到新版fund-app路径。
+   */
   public void shouldUseNewMerchantTransferElecsignApiPath() throws WxPayException {
     RequestCaptureHandler handler = new RequestCaptureHandler();
     WxPayService wxPayService = handler.createWxPayService();
@@ -33,6 +36,9 @@ public void shouldUseNewMerchantTransferElecsignApiPath() throws WxPayException
     Assert.assertEquals(handler.lastGetUrl, BASE_URL + "/v3/fund-app/mch-transfer/elecsign/out-bill-no/plfk2020042013");
   }
 
+  /**
+   * 验证服务商电子回单接口已切换到新版fund-app路径。
+   */
   public void shouldUseNewPartnerTransferElecsignApiPath() throws WxPayException {
     RequestCaptureHandler handler = new RequestCaptureHandler();
     WxPayService wxPayService = handler.createWxPayService();
@@ -49,6 +55,9 @@ public void shouldUseNewPartnerTransferElecsignApiPath() throws WxPayException {
     Assert.assertEquals(handler.lastGetUrl, BASE_URL + "/v3/fund-app/mch-transfer/elecsign/out-bill-no/plfk2020042013");
   }
 
+  /**
+   * 验证新版字段名能够正确反序列化到现有结果对象。
+   */
   public void shouldDeserializeNewResponseFieldNames() {
     Gson gson = new Gson();
     BillReceiptResult billReceiptResult =
@@ -62,6 +71,9 @@ public void shouldDeserializeNewResponseFieldNames() {
     Assert.assertEquals(electronicBillResult.getSignatureStatus(), "FINISHED");
   }
 
+  /**
+   * 通过动态代理拦截WxPayService请求并记录URL/请求体，便于断言接口路径和参数。
+   */
   private static class RequestCaptureHandler implements InvocationHandler {
     private String lastPostUrl;
     private String lastPostBody;