.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}");
}