wxpay-nodejs-sdk 0.2.3 → 0.2.5

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import crypto from 'node:crypto';
+
 /** 微信支付 API V3 通用响应结构 */
 interface WxPayResponse<T = unknown> {
     /** HTTP 状态码 */
@@ -61,6 +63,8 @@ interface WxPayOptions {
     enableResponseVerification?: boolean;
     /** 是否启用跨城容灾（主备域名自动切换），默认 true */
     enableFailover?: boolean;
+    /** 自定义 fetch 实现，用于注入代理、自定义超时等场景 */
+    customFetch?: typeof fetch;
 }
 /** 请求参数基础类型 */
 type RequestParams = Record<string, string | number | boolean | undefined>;
@@ -607,6 +611,54 @@ interface FundFlowBillResponse {
     /** 下载地址 */
     download_url: string;
 }
+/** 申请单个子商户资金账单请求参数 */
+interface SubMerchantFundFlowBillParams {
+    /** 子商户号 */
+    sub_mchid: string;
+    /** 账单日期，格式 YYYY-MM-DD */
+    bill_date: string;
+    /** 资金账户类型 */
+    account_type?: 'BASIC' | 'OPERATION' | 'ALL';
+    /** 账单文件加密算法 */
+    algorithm?: 'AEAD_AES_256_GCM';
+    /** 压缩方式 */
+    tar_type?: 'GZIP';
+    [key: string]: unknown;
+}
+/** 加密账单文件信息 */
+interface EncryptBillEntity {
+    /** 账单文件序号 */
+    bill_sequence: number;
+    /** 哈希类型 */
+    hash_type: string;
+    /** 哈希值 */
+    hash_value: string;
+    /** 下载地址（5分钟内有效） */
+    download_url: string;
+    /** 加密密钥（已用商户证书公钥加密） */
+    encrypt_key: string;
+    /** 随机字符串 */
+    nonce: string;
+}
+/** 加密账单响应 */
+interface EncryptBillResponse {
+    /** 下载信息总数 */
+    download_bill_count: number;
+    /** 下载信息明细 */
+    download_bill_list: EncryptBillEntity[];
+}
+/** 申请二级商户资金账单请求参数 */
+interface EcommerceFundFlowBillParams {
+    /** 账单日期，格式 YYYY-MM-DD */
+    bill_date: string;
+    /** 资金账户类型（本接口只支持填 ALL） */
+    account_type?: 'ALL';
+    /** 压缩方式 */
+    tar_type?: 'GZIP';
+    /** 账单文件加密算法 */
+    algorithm?: 'AEAD_AES_256_GCM';
+    [key: string]: unknown;
+}
 /** 回调通知资源 */
 interface CallbackResource {
     /** 原始回调类型 */
@@ -4576,6 +4628,125 @@ interface MedInsJsapiBridgeConfig {
     /** 签名 */
     sign: string;
 }
+interface PartnerJsapiPayer {
+    sp_openid?: string;
+    sub_openid?: string;
+}
+interface CreatePartnerJsapiOrderRequest {
+    sp_appid: string;
+    sp_mchid: string;
+    sub_appid?: string;
+    sub_mchid: string;
+    description: string;
+    out_trade_no: string;
+    time_expire?: string;
+    attach?: string;
+    notify_url: string;
+    goods_tag?: string;
+    support_fapiao?: boolean;
+    amount: OrderAmount;
+    payer: PartnerJsapiPayer;
+    detail?: OrderDetail;
+    scene_info?: SceneInfo;
+    settle_info?: SettleInfo;
+}
+interface CreatePartnerJsapiOrderResponse {
+    prepay_id: string;
+}
+interface CreatePartnerAppOrderRequest {
+    sp_appid: string;
+    sp_mchid: string;
+    sub_appid?: string;
+    sub_mchid: string;
+    description: string;
+    out_trade_no: string;
+    time_expire?: string;
+    attach?: string;
+    notify_url: string;
+    goods_tag?: string;
+    support_fapiao?: boolean;
+    amount: OrderAmount;
+    detail?: OrderDetail;
+    scene_info?: SceneInfo;
+    settle_info?: SettleInfo;
+}
+interface CreatePartnerAppOrderResponse {
+    prepay_id: string;
+}
+interface PartnerH5SceneInfo {
+    payer_client_ip: string;
+    device_id?: string;
+    store_info?: StoreInfo;
+    h5_info: H5Info;
+}
+interface CreatePartnerH5OrderRequest {
+    sp_appid: string;
+    sp_mchid: string;
+    sub_appid?: string;
+    sub_mchid: string;
+    description: string;
+    out_trade_no: string;
+    time_expire?: string;
+    attach?: string;
+    notify_url: string;
+    goods_tag?: string;
+    support_fapiao?: boolean;
+    amount: OrderAmount;
+    detail?: OrderDetail;
+    scene_info: PartnerH5SceneInfo;
+    settle_info?: SettleInfo;
+}
+interface CreatePartnerH5OrderResponse {
+    h5_url: string;
+}
+interface CreatePartnerNativeOrderRequest {
+    sp_appid: string;
+    sp_mchid: string;
+    sub_appid?: string;
+    sub_mchid: string;
+    description: string;
+    out_trade_no: string;
+    time_expire?: string;
+    attach?: string;
+    notify_url: string;
+    goods_tag?: string;
+    support_fapiao?: boolean;
+    amount: OrderAmount;
+    detail?: OrderDetail;
+    scene_info?: SceneInfo;
+    settle_info?: SettleInfo;
+}
+interface CreatePartnerNativeOrderResponse {
+    code_url: string;
+}
+interface PartnerQueryOrderParams {
+    out_trade_no?: string;
+    transaction_id?: string;
+    sp_mchid: string;
+    sub_mchid: string;
+}
+interface PartnerQueryOrderResponse {
+    sp_appid: string;
+    sp_mchid: string;
+    sub_appid?: string;
+    sub_mchid: string;
+    out_trade_no: string;
+    transaction_id?: string;
+    trade_type?: string;
+    trade_state: string;
+    trade_state_desc: string;
+    bank_type?: string;
+    attach?: string;
+    success_time?: string;
+    payer: PartnerJsapiPayer;
+    amount: OrderAmountResponse;
+    scene_info?: SceneInfoResponse;
+    promotion_detail?: PromotionDetail[];
+}
+interface PartnerCloseOrderRequest {
+    sp_mchid: string;
+    sub_mchid: string;
+}
 
 /**
  * 自动更新配置选项
@@ -4633,11 +4804,21 @@ declare class CertificateManager {
      * 获取用于验签的公钥
      *
      * 优先返回微信支付公钥（公钥模式），否则根据证书序列号查找平台证书。
+     * 在组合模式下，如果证书未找到，会回退到微信支付公钥。
      *
      * @param serialNo - 证书序列号或公钥ID
      * @returns PEM 格式的公钥，不存在则返回 null
      */
     getPublicKey(serialNo: string): string | null;
+    /**
+     * 判断当前是否为组合验签模式
+     *
+     * 当同时配置了微信支付公钥和平台证书时，返回 true。
+     * 组合模式用于平台证书→微信支付公钥的灰度迁移期间。
+     *
+     * @returns 是否为组合模式
+     */
+    isCombinedMode(): boolean;
     /**
      * 更新平台证书
      */
@@ -4703,8 +4884,6 @@ declare class WxPayClient {
     private static readonly PRODUCTION_BACKUP;
     /** 沙箱环境 API 地址 */
     private static readonly SANDBOX_BASE;
-    /** SDK 版本号 */
-    private static readonly SDK_VERSION;
     /** 动态 User-Agent 字符串 */
     private static readonly USER_AGENT;
     /** 商户号 */
@@ -4716,6 +4895,7 @@ declare class WxPayClient {
     private readonly baseUrl;
     private readonly backupUrl;
     private readonly enableResponseVerification;
+    private readonly customFetch;
     /** 平台证书管理器 */
     readonly certificates: CertificateManager;
     constructor(options: WxPayOptions);
@@ -5030,6 +5210,31 @@ declare class JsapiService {
      * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791859 (商户订单号查询订单)
      */
     queryOrderById(params: QueryOrderParams): Promise<WxPayResponse<QueryOrderResponse>>;
+    /**
+     * 通过商户订单号查询订单
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791859
+     */
+    queryOrderByOutTradeNo(outTradeNo: string): Promise<WxPayResponse<QueryOrderResponse>>;
+    /**
+     * 通过微信支付订单号查询订单
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791858
+     */
+    queryOrderByTransactionId(transactionId: string): Promise<WxPayResponse<QueryOrderResponse>>;
+    /**
+     * JSAPI 下单并生成调起支付参数
+     *
+     * 封装了下单和调起支付参数生成两个步骤，一次调用即可获得
+     * prepay_id 和前端 WeixinJSBridge.invoke() 所需的全部参数。
+     *
+     * @param request - 下单请求参数（需包含 appid）
+     * @param privateKey - 商户私钥
+     * @returns 下单响应 + 调起支付参数
+     */
+    prepayWithRequestPayment(request: CreateJsapiOrderRequest, privateKey: string | Buffer): Promise<WxPayResponse<CreateJsapiOrderResponse> & {
+        bridgeConfig: JsapiBridgeConfig;
+    }>;
     /**
      * 关闭订单
      *
@@ -5133,6 +5338,8 @@ declare class H5Service {
      * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791838 (商户订单号查询订单)
      */
     queryOrderById(params: QueryOrderParams): Promise<WxPayResponse<QueryOrderResponse>>;
+    queryOrderByOutTradeNo(outTradeNo: string): Promise<WxPayResponse<QueryOrderResponse>>;
+    queryOrderByTransactionId(transactionId: string): Promise<WxPayResponse<QueryOrderResponse>>;
     /**
      * 关闭订单
      *
@@ -5236,6 +5443,11 @@ declare class AppService {
      * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070356 (商户订单号查询订单)
      */
     queryOrderById(params: QueryOrderParams): Promise<WxPayResponse<QueryOrderResponse>>;
+    queryOrderByOutTradeNo(outTradeNo: string): Promise<WxPayResponse<QueryOrderResponse>>;
+    queryOrderByTransactionId(transactionId: string): Promise<WxPayResponse<QueryOrderResponse>>;
+    prepayWithRequestPayment(request: CreateAppOrderRequest, privateKey: string | Buffer): Promise<WxPayResponse<CreateAppOrderResponse> & {
+        bridgeConfig: AppBridgeConfig;
+    }>;
     /**
      * 关闭订单
      *
@@ -5342,6 +5554,8 @@ declare class NativeService {
      * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791880 (商户订单号查询订单)
      */
     queryOrderById(params: QueryOrderParams): Promise<WxPayResponse<QueryOrderResponse>>;
+    queryOrderByOutTradeNo(outTradeNo: string): Promise<WxPayResponse<QueryOrderResponse>>;
+    queryOrderByTransactionId(transactionId: string): Promise<WxPayResponse<QueryOrderResponse>>;
     /**
      * 关闭订单
      *
@@ -6567,6 +6781,30 @@ declare class BillService {
      * ```
      */
     applyProfitSharingBill(params: ProfitSharingBillParams): Promise<WxPayResponse<ProfitSharingBillResponse>>;
+    /**
+     * 申请单个子商户资金账单
+     *
+     * 服务商调用该接口获取单个子商户资金账单的下载链接。
+     * 返回的账单文件使用 AES-256-GCM 加密，需用子商户的 API 证书私钥解密。
+     *
+     * @param params - 账单请求参数
+     * @returns 加密账单下载信息
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071235
+     */
+    applySubMerchantFundFlowBill(params: SubMerchantFundFlowBillParams): Promise<WxPayResponse<EncryptBillResponse>>;
+    /**
+     * 申请二级商户资金账单
+     *
+     * 电商平台调用该接口获取二级商户资金账单的下载链接。
+     * 返回的账单文件使用 AES-256-GCM 加密，需用平台的 API 证书私钥解密。
+     *
+     * @param params - 账单请求参数
+     * @returns 加密账单下载信息
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071235
+     */
+    applyEcommerceFundFlowBill(params: EcommerceFundFlowBillParams): Promise<WxPayResponse<EncryptBillResponse>>;
     /**
      * 下载账单文件
      *
@@ -6602,6 +6840,28 @@ declare class BillService {
      * ```
      */
     downloadBill(downloadUrl: string): Promise<WxPayResponse<Buffer>>;
+    /**
+     * 下载账单文件并自动解压、校验摘要
+     *
+     * 封装了完整的账单下载流程：
+     * 1. 下载原始文件
+     * 2. 自动检测并解压 GZIP 格式
+     * 3. 可选：与申请账单返回的 hash_value 进行 SHA-1 摘要校验
+     *
+     * @param downloadUrl - 申请账单接口返回的 download_url
+     * @param expectedDigest - 期望的 SHA-1 摘要值（来自申请账单接口返回的 hash_value）
+     * @returns 包含解压后账单文件 Buffer 的响应
+     * @throws 如果摘要校验失败
+     *
+     * @example
+     * ```ts
+     * const result = await billService.downloadAndVerifyBill(
+     *   applyResult.data.download_url,
+     *   applyResult.data.hash_value,
+     * );
+     * ```
+     */
+    downloadAndVerifyBill(downloadUrl: string, expectedDigest?: string): Promise<WxPayResponse<Buffer>>;
 }
 
 /**
@@ -8079,48 +8339,1487 @@ declare class MerchantExclusiveCouponService {
 }
 
 /**
- * 调起支付参数生成工具
+ * 境内退款服务
  *
- * 用于生成各场景下调起微信支付所需的参数，包括签名计算：
- * - APP 支付：生成 PayReq 对象参数（通过 OpenSDK 的 sendReq 调起）
- * - JSAPI 支付：生成 WeixinJSBridge.invoke() 参数
- * - 小程序支付：生成 wx.requestPayment() 参数
+ * 提供独立的退款 API 封装，不绑定特定支付方式。
+ * 适用于所有支付方式（JSAPI/APP/H5/Native）的退款场景。
  *
- * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070351 (APP 调起支付)
- * @see https://pay.weixin.qq.com/doc/v3/merchant/4012365340 (APP 调起支付签名)
- * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791857 (JSAPI 调起支付)
- * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791898 (小程序调起支付)
- * @see https://pay.weixin.qq.com/doc/v3/merchant/4012365341 (小程序调起支付签名)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071001 (产品介绍)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071036 (申请退款)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071041 (查询单笔退款)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071193 (发起异常退款)
  */
+declare class RefundService {
+    private readonly client;
+    constructor(client: WxPayClient);
+    /**
+     * 申请退款
+     *
+     * 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，
+     * 卖家可以通过退款接口将支付款退还给买家。
+     * 支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。
+     * 一笔退款失败后重新提交，要采用原来的退款单号。
+     *
+     * @param request - 退款请求参数，包含商户订单号、退款单号、退款金额等信息
+     * @returns 退款申请结果，包含微信退款单号、退款状态等
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071036
+     */
+    create(request: CreateRefundRequest): Promise<WxPayResponse<CreateRefundResponse>>;
+    /**
+     * 查询单笔退款（通过商户退款单号）
+     *
+     * 提交退款申请后，通过调用该接口查询退款状态。
+     * 退款有一定延时，建议在提交退款申请后1分钟再查询退款状态。
+     *
+     * @param params - 查询参数，需包含 outRefundNo（商户退款单号）
+     * @returns 退款单详情，包含退款状态、退款金额、退款渠道等
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071041
+     */
+    queryByOutRefundNo(params: QueryRefundParams): Promise<WxPayResponse<QueryRefundResponse>>;
+    /**
+     * 发起异常退款
+     *
+     * 当退款因为用户账户异常而无法原路退回时，可使用此接口将退款资金
+     * 退到用户的其他银行卡或商户的银行账户。
+     *
+     * @param refundId - 微信支付退款单号
+     * @param request - 异常退款请求参数，包含退款方式、收款账户信息等
+     * @returns 异常退款处理结果
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071193
+     */
+    applyAbnormalRefund(refundId: string, request: ApplyAbnormalRefundRequest): Promise<WxPayResponse<ApplyAbnormalRefundResponse>>;
+}
+
 /**
- * 生成 APP 调起支付的 sign
+ * 服务商 JSAPI 支付服务
  *
- * 签名算法：使用商户私钥对签名串进行 RSA-SHA256 签名
- * 签名串格式：appId\ntimeStamp\nnonceStr\nprepay_id\n
+ * 服务商模式下，服务商代替特约商户发起 JSAPI 支付请求。
+ * 与直连商户模式的区别在于请求中包含 sp_appid、sp_mchid、sub_mchid 等字段。
  *
- * @param appId - 应用ID
- * @param timeStamp - 时间戳（秒）
- * @param nonceStr - 随机字符串
- * @param prepayId - 预支付ID
- * @param privateKey - 商户私钥
- * @returns Base64 编码的签名
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012738519 (JSAPI/小程序下单)
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012738964 (微信支付订单号查询)
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012739008 (商户订单号查询)
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012739019 (关闭订单)
  */
-declare function generateAppPaySign(appId: string, timeStamp: string, nonceStr: string, prepayId: string, privateKey: string | Buffer): string;
+declare class PartnerJsapiService {
+    private readonly client;
+    constructor(client: WxPayClient);
+    /**
+     * 服务商 JSAPI/小程序下单
+     *
+     * 服务商通过此接口代特约商户发起 JSAPI 支付下单，获取 prepay_id。
+     *
+     * @param request - 下单请求参数，需包含 sp_appid、sp_mchid、sub_mchid 等
+     * @returns 下单结果，包含 prepay_id
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012738519
+     */
+    createOrder(request: CreatePartnerJsapiOrderRequest): Promise<WxPayResponse<CreatePartnerJsapiOrderResponse>>;
+    /**
+     * 通过商户订单号查询订单
+     *
+     * @param params - 查询参数，需包含 out_trade_no、sp_mchid、sub_mchid
+     * @returns 订单详情
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012739008
+     */
+    queryOrderByOutTradeNo(params: PartnerQueryOrderParams): Promise<WxPayResponse<PartnerQueryOrderResponse>>;
+    /**
+     * 通过微信支付订单号查询订单
+     *
+     * @param params - 查询参数，需包含 transaction_id、sp_mchid、sub_mchid
+     * @returns 订单详情
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012738964
+     */
+    queryOrderByTransactionId(params: PartnerQueryOrderParams): Promise<WxPayResponse<PartnerQueryOrderResponse>>;
+    /**
+     * 关闭订单
+     *
+     * 对于未支付的订单，服务商可通过此接口代特约商户关闭订单。
+     *
+     * @param outTradeNo - 商户订单号
+     * @param request - 关单请求参数，需包含 sp_mchid、sub_mchid
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012739019
+     */
+    closeOrder(outTradeNo: string, request: PartnerCloseOrderRequest): Promise<WxPayResponse>;
+    /**
+     * 服务商 JSAPI 下单并生成调起支付参数
+     *
+     * 封装了下单和调起支付参数生成两个步骤，一次调用即可获得
+     * prepay_id 和前端 WeixinJSBridge.invoke() 所需的全部参数。
+     *
+     * @param request - 下单请求参数
+     * @param privateKey - 商户私钥，用于生成调起支付签名
+     * @returns 下单响应 + 调起支付参数
+     */
+    prepayWithRequestPayment(request: CreatePartnerJsapiOrderRequest, privateKey: string | Buffer): Promise<WxPayResponse<CreatePartnerJsapiOrderResponse> & {
+        bridgeConfig: JsapiBridgeConfig;
+    }>;
+}
+
 /**
- * 生成 APP 调起支付所需的完整配置
- *
- * 用于生成 OpenSDK sendReq 方法中 PayReq 对象所需的全部参数。
- * sign 使用商户 API 证书私钥进行 RSA-SHA256 签名。
+ * 服务商 APP 支付服务
  *
- * @param appId - 应用ID（下单时传入的 appid）
- * @param partnerId - 商户号（下单时传入的 mchid）
- * @param prepayId - 预支付ID（从 APP 下单接口获取）
- * @param privateKey - 商户私钥
- * @returns PayReq 对象所需的参数
+ * 服务商模式下，服务商代替特约商户发起 APP 支付请求。
  *
- * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070351
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4013080231 (APP下单)
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4013080234 (微信支付订单号查询)
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4013080235 (商户订单号查询)
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4013080236 (关闭订单)
  */
-declare function buildAppBridgeConfig(appId: string, partnerId: string, prepayId: string, privateKey: string | Buffer): AppBridgeConfig;
+declare class PartnerAppService {
+    private readonly client;
+    constructor(client: WxPayClient);
+    /**
+     * 服务商 APP 下单
+     *
+     * @param request - 下单请求参数
+     * @returns 下单结果，包含 prepay_id
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4013080231
+     */
+    createOrder(request: CreatePartnerAppOrderRequest): Promise<WxPayResponse<CreatePartnerAppOrderResponse>>;
+    /**
+     * 通过商户订单号查询订单
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4013080235
+     */
+    queryOrderByOutTradeNo(params: PartnerQueryOrderParams): Promise<WxPayResponse<PartnerQueryOrderResponse>>;
+    /**
+     * 通过微信支付订单号查询订单
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4013080234
+     */
+    queryOrderByTransactionId(params: PartnerQueryOrderParams): Promise<WxPayResponse<PartnerQueryOrderResponse>>;
+    /**
+     * 关闭订单
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4013080236
+     */
+    closeOrder(outTradeNo: string, request: PartnerCloseOrderRequest): Promise<WxPayResponse>;
+    /**
+     * 服务商 APP 下单并生成调起支付参数
+     *
+     * @param request - 下单请求参数
+     * @param privateKey - 商户私钥
+     * @returns 下单响应 + 调起支付参数
+     */
+    prepayWithRequestPayment(request: CreatePartnerAppOrderRequest, privateKey: string | Buffer): Promise<WxPayResponse<CreatePartnerAppOrderResponse> & {
+        bridgeConfig: AppBridgeConfig;
+    }>;
+}
+
+/**
+ * 服务商 H5 支付服务
+ *
+ * 服务商模式下，服务商代替特约商户发起 H5 支付请求。
+ *
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012738604 (H5下单)
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012738969 (微信支付订单号查询)
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012759661 (商户订单号查询)
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012759669 (关闭订单)
+ */
+declare class PartnerH5Service {
+    private readonly client;
+    constructor(client: WxPayClient);
+    /**
+     * 服务商 H5 下单
+     *
+     * @param request - 下单请求参数，需包含 scene_info.h5_info
+     * @returns 下单结果，包含 h5_url
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012738604
+     */
+    createOrder(request: CreatePartnerH5OrderRequest): Promise<WxPayResponse<CreatePartnerH5OrderResponse>>;
+    /**
+     * 通过商户订单号查询订单
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012759661
+     */
+    queryOrderByOutTradeNo(params: PartnerQueryOrderParams): Promise<WxPayResponse<PartnerQueryOrderResponse>>;
+    /**
+     * 通过微信支付订单号查询订单
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012738969
+     */
+    queryOrderByTransactionId(params: PartnerQueryOrderParams): Promise<WxPayResponse<PartnerQueryOrderResponse>>;
+    /**
+     * 关闭订单
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012759669
+     */
+    closeOrder(outTradeNo: string, request: PartnerCloseOrderRequest): Promise<WxPayResponse>;
+}
+
+/**
+ * 服务商 Native 支付服务
+ *
+ * 服务商模式下，服务商代替特约商户发起 Native 支付请求。
+ *
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012738659 (Native下单)
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012738971 (微信支付订单号查询)
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012759714 (商户订单号查询)
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012759725 (关闭订单)
+ */
+declare class PartnerNativeService {
+    private readonly client;
+    constructor(client: WxPayClient);
+    /**
+     * 服务商 Native 下单
+     *
+     * @param request - 下单请求参数
+     * @returns 下单结果，包含 code_url
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012738659
+     */
+    createOrder(request: CreatePartnerNativeOrderRequest): Promise<WxPayResponse<CreatePartnerNativeOrderResponse>>;
+    /**
+     * 通过商户订单号查询订单
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012759714
+     */
+    queryOrderByOutTradeNo(params: PartnerQueryOrderParams): Promise<WxPayResponse<PartnerQueryOrderResponse>>;
+    /**
+     * 通过微信支付订单号查询订单
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012738971
+     */
+    queryOrderByTransactionId(params: PartnerQueryOrderParams): Promise<WxPayResponse<PartnerQueryOrderResponse>>;
+    /**
+     * 关闭订单
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012759725
+     */
+    closeOrder(outTradeNo: string, request: PartnerCloseOrderRequest): Promise<WxPayResponse>;
+}
+
+/** 服务商商家转账请求参数 */
+interface PartnerTransferRequest {
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 特约商户 AppID */
+    sub_appid?: string;
+    /** 免确认收款授权单号 */
+    authorization_id?: string;
+    /** 商户转账单号 */
+    out_bill_no: string;
+    /** 转账场景ID */
+    transfer_scene_id: string;
+    /** 用户 OpenID */
+    openid: string;
+    /** 收款用户姓名 */
+    user_name?: string;
+    /** 转账金额（分） */
+    transfer_amount: number;
+    /** 转账备注 */
+    transfer_remark: string;
+    /** 回调通知地址 */
+    notify_url?: string;
+    /** 用户收款感知 */
+    user_recv_perception?: string;
+    /** 转账场景报备信息 */
+    transfer_scene_report_infos: {
+        info_type: string;
+        info_content: string;
+    }[];
+}
+/** 服务商商家转账响应 */
+interface PartnerTransferResponse {
+    /** 商户转账单号 */
+    out_bill_no: string;
+    /** 微信转账单号 */
+    transfer_bill_no: string;
+    /** 创建时间 */
+    create_time: string;
+    /** 转账状态 */
+    state: string;
+    /** 跳转领取页面的 package 信息 */
+    package_info?: string;
+}
+/** 服务商商家转账查询响应 */
+interface PartnerTransferQueryResponse {
+    /** 服务商户号 */
+    sp_mchid: string;
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 商户转账单号 */
+    out_bill_no: string;
+    /** 微信转账单号 */
+    transfer_bill_no: string;
+    /** 创建时间 */
+    create_time: string;
+    /** 转账状态 */
+    state: string;
+    /** 转账金额（分） */
+    transfer_amount: number;
+    /** 转账备注 */
+    transfer_remark: string;
+    /** 失败原因 */
+    fail_reason?: string;
+    /** 用户 OpenID */
+    openid: string;
+    /** 收款用户姓名 */
+    user_name?: string;
+    /** 更新时间 */
+    update_time?: string;
+}
+/**
+ * 服务商商家转账服务
+ *
+ * 服务商模式下，服务商代替特约商户发起商家转账。
+ *
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012716434 (商家转账)
+ */
+declare class PartnerTransferService {
+    private readonly client;
+    constructor(client: WxPayClient);
+    /**
+     * 服务商发起商家转账
+     *
+     * @param request - 转账请求参数
+     * @returns 转账结果
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012716434
+     */
+    createTransfer(request: PartnerTransferRequest): Promise<WxPayResponse<PartnerTransferResponse>>;
+    /**
+     * 通过商户单号查询转账单
+     *
+     * @param outBillNo - 商户转账单号
+     * @param subMchid - 特约商户号
+     * @returns 转账单详情
+     */
+    queryTransferByOutBillNo(outBillNo: string, subMchid: string): Promise<WxPayResponse<PartnerTransferQueryResponse>>;
+    /**
+     * 撤销转账
+     *
+     * @param outBillNo - 商户转账单号
+     * @param subMchid - 特约商户号
+     */
+    cancelTransfer(outBillNo: string, subMchid: string): Promise<WxPayResponse>;
+}
+
+/** 批量转账明细输入 */
+interface TransferDetailInput {
+    /** 商家明细单号 */
+    out_detail_no: string;
+    /** 转账金额（分） */
+    transfer_amount: number;
+    /** 转账备注（UTF8编码，最多32字符） */
+    transfer_remark: string;
+    /** 收款用户openid */
+    openid: string;
+    /** 收款用户姓名（加密，转账金额>=2000元时必填） */
+    user_name?: string;
+}
+/** 发起批量转账请求 */
+interface InitiateBatchTransferRequest {
+    /** 商户appid */
+    appid: string;
+    /** 商家批次单号 */
+    out_batch_no: string;
+    /** 批次名称 */
+    batch_name: string;
+    /** 批次备注（UTF8编码，最多32字符） */
+    batch_remark: string;
+    /** 转账总金额（分），必须与明细金额之和一致 */
+    total_amount: number;
+    /** 转账总笔数，最多1000笔，必须与明细数一致 */
+    total_num: number;
+    /** 转账明细列表 */
+    transfer_detail_list: TransferDetailInput[];
+    /** 转账场景ID（如 1001-现金营销） */
+    transfer_scene_id?: string;
+    /** 异步通知回调地址 */
+    notify_url?: string;
+}
+/** 发起批量转账响应 */
+interface InitiateBatchTransferResponse {
+    /** 商家批次单号 */
+    out_batch_no: string;
+    /** 微信批次单号 */
+    batch_id: string;
+    /** 批次创建时间（RFC3339） */
+    create_time: string;
+    /** 批次状态：ACCEPTED / PROCESSING / FINISHED / CLOSED */
+    batch_status: string;
+}
+/** 批次单信息 */
+interface TransferBatchGet {
+    /** 商户号 */
+    mchid: string;
+    /** 商家批次单号 */
+    out_batch_no: string;
+    /** 微信批次单号 */
+    batch_id: string;
+    /** 商户appid */
+    appid: string;
+    /** 批次状态 */
+    batch_status: string;
+    /** 批次类型 */
+    batch_type?: string;
+    /** 批次名称 */
+    batch_name: string;
+    /** 批次备注 */
+    batch_remark: string;
+    /** 转账总金额（分） */
+    total_amount: number;
+    /** 转账总笔数 */
+    total_num: number;
+    /** 转账成功金额（分） */
+    success_amount?: number;
+    /** 转账成功笔数 */
+    success_num?: number;
+    /** 转账失败金额（分） */
+    fail_amount?: number;
+    /** 转账失败笔数 */
+    fail_num?: number;
+    /** 批次关闭原因 */
+    close_reason?: string;
+    /** 批次创建时间 */
+    create_time?: string;
+    /** 批次更新时间 */
+    update_time?: string;
+}
+/** 转账明细简要信息 */
+interface TransferDetailCompact {
+    /** 微信明细单号 */
+    detail_id: string;
+    /** 商家明细单号 */
+    out_detail_no: string;
+    /** 明细状态 */
+    detail_status: string;
+}
+/** 查询批次单响应 */
+interface TransferBatchEntity {
+    /** 转账批次单基本信息 */
+    transfer_batch: TransferBatchGet;
+    /** 转账明细单列表（批次完成时返回） */
+    transfer_detail_list?: TransferDetailCompact[];
+}
+/** 转账明细单详情 */
+interface TransferDetailEntity {
+    /** 商户号 */
+    mchid: string;
+    /** 商家批次单号 */
+    out_batch_no: string;
+    /** 微信批次单号 */
+    batch_id: string;
+    /** 商户appid */
+    appid: string;
+    /** 商家明细单号 */
+    out_detail_no: string;
+    /** 微信明细单号 */
+    detail_id: string;
+    /** 明细状态：INIT / WAIT_PAY / PROCESSING / SUCCESS / FAIL */
+    detail_status: string;
+    /** 转账金额（分） */
+    transfer_amount: number;
+    /** 转账备注 */
+    transfer_remark: string;
+    /** 明细失败原因 */
+    fail_reason?: string;
+    /** 收款用户openid */
+    openid: string;
+    /** 收款用户姓名（加密） */
+    user_name?: string;
+    /** 转账发起时间 */
+    initiate_time?: string;
+    /** 明细更新时间 */
+    update_time?: string;
+}
+/** 查询批次单参数 */
+interface GetTransferBatchParams {
+    /** 是否查询明细单（默认 false） */
+    need_query_detail?: boolean;
+    /** 请求资源起始位置（默认 0） */
+    offset?: number;
+    /** 最大资源条数（20~100，默认 20） */
+    limit?: number;
+    /** 明细状态筛选：WAIT_PAY / ALL / SUCCESS / FAIL */
+    detail_status?: string;
+}
+/**
+ * 批量转账服务
+ *
+ * 商户可通过该产品实现同时向多个用户微信零钱进行转账的操作。
+ *
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4012716434 (商家转账)
+ */
+declare class TransferBatchService {
+    private readonly client;
+    constructor(client: WxPayClient);
+    /**
+     * 发起批量转账
+     *
+     * @param request - 批量转账请求参数
+     * @returns 批量转账结果
+     */
+    initiateBatchTransfer(request: InitiateBatchTransferRequest): Promise<WxPayResponse<InitiateBatchTransferResponse>>;
+    /**
+     * 通过微信批次单号查询批次单
+     *
+     * @param batchId - 微信批次单号
+     * @param params - 可选查询参数
+     * @returns 批次单详情
+     */
+    getTransferBatchByNo(batchId: string, params?: GetTransferBatchParams): Promise<WxPayResponse<TransferBatchEntity>>;
+    /**
+     * 通过商家批次单号查询批次单
+     *
+     * @param outBatchNo - 商家批次单号
+     * @param params - 可选查询参数
+     * @returns 批次单详情
+     */
+    getTransferBatchByOutNo(outBatchNo: string, params?: GetTransferBatchParams): Promise<WxPayResponse<TransferBatchEntity>>;
+    /**
+     * 通过微信明细单号查询明细单
+     *
+     * @param batchId - 微信批次单号
+     * @param detailId - 微信明细单号
+     * @returns 明细单详情
+     */
+    getTransferDetailByNo(batchId: string, detailId: string): Promise<WxPayResponse<TransferDetailEntity>>;
+    /**
+     * 通过商家明细单号查询明细单
+     *
+     * @param outBatchNo - 商家批次单号
+     * @param outDetailNo - 商家明细单号
+     * @returns 明细单详情
+     */
+    getTransferDetailByOutNo(outBatchNo: string, outDetailNo: string): Promise<WxPayResponse<TransferDetailEntity>>;
+}
+
+/** 服务商批量转账明细输入 */
+interface PartnerTransferDetailInput {
+    /** 商家明细单号 */
+    out_detail_no: string;
+    /** 转账金额（分） */
+    transfer_amount: number;
+    /** 转账备注（UTF8编码，最多32字符） */
+    transfer_remark: string;
+    /** 收款用户openid */
+    openid: string;
+    /** 收款用户姓名（加密） */
+    user_name?: string;
+}
+/** 发起服务商批量转账请求 */
+interface InitiatePartnerBatchTransferRequest {
+    /** 商户appid */
+    appid: string;
+    /** 商家批次单号 */
+    out_batch_no: string;
+    /** 批次名称 */
+    batch_name: string;
+    /** 批次备注（UTF8编码，最多32字符） */
+    batch_remark: string;
+    /** 转账总金额（分），必须与明细金额之和一致 */
+    total_amount: number;
+    /** 转账总笔数，最多1000笔，必须与明细数一致 */
+    total_num: number;
+    /** 转账明细列表 */
+    transfer_detail_list: PartnerTransferDetailInput[];
+    /** 转账场景ID */
+    transfer_scene_id?: string;
+    /** 异步通知回调地址 */
+    notify_url?: string;
+}
+/** 发起服务商批量转账响应 */
+interface InitiatePartnerBatchTransferResponse {
+    /** 商家批次单号 */
+    out_batch_no: string;
+    /** 微信批次单号 */
+    batch_id: string;
+    /** 批次创建时间（RFC3339） */
+    create_time: string;
+    /** 批次状态：ACCEPTED / PROCESSING / FINISHED / CLOSED */
+    batch_status: string;
+}
+/** 服务商批次单信息 */
+interface PartnerTransferBatchGet {
+    /** 商户号 */
+    mchid: string;
+    /** 商家批次单号 */
+    out_batch_no: string;
+    /** 微信批次单号 */
+    batch_id: string;
+    /** 商户appid */
+    appid: string;
+    /** 批次状态 */
+    batch_status: string;
+    /** 批次类型 */
+    batch_type?: string;
+    /** 批次名称 */
+    batch_name: string;
+    /** 批次备注 */
+    batch_remark: string;
+    /** 转账总金额（分） */
+    total_amount: number;
+    /** 转账总笔数 */
+    total_num: number;
+    /** 转账成功金额（分） */
+    success_amount?: number;
+    /** 转账成功笔数 */
+    success_num?: number;
+    /** 转账失败金额（分） */
+    fail_amount?: number;
+    /** 转账失败笔数 */
+    fail_num?: number;
+    /** 批次关闭原因 */
+    close_reason?: string;
+    /** 批次创建时间 */
+    create_time?: string;
+    /** 批次更新时间 */
+    update_time?: string;
+}
+/** 服务商转账明细简要信息 */
+interface PartnerTransferDetailCompact {
+    /** 微信明细单号 */
+    detail_id: string;
+    /** 商家明细单号 */
+    out_detail_no: string;
+    /** 明细状态 */
+    detail_status: string;
+}
+/** 查询服务商批次单响应 */
+interface PartnerTransferBatchEntity {
+    /** 转账批次单基本信息 */
+    transfer_batch: PartnerTransferBatchGet;
+    /** 转账明细单列表（批次完成时返回） */
+    transfer_detail_list?: PartnerTransferDetailCompact[];
+}
+/** 服务商转账明细单详情 */
+interface PartnerTransferDetailEntity {
+    /** 商户号 */
+    mchid: string;
+    /** 商家批次单号 */
+    out_batch_no: string;
+    /** 微信批次单号 */
+    batch_id: string;
+    /** 商户appid */
+    appid: string;
+    /** 商家明细单号 */
+    out_detail_no: string;
+    /** 微信明细单号 */
+    detail_id: string;
+    /** 明细状态：INIT / WAIT_PAY / PROCESSING / SUCCESS / FAIL */
+    detail_status: string;
+    /** 转账金额（分） */
+    transfer_amount: number;
+    /** 转账备注 */
+    transfer_remark: string;
+    /** 明细失败原因 */
+    fail_reason?: string;
+    /** 收款用户openid */
+    openid: string;
+    /** 收款用户姓名（加密） */
+    user_name?: string;
+    /** 转账发起时间 */
+    initiate_time?: string;
+    /** 明细更新时间 */
+    update_time?: string;
+}
+/** 查询服务商批次单参数 */
+interface GetPartnerTransferBatchParams {
+    /** 是否查询明细单（默认 false） */
+    need_query_detail?: boolean;
+    /** 请求资源起始位置（默认 0） */
+    offset?: number;
+    /** 最大资源条数（20~100，默认 20） */
+    limit?: number;
+    /** 明细状态筛选：WAIT_PAY / ALL / SUCCESS / FAIL */
+    detail_status?: string;
+}
+/**
+ * 服务商批量转账服务
+ *
+ * 服务商模式下，实现同时向多个用户微信零钱进行转账的操作。
+ *
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012716434 (服务商商家转账)
+ */
+declare class PartnerTransferBatchService {
+    private readonly client;
+    constructor(client: WxPayClient);
+    /**
+     * 发起服务商批量转账
+     *
+     * @param request - 批量转账请求参数
+     * @returns 批量转账结果
+     */
+    initiateBatchTransfer(request: InitiatePartnerBatchTransferRequest): Promise<WxPayResponse<InitiatePartnerBatchTransferResponse>>;
+    /**
+     * 通过微信批次单号查询批次单
+     *
+     * @param batchId - 微信批次单号
+     * @param params - 可选查询参数
+     * @returns 批次单详情
+     */
+    getTransferBatchByNo(batchId: string, params?: GetPartnerTransferBatchParams): Promise<WxPayResponse<PartnerTransferBatchEntity>>;
+    /**
+     * 通过商家批次单号查询批次单
+     *
+     * @param outBatchNo - 商家批次单号
+     * @param params - 可选查询参数
+     * @returns 批次单详情
+     */
+    getTransferBatchByOutNo(outBatchNo: string, params?: GetPartnerTransferBatchParams): Promise<WxPayResponse<PartnerTransferBatchEntity>>;
+    /**
+     * 通过微信明细单号查询明细单
+     *
+     * @param batchId - 微信批次单号
+     * @param detailId - 微信明细单号
+     * @returns 明细单详情
+     */
+    getTransferDetailByNo(batchId: string, detailId: string): Promise<WxPayResponse<PartnerTransferDetailEntity>>;
+    /**
+     * 通过商家明细单号查询明细单
+     *
+     * @param outBatchNo - 商家批次单号
+     * @param outDetailNo - 商家明细单号
+     * @returns 明细单详情
+     */
+    getTransferDetailByOutNo(outBatchNo: string, outDetailNo: string): Promise<WxPayResponse<PartnerTransferDetailEntity>>;
+}
+
+/** 电商收付通分账接收方 */
+interface EcommerceProfitSharingReceiver {
+    /** 接收方类型：MERCHANT_ID / PERSONAL_OPENID */
+    type: string;
+    /** 接收方账号 */
+    receiver_account: string;
+    /** 分账金额（分） */
+    amount: number;
+    /** 分账描述 */
+    description: string;
+    /** 接收方姓名（加密） */
+    receiver_name?: string;
+}
+/** 电商收付通请求分账请求 */
+interface CreateEcommerceProfitSharingRequest {
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 电商平台 AppID */
+    appid: string;
+    /** 微信支付订单号 */
+    transaction_id: string;
+    /** 商户分账单号 */
+    out_order_no: string;
+    /** 分账接收方列表 */
+    receivers: EcommerceProfitSharingReceiver[];
+    /** 是否解冻剩余资金 */
+    finish: boolean;
+}
+/** 电商收付通请求分账响应 */
+interface CreateEcommerceProfitSharingResponse {
+    sub_mchid: string;
+    transaction_id: string;
+    out_order_no: string;
+    /** 微信分账单号 */
+    order_id: string;
+}
+/** 电商收付通查询分账响应 */
+interface QueryEcommerceProfitSharingResponse {
+    sub_mchid: string;
+    transaction_id: string;
+    out_order_no: string;
+    order_id: string;
+    /** 分账状态 */
+    state: string;
+    receivers: {
+        amount: number;
+        description: string;
+        type: string;
+        receiver_account: string;
+        result: string;
+        fail_reason?: string;
+        detail_id: string;
+        create_time: string;
+        finish_time: string;
+    }[];
+}
+/** 电商收付通分账回退请求 */
+interface EcommerceProfitSharingReturnRequest {
+    sub_mchid: string;
+    order_id: string;
+    out_order_no: string;
+    out_return_no: string;
+    return_mchid: string;
+    amount: number;
+    description: string;
+}
+/** 电商收付通分账回退响应 */
+interface EcommerceProfitSharingReturnResponse {
+    sub_mchid: string;
+    order_id: string;
+    out_order_no: string;
+    out_return_no: string;
+    return_no: string;
+    return_mchid: string;
+    amount: number;
+    result: string;
+    fail_reason?: string;
+}
+/** 电商收付通完结分账请求 */
+interface EcommerceFinishOrderRequest {
+    sub_mchid: string;
+    transaction_id: string;
+    out_order_no: string;
+    description: string;
+}
+/** 电商收付通售后服务分账请求 */
+interface CreateAfterSalesOrderRequest {
+    /** 子商户号 */
+    sub_mchid: string;
+    /** 微信支付订单号 */
+    transaction_id: string;
+    /** 分账金额（分） */
+    amount: number;
+    /** 类型：SERVICE_FEE_INCOME */
+    type: string;
+    /** 场景：REFUND_TICKET / CHANGE_TICKET / RETURN_GOODS */
+    scene: string;
+    /** 微信退款单号（退票/改签/退货收入分账时必填） */
+    refund_id?: string;
+}
+/** 电商收付通售后服务分账响应 */
+interface CreateAfterSalesOrderResponse {
+    sub_mchid: string;
+    transaction_id: string;
+    /** 分账金额（分） */
+    amount: number;
+}
+/** 电商收付通查询售后服务分账响应 */
+interface QueryAfterSalesOrderResponse {
+    sub_mchid: string;
+    transaction_id: string;
+    /** 分账金额（分） */
+    amount: number;
+    /** 分账结果：PROCESSING / SUCCESS / FAILED */
+    result: string;
+    /** 分账完成时间 */
+    finish_time?: string;
+    /** 分账失败原因 */
+    fail_reason?: string;
+}
+/** 电商收付通查询订单剩余待分金额响应 */
+interface QueryEcommerceOrderAmountResponse {
+    /** 微信支付订单号 */
+    transaction_id: string;
+    /** 订单剩余待分金额（分） */
+    unsplit_amount: number;
+}
+/** 电商收付通添加分账接收方请求 */
+interface AddEcommerceReceiverRequest {
+    /** 公众账号ID */
+    appid: string;
+    /** 接收方类型：MERCHANT_ID / PERSONAL_OPENID */
+    type: string;
+    /** 接收方账号 */
+    account: string;
+    /** 接收方名称（商户全称，仅 MERCHANT_ID 时需要） */
+    name?: string;
+    /** 与分账方的关系类型：SUPPLIER / DISTRIBUTOR / SERVICE_PROVIDER / PLATFORM / OTHERS */
+    relation_type: string;
+}
+/** 电商收付通添加分账接收方响应 */
+interface AddEcommerceReceiverResponse {
+    type: string;
+    account: string;
+}
+/** 电商收付通删除分账接收方请求 */
+interface DeleteEcommerceReceiverRequest {
+    /** 公众账号ID */
+    appid: string;
+    /** 接收方类型：MERCHANT_ID / PERSONAL_OPENID */
+    type: string;
+    /** 接收方账号 */
+    account: string;
+}
+/** 电商收付通删除分账接收方响应 */
+interface DeleteEcommerceReceiverResponse {
+    type: string;
+    account: string;
+}
+/**
+ * 电商收付通分账服务
+ *
+ * 用于电商平台对二级商户的订单进行分账。
+ *
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012690683 (分账)
+ */
+declare class EcommerceProfitSharingService {
+    private readonly client;
+    constructor(client: WxPayClient);
+    /**
+     * 请求分账
+     *
+     * @param request - 分账请求参数
+     * @returns 分账结果
+     */
+    createOrder(request: CreateEcommerceProfitSharingRequest): Promise<WxPayResponse<CreateEcommerceProfitSharingResponse>>;
+    /**
+     * 查询分账结果
+     *
+     * @param subMchid - 特约商户号
+     * @param transactionId - 微信支付订单号
+     * @param outOrderNo - 商户分账单号
+     * @returns 分账结果详情
+     */
+    queryOrder(subMchid: string, transactionId: string, outOrderNo: string): Promise<WxPayResponse<QueryEcommerceProfitSharingResponse>>;
+    /**
+     * 请求分账回退
+     *
+     * @param request - 分账回退请求参数
+     * @returns 回退结果
+     */
+    createReturnOrder(request: EcommerceProfitSharingReturnRequest): Promise<WxPayResponse<EcommerceProfitSharingReturnResponse>>;
+    /**
+     * 查询分账回退结果
+     *
+     * @param subMchid - 特约商户号
+     * @param orderId - 微信分账单号
+     * @param outReturnNo - 商户回退单号
+     * @returns 回退结果详情
+     */
+    queryReturnOrder(subMchid: string, orderId: string, outReturnNo: string): Promise<WxPayResponse<EcommerceProfitSharingReturnResponse>>;
+    /**
+     * 完结分账
+     *
+     * @param request - 完结分账请求参数
+     */
+    finishOrder(request: EcommerceFinishOrderRequest): Promise<WxPayResponse>;
+    /**
+     * 请求售后服务分账
+     *
+     * @param request - 售后服务分账请求参数
+     * @returns 售后服务分账结果
+     */
+    createAfterSalesOrder(request: CreateAfterSalesOrderRequest): Promise<WxPayResponse<CreateAfterSalesOrderResponse>>;
+    /**
+     * 查询售后服务分账结果
+     *
+     * @param subMchid - 子商户号
+     * @param transactionId - 微信支付订单号
+     * @returns 售后服务分账结果详情
+     */
+    queryAfterSalesOrder(subMchid: string, transactionId: string): Promise<WxPayResponse<QueryAfterSalesOrderResponse>>;
+    /**
+     * 查询订单剩余待分金额
+     *
+     * @param transactionId - 微信支付订单号
+     * @returns 订单剩余待分金额
+     */
+    queryOrderAmount(transactionId: string): Promise<WxPayResponse<QueryEcommerceOrderAmountResponse>>;
+    /**
+     * 添加分账接收方
+     *
+     * @param request - 添加接收方请求参数
+     * @returns 添加接收方结果
+     */
+    addReceiver(request: AddEcommerceReceiverRequest): Promise<WxPayResponse<AddEcommerceReceiverResponse>>;
+    /**
+     * 删除分账接收方
+     *
+     * @param request - 删除接收方请求参数
+     * @returns 删除接收方结果
+     */
+    deleteReceiver(request: DeleteEcommerceReceiverRequest): Promise<WxPayResponse<DeleteEcommerceReceiverResponse>>;
+}
+
+/** 电商收付通退款金额 */
+interface EcommerceRefundAmount {
+    /** 退款金额（分） */
+    refund: number;
+    /** 原订单金额（分） */
+    total: number;
+    /** 货币类型 */
+    currency?: string;
+}
+/** 电商收付通申请退款请求 */
+interface CreateEcommerceRefundRequest {
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 电商平台 AppID */
+    sp_appid: string;
+    /** 特约商户 AppID */
+    sub_appid?: string;
+    /** 微信支付订单号 */
+    transaction_id?: string;
+    /** 商户订单号 */
+    out_trade_no?: string;
+    /** 商户退款单号 */
+    out_refund_no: string;
+    /** 退款原因 */
+    reason?: string;
+    /** 退款金额 */
+    amount: EcommerceRefundAmount;
+    /** 回调通知地址 */
+    notify_url?: string;
+    /** 退款资金来源 */
+    funds_account?: string;
+}
+/** 电商收付通申请退款响应 */
+interface CreateEcommerceRefundResponse {
+    /** 微信退款单号 */
+    refund_id: string;
+    /** 商户退款单号 */
+    out_refund_no: string;
+    /** 创建时间 */
+    create_time: string;
+    /** 退款金额 */
+    amount: EcommerceRefundAmount;
+}
+/** 电商收付通查询退款响应 */
+interface QueryEcommerceRefundResponse {
+    refund_id: string;
+    out_refund_no: string;
+    transaction_id: string;
+    out_trade_no: string;
+    channel?: string;
+    user_received_account: string;
+    success_time?: string;
+    create_time: string;
+    /** 退款状态 */
+    status: string;
+    amount: EcommerceRefundAmount;
+    promotion_detail?: {
+        promotion_id: string;
+        scope: string;
+        type: string;
+        amount: number;
+        refund_amount: number;
+    }[];
+    /** 退款出资账户 */
+    refund_account?: string;
+    /** 资金账户 */
+    funds_account?: string;
+}
+/** 电商收付通垫付退款回补请求 */
+interface CreateReturnAdvanceRequest {
+    /** 微信退款单号（必须是垫付退款的微信退款单） */
+    refund_id: string;
+    /** 二级商户号 */
+    sub_mchid: string;
+}
+/** 电商收付通垫付退款回补响应 */
+interface ReturnAdvanceResponse {
+    /** 微信退款单号 */
+    refund_id: string;
+    /** 微信回补单号 */
+    advance_return_id: string;
+    /** 垫付回补金额（分） */
+    return_amount: number;
+    /** 出款方商户号 */
+    payer_mchid: string;
+    /** 出款方账户：BASIC / OPERATION */
+    payer_account: string;
+    /** 入账方商户号 */
+    payee_mchid: string;
+    /** 入账方账户：BASIC / OPERATION */
+    payee_account: string;
+    /** 垫付回补结果：SUCCESS / FAILED / PROCESSING */
+    result: string;
+    /** 垫付回补完成时间 */
+    success_time?: string;
+}
+/**
+ * 电商收付通退款服务
+ *
+ * 用于电商平台对二级商户的订单进行退款。
+ *
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4013080625 (申请退款)
+ */
+declare class EcommerceRefundService {
+    private readonly client;
+    constructor(client: WxPayClient);
+    /**
+     * 申请退款
+     *
+     * @param request - 退款请求参数
+     * @returns 退款结果
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4013080625
+     */
+    create(request: CreateEcommerceRefundRequest): Promise<WxPayResponse<CreateEcommerceRefundResponse>>;
+    /**
+     * 查询单笔退款（通过商户退款单号）
+     *
+     * @param subMchid - 特约商户号
+     * @param outRefundNo - 商户退款单号
+     * @returns 退款详情
+     */
+    queryByOutRefundNo(subMchid: string, outRefundNo: string): Promise<WxPayResponse<QueryEcommerceRefundResponse>>;
+    /**
+     * 查询单笔退款（通过微信支付退款单号）
+     *
+     * @param subMchid - 特约商户号
+     * @param refundId - 微信支付退款单号
+     * @returns 退款详情
+     */
+    queryByRefundId(subMchid: string, refundId: string): Promise<WxPayResponse<QueryEcommerceRefundResponse>>;
+    /**
+     * 垫付退款回补
+     *
+     * 当电商平台已垫付退款给用户，后续从二级商户处回补该笔退款资金。
+     *
+     * @param request - 垫付回补请求参数
+     * @returns 垫付回补结果
+     */
+    createReturnAdvance(request: CreateReturnAdvanceRequest): Promise<WxPayResponse<ReturnAdvanceResponse>>;
+    /**
+     * 查询垫付回补结果
+     *
+     * @param subMchid - 特约商户号
+     * @param refundId - 微信退款单号
+     * @returns 垫付回补结果
+     */
+    queryReturnAdvance(subMchid: string, refundId: string): Promise<WxPayResponse<ReturnAdvanceResponse>>;
+}
+
+/** 电商收付通请求补差请求 */
+interface CreateEcommerceSubsidyRequest {
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 微信支付订单号 */
+    transaction_id: string;
+    /** 补差金额（分） */
+    amount: number;
+    /** 补差描述 */
+    description: string;
+    /** 商户补差单号 */
+    out_subsidy_no?: string;
+}
+/** 电商收付通请求补差响应 */
+interface CreateEcommerceSubsidyResponse {
+    sub_mchid: string;
+    transaction_id: string;
+    /** 微信补差单号 */
+    subsidy_id: string;
+    amount: number;
+    description: string;
+    /** 补差结果 */
+    result: string;
+    success_time?: string;
+}
+/** 电商收付通补差回退请求 */
+interface EcommerceSubsidyReturnRequest {
+    sub_mchid: string;
+    transaction_id: string;
+    refund_id?: string;
+    amount: number;
+    description: string;
+    /** 商户补差回退单号 */
+    out_order_no: string;
+}
+/** 电商收付通补差回退响应 */
+interface EcommerceSubsidyReturnResponse {
+    sub_mchid: string;
+    transaction_id: string;
+    /** 微信补差回退单号 */
+    subsidy_refund_id: string;
+    amount: number;
+    description: string;
+    result: string;
+    success_time?: string;
+}
+/** 电商收付通取消补差请求 */
+interface CancelEcommerceSubsidyRequest {
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 微信支付订单号 */
+    transaction_id: string;
+    /** 取消补差描述 */
+    description: string;
+}
+/** 电商收付通取消补差响应 */
+interface CancelEcommerceSubsidyResponse {
+    sub_mchid: string;
+    transaction_id: string;
+    /** 取消补差结果 */
+    result: string;
+    description: string;
+}
+/**
+ * 电商收付通补差服务
+ *
+ * 用于电商平台对二级商户的订单进行补差。
+ *
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012690683 (补差)
+ */
+declare class EcommerceSubsidyService {
+    private readonly client;
+    constructor(client: WxPayClient);
+    /**
+     * 请求补差
+     *
+     * @param request - 补差请求参数
+     * @returns 补差结果
+     */
+    create(request: CreateEcommerceSubsidyRequest): Promise<WxPayResponse<CreateEcommerceSubsidyResponse>>;
+    /**
+     * 请求补差回退
+     *
+     * @param request - 补差回退请求参数
+     * @returns 回退结果
+     */
+    returnSubsidy(request: EcommerceSubsidyReturnRequest): Promise<WxPayResponse<EcommerceSubsidyReturnResponse>>;
+    /**
+     * 取消补差
+     *
+     * @param request - 取消补差请求参数
+     * @returns 取消补差结果
+     */
+    cancelSubsidy(request: CancelEcommerceSubsidyRequest): Promise<WxPayResponse<CancelEcommerceSubsidyResponse>>;
+}
+
+/** 连锁品牌分账接收方 */
+interface BrandProfitSharingReceiver {
+    /** 接收方类型 */
+    type: string;
+    /** 接收方账号 */
+    account: string;
+    /** 分账金额（分） */
+    amount: number;
+    /** 分账描述 */
+    description: string;
+    /** 接收方姓名 */
+    name?: string;
+}
+/** 连锁品牌请求分账请求 */
+interface CreateBrandProfitSharingRequest {
+    /** 品牌主商户号 */
+    brand_mchid: string;
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 微信支付订单号 */
+    transaction_id: string;
+    /** 商户分账单号 */
+    out_order_no: string;
+    /** 分账接收方列表 */
+    receivers: BrandProfitSharingReceiver[];
+    /** 是否解冻剩余资金 */
+    finish: boolean;
+}
+/** 连锁品牌请求分账响应 */
+interface CreateBrandProfitSharingResponse {
+    transaction_id: string;
+    out_order_no: string;
+    /** 微信分账单号 */
+    order_id: string;
+}
+/** 连锁品牌分账回退请求 */
+interface BrandProfitSharingReturnRequest {
+    brand_mchid: string;
+    sub_mchid: string;
+    order_id: string;
+    out_order_no: string;
+    out_return_no: string;
+    return_mchid: string;
+    amount: number;
+    description: string;
+}
+/** 连锁品牌分账回退响应 */
+interface BrandProfitSharingReturnResponse {
+    order_id: string;
+    out_order_no: string;
+    out_return_no: string;
+    return_no: string;
+    return_mchid: string;
+    amount: number;
+    result: string;
+}
+/** 连锁品牌完结分账请求 */
+interface BrandFinishOrderRequest {
+    brand_mchid: string;
+    sub_mchid: string;
+    transaction_id: string;
+    out_order_no: string;
+    description: string;
+}
+/** 连锁品牌查询最大分账比例响应 */
+interface QueryBrandMerchantRatioResponse {
+    /** 品牌商户号 */
+    brand_mchid: string;
+    /** 最大分账比例（万分比，如2000表示20%） */
+    max_ratio: number;
+}
+/** 连锁品牌查询订单剩余待分金额响应 */
+interface QueryBrandOrderAmountResponse {
+    /** 微信支付订单号 */
+    transaction_id: string;
+    /** 订单剩余待分金额（分） */
+    unsplit_amount: number;
+}
+/** 连锁品牌添加分账接收方请求 */
+interface AddBrandReceiverRequest {
+    /** 品牌主商户号 */
+    brand_mchid: string;
+    /** 公众账号ID */
+    appid: string;
+    /** 子商户公众账号ID（PERSONAL_SUB_OPENID 时必填） */
+    sub_appid?: string;
+    /** 接收方类型：MERCHANT_ID / PERSONAL_OPENID / PERSONAL_SUB_OPENID */
+    type: string;
+    /** 接收方账号 */
+    account: string;
+    /** 接收方名称 */
+    name?: string;
+    /** 与品牌主的关系类型：SUPPLIER / DISTRIBUTOR / SERVICE_PROVIDER / PLATFORM / STAFF / OTHERS */
+    relation_type: string;
+}
+/** 连锁品牌添加分账接收方响应 */
+interface AddBrandReceiverResponse {
+    brand_mchid: string;
+    type: string;
+    account: string;
+}
+/** 连锁品牌删除分账接收方请求 */
+interface DeleteBrandReceiverRequest {
+    /** 品牌主商户号 */
+    brand_mchid: string;
+    /** 公众账号ID */
+    appid: string;
+    /** 子商户公众账号ID */
+    sub_appid?: string;
+    /** 接收方类型：MERCHANT_ID / PERSONAL_OPENID / PERSONAL_SUB_OPENID */
+    type: string;
+    /** 接收方账号 */
+    account: string;
+}
+/** 连锁品牌删除分账接收方响应 */
+interface DeleteBrandReceiverResponse {
+    brand_mchid: string;
+    type: string;
+    account: string;
+}
+/**
+ * 连锁品牌分账服务
+ *
+ * 用于连锁品牌对门店的订单进行分账。
+ *
+ * @see https://pay.weixin.qq.com/doc/v3/partner/4012690683 (连锁品牌分账)
+ */
+declare class BrandProfitSharingService {
+    private readonly client;
+    constructor(client: WxPayClient);
+    /**
+     * 请求分账
+     *
+     * @param request - 分账请求参数
+     * @returns 分账结果
+     */
+    createOrder(request: CreateBrandProfitSharingRequest): Promise<WxPayResponse<CreateBrandProfitSharingResponse>>;
+    /**
+     * 查询分账结果
+     *
+     * @param brandMchid - 品牌主商户号
+     * @param subMchid - 特约商户号
+     * @param transactionId - 微信支付订单号
+     * @param outOrderNo - 商户分账单号
+     * @returns 分账结果详情
+     */
+    queryOrder(brandMchid: string, subMchid: string, transactionId: string, outOrderNo: string): Promise<WxPayResponse<CreateBrandProfitSharingResponse>>;
+    /**
+     * 请求分账回退
+     *
+     * @param request - 分账回退请求参数
+     * @returns 回退结果
+     */
+    createReturnOrder(request: BrandProfitSharingReturnRequest): Promise<WxPayResponse<BrandProfitSharingReturnResponse>>;
+    /**
+     * 查询分账回退结果
+     *
+     * @param brandMchid - 品牌主商户号
+     * @param subMchid - 特约商户号
+     * @param orderId - 微信分账单号
+     * @param outReturnNo - 商户回退单号
+     * @returns 回退结果详情
+     */
+    queryReturnOrder(brandMchid: string, subMchid: string, orderId: string, outReturnNo: string): Promise<WxPayResponse<BrandProfitSharingReturnResponse>>;
+    /**
+     * 完结分账
+     *
+     * @param request - 完结分账请求参数
+     */
+    finishOrder(request: BrandFinishOrderRequest): Promise<WxPayResponse>;
+    /**
+     * 查询最大分账比例
+     *
+     * @param brandMchid - 品牌主商户号
+     * @returns 最大分账比例
+     */
+    queryBrandMerchantRatio(brandMchid: string): Promise<WxPayResponse<QueryBrandMerchantRatioResponse>>;
+    /**
+     * 查询订单剩余待分金额
+     *
+     * @param transactionId - 微信支付订单号
+     * @returns 订单剩余待分金额
+     */
+    queryOrderAmount(transactionId: string): Promise<WxPayResponse<QueryBrandOrderAmountResponse>>;
+    /**
+     * 添加分账接收方
+     *
+     * @param request - 添加接收方请求参数
+     * @returns 添加接收方结果
+     */
+    addReceiver(request: AddBrandReceiverRequest): Promise<WxPayResponse<AddBrandReceiverResponse>>;
+    /**
+     * 删除分账接收方
+     *
+     * @param request - 删除接收方请求参数
+     * @returns 删除接收方结果
+     */
+    deleteReceiver(request: DeleteBrandReceiverRequest): Promise<WxPayResponse<DeleteBrandReceiverResponse>>;
+}
+
+/**
+ * 调起支付参数生成工具
+ *
+ * 用于生成各场景下调起微信支付所需的参数，包括签名计算：
+ * - APP 支付：生成 PayReq 对象参数（通过 OpenSDK 的 sendReq 调起）
+ * - JSAPI 支付：生成 WeixinJSBridge.invoke() 参数
+ * - 小程序支付：生成 wx.requestPayment() 参数
+ *
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070351 (APP 调起支付)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4012365340 (APP 调起支付签名)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791857 (JSAPI 调起支付)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791898 (小程序调起支付)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4012365341 (小程序调起支付签名)
+ */
+/**
+ * 生成 APP 调起支付的 sign
+ *
+ * 签名算法：使用商户私钥对签名串进行 RSA-SHA256 签名
+ * 签名串格式：appId\ntimeStamp\nnonceStr\nprepay_id\n
+ *
+ * @param appId - 应用ID
+ * @param timeStamp - 时间戳（秒）
+ * @param nonceStr - 随机字符串
+ * @param prepayId - 预支付ID
+ * @param privateKey - 商户私钥
+ * @returns Base64 编码的签名
+ */
+declare function generateAppPaySign(appId: string, timeStamp: string, nonceStr: string, prepayId: string, privateKey: string | Buffer): string;
+/**
+ * 生成 APP 调起支付所需的完整配置
+ *
+ * 用于生成 OpenSDK sendReq 方法中 PayReq 对象所需的全部参数。
+ * sign 使用商户 API 证书私钥进行 RSA-SHA256 签名。
+ *
+ * @param appId - 应用ID（下单时传入的 appid）
+ * @param partnerId - 商户号（下单时传入的 mchid）
+ * @param prepayId - 预支付ID（从 APP 下单接口获取）
+ * @param privateKey - 商户私钥
+ * @returns PayReq 对象所需的参数
+ *
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070351
+ */
+declare function buildAppBridgeConfig(appId: string, partnerId: string, prepayId: string, privateKey: string | Buffer): AppBridgeConfig;
 /**
  * 生成 JSAPI 调起支付的 paySign
  *
@@ -8525,4 +10224,39 @@ declare function oaepEncrypt(plaintext: string, publicKey: string | Buffer): str
  */
 declare function oaepDecrypt(ciphertext: string, privateKey: string | Buffer): string;
 
-export { type ActivateCouponStockRequest, type ActivateCouponStockResponse, type AddProfitSharingReceiverRequest, type AddProfitSharingReceiverResponse, type AppBridgeConfig, AppService, type ApplyAbnormalRefundRequest, type ApplyAbnormalRefundResponse, type ApplyMerchantTransferElecSignByOutBillNoRequest, type ApplyMerchantTransferElecSignByTransferBillNoRequest, type ApplyMerchantTransferElecSignResponse, type ApplyParkingRefundRequest, type ApplyParkingRefundResponse, type AssignSmartGuideRequest, type AuthorizationCloseInfo, type AuthorizationCloseReason, BillService, type BuildPartnershipRequest, type BuildPartnershipResponse, type BusinessCircleAuthorizeCallbackData, type BusinessCircleRefundCallbackData, BusinessCircleService, type BusinessCircleTransactionCallbackData, CallbackHandler, type CallbackHeaders, type CallbackNotification, type CallbackResource, type CancelMerchantTransferResponse, type CancelPayScoreOrderRequest, type CancelPayScoreOrderResponse, CertificateManager, CertificateService, type CloseCombineOrderParams, type CloseCombineOrderRequest, type CloseCombineSubOrder, type CloseMerchantTransferAuthorizationResponse, type CloseOrderParams, type CloseOrderRequest, CombineAppService, CombineH5Service, CombineMiniProgramService, CombineNativeService, type CombinePayerInfo, type CombinePayerInfoResponse, type CombinePromotionDetail, type CombinePromotionGoodsDetail, type CombineSceneInfo, type CombineSceneInfoResponse, CombineService, type CombineSubOrder, type CombineSubOrderAmount, type CombineSubOrderAmountResponse, type CombineSubOrderResponse, type CombineSubOrderSettleInfo, type CombineTransactionCallbackData, type CombineTransactionSubOrder, type ComplaintCallbackData, type ComplaintCallbackUrlRequest, type ComplaintCallbackUrlResponse, type ComplaintNegotiationHistoryResponse, type ComplaintNegotiationRecord, type ComplaintNegotiationState, ComplaintService, type ComplaintState, type ComplaintSummary, type CompleteComplaintRequest, type CompletePayScoreOrderRequest, type CompletePayScoreOrderResponse, type CouponConsumeGoodsDetail, type CouponConsumeInformation, type CouponCutToMessage, type CouponFixedNormalCoupon, type CouponLimitCard, type CouponNormalCouponInformation, type CouponPatternInfo, CouponService, type CouponStatus, type CouponStockItem, type CouponStockStatus, type CouponStockType, type CouponStockUseRule, type CouponType, type CouponUseCallbackData, type CouponUseRule, type CreateAppCombineOrderRequest, type CreateAppCombineOrderResponse, type CreateAppOrderRequest, type CreateAppOrderResponse, type CreateCombineOrderRequest, type CreateCombineOrderResponse, type CreateCouponStockRequest, type CreateCouponStockResponse, type CreateH5CombineOrderRequest, type CreateH5CombineOrderResponse, type CreateH5OrderRequest, type CreateH5OrderResponse, type CreateJsapiOrderRequest, type CreateJsapiOrderResponse, type CreateMedInsOrderRequest, type CreateMerchantTransferAuthorizationRequest, type CreateMerchantTransferAuthorizationResponse, type CreateMerchantTransferRequest, type CreateMerchantTransferResponse, type CreateMiniProgramCombineOrderRequest, type CreateMiniProgramCombineOrderResponse, type CreateNativeCombineOrderRequest, type CreateNativeCombineOrderResponse, type CreateNativeOrderRequest, type CreateNativeOrderResponse, type CreateParkingRequest, type CreateParkingResponse, type CreateParkingTransactionRequest, type CreateParkingTransactionResponse, type CreatePayGiftActivityRequest, type CreatePayGiftActivityResponse, type CreatePayScoreOrderRequest, type CreatePayScoreOrderResponse, type CreateProfitSharingOrderRequest, type CreateProfitSharingOrderResponse, type CreateProfitSharingReturnOrderRequest, type CreateProfitSharingReturnOrderResponse, type CreateRefundRequest, type CreateRefundResponse, type CreateTransferAfterAuthorizationRequest, type CreateTransferAfterAuthorizationResponse, type CreateTransferWithAuthorizationRequest, type CreateTransferWithAuthorizationResponse, type DecryptedCallback, type DecryptedCertificate, DecryptionException, type DeleteProfitSharingReceiverRequest, type DeleteProfitSharingReceiverResponse, type DownloadBillParams, type DownloadBillResponse, type DownloadCouponStockFlowResponse, type EchoTestRequest, type EchoTestResponse, type ElecSignHashType, type ElecSignState, type FundFlowBillParams, type FundFlowBillResponse, type GetPayGiftActivityGoodsResponse, type GetPayGiftActivityMerchantsResponse, GoldPlanService, type GoodsDetail, type H5CombineSceneInfo, type H5Info, type H5SceneInfo, H5Service, HttpException, type JsapiBridgeConfig, JsapiService, LoveFeastService, MalformedMessageException, type MedInsCashAddEntity, type MedInsCashReduceEntity, type MedInsJsapiBridgeConfig, type MedInsMedInsPayStatus, type MedInsMiniProgramBridgeConfig, type MedInsMixPayStatus, type MedInsMixPayType, type MedInsOrderResponse, type MedInsOrderType, type MedInsPersonIdentification, type MedInsRefundCallbackData, type MedInsSelfPayStatus, MedInsService, type MedInsSuccessCallbackData, MediaService, MerchantExclusiveCouponService, type MerchantTransferAuthorizationCallbackData, type MerchantTransferAuthorizationJsapiBridgeConfig, type MerchantTransferAuthorizationState, type MerchantTransferCallbackData, type MerchantTransferJsapiBridgeConfig, MerchantTransferService, type MerchantTransferState, type MiniProgramBridgeConfig, type ModifyPayScoreOrderRequest, type ModifyPayScoreOrderResponse, NativeService, type OrderAmount, type OrderAmountResponse, type OrderDetail, type OrderPayer, type ParkingAmount, type ParkingAppBridgeConfig, type ParkingBlockReason, type ParkingCallbackBlockReason, type ParkingEntryStatusCallbackData, type ParkingH5BridgeConfig, type ParkingMiniProgramBridgeConfig, type ParkingPayer, type ParkingPromotionDetail, type ParkingRefundAmount, type ParkingRefundFrom, type ParkingRefundGoodsDetail, type ParkingRefundPromotionDetail, type ParkingRepayBridgeConfig, type ParkingSceneInfo, ParkingService, type ParkingState, type ParkingTradeState, type ParkingTransactionCallbackData, type PartnershipAuthorizedData, type PartnershipBusinessType, type PartnershipPartner, type PartnershipPartnerType, type PartnershipRecord, PartnershipService, type PartnershipState, type PauseCouponStockRequest, type PauseCouponStockResponse, PayGiftActivityService, type PayGiftActivityState, type PayGiftActivitySummary, type PayScoreAppBridgeConfig, type PayScoreCollection, type PayScoreCollectionDetail, type PayScoreCollectionState, type PayScoreDetailAppBridgeConfig, type PayScoreDetailJsapiBridgeConfig, type PayScoreDetailMiniProgramBridgeConfig, type PayScoreDevice, type PayScoreDiscount, type PayScoreJsapiBridgeConfig, type PayScoreLocation, type PayScoreMiniProgramBridgeConfig, type PayScoreOrderState, type PayScoreOrderStateDescription, type PayScorePayment, type PayScorePromotionDetail, type PayScorePromotionGoodsDetail, type PayScoreRefundCallbackData, type PayScoreRiskFund, PayScoreService, type PayScoreTimeRange, type PayScoreUserConfirmCallbackData, type PayScoreUserPaidCallbackData, PayrollCardService, type PlateColor, type PlateServiceState, type PlatformCertificate, type ProfitSharingBillParams, type ProfitSharingBillResponse, type ProfitSharingCallbackData, type ProfitSharingFailReason, type ProfitSharingReceiver, type ProfitSharingReceiverResponse, type ProfitSharingReceiverResult, type ProfitSharingReceiverType, type ProfitSharingRelationType, type ProfitSharingReturnFailReason, type ProfitSharingReturnResult, ProfitSharingService, type ProfitSharingState, type PromotionDetail, type PromotionGoodsDetail, type QueryBusinessCircleAuthorizationResponse, type QueryBusinessCirclePendingPointsParams, type QueryBusinessCirclePendingPointsResponse, type QueryCombineOrderParams, type QueryCombineOrderResponse, type QueryComplaintResponse, type QueryComplaintsParams, type QueryComplaintsResponse, type QueryCouponDetailParams, type QueryCouponDetailResponse, type QueryCouponStockItemsParams, type QueryCouponStockItemsResponse, type QueryCouponStockMerchantsParams, type QueryCouponStockMerchantsResponse, type QueryCouponStocksParams, type QueryCouponStocksResponse, type QueryMerchantTransferAuthorizationResponse, type QueryMerchantTransferElecSignResponse, type QueryMerchantTransferResponse, type QueryOrderParams, type QueryOrderResponse, type QueryParkingOrderResponse, type QueryParkingRefundResponse, type QueryPartnershipsParams, type QueryPartnershipsResponse, type QueryPayGiftActivitiesParams, type QueryPayGiftActivitiesResponse, type QueryPayGiftActivityResponse, type QueryPayScoreOrderParams, type QueryPayScoreOrderResponse, type QueryPlateServiceParams, type QueryPlateServiceResponse, type QueryProfitSharingAmountResponse, type QueryProfitSharingOrderParams, type QueryProfitSharingOrderResponse, type QueryProfitSharingReturnOrderParams, type QueryProfitSharingReturnOrderResponse, type QueryRefundParams, type QueryRefundResponse, type QuerySmartGuidesParams, type QuerySmartGuidesResponse, type QueryUserCouponsParams, type QueryUserCouponsResponse, type RefundAmount, type RefundAmountResponse, type RefundCallbackData, type RefundFromAccount, type RefundGoodsDetail, type RefundPromotionDetail, type RegisterSmartGuideRequest, type RegisterSmartGuideResponse, type ReplyComplaintRequest, type ReplyImmediateServiceRequest, type RequestParams, type RestartCouponStockRequest, type RestartCouponStockResponse, RetailStoreService, ScanAndRideService, type SceneInfo, type SceneInfoResponse, SecurityService, type SendCouponRequest, type SendCouponResponse, ServiceException, type SetCouponCallbackRequest, type SetCouponCallbackResponse, type SettleInfo, type SignPayload, type SignType, type SignatureType, type SmartGuide, SmartGuideService, type StoreInfo, type SyncBusinessCircleParkingStatusRequest, type SyncBusinessCirclePointsRequest, type SyncPayScoreOrderRequest, type SyncPayScoreOrderResponse, type TradeBillParams, type TradeBillResponse, type TransactionCallbackData, type TransferSceneReportInfo, type UnfreezeProfitSharingRequest, type UnfreezeProfitSharingResponse, type UpdateComplaintRefundRequest, type UpdateSmartGuideRequest, type UploadComplaintImageResponse, type UploadMarketingImageRequest, type UploadMarketingImageResponse, type UserCouponItem, ValidationException, WxPayClient, WxPayError, type WxPayErrorDetail$1 as WxPayErrorDetail, type WxPayOptions, type WxPayResponse, buildAppBridgeConfig, buildAuthorization, buildH5CouponUrl, buildJsapiBridgeConfig, buildMedInsJsapiBridgeConfig, buildMedInsMiniProgramBridgeConfig, buildMerchantTransferAuthorizationJsapiBridgeConfig, buildMerchantTransferJsapiBridgeConfig, buildMerchantTransferMiniProgramBridgeConfig, buildMiniProgramBridgeConfig, buildParkingAppBridgePath, buildParkingH5BridgeUrl, buildParkingMiniProgramBridgeConfig, buildParkingRepayBridgeConfig, buildPayScoreAppBridgeConfig, buildPayScoreDetailAppBridgeConfig, buildPayScoreDetailJsapiBridgeConfig, buildPayScoreDetailMiniProgramBridgeConfig, buildPayScoreJsapiBridgeConfig, buildPayScoreMiniProgramBridgeConfig, buildSignString, decryptSensitiveFields, decryptSensitiveFieldsInArray, encryptSensitiveFields, encryptSensitiveFieldsInArray, generateAppPaySign, generateNonce, generateNonceStr, generatePayScorePaySign, generatePaySign, isTimestampValid, oaepDecrypt, oaepEncrypt, registerSensitiveFields, sign, verifySignature };
+/**
+ * 从 PEM 字符串加载 X.509 证书
+ */
+declare function loadCertificate(certificate: string): crypto.X509Certificate;
+/**
+ * 从文件路径加载 X.509 证书
+ */
+declare function loadCertificateFromPath(path: string): crypto.X509Certificate;
+/**
+ * 加载私钥内容（支持 PEM 字符串、文件路径、Buffer）
+ */
+declare function loadPrivateKey(key: string | Buffer): string;
+/**
+ * 加载公钥内容（支持 PEM 字符串、文件路径、Buffer）
+ */
+declare function loadPublicKey(key: string | Buffer): string;
+/**
+ * 获取 X.509 证书序列号（大写十六进制）
+ */
+declare function getCertificateSerialNumber(cert: crypto.X509Certificate): string;
+/**
+ * 判断证书是否已过期
+ *
+ * @param cert - X.509 证书
+ * @param now - 检查时间点，默认为当前时间
+ */
+declare function isCertificateExpired(cert: crypto.X509Certificate, now?: Date): boolean;
+/**
+ * 判断证书是否在有效期内
+ *
+ * @param cert - X.509 证书
+ * @param now - 检查时间点，默认为当前时间
+ */
+declare function isCertificateValid(cert: crypto.X509Certificate, now?: Date): boolean;
+
+export { type ActivateCouponStockRequest, type ActivateCouponStockResponse, type AddProfitSharingReceiverRequest, type AddProfitSharingReceiverResponse, type AppBridgeConfig, AppService, type ApplyAbnormalRefundRequest, type ApplyAbnormalRefundResponse, type ApplyMerchantTransferElecSignByOutBillNoRequest, type ApplyMerchantTransferElecSignByTransferBillNoRequest, type ApplyMerchantTransferElecSignResponse, type ApplyParkingRefundRequest, type ApplyParkingRefundResponse, type AssignSmartGuideRequest, type AuthorizationCloseInfo, type AuthorizationCloseReason, BillService, BrandProfitSharingService, type BuildPartnershipRequest, type BuildPartnershipResponse, type BusinessCircleAuthorizeCallbackData, type BusinessCircleRefundCallbackData, BusinessCircleService, type BusinessCircleTransactionCallbackData, CallbackHandler, type CallbackHeaders, type CallbackNotification, type CallbackResource, type CancelMerchantTransferResponse, type CancelPayScoreOrderRequest, type CancelPayScoreOrderResponse, CertificateManager, CertificateService, type CloseCombineOrderParams, type CloseCombineOrderRequest, type CloseCombineSubOrder, type CloseMerchantTransferAuthorizationResponse, type CloseOrderParams, type CloseOrderRequest, CombineAppService, CombineH5Service, CombineMiniProgramService, CombineNativeService, type CombinePayerInfo, type CombinePayerInfoResponse, type CombinePromotionDetail, type CombinePromotionGoodsDetail, type CombineSceneInfo, type CombineSceneInfoResponse, CombineService, type CombineSubOrder, type CombineSubOrderAmount, type CombineSubOrderAmountResponse, type CombineSubOrderResponse, type CombineSubOrderSettleInfo, type CombineTransactionCallbackData, type CombineTransactionSubOrder, type ComplaintCallbackData, type ComplaintCallbackUrlRequest, type ComplaintCallbackUrlResponse, type ComplaintNegotiationHistoryResponse, type ComplaintNegotiationRecord, type ComplaintNegotiationState, ComplaintService, type ComplaintState, type ComplaintSummary, type CompleteComplaintRequest, type CompletePayScoreOrderRequest, type CompletePayScoreOrderResponse, type CouponConsumeGoodsDetail, type CouponConsumeInformation, type CouponCutToMessage, type CouponFixedNormalCoupon, type CouponLimitCard, type CouponNormalCouponInformation, type CouponPatternInfo, CouponService, type CouponStatus, type CouponStockItem, type CouponStockStatus, type CouponStockType, type CouponStockUseRule, type CouponType, type CouponUseCallbackData, type CouponUseRule, type CreateAppCombineOrderRequest, type CreateAppCombineOrderResponse, type CreateAppOrderRequest, type CreateAppOrderResponse, type CreateCombineOrderRequest, type CreateCombineOrderResponse, type CreateCouponStockRequest, type CreateCouponStockResponse, type CreateH5CombineOrderRequest, type CreateH5CombineOrderResponse, type CreateH5OrderRequest, type CreateH5OrderResponse, type CreateJsapiOrderRequest, type CreateJsapiOrderResponse, type CreateMedInsOrderRequest, type CreateMerchantTransferAuthorizationRequest, type CreateMerchantTransferAuthorizationResponse, type CreateMerchantTransferRequest, type CreateMerchantTransferResponse, type CreateMiniProgramCombineOrderRequest, type CreateMiniProgramCombineOrderResponse, type CreateNativeCombineOrderRequest, type CreateNativeCombineOrderResponse, type CreateNativeOrderRequest, type CreateNativeOrderResponse, type CreateParkingRequest, type CreateParkingResponse, type CreateParkingTransactionRequest, type CreateParkingTransactionResponse, type CreatePartnerAppOrderRequest, type CreatePartnerAppOrderResponse, type CreatePartnerH5OrderRequest, type CreatePartnerH5OrderResponse, type CreatePartnerJsapiOrderRequest, type CreatePartnerJsapiOrderResponse, type CreatePartnerNativeOrderRequest, type CreatePartnerNativeOrderResponse, type CreatePayGiftActivityRequest, type CreatePayGiftActivityResponse, type CreatePayScoreOrderRequest, type CreatePayScoreOrderResponse, type CreateProfitSharingOrderRequest, type CreateProfitSharingOrderResponse, type CreateProfitSharingReturnOrderRequest, type CreateProfitSharingReturnOrderResponse, type CreateRefundRequest, type CreateRefundResponse, type CreateTransferAfterAuthorizationRequest, type CreateTransferAfterAuthorizationResponse, type CreateTransferWithAuthorizationRequest, type CreateTransferWithAuthorizationResponse, type DecryptedCallback, type DecryptedCertificate, DecryptionException, type DeleteProfitSharingReceiverRequest, type DeleteProfitSharingReceiverResponse, type DownloadBillParams, type DownloadBillResponse, type DownloadCouponStockFlowResponse, type EchoTestRequest, type EchoTestResponse, type EcommerceFundFlowBillParams, EcommerceProfitSharingService, EcommerceRefundService, EcommerceSubsidyService, type ElecSignHashType, type ElecSignState, type EncryptBillEntity, type EncryptBillResponse, type FundFlowBillParams, type FundFlowBillResponse, type GetPayGiftActivityGoodsResponse, type GetPayGiftActivityMerchantsResponse, GoldPlanService, type GoodsDetail, type H5CombineSceneInfo, type H5Info, type H5SceneInfo, H5Service, HttpException, type JsapiBridgeConfig, JsapiService, LoveFeastService, MalformedMessageException, type MedInsCashAddEntity, type MedInsCashReduceEntity, type MedInsJsapiBridgeConfig, type MedInsMedInsPayStatus, type MedInsMiniProgramBridgeConfig, type MedInsMixPayStatus, type MedInsMixPayType, type MedInsOrderResponse, type MedInsOrderType, type MedInsPersonIdentification, type MedInsRefundCallbackData, type MedInsSelfPayStatus, MedInsService, type MedInsSuccessCallbackData, MediaService, MerchantExclusiveCouponService, type MerchantTransferAuthorizationCallbackData, type MerchantTransferAuthorizationJsapiBridgeConfig, type MerchantTransferAuthorizationState, type MerchantTransferCallbackData, type MerchantTransferJsapiBridgeConfig, MerchantTransferService, type MerchantTransferState, type MiniProgramBridgeConfig, type ModifyPayScoreOrderRequest, type ModifyPayScoreOrderResponse, NativeService, type OrderAmount, type OrderAmountResponse, type OrderDetail, type OrderPayer, type ParkingAmount, type ParkingAppBridgeConfig, type ParkingBlockReason, type ParkingCallbackBlockReason, type ParkingEntryStatusCallbackData, type ParkingH5BridgeConfig, type ParkingMiniProgramBridgeConfig, type ParkingPayer, type ParkingPromotionDetail, type ParkingRefundAmount, type ParkingRefundFrom, type ParkingRefundGoodsDetail, type ParkingRefundPromotionDetail, type ParkingRepayBridgeConfig, type ParkingSceneInfo, ParkingService, type ParkingState, type ParkingTradeState, type ParkingTransactionCallbackData, PartnerAppService, type PartnerCloseOrderRequest, type PartnerH5SceneInfo, PartnerH5Service, type PartnerJsapiPayer, PartnerJsapiService, PartnerNativeService, type PartnerQueryOrderParams, type PartnerQueryOrderResponse, PartnerTransferBatchService, PartnerTransferService, type PartnershipAuthorizedData, type PartnershipBusinessType, type PartnershipPartner, type PartnershipPartnerType, type PartnershipRecord, PartnershipService, type PartnershipState, type PauseCouponStockRequest, type PauseCouponStockResponse, PayGiftActivityService, type PayGiftActivityState, type PayGiftActivitySummary, type PayScoreAppBridgeConfig, type PayScoreCollection, type PayScoreCollectionDetail, type PayScoreCollectionState, type PayScoreDetailAppBridgeConfig, type PayScoreDetailJsapiBridgeConfig, type PayScoreDetailMiniProgramBridgeConfig, type PayScoreDevice, type PayScoreDiscount, type PayScoreJsapiBridgeConfig, type PayScoreLocation, type PayScoreMiniProgramBridgeConfig, type PayScoreOrderState, type PayScoreOrderStateDescription, type PayScorePayment, type PayScorePromotionDetail, type PayScorePromotionGoodsDetail, type PayScoreRefundCallbackData, type PayScoreRiskFund, PayScoreService, type PayScoreTimeRange, type PayScoreUserConfirmCallbackData, type PayScoreUserPaidCallbackData, PayrollCardService, type PlateColor, type PlateServiceState, type PlatformCertificate, type ProfitSharingBillParams, type ProfitSharingBillResponse, type ProfitSharingCallbackData, type ProfitSharingFailReason, type ProfitSharingReceiver, type ProfitSharingReceiverResponse, type ProfitSharingReceiverResult, type ProfitSharingReceiverType, type ProfitSharingRelationType, type ProfitSharingReturnFailReason, type ProfitSharingReturnResult, ProfitSharingService, type ProfitSharingState, type PromotionDetail, type PromotionGoodsDetail, type QueryBusinessCircleAuthorizationResponse, type QueryBusinessCirclePendingPointsParams, type QueryBusinessCirclePendingPointsResponse, type QueryCombineOrderParams, type QueryCombineOrderResponse, type QueryComplaintResponse, type QueryComplaintsParams, type QueryComplaintsResponse, type QueryCouponDetailParams, type QueryCouponDetailResponse, type QueryCouponStockItemsParams, type QueryCouponStockItemsResponse, type QueryCouponStockMerchantsParams, type QueryCouponStockMerchantsResponse, type QueryCouponStocksParams, type QueryCouponStocksResponse, type QueryMerchantTransferAuthorizationResponse, type QueryMerchantTransferElecSignResponse, type QueryMerchantTransferResponse, type QueryOrderParams, type QueryOrderResponse, type QueryParkingOrderResponse, type QueryParkingRefundResponse, type QueryPartnershipsParams, type QueryPartnershipsResponse, type QueryPayGiftActivitiesParams, type QueryPayGiftActivitiesResponse, type QueryPayGiftActivityResponse, type QueryPayScoreOrderParams, type QueryPayScoreOrderResponse, type QueryPlateServiceParams, type QueryPlateServiceResponse, type QueryProfitSharingAmountResponse, type QueryProfitSharingOrderParams, type QueryProfitSharingOrderResponse, type QueryProfitSharingReturnOrderParams, type QueryProfitSharingReturnOrderResponse, type QueryRefundParams, type QueryRefundResponse, type QuerySmartGuidesParams, type QuerySmartGuidesResponse, type QueryUserCouponsParams, type QueryUserCouponsResponse, type RefundAmount, type RefundAmountResponse, type RefundCallbackData, type RefundFromAccount, type RefundGoodsDetail, type RefundPromotionDetail, RefundService, type RegisterSmartGuideRequest, type RegisterSmartGuideResponse, type ReplyComplaintRequest, type ReplyImmediateServiceRequest, type RequestParams, type RestartCouponStockRequest, type RestartCouponStockResponse, RetailStoreService, ScanAndRideService, type SceneInfo, type SceneInfoResponse, SecurityService, type SendCouponRequest, type SendCouponResponse, ServiceException, type SetCouponCallbackRequest, type SetCouponCallbackResponse, type SettleInfo, type SignPayload, type SignType, type SignatureType, type SmartGuide, SmartGuideService, type StoreInfo, type SubMerchantFundFlowBillParams, type SyncBusinessCircleParkingStatusRequest, type SyncBusinessCirclePointsRequest, type SyncPayScoreOrderRequest, type SyncPayScoreOrderResponse, type TradeBillParams, type TradeBillResponse, type TransactionCallbackData, TransferBatchService, type TransferSceneReportInfo, type UnfreezeProfitSharingRequest, type UnfreezeProfitSharingResponse, type UpdateComplaintRefundRequest, type UpdateSmartGuideRequest, type UploadComplaintImageResponse, type UploadMarketingImageRequest, type UploadMarketingImageResponse, type UserCouponItem, ValidationException, WxPayClient, WxPayError, type WxPayErrorDetail$1 as WxPayErrorDetail, type WxPayOptions, type WxPayResponse, buildAppBridgeConfig, buildAuthorization, buildH5CouponUrl, buildJsapiBridgeConfig, buildMedInsJsapiBridgeConfig, buildMedInsMiniProgramBridgeConfig, buildMerchantTransferAuthorizationJsapiBridgeConfig, buildMerchantTransferJsapiBridgeConfig, buildMerchantTransferMiniProgramBridgeConfig, buildMiniProgramBridgeConfig, buildParkingAppBridgePath, buildParkingH5BridgeUrl, buildParkingMiniProgramBridgeConfig, buildParkingRepayBridgeConfig, buildPayScoreAppBridgeConfig, buildPayScoreDetailAppBridgeConfig, buildPayScoreDetailJsapiBridgeConfig, buildPayScoreDetailMiniProgramBridgeConfig, buildPayScoreJsapiBridgeConfig, buildPayScoreMiniProgramBridgeConfig, buildSignString, decryptSensitiveFields, decryptSensitiveFieldsInArray, encryptSensitiveFields, encryptSensitiveFieldsInArray, generateAppPaySign, generateNonce, generateNonceStr, generatePayScorePaySign, generatePaySign, getCertificateSerialNumber, isCertificateExpired, isCertificateValid, isTimestampValid, loadCertificate, loadCertificateFromPath, loadPrivateKey, loadPublicKey, oaepDecrypt, oaepEncrypt, registerSensitiveFields, sign, verifySignature };