feat(tenpayv3): 新增银行周周惠相关接口

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

@@ -0,0 +1,79 @@
+using System;
+using System.Net.Http;
+using System.Threading;
+using System.Threading.Tasks;
+using Flurl.Http;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3
+{
+    /// <summary>
+    /// 为 <see cref="WechatTenpayClient"/> 提供银行周周惠相关的 API 扩展方法。
+    /// </summary>
+    public static class WechatTenpayClientExecuteMerchantWeeklyDiscountExtensions
+    {
+        /// <summary>
+        /// <para>异步调用 [POST] /marketing/weekly-discount/activities/{activity_id}/apply 接口。</para>
+        /// <para>REF: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/Offline/apis/chapter6_1_1.shtml </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.ApplyMarketingWeeklyDiscountActivityResponse> ExecuteApplyMarketingWeeklyDiscountActivityAsync(this WechatTenpayClient client, Models.ApplyMarketingWeeklyDiscountActivityRequest 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
+                .CreateRequest(request, HttpMethod.Post, "marketing", "weekly-discount", "activities", request.ActivityId, "apply");
+
+            return await client.SendRequestWithJsonAsync<Models.ApplyMarketingWeeklyDiscountActivityResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
+        }
+
+        /// <summary>
+        /// <para>异步调用 [GET] /marketing/weekly-discount/activities 接口。</para>
+        /// <para>REF: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/Offline/apis/chapter6_1_3.shtml </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.QueryApplyMarketingWeeklyDiscountActivitiesResponse> ExecuteQueryApplyMarketingWeeklyDiscountActivitiesAsync(this WechatTenpayClient client, Models.QueryApplyMarketingWeeklyDiscountActivitiesRequest 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
+                .CreateRequest(request, HttpMethod.Get, "marketing", "weekly-discount", "activities")
+                .SetQueryParam("applying_merchant_id", request.ApplyingMerchantId)
+                .SetQueryParam("activity_area_code", request.ActivityAreaCode)
+                .SetQueryParam("activity_scene", request.ActivityScene)
+                .SetQueryParam("limit", request.Limit)
+                .SetQueryParam("offset", request.Offset);
+
+            if (request.StoreId != null)
+                flurlReq.SetQueryParam("store_id", request.StoreId.Value);
+
+            return await client.SendRequestWithJsonAsync<Models.QueryApplyMarketingWeeklyDiscountActivitiesResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
+        }
+
+        /// <summary>
+        /// <para>异步调用 [GET] /marketing/weekly-discount/activities/{activity_id} 接口。</para>
+        /// <para>REF: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/Offline/apis/chapter6_1_2.shtml </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.GetApplyMarketingWeeklyDiscountActivityByActivityIdResponse> ExecuteGetApplyMarketingWeeklyDiscountActivityByActivityIdAsync(this WechatTenpayClient client, Models.GetApplyMarketingWeeklyDiscountActivityByActivityIdRequest 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
+                .CreateRequest(request, HttpMethod.Get, "marketing", "weekly-discount", "activities", request.ActivityId);
+
+            return await client.SendRequestWithJsonAsync<Models.GetApplyMarketingWeeklyDiscountActivityByActivityIdResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
+        }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/MarketingWeeklyDiscount/ApplyMarketingWeeklyDiscountActivityRequest.cs

