feat(tenpayv3): 新增查询营销补差付款单列表接口

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

@@ -366,6 +366,31 @@ namespace SKIT.FlurlHttpClient.Wechat.TenpayV3
             return await client.SendRequestWithJsonAsync<Models.CreateMarketingBusifavorSubsidyPayReceiptResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
         }
 
+        /// <summary>
+        /// <para>异步调用 [GET] /marketing/busifavor/subsidy/pay-receipts 接口。</para>
+        /// <para>REF: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter9_2_19.shtml </para>
+        /// <para>REF: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter9_2_19.shtml </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.QueryMarketingBusifavorSubsidyPayReceiptsResponse> ExecuteQueryMarketingBusifavorSubsidyPayReceiptsAsync(this WechatTenpayClient client, Models.QueryMarketingBusifavorSubsidyPayReceiptsRequest 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", "busifavor", "subsidy", "pay-receipts")
+                .SetQueryParam("stock_id", request.StockId)
+                .SetQueryParam("coupon_code", request.CouponCode);
+
+            if (request.OutSubsidyNumber != null)
+                flurlReq.SetQueryParam("out_subsidy_no", request.OutSubsidyNumber);
+
+            return await client.SendRequestWithJsonAsync<Models.QueryMarketingBusifavorSubsidyPayReceiptsResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
+        }
+
         /// <summary>
         /// <para>异步调用 [GET] /marketing/busifavor/subsidy/pay-receipts/{subsidy_receipt_id} 接口。</para>
         /// <para>REF: https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter9_2_18.shtml </para>

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/MarketingBusifavor/Subsidy/QueryMarketingBusifavorSubsidyPayReceiptsRequest.cs

@@ -0,0 +1,29 @@
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /marketing/busifavor/subsidy/pay-receipts 接口的请求。</para>
+    /// </summary>
+    public class QueryMarketingBusifavorSubsidyPayReceiptsRequest : WechatTenpayRequest
+    {
+        /// <summary>
+        /// 获取或设置商家券批次号。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string StockId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置商家券 Code。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string CouponCode { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置补差请求单号。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string? OutSubsidyNumber { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/MarketingBusifavor/Subsidy/QueryMarketingBusifavorSubsidyPayReceiptsResponse.cs

@@ -0,0 +1,118 @@
+using System;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /marketing/busifavor/subsidy/pay-receipts 接口的响应。</para>
+    /// </summary>
+    public class QueryMarketingBusifavorSubsidyPayReceiptsResponse : WechatTenpayResponse
+    {
+        public static class Types
+        {
+            public class PayReceipt
+            {
+                /// <summary>
+                /// 获取或设置补差付款单号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("subsidy_receipt_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("subsidy_receipt_id")]
+                public string SubsidyReceiptId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置商家券批次号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("stock_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("stock_id")]
+                public string StockId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置商家券 Code。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("coupon_code")]
+                [System.Text.Json.Serialization.JsonPropertyName("coupon_code")]
+                public string CouponCode { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置微信支付订单号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("transaction_id")]
+                [System.Text.Json.Serialization.JsonPropertyName("transaction_id")]
+                public string TransactionId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置营销补差扣款商户号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("payer_merchant")]
+                [System.Text.Json.Serialization.JsonPropertyName("payer_merchant")]
+                public string PayerMerchantId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置营销补差入账商户号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("payee_merchant")]
+                [System.Text.Json.Serialization.JsonPropertyName("payee_merchant")]
+                public string PayeeMerchantId { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置补差付款金额（单位：分）。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("amount")]
+                [System.Text.Json.Serialization.JsonPropertyName("amount")]
+                public int Amount { get; set; }
+
+                /// <summary>
+                /// 获取或设置补差付款描述。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("description")]
+                [System.Text.Json.Serialization.JsonPropertyName("description")]
+                public string Description { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置业务请求唯一单号。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("out_subsidy_no")]
+                [System.Text.Json.Serialization.JsonPropertyName("out_subsidy_no")]
+                public string OutSubsidyNumber { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置补差付款单据状态。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("status")]
+                [System.Text.Json.Serialization.JsonPropertyName("status")]
+                public string Status { get; set; } = default!;
+
+                /// <summary>
+                /// 获取或设置补差付款失败原因。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("fail_reason")]
+                [System.Text.Json.Serialization.JsonPropertyName("fail_reason")]
+                public string? FailReason { get; set; }
+
+                /// <summary>
+                /// 获取或设置补差付款完成时间。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("success_time")]
+                [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.RFC3339NullableDateTimeOffsetConverter))]
+                [System.Text.Json.Serialization.JsonPropertyName("success_time")]
+                [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Converters.RFC3339NullableDateTimeOffsetConverter))]
+                public DateTimeOffset? SuccessTime { get; set; }
+
+                /// <summary>
+                /// 获取或设置补差付款发起时间。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("create_time")]
+                [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.RFC3339DateTimeOffsetConverter))]
+                [System.Text.Json.Serialization.JsonPropertyName("create_time")]
+                [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Converters.RFC3339DateTimeOffsetConverter))]
+                public DateTimeOffset CreateTime { get; set; }
+            }
+        }
+
+        /// <summary>
+        /// 获取或设置补差付款单据列表。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("pay_receipt_list")]
+        [System.Text.Json.Serialization.JsonPropertyName("pay_receipt_list")]
+        public Types.PayReceipt[]? PayReceiptList { get; set; }
+    }
+}

test/SKIT.FlurlHttpClient.Wechat.TenpayV3.UnitTests/ModelSamples/MarketingBusifavor/Subsidy/QueryMarketingBusifavorSubsidyPayReceiptsResponse.json

@@ -0,0 +1,18 @@
+{
+    "pay_receipt_list": [
+        {
+            "subsidy_receipt_id": "1120200119165100000000000001",
+            "stock_id": "128888000000001",
+            "coupon_code": "ABCD12345678",
+            "transaction_id": "4200000913202101152566792388",
+            "payer_merchant": "1900000001",
+            "payee_merchant": "1900000002",
+            "amount": 100,
+            "description": "20210115DESCRIPTION",
+            "status": "SUCCESS",
+            "success_time": "2021-01-20T10:29:35.120+08:00",
+            "out_subsidy_no": "subsidy-abcd-12345678",
+            "create_time": "2021-01-20T10:29:35.120+08:00"
+        }
+    ]
+}