docs: 更新示例项目

2025-12-30 02:14:44 +08:00 · 2025-06-04 23:53:34 +08:00
parent ac925f87cf
commit 56ed274c40
45 changed files with 800 additions and 492 deletions
--- a/samples/SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample_NetFramework48/Controllers/TenpayNotifyController.cs
+++ b/samples/SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample_NetFramework48/Controllers/TenpayNotifyController.cs
@@ -0,0 +1,83 @@
+using System.Diagnostics;
+using System.IO;
+using System.Linq;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+using System.Web.Http;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample.Controllers
+{
+    using SKIT.FlurlHttpClient.Wechat.TenpayV3;
+
+    [RoutePrefix("api/notify")]
+    public class TenpayNotifyController : ApiController
+    {
+        private readonly Services.HttpClients.IWechatTenpayClientFactory _wechatTenpayClientFactory;
+
+        public TenpayNotifyController(
+            Services.HttpClients.IWechatTenpayClientFactory wechatTenpayClientFactory)
+        {
+            _wechatTenpayClientFactory = wechatTenpayClientFactory;
+        }
+
+
+        [HttpPost]
+        [Route("m-{merchant_id}/message-push")]
+        public async Task<IHttpActionResult> ReceiveMessage([FromUri(Name = "merchant_id")] string merchantId, CancellationToken cancellationToken)
+        {
+            using (var stream = await Request.Content.ReadAsStreamAsync())
+            using (var reader = new StreamReader(stream, Encoding.UTF8))
+            {
+                string timestamp = Request.Headers.Contains("Wechatpay-Timestamp") ? Request.Headers.GetValues("Wechatpay-Timestamp").First() : null;
+                string nonce = Request.Headers.Contains("Wechatpay-Nonce") ? Request.Headers.GetValues("Wechatpay-Nonce").First() : null;
+                string signature = Request.Headers.Contains("Wechatpay-Signature") ? Request.Headers.GetValues("Wechatpay-Signature").First() : null;
+                string serialNumber = Request.Headers.Contains("Wechatpay-Serial") ? Request.Headers.GetValues("Wechatpay-Serial").First() : null;
+                string content = await reader.ReadToEndAsync();
+                Debug.WriteLine("接收到微信支付推送的数据：{0}", content);
+
+                using (var client = _wechatTenpayClientFactory.Create(merchantId))
+                {
+                    bool valid = client.VerifyEventSignature(
+                        webhookTimestamp: timestamp,
+                        webhookNonce: nonce,
+                        webhookBody: content,
+                        webhookSignature: signature,
+                        webhookSerialNumber: serialNumber
+                    );
+                    if (!valid)
+                    {
+                        // NOTICE:
+                        //   需提前注入 CertificateManager、并添加平台证书，才可以使用扩展方法执行验签操作。
+                        //   请参考本示例项目 TenpayCertificateRefreshingBackgroundService 后台任务中的相关实现。
+                        //   有关 CertificateManager 的完整介绍请参阅《开发文档 / 基础用法 / 如何验证回调通知事件签名？》。
+                        //   后续如何解密并反序列化，请参阅《开发文档 / 基础用法 / 如何解密回调通知事件中的敏感数据？》。
+
+                        return Json(new { code = "FAIL", message = "验签失败" });
+                    }
+
+                    var callbackModel = client.DeserializeEvent(content);
+                    var eventType = callbackModel.EventType?.ToUpper();
+                    switch (eventType)
+                    {
+                        case "TRANSACTION.SUCCESS":
+                            {
+                                var callbackResource = client.DecryptEventResource<Events.TransactionResource>(callbackModel);
+                                Debug.WriteLine("接收到微信支付推送的订单支付成功通知，商户订单号：{0}", callbackResource.OutTradeNumber);
+                                // 后续处理略
+                            }
+                            break;
+
+                        default:
+                            {
+                                // 其他情况略
+                            }
+                            break;
+                    }
+
+                    return Json(new { code = "SUCCESS", message = "成功" });
+                }
+            }
+        }
+    }
+}
--- a/samples/SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample_NetFramework48/Controllers/TenpayOrderController.cs
+++ b/samples/SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample_NetFramework48/Controllers/TenpayOrderController.cs
@@ -0,0 +1,54 @@
+using System;
+using System.Diagnostics;
+using System.Threading;
+using System.Threading.Tasks;
+using System.Web.Http;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample.Controllers
+{
+    using SKIT.FlurlHttpClient.Wechat.TenpayV3;
+    using SKIT.FlurlHttpClient.Wechat.TenpayV3.Models;
+
+    [RoutePrefix("api/order")]
+    public class TenpayOrderController : ApiController
+    {
+        private readonly Services.HttpClients.IWechatTenpayClientFactory _wechatTenpayClientFactory;
+
+        public TenpayOrderController(
+            Services.HttpClients.IWechatTenpayClientFactory wechatTenpayClientFactory)
+        {
+            _wechatTenpayClientFactory = wechatTenpayClientFactory;
+        }
+
+        [HttpPost]
+        [Route("jsapi")]
+        public async Task<IHttpActionResult> CreateOrderByJsapi([FromBody] Models.CreateOrderByJsapiRequest requestModel, CancellationToken cancellationToken)
+        {
+            if (requestModel == null)
+                return BadRequest();
+
+            using (var client = _wechatTenpayClientFactory.Create(requestModel.MerchantId))
+            {
+                var request = new CreatePayTransactionJsapiRequest()
+                {
+                    OutTradeNumber = "SAMPLE_OTN_" + DateTimeOffset.Now.ToString("yyyyMMddHHmmssfff"),
+                    AppId = requestModel.AppId,
+                    Description = "演示订单",
+                    NotifyUrl = Options.TenpayOptions.Instance.Value.NotifyUrl,
+                    Amount = new CreatePayTransactionJsapiRequest.Types.Amount() { Total = requestModel.Amount },
+                    Payer = new CreatePayTransactionJsapiRequest.Types.Payer() { OpenId = requestModel.OpenId }
+                };
+                var response = await client.ExecuteCreatePayTransactionJsapiAsync(request, cancellationToken);
+                if (!response.IsSuccessful())
+                {
+                    Debug.WriteLine(
+                        "JSAPI 下单失败（状态码：{0}，错误代码：{1}，错误描述：{2}）。",
+                        response.GetRawStatus(), response.ErrorCode, response.ErrorMessage
+                    );
+                }
+
+                return Json(response);
+            }
+        }
+    }
+}
--- a/samples/SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample_NetFramework48/Controllers/TenpayRefundController.cs
+++ b/samples/SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample_NetFramework48/Controllers/TenpayRefundController.cs
@@ -0,0 +1,57 @@
+using System;
+using System.Diagnostics;
+using System.Threading;
+using System.Threading.Tasks;
+using System.Web.Http;
+
+namespace SKIT.FlurlHttpClient.Wechat.TenpayV3.Sample.Controllers
+{
+    using SKIT.FlurlHttpClient.Wechat.TenpayV3;
+    using SKIT.FlurlHttpClient.Wechat.TenpayV3.Models;
+
+    [RoutePrefix("api/refund")]
+    public class TenpayRefundController : ApiController
+    {
+        private readonly Services.HttpClients.IWechatTenpayClientFactory _wechatTenpayClientFactory;
+
+        public TenpayRefundController(
+            Services.HttpClients.IWechatTenpayClientFactory wechatTenpayClientFactory)
+        {
+            _wechatTenpayClientFactory = wechatTenpayClientFactory;
+        }
+
+        [HttpPost]
+        [Route("")]
+        public async Task<IHttpActionResult> CreateRefund([FromBody] Models.CreateRefundRequest requestModel, CancellationToken cancellationToken)
+        {
+            if (requestModel == null)
+                return BadRequest();
+
+            using (var client = _wechatTenpayClientFactory.Create(requestModel.MerchantId))
+            {
+                var request = new CreateRefundDomesticRefundRequest()
+                {
+                    TransactionId = requestModel.TransactionId,
+                    OutRefundNumber = "SAMPLE_ORN_" + DateTimeOffset.Now.ToString("yyyyMMddHHmmssfff"),
+                    Amount = new CreateRefundDomesticRefundRequest.Types.Amount()
+                    {
+                        Total = requestModel.OrderAmount,
+                        Refund = requestModel.RefundAmount
+                    },
+                    Reason = "示例退款",
+                    NotifyUrl = Options.TenpayOptions.Instance.Value.NotifyUrl
+                };
+                var response = await client.ExecuteCreateRefundDomesticRefundAsync(request, cancellationToken);
+                if (!response.IsSuccessful())
+                {
+                    Debug.WriteLine(
+                        "申请退款失败（状态码：{0}，错误代码：{1}，错误描述：{2}）。",
+                        response.GetRawStatus(), response.ErrorCode, response.ErrorMessage
+                    );
+                }
+
+                return Json(response);
+            }
+        }
+    }
+}