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

前言

快速发展的互联网应用开发中，支付功能已成为各类平台不可或缺的一环。为了帮助大家更高效地接入主流支付渠道，推荐一套基于 .NET 开发的第三方支付 SDK。该 SDK 支持跨平台运行，适用于多种操作系统和设备，并提供对支付宝和微信支付的全面支持。

项目介绍

本SDK 以简化接入流程、提升开发效率为目标，设计上注重易用性与扩展性，特别适合需要快速集成支付功能的多商户应用场景。不管是开发电商平台、SaaS 系统，还是其他需要支付能力的应用，本工具都能提供稳定、灵活且高效的解决方案。

项目技术

开发环境

IDE：Rider、Visual Studio
.NET SDK：.NET 9.0

运行环境： 支持的.NET版本.NET 8.0、.NET 9.0

配置选项

本 SDK 提供了针对不同支付平台的客户端配置选项，以确保可以轻松地进行定制化设置：

AlipayClientOptions: 用于配置与支付宝对接所需的各种参数。
WeChatPayClientOptions: 用于配置与微信支付对接所需的各种参数。
配置选项简化开发流程，使得集成支付功能变得更加直观和高效。

项目示例

支付宝 - 示例代码

.NET 开发的第三方支付 SDK 实现支付宝 V3 扫码支付的一个简化步骤：

支付宝 V3 扫码支付实现步骤

1、安装NuGet包

使用命令行工具安装必要的 NuGet 包：

复制代码

dotnet add package Essensoft.Paylinks.Alipay.Client
dotnet add package Essensoft.Paylinks.Alipay.Payments

2、配置依赖注入

在 Startup.cs 或 Program.cs 文件中添加对 AlipayClient 的服务注册：

复制代码

services.AddAlipay/XMLSchema

3、注入 IAlipayClient

在需要使用的地方通过构造函数或方法参数注入 IAlipayClient 实例。

4、支付宝客户端选项

创建并配置 AlipayClientOptions 对象，设置如应用ID、私钥等必要参数（此处省略具体设置）：

复制代码

var options = new AlipayClientOptions()
{
    // 设置您的配置项
};

5、创建请求模型

交易预创建模型 AlipayTradePreCreateBodyModel，包括商户订单号、总金额、商品标题和异步通知地址等信息：

复制代码

var model = new AlipayTradePreCreateBodyModel
{
    OutTradeNo = DateTimeOffset.Now.ToString("yyyyMMddHHmmssfff"),
    TotalAmount = "0.01",
    Subject = "扫码支付测试",
    NotifyUrl = "https://www.domain.com/Alipay/Payments/Notify/TradeResult"
};

6、初始化请求对象

创建一个 AlipayTradePreCreateRequest 实例，并将之前准备好的模型绑定到该请求上：

复制代码

var request = new AlipayTradePreCreateRequest();
request.SetBodyModel(model);

7、执行请求并处理响应

调用 client.ExecuteAsync(request, options) 方法发送请求，并检查响应是否成功。如果成功，则可以获取返回的数据进行后续处理：

复制代码

var response = await client.ExecuteAsync(request, options);
if (response.IsSuccessful)
{
  // 处理成功响应...
}

以上步骤提供了一个简化的流程，帮助快速理解和集成支付宝扫码支付功能到.NET 应用程序中。根据实际需求，可能还需要添加异常处理和日志记录等增强功能。

微信支付 - 示例代码

微信支付 V3 Native 下单示例代码整理出的简化步骤说明，便于快速理解与集成：

微信支付 V3 Native 下单实现步骤

1、安装 NuGet 包

使用命令行安装必要的 SDK 组件：

复制代码

dotnet add package Essensoft.Paylinks.WeChatPay.Client
dotnet add package Essensoft.Paylinks.WeChatPay.Payments

2、注册服务（依赖注入）

在 Startup.cs 或 Program.cs 中注册微信支付客户端服务：

复制代码

services.AddWeChatPayClient();

3、注入 IWeChatPayClient

在需要使用的类中通过构造函数注入微信支付客户端实例：

复制代码

public class PaymentService
{
    private readonly IWeChatPayClient _client;

    public PaymentService(IWeChatPayClient client)
    {
        _client = client;
    }
}

4、微信支付客户端配置选项

创建并设置 WeChatPayClientOptions，例如商户私钥、APIv3 密钥等：

复制代码

var options = new WeChatPayClientOptions()
{
    // 设置您的微信支付相关参数
};

5、创建请求模型

构建 Native 支付下单请求模型 WeChatPayTransactionsNativeBodyModel：

复制代码

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 } // 支付金额，单位：分
};

6、初始化请求对象并绑定模型

创建 WeChatPayTransactionsNativeRequest 实例，并将模型数据绑定到请求体中：

复制代码

var request = new WeChatPayTransactionsNativeRequest();
request.SetBodyModel(model);

7、执行请求并处理响应

调用 ExecuteAsync 方法发起请求，并判断是否成功：

复制代码

var response = await client.ExecuteAsync(request, options);
if (response.IsSuccessful)
{
    // 获取预支付交易码（二维码内容），返回给前端生成二维码
    var codeUrl = response.CodeUrl;
    // 可以生成二维码图片或直接跳转至扫码页面
}
else
{
    // 处理错误信息
    Console.WriteLine($"请求失败: {response.ErrorMessage}");
}

补充建议

订单号生成：建议封装一个方法生成唯一订单号，如 GenerateOutTradeNo()。
日志记录：推荐使用 ILogger 替代 Console.WriteLine，方便追踪问题。
异常处理：实际生产环境中应加入 try-catch 块，防止未捕获异常中断流程。
多商户支持：可通过 IOptionsMonitor<WeChatPayClientOptions> 动态切换不同商户配置。

项目源码

Gitee： https://gitee.com/essensoft/paylinks

GitHub： https://github.com/essensoft/paylinks

总结

以上仅展示了第三方支付SDK的部分功能。更多实用特性和详细信息，请大家访问项目源码。

希望通过本文能为.NET在第三方支付支付宝支付和微信支付开发方面提供有价值的参考。感谢您阅读本篇文章，欢迎在评论区留言交流，分享您的宝贵经验和建议。

最后

如果你觉得这篇文章对你有帮助，不妨点个赞支持一下！你的支持是我继续分享知识的动力。如果有任何疑问或需要进一步的帮助，欢迎随时留言。

也可以加入微信公众号**[DotNet技术匠]** 社区，与其他热爱技术的同行一起交流心得，共同成长！优秀是一种习惯，欢迎大家留言学习！