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

docs/WechatTenpayV3/Basic_ModelDefinition.md

@@ -82,6 +82,7 @@
 |  √  |        其他：微信点餐订单         |      合作伙伴       |                   |
 |  √  |         其他：微信寄快递          |      合作伙伴       |                   |
 |  √  |        其他：品牌小店营销         |      合作伙伴       |                   |
+|  √  |         其他：银行多笔立减          |      直连商户       |                   |
 |  √  |        其他：银行定向促活         | 直连商户 & 合作伙伴 |                   |
 |  √  |       其他：银行提现免费券        |      合作伙伴       |                   |
 |  √  |         其他：银行周周惠          |      合作伙伴       |                   |
@@ -580,6 +581,12 @@
 
         -   发放消费卡：`SendMarketingBusifavorCoupon`
 
+    -   银行多笔立减
+
+        -   查询绑定多笔立减活动的代金券详情：`GetMarketingBankFavorUserCoupon`
+
+        -   给指定用户报名多笔立减活动：`SendMarketingBankFavorUserBankMultipleActivityCoupon`
+
     -   银行定向促活
 
         -   导入定向用户协议号：`UploadMarketingBankPackagesTasks`

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!;
+    }
+}

test/SKIT.FlurlHttpClient.Wechat.TenpayV3.UnitTests/ModelSamples/_/MarketingBankFavor/GetMarketingBankFavorUserCouponResponse.json

@@ -0,0 +1,20 @@
+{
+    "stock_creator_mchid": "9800064",
+    "stock_id": "9865888",
+    "coupon_id": "98674556",
+    "coupon_name": "微信支付代金券",
+    "coupon_state": "COUPON_STATE_UNKNOW",
+    "receive_time": "2015-05-20T13:29:35.120+08:00",
+    "available_begin_time": "2015-05-20T13:29:35.120+08:00",
+    "available_end_time": "2015-05-20T13:29:35.120+08:00",
+    "activity_id": "186745560",
+    "max_use_number": 5,
+    "available_number": 3,
+    "used_number": 2,
+    "use_amount_list": {
+        "used_amounts": [
+            "200"
+        ]
+    },
+    "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
+}

test/SKIT.FlurlHttpClient.Wechat.TenpayV3.UnitTests/ModelSamples/_/MarketingBankFavor/SendMarketingBankFavorUserBankMultipleActivityCouponRequest.json

@@ -0,0 +1,7 @@
+{
+    "stock_id": "9865888",
+    "activity_id": "186745560",
+    "out_request_no": "6122352020010133287985742",
+    "appid": "wx57849631bb367f52",
+    "stock_creator_mchid": "9800064"
+}

test/SKIT.FlurlHttpClient.Wechat.TenpayV3.UnitTests/ModelSamples/_/MarketingBankFavor/SendMarketingBankFavorUserBankMultipleActivityCouponResponse.json

@@ -0,0 +1,3 @@
+{
+    "coupon_id": "9856888"
+}