Skip to content

Commit c844946

Browse files
fudiweifudiwei
committed
feat(tenpayv3): 新增银行多笔立减相关接口
1 parent f7ad30e commit c844946

9 files changed

Lines changed: 325 additions & 0 deletions

‎docs/WechatTenpayV3/Basic_ModelDefinition.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,7 @@
8282
| √ | 其他：微信点餐订单 | 合作伙伴 | |
8383
| √ | 其他：微信寄快递 | 合作伙伴 | |
8484
| √ | 其他：品牌小店营销 | 合作伙伴 | |
85+
| √ | 其他：银行多笔立减 | 直连商户 | |
8586
| √ | 其他：银行定向促活 | 直连商户 & 合作伙伴 | |
8687
| √ | 其他：银行提现免费券 | 合作伙伴 | |
8788
| √ | 其他：银行周周惠 | 合作伙伴 | |
@@ -580,6 +581,12 @@
580581

581582
- 发放消费卡：`SendMarketingBusifavorCoupon`
582583

584+
- 银行多笔立减
585+
586+
- 查询绑定多笔立减活动的代金券详情：`GetMarketingBankFavorUserCoupon`
587+
588+
- 给指定用户报名多笔立减活动：`SendMarketingBankFavorUserBankMultipleActivityCoupon`
589+
583590
- 银行定向促活
584591

585592
- 导入定向用户协议号：`UploadMarketingBankPackagesTasks`

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

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
using System;
2+
using System.Net.Http;
3+
using System.Threading;
4+
using System.Threading.Tasks;
5+
using Flurl.Http;
6+
7+
namespace SKIT.FlurlHttpClient.Wechat.TenpayV3
8+
{
9+
public static class WechatTenpayClientExecuteMarketingBankFavorExtensions
10+
{
11+
/// <summary>
12+
/// <para>异步调用 [GET] /marketing/bank-favor/users/{openid}/coupons/{coupon_id} 接口。</para>
13+
/// <para>
14+
/// REF: <br/>
15+
/// <![CDATA[ https://pay.weixin.qq.com/doc/v3/merchant/4014569864 ]]>
16+
/// </para>
17+
/// </summary>
18+
/// <param name="client"></param>
19+
/// <param name="request"></param>
20+
/// <param name="cancellationToken"></param>
21+
/// <returns></returns>
22+
public static async Task<Models.GetMarketingBankFavorUserCouponResponse> ExecuteGetMarketingBankFavorUserCouponAsync(this WechatTenpayClient client, Models.GetMarketingBankFavorUserCouponRequest request, CancellationToken cancellationToken = default)
23+
{
24+
if (client is null) throw new ArgumentNullException(nameof(client));
25+
if (request is null) throw new ArgumentNullException(nameof(request));
26+
27+
IFlurlRequest flurlReq = client
28+
.CreateFlurlRequest(request, HttpMethod.Get, "marketing", "bank-favor", "users", request.OpenId, "coupons", request.CouponId)
29+
.SetQueryParam("appid", request.AppId);
30+
31+
return await client.SendFlurlRequestAsJsonAsync<Models.GetMarketingBankFavorUserCouponResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
32+
}
33+
34+
/// <summary>
35+
/// <para>异步调用 [POST] /marketing/bank-favor/users/{openid}/bank-multi-activity 接口。</para>
36+
/// <para>
37+
/// REF: <br/>
38+
/// <![CDATA[ https://pay.weixin.qq.com/doc/v3/merchant/4014569793 ]]>
39+
/// </para>
40+
/// </summary>
41+
/// <param name="client"></param>
42+
/// <param name="request"></param>
43+
/// <param name="cancellationToken"></param>
44+
/// <returns></returns>
45+
public static async Task<Models.SendMarketingBankFavorUserBankMultipleActivityCouponResponse> ExecuteSendMarketingBankFavorUserBankMultipleActivityCouponAsync(this WechatTenpayClient client, Models.SendMarketingBankFavorUserBankMultipleActivityCouponRequest request, CancellationToken cancellationToken = default)
46+
{
47+
if (client is null) throw new ArgumentNullException(nameof(client));
48+
if (request is null) throw new ArgumentNullException(nameof(request));
49+
50+
if (request.StockCreatorMerchantId is null)
51+
request.StockCreatorMerchantId = client.Credentials.MerchantId;
52+
53+
IFlurlRequest flurlReq = client
54+
.CreateFlurlRequest(request, HttpMethod.Post, "marketing", "bank-favor", "users", request.OpenId, "bank-multi-activity");
55+
56+
return await client.SendFlurlRequestAsJsonAsync<Models.SendMarketingBankFavorUserBankMultipleActivityCouponResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
57+
}
58+
}
59+
}

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

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
2+
{
3+
/// <summary>
4+
/// <para>表示 [GET] /marketing/bank-favor/users/{openid}/coupons/{coupon_id} 接口的请求。</para>
5+
/// </summary>
6+
public class GetMarketingBankFavorUserCouponRequest : WechatTenpayRequest
7+
{
8+
/// <summary>
9+
/// 获取或设置微信 AppId。
10+
/// </summary>
11+
[Newtonsoft.Json.JsonIgnore]
12+
[System.Text.Json.Serialization.JsonIgnore]
13+
public string AppId { get; set; } = string.Empty;
14+
15+
/// <summary>
16+
/// 获取或设置用户 OpenId。
17+
/// </summary>
18+
[Newtonsoft.Json.JsonIgnore]
19+
[System.Text.Json.Serialization.JsonIgnore]
20+
public string OpenId { get; set; } = string.Empty;
21+
22+
/// <summary>
23+
/// 获取或设置代金券 ID。
24+
/// </summary>
25+
[Newtonsoft.Json.JsonIgnore]
26+
[System.Text.Json.Serialization.JsonIgnore]
27+
public string CouponId { get; set; } = string.Empty;
28+
}
29+
}

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

