feat(tenpayv3): 新增银行多笔立减相关接口

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Extensions/WechatTenpayClientExecuteMarketingBankFavorExtensions.cs

@@ -0,0 +1,59 @@
+using System;
+using System.Net.Http;
+using System.Threading;
+using System.Threading.Tasks;
+using Flurl.Http;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3
+{
+    public static class WechatTenpayClientExecuteMarketingBankFavorExtensions
+    {
+        /// <summary>
+        /// <para>异步调用 [GET] /marketing/bank-favor/users/{openid}/coupons/{coupon_id} 接口。</para>
+        /// <para>
+        /// REF: <br/>
+        /// <![CDATA[ https://pay.weixin.qq.com/doc/v3/merchant/4014569864 ]]>
+        /// </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.GetMarketingBankFavorUserCouponResponse> ExecuteGetMarketingBankFavorUserCouponAsync(this WechatTenpayClient client, Models.GetMarketingBankFavorUserCouponRequest request, CancellationToken cancellationToken = default)
+        {
+            if (client is null) throw new ArgumentNullException(nameof(client));
+            if (request is null) throw new ArgumentNullException(nameof(request));
+
+            IFlurlRequest flurlReq = client
+                .CreateFlurlRequest(request, HttpMethod.Get, "marketing", "bank-favor", "users", request.OpenId, "coupons", request.CouponId)
+                .SetQueryParam("appid", request.AppId);
+
+            return await client.SendFlurlRequestAsJsonAsync<Models.GetMarketingBankFavorUserCouponResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
+        }
+
+        /// <summary>
+        /// <para>异步调用 [POST] /marketing/bank-favor/users/{openid}/bank-multi-activity 接口。</para>
+        /// <para>
+        /// REF: <br/>
+        /// <![CDATA[ https://pay.weixin.qq.com/doc/v3/merchant/4014569793 ]]>
+        /// </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.SendMarketingBankFavorUserBankMultipleActivityCouponResponse> ExecuteSendMarketingBankFavorUserBankMultipleActivityCouponAsync(this WechatTenpayClient client, Models.SendMarketingBankFavorUserBankMultipleActivityCouponRequest request, CancellationToken cancellationToken = default)
+        {
+            if (client is null) throw new ArgumentNullException(nameof(client));
+            if (request is null) throw new ArgumentNullException(nameof(request));
+
+            if (request.StockCreatorMerchantId is null)
+                request.StockCreatorMerchantId = client.Credentials.MerchantId;
+
+            IFlurlRequest flurlReq = client
+                .CreateFlurlRequest(request, HttpMethod.Post, "marketing", "bank-favor", "users", request.OpenId, "bank-multi-activity");
+
+            return await client.SendFlurlRequestAsJsonAsync<Models.SendMarketingBankFavorUserBankMultipleActivityCouponResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
+        }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/MarketingBankFavor/GetMarketingBankFavorUserCouponRequest.cs

@@ -0,0 +1,29 @@
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /marketing/bank-favor/users/{openid}/coupons/{coupon_id} 接口的请求。</para>
+    /// </summary>
+    public class GetMarketingBankFavorUserCouponRequest : WechatTenpayRequest
+    {
+        /// <summary>
+        /// 获取或设置微信 AppId。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string AppId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置用户 OpenId。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string OpenId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置代金券 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string CouponId { get; set; } = string.Empty;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/MarketingBankFavor/GetMarketingBankFavorUserCouponResponse.cs

@@ -0,0 +1,135 @@
+using System;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /marketing/bank-favor/users/{openid}/coupons/{coupon_id} 接口的响应。</para>
+    /// </summary>
+    public class GetMarketingBankFavorUserCouponResponse : WechatTenpayResponse
+    {
+        public static class Types
+        {
+            public class UsedAmountList
+            {
+                /// <summary>
+                /// 获取或设置已用金额列表（单位：分）。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("used_amounts")]
+                [System.Text.Json.Serialization.JsonPropertyName("used_amounts")]
+                [System.Text.Json.Serialization.JsonNumberHandling(System.Text.Json.Serialization.JsonNumberHandling.AllowReadingFromString)]
+                public int[] Items { get; set; } = default!;
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置批次 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("stock_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("stock_id")]
+        public string StockId { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置创建批次的商户号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("stock_creator_mchid")]
+        [System.Text.Json.Serialization.JsonPropertyName("stock_creator_mchid")]
+        public string StockCreatorMerchantId { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置代金券 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("coupon_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("coupon_id")]
+        public string CouponId { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置代金券名称。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("coupon_name")]
+        [System.Text.Json.Serialization.JsonPropertyName("coupon_name")]
+        public string CouponName { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置代金券状态。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("coupon_state")]
+        [System.Text.Json.Serialization.JsonPropertyName("coupon_state")]
+        public string CouponState { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置微信 AppId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("appid")]
+        [System.Text.Json.Serialization.JsonPropertyName("appid")]
+        public string AppId { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置领券时间。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("receive_time")]
+        [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.Rfc3339DateTimeOffsetConverter))]
+        [System.Text.Json.Serialization.JsonPropertyName("receive_time")]
+        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.Rfc3339DateTimeOffsetConverter))]
+        public DateTimeOffset ReceiveTime { get; set; }
+
+        /// <summary>
+        /// 获取或设置券可使用开始时间。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("available_begin_time")]
+        [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.Rfc3339DateTimeOffsetConverter))]
+        [System.Text.Json.Serialization.JsonPropertyName("available_begin_time")]
+        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.Rfc3339DateTimeOffsetConverter))]
+        public DateTimeOffset AvailableBeginTime { get; set; }
+
+        /// <summary>
+        /// 获取或设置券可使用结束时间。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("available_end_time")]
+        [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.Rfc3339DateTimeOffsetConverter))]
+        [System.Text.Json.Serialization.JsonPropertyName("available_end_time")]
+        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.Rfc3339DateTimeOffsetConverter))]
+        public DateTimeOffset AvailableEndTime { get; set; }
+
+        /// <summary>
+        /// 获取或设置用户 OpenId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("openid")]
+        [System.Text.Json.Serialization.JsonPropertyName("openid")]
+        public string? OpenId { get; set; }
+
+        /// <summary>
+        /// 获取或设置多笔立减活动 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_id")]
+        public string ActivityId { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置券最大使用次数。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("max_use_number")]
+        [System.Text.Json.Serialization.JsonPropertyName("max_use_number")]
+        public int MaxUseCount { get; set; }
+
+        /// <summary>
+        /// 获取或设置券剩余可用次数。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("available_number")]
+        [System.Text.Json.Serialization.JsonPropertyName("available_number")]
+        public int AvailableCount { get; set; }
+
+        /// <summary>
+        /// 获取或设置券已使用次数。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("used_number")]
+        [System.Text.Json.Serialization.JsonPropertyName("used_number")]
+        public int UsedCount { get; set; }
+
+        /// <summary>
+        /// 获取或设置已用金额列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("use_amount_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("use_amount_list")]
+        public Types.UsedAmountList? UsedAmountList { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/MarketingBankFavor/SendMarketingBankFavorUserBankMultipleActivityCouponRequest.cs

@@ -0,0 +1,50 @@
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /marketing/bank-favor/users/{openid}/bank-multi-activity 接口的请求。</para>
+    /// </summary>
+    public class SendMarketingBankFavorUserBankMultipleActivityCouponRequest : WechatTenpayRequest
+    {
+        /// <summary>
+        /// 获取或设置批次 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("stock_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("stock_id")]
+        public string StockId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置创建批次的商户号。如果不指定将使用构造 <see cref="WechatTenpayClient"/> 时的 <see cref="WechatTenpayClientOptions.MerchantId"/> 参数。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("stock_creator_mchid")]
+        [System.Text.Json.Serialization.JsonPropertyName("stock_creator_mchid")]
+        public string? StockCreatorMerchantId { get; set; }
+
+        /// <summary>
+        /// 获取或设置微信 AppId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("appid")]
+        [System.Text.Json.Serialization.JsonPropertyName("appid")]
+        public string AppId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置用户 OpenId。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string OpenId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置多笔立减活动 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_id")]
+        public string ActivityId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置商户单号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("out_request_no")]
+        [System.Text.Json.Serialization.JsonPropertyName("out_request_no")]
+        public string OutRequestNumber { get; set; } = string.Empty;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/MarketingBankFavor/SendMarketingBankFavorUserBankMultipleActivityCouponResponse.cs

@@ -0,0 +1,15 @@
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /marketing/bank-favor/users/{openid}/bank-multi-activity 接口的响应。</para>
+    /// </summary>
+    public class SendMarketingBankFavorUserBankMultipleActivityCouponResponse : WechatTenpayResponse
+    {
+        /// <summary>
+        /// 获取或设置代金券 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("coupon_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("coupon_id")]
+        public string CouponId { get; set; } = default!;
+    }
+}