@@ -0,0 +1,31 @@
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /marketing/weekly-discount/activities/{activity_id}/apply 接口的请求。</para>
+    /// </summary>
+    public class ApplyMarketingWeeklyDiscountActivityRequest : WechatTenpayRequest
+    {
+        /// <summary>
+        /// 获取或设置活动 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string ActivityId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置报名商户号。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("applying_merchant_id")]
+        [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.NumericalStringConverter))]
+        [System.Text.Json.Serialization.JsonPropertyName("applying_merchant_id")]
+        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Converters.NumericalStringConverter))]
+        public string ApplyingMerchantId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置门店 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("store_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("store_id")]
+        public int StoreId { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/MarketingWeeklyDiscount/ApplyMarketingWeeklyDiscountActivityResponse.cs

@@ -0,0 +1,26 @@
+using System;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /marketing/weekly-discount/activities/{activity_id}/apply 接口的响应。</para>
+    /// </summary>
+    public class ApplyMarketingWeeklyDiscountActivityResponse : WechatTenpayResponse
+    {
+        /// <summary>
+        /// 获取或设置活动 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_id")]
+        public int ActivityId { get; set; }
+
+        /// <summary>
+        /// 获取或设置成功时间。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("success_time")]
+        [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.RFC3339DateTimeOffsetConverter))]
+        [System.Text.Json.Serialization.JsonPropertyName("success_time")]
+        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Converters.RFC3339DateTimeOffsetConverter))]
+        public DateTimeOffset SuccessTime { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/MarketingWeeklyDiscount/GetApplyMarketingWeeklyDiscountActivityByActivityIdRequest.cs

@@ -0,0 +1,15 @@
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /marketing/weekly-discount/activities/{activity_id} 接口的请求。</para>
+    /// </summary>
+    public class GetApplyMarketingWeeklyDiscountActivityByActivityIdRequest : WechatTenpayRequest
+    {
+        /// <summary>
+        /// 获取或设置活动 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string ActivityId { get; set; } = string.Empty;
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/MarketingWeeklyDiscount/GetApplyMarketingWeeklyDiscountActivityByActivityIdResponse.cs

@@ -0,0 +1,120 @@
+using System;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /marketing/weekly-discount/activities/{activity_id} 接口的响应。</para>
+    /// </summary>
+    public class GetApplyMarketingWeeklyDiscountActivityByActivityIdResponse : WechatTenpayResponse
+    {
+        /// <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("activity_name")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_name")]
+        public string ActivityName { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置活动投放场景。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_scene")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_scene")]
+        public string ActivityScene { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置活动投放区域编码列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_area_code")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_area_code")]
+        public string[] ActivityAreaCodeList { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置活动状态。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_state")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_state")]
+        public string ActivityState { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置指定付款方式编码。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_limit_pay")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_limit_pay")]
+        public string? LimitPayCode { get; set; }
+
+        /// <summary>
+        /// 获取或设置活动优惠门槛（单位：分）。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_transaction_minimum_amount")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_transaction_minimum_amount")]
+        public int TransactionMinimumAmount { get; set; }
+
+        /// <summary>
+        /// 获取或设置活动优惠金额（单位：分）。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_coupon_amount")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_coupon_amount")]
+        public int CouponAmount { get; set; }
+
+        /// <summary>
+        /// 获取或设置可使用周期列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_available_week")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_available_week")]
+        [System.Text.Json.Serialization.JsonNumberHandling(System.Text.Json.Serialization.JsonNumberHandling.AllowReadingFromString)]
+        public int[] AvailableWeekList { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置活动预算（单位：分）。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_max_amount")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_max_amount")]
+        public int MaxAmount { get; set; }
+
+        /// <summary>
+        /// 获取或设置活动单日预算（单位：分）。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_max_amount_per_day")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_max_amount_per_day")]
+        public int? MaxAmountPerDay { get; set; }
+
+        /// <summary>
+        /// 获取或设置活动开始时间。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_available_begin_time")]
+        [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.RFC3339DateTimeOffsetConverter))]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_available_begin_time")]
+        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Converters.RFC3339DateTimeOffsetConverter))]
+        public DateTimeOffset BeginTime { get; set; }
+
+        /// <summary>
+        /// 获取或设置活动结束时间。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_available_end_time")]
+        [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.RFC3339DateTimeOffsetConverter))]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_available_end_time")]
+        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Converters.RFC3339DateTimeOffsetConverter))]
+        public DateTimeOffset EndTime { get; set; }
+
+        /// <summary>
+        /// 获取或设置 Logo 地址。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_logo")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_logo")]
+        public string? LogoUrl { get; set; }
+
+        /// <summary>
+        /// 获取或设置备注。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("activity_remark")]
+        [System.Text.Json.Serialization.JsonPropertyName("activity_remark")]
+        public string? Remark { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/MarketingWeeklyDiscount/QueryApplyMarketingWeeklyDiscountActivitiesRequest.cs

@@ -0,0 +1,51 @@
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /marketing/weekly-discount/activities 接口的请求。</para>
+    /// </summary>
+    public class QueryApplyMarketingWeeklyDiscountActivitiesRequest : WechatTenpayRequest
+    {
+        /// <summary>
+        /// 获取或设置投放场景。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string ActivityScene { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置活动投放区域编码。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public int ActivityAreaCode { get; set; }
+
+        /// <summary>
+        /// 获取或设置报名商户号。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string ApplyingMerchantId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置门店 ID。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public int? StoreId { get; set; }
+
+        /// <summary>
+        /// 获取或设置分页大小。
+        /// <para>默认值：10</para>
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public int Limit { get; set; } = 10;
+
+        /// <summary>
+        /// 获取或设置分页开始位置。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public int Offset { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/MarketingWeeklyDiscount/QueryApplyMarketingWeeklyDiscountActivitiesResponse.cs

@@ -0,0 +1,154 @@
+using System;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /marketing/weekly-discount/activities 接口的响应。</para>
+    /// </summary>
+    public class QueryApplyMarketingWeeklyDiscountActivitiesResponse : WechatTenpayResponse
+    {
+        public static class Types
+        {
+            public class Activity
+            {
+                /// <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("activity_name")]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_name")]
+                public string ActivityName { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置活动投放场景。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_scene")]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_scene")]
+                public string ActivityScene { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置活动投放区域编码列表。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_area_code")]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_area_code")]
+                public string[] ActivityAreaCodeList { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置活动状态。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_state")]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_state")]
+                public string ActivityState { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置指定付款方式编码。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_limit_pay")]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_limit_pay")]
+                public string? LimitPayCode { get; set; }
+
+                /// <summary>
+                /// 获取或设置活动优惠门槛（单位：分）。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_transaction_minimum_amount")]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_transaction_minimum_amount")]
+                public int TransactionMinimumAmount { get; set; }
+
+                /// <summary>
+                /// 获取或设置活动优惠金额（单位：分）。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_coupon_amount")]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_coupon_amount")]
+                public int CouponAmount { get; set; }
+
+                /// <summary>
+                /// 获取或设置可使用周期列表。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_available_week")]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_available_week")]
+                [System.Text.Json.Serialization.JsonNumberHandling(System.Text.Json.Serialization.JsonNumberHandling.AllowReadingFromString)]
+                public int[] AvailableWeekList { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置活动预算（单位：分）。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_max_amount")]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_max_amount")]
+                public int MaxAmount { get; set; }
+
+                /// <summary>
+                /// 获取或设置活动单日预算（单位：分）。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_max_amount_per_day")]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_max_amount_per_day")]
+                public int? MaxAmountPerDay { get; set; }
+
+                /// <summary>
+                /// 获取或设置活动开始时间。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_available_begin_time")]
+                [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.RFC3339DateTimeOffsetConverter))]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_available_begin_time")]
+                [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Converters.RFC3339DateTimeOffsetConverter))]
+                public DateTimeOffset BeginTime { get; set; }
+
+                /// <summary>
+                /// 获取或设置活动结束时间。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_available_end_time")]
+                [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.RFC3339DateTimeOffsetConverter))]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_available_end_time")]
+                [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Converters.RFC3339DateTimeOffsetConverter))]
+                public DateTimeOffset EndTime { get; set; }
+
+                /// <summary>
+                /// 获取或设置 Logo 地址。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_logo")]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_logo")]
+                public string? LogoUrl { get; set; }
+
+                /// <summary>
+                /// 获取或设置备注。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("activity_remark")]
+                [System.Text.Json.Serialization.JsonPropertyName("activity_remark")]
+                public string? Remark { get; set; }
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置活动列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("data")]
+        [System.Text.Json.Serialization.JsonPropertyName("data")]
+        public Types.Activity[] ActivityList { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置分页大小。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("limit")]
+        [System.Text.Json.Serialization.JsonPropertyName("limit")]
+        public int Limit { get; set; }
+
+        /// <summary>
+        /// 获取或设置分页开始位置。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("offset")]
+        [System.Text.Json.Serialization.JsonPropertyName("offset")]
+        public int Offset { get; set; }
+
+        /// <summary>
+        /// 获取或设置活动总数量。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("total_count")]
+        [System.Text.Json.Serialization.JsonPropertyName("total_count")]
+        public int TotalCount { get; set; }
+    }
+}