Bitzsoft.Integrations.Payment.Stripe 1.0.1

Bitzsoft.Integrations.Payment.Stripe

Stripe 支付服务实现，实现 IPaymentProvider 统一接口。

功能特性

• Checkout Session 下单：基于 Stripe Checkout Session 创建支付订单，返回支付链接
• 全流程覆盖：下单、查单、关单、退款均通过统一 IPaymentProvider 接口暴露
• Webhook 验签：除 IPaymentProvider.VerifyCallbackAsync 兼容入口外，额外注册 IWebhookVerifier，可接入 Bitzsoft.Integrations.Webhooks 原始字节验签、防重放、幂等 Inbox、重试与 DLQ
• 多租户凭据：支持按 WebhookRoute 租户解析 Webhook 密钥，防止租户间误用全局密钥
• 零厂商 SDK 依赖：裸 HttpClient 直调 REST API，包体积小
• 请求审计：内置 RequestLogging 管道，记录出站请求

安装

dotnet add package Bitzsoft.Integrations.Payment.Stripe

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

配置

appsettings.json

{
  "Stripe": {
    "SecretKey": "sk_live_xxx",
    "WebhookSecret": "whsec_xxx"
  }
}

注册服务

从 IConfiguration 绑定（推荐）

using Microsoft.Extensions.DependencyInjection;

builder.Services.AddBitzsoftStripePayment(
    builder.Configuration.GetSection("Stripe"));

委托配置

builder.Services.AddBitzsoftStripePayment(options =>
{
    options.SecretKey = "sk_live_xxx";
    options.WebhookSecret = "whsec_xxx";
});

使用示例

注入 IPaymentProvider 调用

using Bitzsoft.Integrations.Payment;

public class OrderService(IPaymentProvider payment)
{
    public async Task<string> CreatePaymentAsync(string outTradeNo, long amountCents, string subject)
    {
        var result = await payment.CreateOrderAsync(new PaymentOrderRequest
        {
            OutTradeNo = outTradeNo,
            Subject = subject,
            TotalAmount = amountCents,
            Currency = "USD",
            Scene = PaymentScene.Web
        });

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

        return result.Data!.PayUrl!;
    }

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

Webhook Gateway（多租户）

宿主以可信 endpoint 解析租户后调用 Gateway：

var route = new WebhookRoute(
    tenantId,
    "Payment:stripe",
    endpointId,
    region: "global",
    environment: "Live");

var result = await gateway.ReceiveAsync(
    route,
    new WebhookRequest(rawBody, headers, contentType: "application/json"),
    cancellationToken);

多租户宿主应设置 UseTenantWebhookCredentials = true，并按 Payment:stripe 的 IntegrationCredentialKey 配置 WebhookSecret 字段。该模式下缺失租户凭据会直接失败，不会回退到全局 WebhookSecret。

依赖

相关包