Bitzsoft.Integrations.Payment.WeChatPay 1.0.1

Bitzsoft.Integrations.Payment.WeChatPay

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

功能特性

• 多场景下单：APP 支付、Native 扫码、H5 支付、付款码（当面付）
• 交易管理：订单状态查询、关闭订单、申请退款
• APIv3 安全：请求使用商户私钥 RSA-SHA256 签名 + 证书序列号头
• 回调验签解密：使用微信支付平台公钥 RSA-SHA256 验签，再用 APIv3Key 进行 AES-256-GCM 解密
• 统一接口：实现 IPaymentProvider，Code 返回 PaymentProviderCode.WeChatPay
• 请求审计：内置 RequestLogging 管道，记录出站请求

安装

dotnet add package Bitzsoft.Integrations.Payment.WeChatPay

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

配置

appsettings.json

{
  "WeChatPay": {
    "AppId": "wx your-app-id",
    "MchId": "your-mch-id",
    "MchSerialNo": "your-merchant-cert-serial-no",
    "APIv3Key": "your-32-byte-apiv3-key",
    "PrivateKey": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----",
    "WeChatPayPublicKey": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----",
    "NotifyUrl": "https://your-domain.com/callback/wechatpay",
    "ApiBase": "https://api.mch.weixin.qq.com"
  }
}

注册服务

从 IConfiguration 绑定（推荐）

using Microsoft.Extensions.DependencyInjection;

builder.Services.AddBitzsoftWeChatPayPayment(
    builder.Configuration.GetSection("WeChatPay"));

委托配置

builder.Services.AddBitzsoftWeChatPayPayment(options =>
{
    options.AppId = "wx your-app-id";
    options.MchId = "your-mch-id";
    options.MchSerialNo = "your-merchant-cert-serial-no";
    options.APIv3Key = "your-32-byte-apiv3-key";
    options.PrivateKey = "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----";
    options.WeChatPayPublicKey = "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----";
    options.NotifyUrl = "https://your-domain.com/callback/wechatpay";
});

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

使用示例

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

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

        // Native 扫码下单，返回 code_url
        var order = await provider.CreateOrderAsync(new PaymentOrderRequest
        {
            OutTradeNo = outTradeNo,
            TotalAmount = amountCents,   // 单位：分
            Subject = description,
            Scene = PaymentScene.Web      // Native 扫码
        }, 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.WeChatPay);
        var status = await provider.QueryStatusAsync(outTradeNo, ct);
        return status.IsSuccess ? status.Data!.Status : PaymentStatus.Pending;
    }
}

金额单位：统一接口与微信支付均以「分」为单位，无需换算。

回调验签：含 5 分钟时间戳容差校验防重放。

依赖

相关包

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