Bitzsoft.Integrations.Payment.Alipay 1.0.1

Bitzsoft.Integrations.Payment.Alipay

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

功能特性

• 多场景下单：APP 支付、电脑网站支付（Page）、手机网站支付（H5/WAP）、扫码当面付（Precreate）
• 交易管理：订单状态查询、关闭订单、申请退款
• 回调验签：异步通知使用支付宝公钥 RSA2 验签，解析交易状态与金额
• RSA2 签名：请求使用应用私钥 SHA256WithRSA 签名（PEM 格式，PKCS#1 / PKCS#8 均可）
• 统一接口：实现 IPaymentProvider，Code 返回 PaymentProviderCode.Alipay
• 请求审计：内置 RequestLogging 管道，记录出站请求

安装

dotnet add package Bitzsoft.Integrations.Payment.Alipay

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

配置

appsettings.json

{
  "Alipay": {
    "AppId": "your-app-id",
    "AppPrivateKey": "-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----",
    "AlipayPublicKey": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----",
    "Gateway": "https://openapi.alipay.com/gateway.do",
    "NotifyUrl": "https://your-domain.com/callback/alipay",
    "SignType": "RSA2"
  }
}

注册服务

从 IConfiguration 绑定（推荐）

using Microsoft.Extensions.DependencyInjection;

builder.Services.AddBitzsoftAlipayPayment(
    builder.Configuration.GetSection("Alipay"));

委托配置

builder.Services.AddBitzsoftAlipayPayment(options =>
{
    options.AppId = "your-app-id";
    options.AppPrivateKey = "-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----";
    options.AlipayPublicKey = "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----";
    options.NotifyUrl = "https://your-domain.com/callback/alipay";
});

注册后 IPaymentProvider（Code = alipay）可用，可通过 IIntegrationProviderResolver<IPaymentProvider> 按供应商 ID 解析。

使用示例

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

public class CheckoutService(IIntegrationProviderResolver<IPaymentProvider> resolver)
{
    public async Task<string> CreateQrOrderAsync(string outTradeNo, long amountCents, string subject, CancellationToken ct)
    {
        var provider = resolver.GetRequired(PaymentProviderCode.Alipay);

        // 扫码当面付下单
        var order = await provider.CreateOrderAsync(new PaymentOrderRequest
        {
            OutTradeNo = outTradeNo,
            TotalAmount = amountCents,   // 单位：分
            Subject = subject,
            Scene = PaymentScene.Code     // 扫码预下单
        }, ct);

        return order.IsSuccess ? order.Data!.QrCode! : throw new Exception(order.ErrorMessage);
    }

    public async Task<PaymentStatus> QueryAsync(string outTradeNo, CancellationToken ct)
    {
        var provider = resolver.GetRequired(PaymentProviderCode.Alipay);
        var status = await provider.QueryStatusAsync(outTradeNo, ct);
        return status.IsSuccess ? status.Data!.Status : PaymentStatus.Pending;
    }
}

金额单位：统一接口与支付宝均以「分」为单位，内部按需换算为元字符串。

依赖

相关包

• Bitzsoft.Integrations.Payment -- 抽象层
• Bitzsoft.Integrations.Payment.WeChatPay -- 微信支付实现
• Bitzsoft.Integrations.Payment.PayPal -- PayPal 实现
• Bitzsoft.Integrations.Payment.Stripe -- Stripe 实现
• Bitzsoft.Integrations.Payment.UnionPay -- 银联实现
• Bitzsoft.Integrations.Payment.All -- 聚合包