.NET 8 开发的跨平台多商户第三方支付SDK

老盐發表於 2025-5-16 09:20:00

.NET 8 开发的跨平台多商户第三方支付SDK

<h2>前言</h2>
快速发展的互联网应用开发中，支付功能已成为各类平台不可或缺的一环。为了帮助大家更高效地接入主流支付渠道，推荐一套基于 .NET 开发的第三方支付 SDK。该 SDK 支持跨平台运行，适用于多种操作系统和设备，并提供对支付宝和微信支付的全面支持。
<h2>项目介绍</h2>
本SDK 以简化接入流程、提升开发效率为目标，设计上注重易用性与扩展性，特别适合需要快速集成支付功能的多商户应用场景。不管是开发电商平台、SaaS 系统，还是其他需要支付能力的应用，本工具都能提供稳定、灵活且高效的解决方案。
<img src="https://img2024.cnblogs.com/blog/576536/202505/576536-20250516091325235-744794644.png" width="700" loading="lazy" style="display: block; margin-left: auto; margin-right: auto">
<h2>项目技术</h2>
开发环境
<ul>
<li>IDE：Rider、Visual Studio</li>
<li>.NET SDK：.NET 9.0</li>
</ul>
运行环境：支持的.NET版本.NET 8.0、.NET 9.0
<h3>配置选项</h3>
本 SDK 提供了针对不同支付平台的客户端配置选项，以确保可以轻松地进行定制化设置：
<ul>
<li>AlipayClientOptions: 用于配置与支付宝对接所需的各种参数。</li>
<li>WeChatPayClientOptions: 用于配置与微信支付对接所需的各种参数。</li>
<li>配置选项简化开发流程，使得集成支付功能变得更加直观和高效。</li>
</ul>
<h2>项目示例</h2>
<h3>支付宝 - 示例代码</h3>
.NET 开发的第三方支付 SDK 实现支付宝 V3 扫码支付的一个简化步骤：
支付宝 V3 扫码支付实现步骤
1、安装NuGet包
使用命令行工具安装必要的 NuGet 包：
<div class="cnblogs_code">
<pre>dotnet add package Essensoft.Paylinks.Alipay.Client
dotnet add package Essensoft.Paylinks.Alipay.Payments</pre>
</div>
2、配置依赖注入
在 <code>Startup.cs</code> 或 <code>Program.cs</code> 文件中添加对 <code>AlipayClient</code> 的服务注册：
<div class="cnblogs_code">
<pre>services.AddAlipay/XMLSchema</pre>
</div>
3、注入 IAlipayClient
在需要使用的地方通过构造函数或方法参数注入 <code>IAlipayClient</code> 实例。
4、支付宝客户端选项
创建并配置 <code>AlipayClientOptions</code> 对象，设置如应用ID、私钥等必要参数（此处省略具体设置）：
<div class="cnblogs_code">
<pre>var options = new AlipayClientOptions()
{
// 设置您的配置项
};</pre>
</div>
5、创建请求模型
交易预创建模型 <code>AlipayTradePreCreateBodyModel</code>，包括商户订单号、总金额、商品标题和异步通知地址等信息：
<div class="cnblogs_code">
<pre>var model = new AlipayTradePreCreateBodyModel
{
OutTradeNo = DateTimeOffset.Now.ToString("yyyyMMddHHmmssfff"),
TotalAmount = "0.01",
Subject = "扫码支付测试",
NotifyUrl = "https://www.domain.com/Alipay/Payments/Notify/TradeResult"
};</pre>
</div>
6、初始化请求对象
创建一个 <code>AlipayTradePreCreateRequest</code> 实例，并将之前准备好的模型绑定到该请求上：
<div class="cnblogs_code">
<pre>var request = new AlipayTradePreCreateRequest();
request.SetBodyModel(model);</pre>
</div>
7、执行请求并处理响应
调用 <code>client.ExecuteAsync(request, options)</code> 方法发送请求，并检查响应是否成功。如果成功，则可以获取返回的数据进行后续处理：
<div class="code-block-extension-header">
<div class="code-block-extension-headerLeft">
<div class="cnblogs_code">
<pre>var response = await client.ExecuteAsync(request, options);
if (response.IsSuccessful)
{
// 处理成功响应...
}</pre>
</div>
</div>
</div>
以上步骤提供了一个简化的流程，帮助快速理解和集成支付宝扫码支付功能到.NET 应用程序中。根据实际需求，可能还需要添加异常处理和日志记录等增强功能。
<h3>微信支付 - 示例代码</h3>
微信支付 V3 Native 下单示例代码整理出的简化步骤说明，便于快速理解与集成：
微信支付 V3 Native 下单实现步骤
1、安装 NuGet 包
使用命令行安装必要的 SDK 组件：
<div class="cnblogs_code">
<pre>dotnet add package Essensoft.Paylinks.WeChatPay.Client
dotnet add package Essensoft.Paylinks.WeChatPay.Payments</pre>
</div>
2、注册服务（依赖注入）
在 <code>Startup.cs</code> 或 <code>Program.cs</code> 中注册微信支付客户端服务：
<div class="code-block-extension-header">
<div class="code-block-extension-headerLeft">
<div class="cnblogs_code">
<pre>services.AddWeChatPayClient();</pre>
</div>
</div>
</div>
3、注入 <code>IWeChatPayClient</code>
在需要使用的类中通过构造函数注入微信支付客户端实例：
<div class="cnblogs_code">
<pre>public class PaymentService
{
private readonly IWeChatPayClient _client;

public PaymentService(IWeChatPayClient client)
{
_client = client;
}
}</pre>
</div>
4、微信支付客户端配置选项
创建并设置 <code>WeChatPayClientOptions</code>，例如商户私钥、APIv3 密钥等：
<div class="code-block-extension-header">
<div class="code-block-extension-headerLeft">
<div class="cnblogs_code">
<pre>var options = new WeChatPayClientOptions()
{
// 设置您的微信支付相关参数
};</pre>
</div>
</div>
</div>
5、创建请求模型
构建 Native 支付下单请求模型 <code>WeChatPayTransactionsNativeBodyModel</code>：
<div class="cnblogs_code">
<pre>var model = new WeChatPayTransactionsNativeBodyModel
{
AppId = "123456789", // 应用ID
MchId = "123456789", // 商户号
Description = "Native下单测试", // 商品描述
OutTradeNo = DateTimeOffset.Now.ToString("yyyyMMddHHmmssfff"), // 商户订单号
NotifyUrl = "https://www.domain.com/WeChatPay/Payments/Notify/TransactionSuccess", // 异步通知地址
Amount = new CommReqAmountInfo { Total = 1 } // 支付金额，单位：分
};</pre>
</div>
6、初始化请求对象并绑定模型
创建 <code>WeChatPayTransactionsNativeRequest</code> 实例，并将模型数据绑定到请求体中：
<div class="cnblogs_code">
<pre>var request = new WeChatPayTransactionsNativeRequest();
request.SetBodyModel(model);</pre>
</div>
7、执行请求并处理响应
调用 <code>ExecuteAsync</code> 方法发起请求，并判断是否成功：
<div class="cnblogs_code">
<pre>var response = await client.ExecuteAsync(request, options);
if (response.IsSuccessful)
{
// 获取预支付交易码（二维码内容），返回给前端生成二维码
var codeUrl = response.CodeUrl;
// 可以生成二维码图片或直接跳转至扫码页面
}
else
{
// 处理错误信息
Console.WriteLine($"请求失败: {response.ErrorMessage}");
}</pre>
</div>
<h3>补充建议</h3>
<ul>
<li>
订单号生成：建议封装一个方法生成唯一订单号，如 <code>GenerateOutTradeNo()</code>。
</li>
<li>
日志记录：推荐使用 <code>ILogger</code> 替代 <code>Console.WriteLine</code>，方便追踪问题。
</li>
<li>
异常处理：实际生产环境中应加入 try-catch 块，防止未捕获异常中断流程。
</li>
<li>
多商户支持：可通过 <code>IOptionsMonitor<WeChatPayClientOptions></code> 动态切换不同商户配置。
</li>
</ul>
<h2>项目源码</h2>
Gitee：https://gitee.com/essensoft/paylinks
GitHub：https://github.com/essensoft/paylinks
<h2>总结</h2>
以上仅展示了第三方支付SDK的部分功能。更多实用特性和详细信息，请大家访问项目源码。
希望通过本文能为.NET在第三方支付支付宝支付和微信支付开发方面提供有价值的参考。感谢您阅读本篇文章，欢迎在评论区留言交流，分享您的宝贵经验和建议。
<h2>最后</h2>
如果你觉得这篇文章对你有帮助，不妨点个赞支持一下！你的支持是我继续分享知识的动力。如果有任何疑问或需要进一步的帮助，欢迎随时留言。
也可以加入微信公众号 社区，与其他热爱技术的同行一起交流心得，共同成长！优秀是一种习惯，欢迎大家留言学习！
<img src="https://img2024.cnblogs.com/blog/576536/202408/576536-20240814113403514-910171896.png" alt="" style="display: block; margin-left: auto; margin-right: auto"> 
来源：https://www.cnblogs.com/1312mn/p/18879453

頁: [1]

琼殿技术论坛's Archiver

.NET 8 开发的跨平台多商户第三方支付SDK