Bitzsoft.Integrations.Payment.All 1.0.1

Bitzsoft.Integrations.Payment.All

支付服务聚合包，按配置节自动注册已实现的全部支付供应商。

本包是元包（meta-package），本身不含代码，仅聚合传递引用五个供应商实现包 + 抽象层。

功能特性

• 统一 IPaymentProvider 接口：屏蔽支付宝、微信支付、Stripe、PayPal、银联等供应商差异
• 多供应商配置驱动：按配置节自动注册，仅注册配置中存在的供应商（section.Exists() 判定）
• 跨领域统一解析：通过 IIntegrationProviderResolver<IPaymentProvider> 按供应商编码解析
• 供应商元数据可枚举：IIntegrationProviderCatalog 可枚举当前配置的供应商，读取 API、鉴权、地区、环境、稳定性与限制元数据

安装

dotnet add package Bitzsoft.Integrations.Payment.All

<PackageReference Include="Bitzsoft.Integrations.Payment.All" Version="1.0.0" />

安装后自动引入：

• Bitzsoft.Integrations.Payment -- 抽象层
• Bitzsoft.Integrations.Payment.Alipay -- 支付宝
• Bitzsoft.Integrations.Payment.WeChatPay -- 微信支付
• Bitzsoft.Integrations.Payment.Stripe -- Stripe
• Bitzsoft.Integrations.Payment.PayPal -- PayPal
• Bitzsoft.Integrations.Payment.UnionPay -- 银联

配置

appsettings.json -- 按需配置启用的供应商，未配置的供应商不会注册。

{
  "Payment": {
    "Alipay": {
      "AppId": "your-app-id",
      "MerchantPrivateKey": "your-private-key"
    },
    "WeChatPay": {
      "AppId": "your-app-id",
      "MchId": "your-mch-id",
      "ApiV3Key": "your-api-v3-key"
    },
    "Stripe": {
      "SecretKey": "sk_live_xxx",
      "WebhookSecret": "whsec_xxx"
    },
    "PayPal": {
      "ClientId": "your-client-id",
      "ClientSecret": "your-client-secret",
      "UseSandbox": true
    },
    "UnionPay": {
      "MerId": "your-mer-id",
      "CertPath": "/path/to/your.pfx",
      "CertPassword": "your-cert-password"
    }
  }
}

仅配置中存在的供应商节会被注册，无需删除不想用的供应商节以外的配置。

注册服务

using Microsoft.Extensions.DependencyInjection;

// 一行注册配置中存在的全部供应商
builder.Services.AddBitzsoftPaymentAll(builder.Configuration, "Payment");

单供应商应用可直接注入 IPaymentProvider；多供应商应用请通过 IIntegrationProviderResolver<IPaymentProvider> 按编码解析，不要依赖注册顺序。

使用示例

通过 Resolver 按编码解析（推荐）

using Bitzsoft.Integrations.Core;
using Bitzsoft.Integrations.Payment;

public sealed class CheckoutService(
    IIntegrationProviderResolver<IPaymentProvider> providers)
{
    public async Task<string> CreatePaymentAsync(
        string providerCode, string outTradeNo, long amountCents, string subject)
    {
        // providerCode: "alipay" / "wechatpay" / "stripe" / "paypal" / "unionpay"
        var provider = providers.GetRequired(providerCode);

        var result = await provider.CreateOrderAsync(new PaymentOrderRequest
        {
            OutTradeNo = outTradeNo,
            Subject = subject,
            TotalAmount = amountCents,
            Currency = "CNY",
            Scene = PaymentScene.Web
        });

        if (!result.IsSuccess)
            throw new PaymentException(provider.Code, result.ErrorCode, result.ErrorMessage);

        return result.Data!.PayUrl!;
    }

    public async Task<bool> IsPaidAsync(string providerCode, string outTradeNo)
    {
        var provider = providers.GetRequired(providerCode);
        var result = await provider.QueryStatusAsync(outTradeNo);
        return result.IsSuccess && result.Data!.Status == PaymentStatus.Success;
    }
}

供应商编码对照表

依赖

相关包