feat(tenpayv3): 新增出行券切卡组件预下单接口

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

@@ -0,0 +1,34 @@
+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 WechatTenpayClientExecuteIndustryCouponExtensions
+    {
+        /// <summary>
+        /// <para>异步调用 [POST] /industry-coupon/tokens 接口。</para>
+        /// <para>REF: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter9_9_1.shtml </para>
+        /// <para>REF: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter9_9_1.shtml </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.CreateIndustryCouponTokenResponse> ExecuteCreateIndustryCouponTokenAsync(this WechatTenpayClient client, Models.CreateIndustryCouponTokenRequest 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, "industry-coupon", "tokens");
+
+            return await client.SendRequestWithJsonAsync<Models.CreateIndustryCouponTokenResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
+        }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/IndustryCoupon/CreateIndustryCouponTokenRequest.cs

@@ -0,0 +1,44 @@
+using System.Collections.Generic;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /industry-coupon/tokens 接口的请求。</para>
+    /// </summary>
+    public class CreateIndustryCouponTokenRequest : WechatTenpayRequest
+    {
+        public static class Types
+        {
+            public class Coupon
+            {
+                /// <summary>
+                /// 获取或设置批次号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("stock_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("stock_id")]
+                public int StockId { get; set; }
+
+                /// <summary>
+                /// 获取或设置券 ID。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("coupon_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("coupon_id")]
+                public string CouponId { get; set; } = string.Empty;
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置用户的 OpenId。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("open_id")]
+        [System.Text.Json.Serialization.JsonPropertyName("open_id")]
+        public string OpenId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置券列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("coupon_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("coupon_list")]
+        public IList<Types.Coupon> CouponList { get; set; } = new List<Types.Coupon>();
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/IndustryCoupon/CreateIndustryCouponTokenResponse.cs

@@ -0,0 +1,27 @@
+using System;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [POST] /industry-coupon/tokens 接口的响应。</para>
+    /// </summary>
+    [WechatTenpaySensitive]
+    public class CreateIndustryCouponTokenResponse : WechatTenpayResponse
+    {
+        /// <summary>
+        /// 获取或设置切卡组件 Token。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("token")]
+        [System.Text.Json.Serialization.JsonPropertyName("token")]
+        public string Token { get; set; } = default!;
+
+        /// <summary>
+        /// 获取或设置 Token 过期时间。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("expires_time")]
+        [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.RFC3339DateTimeOffsetConverter))]
+        [System.Text.Json.Serialization.JsonPropertyName("expires_time")]
+        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Converters.RFC3339DateTimeOffsetConverter))]
+        public DateTimeOffset ExpireTime { get; set; }
+    }
+}