From 3f71d71e2f509df58bc59885a9ddb732dbfe445a Mon Sep 17 00:00:00 2001 From: roc Date: Fri, 28 Jun 2024 02:37:51 +0800 Subject: [PATCH] =?UTF-8?q?[[WeChatPay.V3]=20=E6=9B=B4=E6=96=B0=20?= =?UTF-8?q?=E5=8F=91=E8=B5=B7=E5=95=86=E5=AE=B6=E8=BD=AC=E8=B4=A6API?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../WeChatPayTransferBatchesBodyModel.cs | 18 ++++++++++-------- .../Request/WeChatPayTransferBatchesRequest.cs | 4 ++-- .../WeChatPayTransferBatchesResponse.cs | 15 ++++++--------- 3 files changed, 18 insertions(+), 19 deletions(-) diff --git a/src/Essensoft.Paylink.WeChatPay/V3/Domain/WeChatPayTransferBatchesBodyModel.cs b/src/Essensoft.Paylink.WeChatPay/V3/Domain/WeChatPayTransferBatchesBodyModel.cs index 020d76e6e..da8eb1123 100644 --- a/src/Essensoft.Paylink.WeChatPay/V3/Domain/WeChatPayTransferBatchesBodyModel.cs +++ b/src/Essensoft.Paylink.WeChatPay/V3/Domain/WeChatPayTransferBatchesBodyModel.cs @@ -9,11 +9,10 @@ namespace Essensoft.Paylink.WeChatPay.V3.Domain; public class WeChatPayTransferBatchesBodyModel : WeChatPayObject { /// - /// 直连商户的appid + /// 商户appid /// /// /// 申请商户号的appid或商户号绑定的appid（企业号corpid即为此appid） - /// 示例值：wxf636efh567hg4356 /// [JsonPropertyName("appid")] public string AppId { get; set; } @@ -23,7 +22,6 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject /// /// /// 商户系统内部的商家批次单号，要求此参数只能由数字、大小写字母组成，在商户系统内部唯一 - /// 示例值：plfk2020042013 /// [JsonPropertyName("out_batch_no")] public string OutBatchNo { get; set; } @@ -33,7 +31,6 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject /// /// /// 该笔批量转账的名称 - /// 示例值：2019年1月深圳分部报销单 /// [JsonPropertyName("batch_name")] public string BatchName { get; set; } @@ -43,7 +40,6 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject /// /// /// 转账说明，UTF8编码，最多允许32个字符 - /// 示例值：2019年1月深圳分部报销单 /// [JsonPropertyName("batch_remark")] public string BatchRemark { get; set; } @@ -53,7 +49,6 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject /// /// /// 转账金额单位为“分”。转账总金额必须与批次内所有明细转账金额之和保持一致，否则无法发起转账操作 - /// 示例值：4000000 /// [JsonPropertyName("total_amount")] public int TotalAmount { get; set; } @@ -63,7 +58,6 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject /// /// /// 一个转账批次单最多发起一千笔转账。转账总笔数必须与批次内所有明细之和保持一致，否则无法发起转账操作 - /// 示例值：200 /// [JsonPropertyName("total_num")] public int TotalNum { get; set; } @@ -77,7 +71,6 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject [JsonPropertyName("transfer_detail_list")] public List TransferDetailList { get; set; } - /// /// 转账场景ID /// @@ -87,4 +80,13 @@ public class WeChatPayTransferBatchesBodyModel : WeChatPayObject /// [JsonPropertyName("transfer_scene_id")] public string TransferSceneId { get; set; } + + /// + /// 通知地址 + /// + /// + /// 异步接收微信支付结果通知的回调地址，通知url必须为公网可访问的url，必须为https，不能携带参数。 + /// + [JsonPropertyName("notify_url")] + public string NotifyUrl { get; set; } } diff --git a/src/Essensoft.Paylink.WeChatPay/V3/Request/WeChatPayTransferBatchesRequest.cs b/src/Essensoft.Paylink.WeChatPay/V3/Request/WeChatPayTransferBatchesRequest.cs index b9533076c..91179c46d 100644 --- a/src/Essensoft.Paylink.WeChatPay/V3/Request/WeChatPayTransferBatchesRequest.cs +++ b/src/Essensoft.Paylink.WeChatPay/V3/Request/WeChatPayTransferBatchesRequest.cs @@ -3,10 +3,10 @@ namespace Essensoft.Paylink.WeChatPay.V3.Request; /// -/// 发起商家转账API - 最新更新时间：2022.04.24 +/// 发起商家转账API - 最新更新时间：2024.03.22 /// /// -/// 商户可以通过该接口同时向多个用户微信零钱进行转账操作。 +/// 发起商家转账接口。商户可以通过该接口同时向多个用户微信零钱进行转账操作。请求消息中应包含商家批次单号、转账名称、appid、转账总金额、转账总笔数、转账openid、收款用户姓名等信息。注意受理成功将返回批次单号，此时并不代表转账成功，请通过查单接口查询单据的付款状态 /// public class WeChatPayTransferBatchesRequest : IWeChatPayPrivacyPostRequest { diff --git a/src/Essensoft.Paylink.WeChatPay/V3/Response/WeChatPayTransferBatchesResponse.cs b/src/Essensoft.Paylink.WeChatPay/V3/Response/WeChatPayTransferBatchesResponse.cs index f547b7551..404a0d4fe 100644 --- a/src/Essensoft.Paylink.WeChatPay/V3/Response/WeChatPayTransferBatchesResponse.cs +++ b/src/Essensoft.Paylink.WeChatPay/V3/Response/WeChatPayTransferBatchesResponse.cs @@ -8,8 +8,7 @@ public class WeChatPayTransferBatchesResponse : WeChatPayResponse /// 商家批次单号 /// /// - /// 商户系统内部的商家批次单号 - /// 示例值：plfk2020042013 + /// 商户系统内部的商家批次单号，在商户系统内部唯一 /// [JsonPropertyName("out_batch_no")] public string OutBatchNo { get; set; } @@ -19,7 +18,6 @@ public class WeChatPayTransferBatchesResponse : WeChatPayResponse /// /// /// 微信批次单号，微信商家转账系统返回的唯一标识 - /// 示例值：1030000071100999991182020050700019480001 /// [JsonPropertyName("batch_id")] public string BatchId { get; set; } @@ -28,8 +26,7 @@ public class WeChatPayTransferBatchesResponse : WeChatPayResponse /// 批次创建时间 /// /// - /// 批次受理成功时返回，遵循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秒 - /// 示例值：2015-05-20T13:29:35.120+08:00 + /// 批次受理成功时返回，按照使用rfc3339所定义的格式，格式为YYYY-MM-DDThh:mm:ss+TIMEZONE /// [JsonPropertyName("create_time")] public string CreateTime { get; set; } @@ -38,10 +35,10 @@ public class WeChatPayTransferBatchesResponse : WeChatPayResponse /// 批次状态 /// /// - ///ACCEPTED:已受理。批次已受理成功，若发起批量转账的30分钟后，转账批次单仍处于该状态，可能原因是商户账户余额不足等。商户可查询账户资金流水，若该笔转账批次单的扣款已经发生，则表示批次已经进入转账中，请再次查单确认 - ///PROCESSING:转账中。已开始处理批次内的转账明细单 - ///FINISHED:已完成。批次内的所有转账明细单都已处理完成 - ///CLOSED:已关闭。可查询具体的批次关闭原因确认 + /// ACCEPTED:已受理。批次已受理成功，若发起批量转账的30分钟后，转账批次单仍处于该状态，可能原因是商户账户余额不足等。商户可查询账户资金流水，若该笔转账批次单的扣款已经发生，则表示批次已经进入转账中，请再次查单确认 + /// PROCESSING:转账中。已开始处理批次内的转账明细单 + /// FINISHED:已完成。批次内的所有转账明细单都已处理完成 + /// CLOSED:已关闭。可查询具体的批次关闭原因确认 /// [JsonPropertyName("batch_status")] public string BatchStatus { get; set; }