befly-weixin-pay

微信支付能力包，覆盖 JSAPI、H5、Native、退款、账单、回调验签和解密。

import { WeixinPay } from "befly-weixin-pay";

const weixinPay = new WeixinPay(
    {
        mchId: "1900000000",
        serialNo: "merchant-api-cert-serial",
        apiv3Key: "32-byte-apiv3-key",
        privateKey: "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----",
        appId: "wx...",
        responseSerialNo: "PUB_KEY_ID_...",
        payPublicKeys: {
            "PUB_KEY_ID_...": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"
        },
        platformCertificates: {
            "platform-cert-serial": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"
        }
    },
    {
        logger: befly.logger
    }
);

WeixinPay 是新公钥支付主客户端；平台证书只作为迁移期验签材料。可通过 platformCertificates 预置平台证书；如果回调或应答的 Wechatpay-Serial 本地缺失，客户端会自动下载平台证书并重试验签一次。

H5 支付必须由调用方显式传入业务站点信息：

await weixinPay.transactionsH5({
    description: "订单支付",
    outTradeNo: "order001",
    amount: {
        total: 100
    },
    notifyUrl: "https://example.com/pay/notify",
    sceneInfo: {
        payerClientIp: "127.0.0.1",
        appName: "example",
        appUrl: "https://example.com",
        type: "Wap"
    }
});

迁移期仍可手动通过 WeixinPayCertificateManager 下载，再调用 weixinPay.setPlatformCertificates(certificates) 注入验签材料；常规项目直接使用 new WeixinPay(...) 即可。