Lines changed: 135 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,135 @@
1+
using System;
2+
3+
namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
4+
{
5+
/// <summary>
6+
/// <para>表示 [GET] /marketing/bank-favor/users/{openid}/coupons/{coupon_id} 接口的响应。</para>
7+
/// </summary>
8+
public class GetMarketingBankFavorUserCouponResponse : WechatTenpayResponse
9+
{
10+
public static class Types
11+
{
12+
public class UsedAmountList
13+
{
14+
/// <summary>
15+
/// 获取或设置已用金额列表（单位：分）。
16+
/// </summary>
17+
[Newtonsoft.Json.JsonProperty("used_amounts")]
18+
[System.Text.Json.Serialization.JsonPropertyName("used_amounts")]
19+
[System.Text.Json.Serialization.JsonNumberHandling(System.Text.Json.Serialization.JsonNumberHandling.AllowReadingFromString)]
20+
public int[] Items { get; set; } = default!;
21+
}
22+
}
23+
24+
/// <summary>
25+
/// 获取或设置批次 ID。
26+
/// </summary>
27+
[Newtonsoft.Json.JsonProperty("stock_id")]
28+
[System.Text.Json.Serialization.JsonPropertyName("stock_id")]
29+
public string StockId { get; set; } = default!;
30+
31+
/// <summary>
32+
/// 获取或设置创建批次的商户号。
33+
/// </summary>
34+
[Newtonsoft.Json.JsonProperty("stock_creator_mchid")]
35+
[System.Text.Json.Serialization.JsonPropertyName("stock_creator_mchid")]
36+
public string StockCreatorMerchantId { get; set; } = default!;
37+
38+
/// <summary>
39+
/// 获取或设置代金券 ID。
40+
/// </summary>
41+
[Newtonsoft.Json.JsonProperty("coupon_id")]
42+
[System.Text.Json.Serialization.JsonPropertyName("coupon_id")]
43+
public string CouponId { get; set; } = default!;
44+
45+
/// <summary>
46+
/// 获取或设置代金券名称。
47+
/// </summary>
48+
[Newtonsoft.Json.JsonProperty("coupon_name")]
49+
[System.Text.Json.Serialization.JsonPropertyName("coupon_name")]
50+
public string CouponName { get; set; } = default!;
51+
52+
/// <summary>
53+
/// 获取或设置代金券状态。
54+
/// </summary>
55+
[Newtonsoft.Json.JsonProperty("coupon_state")]
56+
[System.Text.Json.Serialization.JsonPropertyName("coupon_state")]
57+
public string CouponState { get; set; } = default!;
58+
59+
/// <summary>
60+
/// 获取或设置微信 AppId。
61+
/// </summary>
62+
[Newtonsoft.Json.JsonProperty("appid")]
63+
[System.Text.Json.Serialization.JsonPropertyName("appid")]
64+
public string AppId { get; set; } = default!;
65+
66+
/// <summary>
67+
/// 获取或设置领券时间。
68+
/// </summary>
69+
[Newtonsoft.Json.JsonProperty("receive_time")]
70+
[Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.Rfc3339DateTimeOffsetConverter))]
71+
[System.Text.Json.Serialization.JsonPropertyName("receive_time")]
72+
[System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.Rfc3339DateTimeOffsetConverter))]
73+
public DateTimeOffset ReceiveTime { get; set; }
74+
75+
/// <summary>
76+
/// 获取或设置券可使用开始时间。
77+
/// </summary>
78+
[Newtonsoft.Json.JsonProperty("available_begin_time")]
79+
[Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.Rfc3339DateTimeOffsetConverter))]
80+
[System.Text.Json.Serialization.JsonPropertyName("available_begin_time")]
81+
[System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.Rfc3339DateTimeOffsetConverter))]
82+
public DateTimeOffset AvailableBeginTime { get; set; }
83+
84+
/// <summary>
85+
/// 获取或设置券可使用结束时间。
86+
/// </summary>
87+
[Newtonsoft.Json.JsonProperty("available_end_time")]
88+
[Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.Rfc3339DateTimeOffsetConverter))]
89+
[System.Text.Json.Serialization.JsonPropertyName("available_end_time")]
90+
[System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.Rfc3339DateTimeOffsetConverter))]
91+
public DateTimeOffset AvailableEndTime { get; set; }
92+
93+
/// <summary>
94+
/// 获取或设置用户 OpenId。
95+
/// </summary>
96+
[Newtonsoft.Json.JsonProperty("openid")]
97+
[System.Text.Json.Serialization.JsonPropertyName("openid")]
98+
public string? OpenId { get; set; }
99+
100+
/// <summary>
101+
/// 获取或设置多笔立减活动 ID。
102+
/// </summary>
103+
[Newtonsoft.Json.JsonProperty("activity_id")]
104+
[System.Text.Json.Serialization.JsonPropertyName("activity_id")]
105+
public string ActivityId { get; set; } = default!;
106+
107+
/// <summary>
108+
/// 获取或设置券最大使用次数。
109+
/// </summary>
110+
[Newtonsoft.Json.JsonProperty("max_use_number")]
111+
[System.Text.Json.Serialization.JsonPropertyName("max_use_number")]
112+
public int MaxUseCount { get; set; }
113+
114+
/// <summary>
115+
/// 获取或设置券剩余可用次数。
116+
/// </summary>
117+
[Newtonsoft.Json.JsonProperty("available_number")]
118+
[System.Text.Json.Serialization.JsonPropertyName("available_number")]
119+
public int AvailableCount { get; set; }
120+
121+
/// <summary>
122+
/// 获取或设置券已使用次数。
123+
/// </summary>
124+
[Newtonsoft.Json.JsonProperty("used_number")]
125+
[System.Text.Json.Serialization.JsonPropertyName("used_number")]
126+
public int UsedCount { get; set; }
127+
128+
/// <summary>
129+
/// 获取或设置已用金额列表。
130+
/// </summary>
131+
[Newtonsoft.Json.JsonProperty("use_amount_list")]
132+
[System.Text.Json.Serialization.JsonPropertyName("use_amount_list")]
133+
public Types.UsedAmountList? UsedAmountList { get; set; }
134+
}
135+
}

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

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
2+
{
3+
/// <summary>
4+
/// <para>表示 [POST] /marketing/bank-favor/users/{openid}/bank-multi-activity 接口的请求。</para>
5+
/// </summary>
6+
public class SendMarketingBankFavorUserBankMultipleActivityCouponRequest : WechatTenpayRequest
7+
{
8+
/// <summary>
9+
/// 获取或设置批次 ID。
10+
/// </summary>
11+
[Newtonsoft.Json.JsonProperty("stock_id")]
12+
[System.Text.Json.Serialization.JsonPropertyName("stock_id")]
13+
public string StockId { get; set; } = string.Empty;
14+
15+
/// <summary>
16+
/// 获取或设置创建批次的商户号。如果不指定将使用构造 <see cref="WechatTenpayClient"/> 时的 <see cref="WechatTenpayClientOptions.MerchantId"/> 参数。
17+
/// </summary>
18+
[Newtonsoft.Json.JsonProperty("stock_creator_mchid")]
19+
[System.Text.Json.Serialization.JsonPropertyName("stock_creator_mchid")]
20+
public string? StockCreatorMerchantId { get; set; }
21+
22+
/// <summary>
23+
/// 获取或设置微信 AppId。
24+
/// </summary>
25+
[Newtonsoft.Json.JsonProperty("appid")]
26+
[System.Text.Json.Serialization.JsonPropertyName("appid")]
27+
public string AppId { get; set; } = string.Empty;
28+
29+
/// <summary>
30+
/// 获取或设置用户 OpenId。
31+
/// </summary>
32+
[Newtonsoft.Json.JsonIgnore]
33+
[System.Text.Json.Serialization.JsonIgnore]
34+
public string OpenId { get; set; } = string.Empty;
35+
36+
/// <summary>
37+
/// 获取或设置多笔立减活动 ID。
38+
/// </summary>
39+
[Newtonsoft.Json.JsonProperty("activity_id")]
40+
[System.Text.Json.Serialization.JsonPropertyName("activity_id")]
41+
public string ActivityId { get; set; } = string.Empty;
42+
43+
/// <summary>
44+
/// 获取或设置商户单号。
45+
/// </summary>
46+
[Newtonsoft.Json.JsonProperty("out_request_no")]
47+
[System.Text.Json.Serialization.JsonPropertyName("out_request_no")]
48+
public string OutRequestNumber { get; set; } = string.Empty;
49+
}
50+
}

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

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models
2+
{
3+
/// <summary>
4+
/// <para>表示 [POST] /marketing/bank-favor/users/{openid}/bank-multi-activity 接口的响应。</para>
5+
/// </summary>
6+
public class SendMarketingBankFavorUserBankMultipleActivityCouponResponse : WechatTenpayResponse
7+
{
8+
/// <summary>
9+
/// 获取或设置代金券 ID。
10+
/// </summary>
11+
[Newtonsoft.Json.JsonProperty("coupon_id")]
12+
[System.Text.Json.Serialization.JsonPropertyName("coupon_id")]
13+
public string CouponId { get; set; } = default!;
14+
}
15+
}

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

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
{
2+
"stock_creator_mchid": "9800064",
3+
"stock_id": "9865888",
4+
"coupon_id": "98674556",
5+
"coupon_name": "微信支付代金券",
6+
"coupon_state": "COUPON_STATE_UNKNOW",
7+
"receive_time": "2015-05-20T13:29:35.120+08:00",
8+
"available_begin_time": "2015-05-20T13:29:35.120+08:00",
9+
"available_end_time": "2015-05-20T13:29:35.120+08:00",
10+
"activity_id": "186745560",
11+
"max_use_number": 5,
12+
"available_number": 3,
13+
"used_number": 2,
14+
"use_amount_list": {
15+
"used_amounts": [
16+
"200"
17+
]
18+
},
19+
"openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
20+
}

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

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
{
2+
"stock_id": "9865888",
3+
"activity_id": "186745560",
4+
"out_request_no": "6122352020010133287985742",
5+
"appid": "wx57849631bb367f52",
6+
"stock_creator_mchid": "9800064"
7+
}

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
{
2+
"coupon_id": "9856888"
3+
}

0 commit comments

Comments
 (0)