From 59697b661bd06973a2145734b571155f0c517fa7 Mon Sep 17 00:00:00 2001 From: Fu Diwei Date: Mon, 3 Apr 2023 19:26:23 +0800 Subject: [PATCH] =?UTF-8?q?feat(tenpayv3):=20=E6=96=B0=E5=A2=9E=E5=BE=AE?= =?UTF-8?q?=E4=BF=A1=E5=AF=84=E5=BF=AB=E9=80=92=E7=9B=B8=E5=85=B3=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/WechatTenpayV3/Basic_ModelDefinition.md | 1 + ...hatTenpayClientExecuteExpressExtensions.cs | 33 +++++++++++++++++++ .../TransformExpressUserOpenIdRequest.cs | 22 +++++++++++++ .../TransformExpressUserOpenIdResponse.cs | 15 +++++++++ .../TransformExpressUserOpenIdRequest.json | 3 ++ .../TransformExpressUserOpenIdResponse.json | 3 ++ 6 files changed, 77 insertions(+) create mode 100644 src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Extensions/WechatTenpayClientExecuteExpressExtensions.cs create mode 100644 src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/Express/TransformExpressUserOpenIdRequest.cs create mode 100644 src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/Express/TransformExpressUserOpenIdResponse.cs create mode 100644 test/SKIT.FlurlHttpClient.Wechat.TenpayV3.UnitTests/ModelSamples/Express/TransformExpressUserOpenIdRequest.json create mode 100644 test/SKIT.FlurlHttpClient.Wechat.TenpayV3.UnitTests/ModelSamples/Express/TransformExpressUserOpenIdResponse.json diff --git a/docs/WechatTenpayV3/Basic_ModelDefinition.md b/docs/WechatTenpayV3/Basic_ModelDefinition.md index f301af3e..46e8e2a0 100644 --- a/docs/WechatTenpayV3/Basic_ModelDefinition.md +++ b/docs/WechatTenpayV3/Basic_ModelDefinition.md @@ -49,6 +49,7 @@ | √ | 行业方案：微信支付分停车服务 | 直连商户 & 服务商 | | | √ | 行业方案：租用充电宝隔夜归还 | 直连商户 | | | √ | 行业方案：微信点餐订单 | 服务商 | | +| √ | 行业方案：微信寄快递 | 服务商 | | | √ | 行业方案：ETC 扣费 | 服务商 | | | √ | 营销工具：代金券 | 直连商户 & 服务商 | | | √ | 营销工具：商家券 | 直连商户 & 服务商 | | diff --git a/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Extensions/WechatTenpayClientExecuteExpressExtensions.cs b/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Extensions/WechatTenpayClientExecuteExpressExtensions.cs new file mode 100644 index 00000000..b8362ee0 --- /dev/null +++ b/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Extensions/WechatTenpayClientExecuteExpressExtensions.cs @@ -0,0 +1,33 @@ +using System; +using System.Net.Http; +using System.Threading; +using System.Threading.Tasks; +using Flurl.Http; + +namespace SKIT.FlurlHttpClient.Wechat.TenpayV3 +{ + /// + /// 为 提供微信寄快递相关的 API 扩展方法。 + /// + public static class WechatTenpayClientExecuteExpressExtensions + { + /// + /// 异步调用 [POST] /express/users/{openid}/transform 接口。 + /// REF: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/Offline/apis/chapter4_9_1.shtml + /// + /// + /// + /// + /// + public static async Task ExecuteTransformExpressUserOpenIdAsync(this WechatTenpayClient client, Models.TransformExpressUserOpenIdRequest 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, "express", "users", request.OpenId, "transform"); + + return await client.SendRequestWithJsonAsync(flurlReq, data: request, cancellationToken: cancellationToken); + } + } +} diff --git a/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/Express/TransformExpressUserOpenIdRequest.cs b/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/Express/TransformExpressUserOpenIdRequest.cs new file mode 100644 index 00000000..1f6254ec --- /dev/null +++ b/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/Express/TransformExpressUserOpenIdRequest.cs @@ -0,0 +1,22 @@ +namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models +{ + /// + /// 表示 [POST] /express/users/{openid}/transform 接口的请求。 + /// + public class TransformExpressUserOpenIdRequest : WechatTenpayRequest + { + /// + /// 获取或设置用户的 OpenId。 + /// + [Newtonsoft.Json.JsonIgnore] + [System.Text.Json.Serialization.JsonIgnore] + public string OpenId { get; set; } = string.Empty; + + /// + /// 获取或设置目标应用的 AppId。 + /// + [Newtonsoft.Json.JsonProperty("appid")] + [System.Text.Json.Serialization.JsonPropertyName("appid")] + public string AppId { get; set; } = string.Empty; + } +} diff --git a/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/Express/TransformExpressUserOpenIdResponse.cs b/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/Express/TransformExpressUserOpenIdResponse.cs new file mode 100644 index 00000000..92067e7f --- /dev/null +++ b/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Models/Express/TransformExpressUserOpenIdResponse.cs @@ -0,0 +1,15 @@ +namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Models +{ + /// + /// 表示 [POST] /express/users/{openid}/transform 接口的响应。 + /// + public class TransformExpressUserOpenIdResponse : WechatTenpayResponse + { + /// + /// 获取或设置转换后的用户 OpenId。 + /// + [Newtonsoft.Json.JsonProperty("openid")] + [System.Text.Json.Serialization.JsonPropertyName("openid")] + public string OpenId { get; set; } = default!; + } +} diff --git a/test/SKIT.FlurlHttpClient.Wechat.TenpayV3.UnitTests/ModelSamples/Express/TransformExpressUserOpenIdRequest.json b/test/SKIT.FlurlHttpClient.Wechat.TenpayV3.UnitTests/ModelSamples/Express/TransformExpressUserOpenIdRequest.json new file mode 100644 index 00000000..48f8da34 --- /dev/null +++ b/test/SKIT.FlurlHttpClient.Wechat.TenpayV3.UnitTests/ModelSamples/Express/TransformExpressUserOpenIdRequest.json @@ -0,0 +1,3 @@ +{ + "appid": "wxaaaa1a123b456c7d" +} diff --git a/test/SKIT.FlurlHttpClient.Wechat.TenpayV3.UnitTests/ModelSamples/Express/TransformExpressUserOpenIdResponse.json b/test/SKIT.FlurlHttpClient.Wechat.TenpayV3.UnitTests/ModelSamples/Express/TransformExpressUserOpenIdResponse.json new file mode 100644 index 00000000..93dd0ce1 --- /dev/null +++ b/test/SKIT.FlurlHttpClient.Wechat.TenpayV3.UnitTests/ModelSamples/Express/TransformExpressUserOpenIdResponse.json @@ -0,0 +1,3 @@ +{ + "openid": "xac1234554567676" +}