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

This commit is contained in:
Fu Diwei 2023-04-03 20:46:41 +08:00
parent bdba0226ed
commit d6b85ef227
12 changed files with 534 additions and 0 deletions

View File

@ -61,6 +61,7 @@
| × | <del>营销工具:现金红包</del> | 直连商户 & 服务商 | 官方未提供 v3 API |
| √ | 营销工具:银行定向促活 | 直连商户 & 服务商 | |
| √ | 营销工具:银行提现免费券 | 服务商 | |
| √ | 营销工具:银行周周惠 | 服务商 | |
| × | <del>资金应用:转账到银行卡</del> | 直连商户 | 官方未提供 v3 API |
| √ | 资金应用:转账到零钱 | 直连商户 & 服务商 | |
| √ | 资金应用:分账 | 直连商户 & 服务商 | |

View File

@ -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);
}
}
}

View File

@ -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; }
}
}

View File

@ -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; }
}
}

View File

@ -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;
}
}

View File

@ -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; }
}
}

View File

@ -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; }
}
}

View File

@ -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; }
}
}

View File

@ -0,0 +1,4 @@
{
"applying_merchant_id": 10000098,
"store_id": 111111
}

View File

@ -0,0 +1,4 @@
{
"activity_id": 10001,
"success_time": "2018-06-08T10:34:56+08:00"
}

View File

@ -0,0 +1,21 @@
{
"activity_area_code": [
"110000"
],
"activity_available_begin_time": "2018-06-08T10:34:56+08:00",
"activity_available_end_time": "2018-08-08T10:34:56+08:00",
"activity_available_week": [
"1"
],
"activity_coupon_amount": 10,
"activity_id": "111111",
"activity_limit_pay": "CCB_DEBIT",
"activity_logo": "https://xxx.xxx.xxx.jpg",
"activity_max_amount": 100000,
"activity_max_amount_per_day": 100000,
"activity_name": "xxx周周惠活动",
"activity_remark": "周周惠,每周日,周一独享",
"activity_scene": "SCAN_CODE_TO_ORDER",
"activity_state": "APPLYING",
"activity_transaction_minimum_amount": 100
}

View File

@ -0,0 +1,28 @@
{
"data": [
{
"activity_area_code": [
"110000"
],
"activity_available_begin_time": "2018-06-08T10:34:56+08:00",
"activity_available_end_time": "2018-08-08T10:34:56+08:00",
"activity_available_week": [
"1"
],
"activity_coupon_amount": 10,
"activity_id": "111111",
"activity_limit_pay": "CCB_DEBIT",
"activity_logo": "https://xxx.xxx.xxx.jpg",
"activity_max_amount": 100000,
"activity_max_amount_per_day": 100000,
"activity_name": "xxx周周惠活动",
"activity_remark": "周周惠,每周日,周一独享",
"activity_scene": "SCAN_CODE_TO_ORDER",
"activity_state": "APPLYING",
"activity_transaction_minimum_amount": 100
}
],
"limit": 5,
"offset": 10,
"total_count": 1234
}