[[WeChatPay.V3] 更新 发起商家转账API

src/Essensoft.Paylink.WeChatPay/V3/Domain/WeChatPayTransferBatchesBodyModel.cs

@@ -9,11 +9,10 @@ namespace Essensoft.Paylink.WeChatPay.V3.Domain;
 public class WeChatPayTransferBatchesBodyModel : WeChatPayObject
 {
     /// <summary>
-    /// 直连商户的appid
+    /// 商户appid
     /// </summary>
     /// <remarks>
     /// 申请商户号的appid或商户号绑定的appid（企业号corpid即为此appid）
-    /// <para>示例值：wxf636efh567hg4356</para>
     /// </remarks>
     [JsonPropertyName("appid")]
     public string AppId { get; set; }
@@ -23,7 +22,6 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject
     /// </summary>
     /// <remarks>
     /// 商户系统内部的商家批次单号，要求此参数只能由数字、大小写字母组成，在商户系统内部唯一
-    /// <para>示例值：plfk2020042013</para>
     /// </remarks>
     [JsonPropertyName("out_batch_no")]
     public string OutBatchNo { get; set; }
@@ -33,7 +31,6 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject
     /// </summary>
     /// <remarks>
     /// 该笔批量转账的名称
-    /// <para>示例值：2019年1月深圳分部报销单</para>
     /// </remarks>
     [JsonPropertyName("batch_name")]
     public string BatchName { get; set; }
@@ -43,7 +40,6 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject
     /// </summary>
     /// <remarks>
     /// 转账说明，UTF8编码，最多允许32个字符
-    /// <para>示例值：2019年1月深圳分部报销单</para>
     /// </remarks>
     [JsonPropertyName("batch_remark")]
     public string BatchRemark { get; set; }
@@ -53,7 +49,6 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject
     /// </summary>
     /// <remarks>
     /// 转账金额单位为“分”。转账总金额必须与批次内所有明细转账金额之和保持一致，否则无法发起转账操作
-    /// <para>示例值：4000000</para>
     /// </remarks>
     [JsonPropertyName("total_amount")]
     public int TotalAmount { get; set; }
@@ -63,7 +58,6 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject
     /// </summary>
     /// <remarks>
     /// 一个转账批次单最多发起一千笔转账。转账总笔数必须与批次内所有明细之和保持一致，否则无法发起转账操作
-    /// <para>示例值：200</para>
     /// </remarks>
     [JsonPropertyName("total_num")]
     public int TotalNum { get; set; }
@@ -77,7 +71,6 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject
     [JsonPropertyName("transfer_detail_list")]
     public List<TransferDetail> TransferDetailList { get; set; }
 
-
     /// <summary>
     /// 转账场景ID
     /// </summary>
@@ -87,4 +80,13 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject
     /// </remarks>
     [JsonPropertyName("transfer_scene_id")]
     public string TransferSceneId { get; set; }
+
+    /// <summary>
+    /// 通知地址
+    /// </summary>
+    /// <remarks>
+    /// 异步接收微信支付结果通知的回调地址，通知url必须为公网可访问的url，必须为https，不能携带参数。
+    /// </remarks>
+    [JsonPropertyName("notify_url")]
+    public string NotifyUrl { get; set; }
 }

src/Essensoft.Paylink.WeChatPay/V3/Request/WeChatPayTransferBatchesRequest.cs

@@ -3,10 +3,10 @@
 namespace Essensoft.Paylink.WeChatPay.V3.Request;
 
 /// <summary>
-/// 发起商家转账API - 最新更新时间：2022.04.24
+/// 发起商家转账API - 最新更新时间：2024.03.22
 /// </summary>
 /// <remarks>
-/// 商户可以通过该接口同时向多个用户微信零钱进行转账操作。
+/// 发起商家转账接口。商户可以通过该接口同时向多个用户微信零钱进行转账操作。请求消息中应包含商家批次单号、转账名称、appid、转账总金额、转账总笔数、转账openid、收款用户姓名等信息。注意受理成功将返回批次单号，此时并不代表转账成功，请通过查单接口查询单据的付款状态
 /// </remarks>
 public class WeChatPayTransferBatchesRequest : IWeChatPayPrivacyPostRequest<WeChatPayTransferBatchesResponse>
 {

src/Essensoft.Paylink.WeChatPay/V3/Response/WeChatPayTransferBatchesResponse.cs

@@ -8,8 +8,7 @@ public class WeChatPayTransferBatchesResponse : WeChatPayResponse
     /// 商家批次单号
     /// </summary>
     /// <remarks>
-    /// 商户系统内部的商家批次单号
-    /// <para>示例值：plfk2020042013</para>
+    /// 商户系统内部的商家批次单号，在商户系统内部唯一
     /// </remarks>
     [JsonPropertyName("out_batch_no")]
     public string OutBatchNo { get; set; }
@@ -19,7 +18,6 @@ public class WeChatPayTransferBatchesResponse : WeChatPayResponse
     /// </summary>
     /// <remarks>
     /// 微信批次单号，微信商家转账系统返回的唯一标识
-    /// <para>示例值：1030000071100999991182020050700019480001</para>
     /// </remarks>
     [JsonPropertyName("batch_id")]
     public string BatchId { get; set; }
@@ -28,8 +26,7 @@ public class WeChatPayTransferBatchesResponse : WeChatPayResponse
     /// 批次创建时间
     /// </summary>
     /// <remarks>
-    /// 批次受理成功时返回，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒
-    /// <para>示例值：2015-05-20T13:29:35.120+08:00</para>
+    /// 批次受理成功时返回，按照使用rfc3339所定义的格式，格式为YYYY-MM-DDThh:mm:ss+TIMEZONE
     /// </remarks>
     [JsonPropertyName("create_time")]
     public string CreateTime { get; set; }
@@ -38,10 +35,10 @@ public class WeChatPayTransferBatchesResponse : WeChatPayResponse
     /// 批次状态
     /// </summary>
     /// <remarks>
-    ///ACCEPTED:已受理。批次已受理成功，若发起批量转账的30分钟后，转账批次单仍处于该状态，可能原因是商户账户余额不足等。商户可查询账户资金流水，若该笔转账批次单的扣款已经发生，则表示批次已经进入转账中，请再次查单确认
-    ///PROCESSING:转账中。已开始处理批次内的转账明细单
-    ///FINISHED:已完成。批次内的所有转账明细单都已处理完成
-    ///CLOSED:已关闭。可查询具体的批次关闭原因确认
+    /// ACCEPTED:已受理。批次已受理成功，若发起批量转账的30分钟后，转账批次单仍处于该状态，可能原因是商户账户余额不足等。商户可查询账户资金流水，若该笔转账批次单的扣款已经发生，则表示批次已经进入转账中，请再次查单确认
+    /// PROCESSING:转账中。已开始处理批次内的转账明细单
+    /// FINISHED:已完成。批次内的所有转账明细单都已处理完成
+    /// CLOSED:已关闭。可查询具体的批次关闭原因确认
     /// </remarks>
     [JsonPropertyName("batch_status")]
     public string BatchStatus { get; set; }