wxpay-nodejs-sdk 0.2.5 → 0.2.6

package/dist/index.d.mts

@@ -5176,129 +5176,109 @@ declare class CertificateService {
 }
 
 /**
- * JSAPI 支付 / 小程序支付 服务
+ * 基础支付服务抽象类
  *
- * 提供 JSAPI 支付全流程相关的 API 封装，包括：
- * - JSAPI/小程序下单
- * - 查询订单
- * - 关闭订单
- * - 申请退款
- * - 查询退款
- * - 申请异常退款
- * - 申请交易账单
- * - 申请资金账单
- * - 下载账单
+ * 提供所有支付渠道通用的查询、退款、账单等方法，避免代码重复。
+ * 子类只需实现 createOrder 方法即可获得完整的支付服务能力。
  */
-declare class JsapiService {
-    private readonly client;
+declare abstract class BasePaymentService {
+    protected readonly client: WxPayClient;
     constructor(client: WxPayClient);
     /**
-     * JSAPI/小程序下单
-     *
-     * 商户通过此接口生成预付单并获取 prepay_id。
-     * prepay_id 有效期为 2 小时，超过 2 小时需重新请求。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791856
-     */
-    createOrder(request: CreateJsapiOrderRequest): Promise<WxPayResponse<CreateJsapiOrderResponse>>;
-    /**
-     * 查询 JSAPI 支付订单
+     * 查询订单
      *
      * 支持通过微信支付订单号或商户订单号查询订单状态。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791858 (微信支付订单号查询订单)
-     * @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;
-    }>;
     /**
      * 关闭订单
      *
      * 对于未支付的订单，商户可通过此接口关闭订单。
-     * 关单后，订单状态从未支付（NOTPAY）流转为已关闭（CLOSED）。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791860
      */
     closeOrder(outTradeNo: string, request: CloseOrderRequest): Promise<WxPayResponse>;
     /**
      * 申请退款
      *
      * 当订单状态为支付成功（SUCCESS）时，商户可通过此接口申请退款。
-     * 仅支持支付成功后 1 年内的订单。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791862
      */
     createRefund(request: CreateRefundRequest): Promise<WxPayResponse<CreateRefundResponse>>;
     /**
      * 查询退款单
      *
      * 通过商户退款单号查询退款状态。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791863
      */
     queryRefund(params: QueryRefundParams): Promise<WxPayResponse<QueryRefundResponse>>;
+    /**
+     * 申请异常退款
+     *
+     * 当退款状态为 ABNORMAL 时，可通过此接口发起异常退款处理。
+     */
+    applyAbnormalRefund(refundId: string, request: ApplyAbnormalRefundRequest): Promise<WxPayResponse<ApplyAbnormalRefundResponse>>;
     /**
      * 申请交易账单
      *
      * 商户可通过此接口获取交易账单的下载链接。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791866
      */
     tradeBill(params: TradeBillParams): Promise<WxPayResponse<TradeBillResponse>>;
     /**
      * 申请资金账单
      *
      * 商户可通过此接口获取资金账单的下载链接。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791867
      */
     fundFlowBill(params: FundFlowBillParams): Promise<WxPayResponse<FundFlowBillResponse>>;
     /**
-     * 申请异常退款
+     * 下载账单
      *
-     * 当退款状态为 ABNORMAL 时，可通过此接口发起异常退款处理。
-     * 支持退款至用户银行卡或退款至交易商户银行账户两种方式。
+     * 通过申请账单接口返回的 download_url，以 GET 方式下载账单原始文件。
+     */
+    downloadBill(downloadUrl: string): Promise<WxPayResponse<Buffer>>;
+}
+
+/**
+ * JSAPI 支付 / 小程序支付 服务
+ *
+ * 提供 JSAPI 支付全流程相关的 API 封装，包括：
+ * - JSAPI/小程序下单
+ * - 查询订单
+ * - 关闭订单
+ * - 申请退款
+ * - 查询退款
+ * - 申请异常退款
+ * - 申请交易账单
+ * - 申请资金账单
+ * - 下载账单
+ */
+declare class JsapiService extends BasePaymentService {
+    /**
+     * JSAPI/小程序下单
      *
-     * @param refundId - 微信支付退款单号
-     * @param request - 异常退款请求参数
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791864
+     * 商户通过此接口生成预付单并获取 prepay_id。
+     * prepay_id 有效期为 2 小时，超过 2 小时需重新请求。
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791856
      */
-    applyAbnormalRefund(refundId: string, request: ApplyAbnormalRefundRequest): Promise<WxPayResponse<ApplyAbnormalRefundResponse>>;
+    createOrder(request: CreateJsapiOrderRequest): Promise<WxPayResponse<CreateJsapiOrderResponse>>;
     /**
-     * 下载账单
+     * JSAPI 下单并生成调起支付参数
      *
-     * 通过申请账单接口返回的 download_url，以 GET 方式下载账单原始文件。
-     * 下载地址 5 分钟内有效，请及时下载。
-     * 返回的 data 为 Buffer，可能为 GZIP 压缩格式，需要自行解压。
+     * 封装了下单和调起支付参数生成两个步骤，一次调用即可获得
+     * prepay_id 和前端 WeixinJSBridge.invoke() 所需的全部参数。
      *
-     * @param downloadUrl - 申请账单返回的 download_url
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791868
+     * @param request - 下单请求参数（需包含 appid）
+     * @param privateKey - 商户私钥
+     * @returns 下单响应 + 调起支付参数
      */
-    downloadBill(downloadUrl: string): Promise<WxPayResponse<Buffer>>;
+    prepayWithRequestPayment(request: CreateJsapiOrderRequest, privateKey: string | Buffer): Promise<WxPayResponse<CreateJsapiOrderResponse> & {
+        bridgeConfig: JsapiBridgeConfig;
+    }>;
 }
 
 /**
@@ -5317,9 +5297,7 @@ declare class JsapiService {
  *
  * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791834
  */
-declare class H5Service {
-    private readonly client;
-    constructor(client: WxPayClient);
+declare class H5Service extends BasePaymentService {
     /**
      * H5 支付下单
      *
@@ -5329,81 +5307,6 @@ declare class H5Service {
      * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791834
      */
     createOrder(request: CreateH5OrderRequest): Promise<WxPayResponse<CreateH5OrderResponse>>;
-    /**
-     * 查询订单
-     *
-     * 支持通过微信支付订单号或商户订单号查询订单状态。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791837 (微信支付订单号查询订单)
-     * @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>>;
-    /**
-     * 关闭订单
-     *
-     * 对于未支付的订单，商户可通过此接口关闭订单。
-     * 关单后，订单状态从未支付（NOTPAY）流转为已关闭（CLOSED）。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791839
-     */
-    closeOrder(outTradeNo: string, request: CloseOrderRequest): Promise<WxPayResponse>;
-    /**
-     * 申请退款
-     *
-     * 当订单状态为支付成功（SUCCESS）时，商户可通过此接口申请退款。
-     * 仅支持支付成功后 1 年内的订单。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012810597
-     */
-    createRefund(request: CreateRefundRequest): Promise<WxPayResponse<CreateRefundResponse>>;
-    /**
-     * 查询退款单
-     *
-     * 通过商户退款单号查询退款状态。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012810601
-     */
-    queryRefund(params: QueryRefundParams): Promise<WxPayResponse<QueryRefundResponse>>;
-    /**
-     * 申请异常退款
-     *
-     * 当退款状态为 ABNORMAL 时，可通过此接口发起异常退款处理。
-     * 支持退款至用户银行卡或退款至交易商户银行账户两种方式。
-     *
-     * @param refundId - 微信支付退款单号
-     * @param request - 异常退款请求参数
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012810603
-     */
-    applyAbnormalRefund(refundId: string, request: ApplyAbnormalRefundRequest): Promise<WxPayResponse<ApplyAbnormalRefundResponse>>;
-    /**
-     * 申请交易账单
-     *
-     * 商户可通过此接口获取交易账单的下载链接。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012810606
-     */
-    tradeBill(params: TradeBillParams): Promise<WxPayResponse<TradeBillResponse>>;
-    /**
-     * 申请资金账单
-     *
-     * 商户可通过此接口获取资金账单的下载链接。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012810609
-     */
-    fundFlowBill(params: FundFlowBillParams): Promise<WxPayResponse<FundFlowBillResponse>>;
-    /**
-     * 下载账单
-     *
-     * 通过申请账单接口返回的 download_url，以 GET 方式下载账单原始文件。
-     * 下载地址 5 分钟内有效，请及时下载。
-     * 返回的 data 为 Buffer，可能为 GZIP 压缩格式，需要自行解压。
-     *
-     * @param downloadUrl - 申请账单返回的 download_url
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012810615
-     */
-    downloadBill(downloadUrl: string): Promise<WxPayResponse<Buffer>>;
 }
 
 /**
@@ -5422,9 +5325,7 @@ declare class H5Service {
  *
  * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070347
  */
-declare class AppService {
-    private readonly client;
-    constructor(client: WxPayClient);
+declare class AppService extends BasePaymentService {
     /**
      * APP 支付下单
      *
@@ -5435,83 +5336,18 @@ declare class AppService {
      */
     createOrder(request: CreateAppOrderRequest): Promise<WxPayResponse<CreateAppOrderResponse>>;
     /**
-     * 查询订单
+     * APP 下单并生成调起支付参数
      *
-     * 支持通过微信支付订单号或商户订单号查询订单状态。
+     * 封装了下单和调起支付参数生成两个步骤，一次调用即可获得
+     * prepay_id 和 APP 端调起支付所需的全部参数。
      *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070354 (微信支付订单号查询订单)
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070356 (商户订单号查询订单)
+     * @param request - 下单请求参数（需包含 appid）
+     * @param privateKey - 商户私钥
+     * @returns 下单响应 + 调起支付参数
      */
-    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;
     }>;
-    /**
-     * 关闭订单
-     *
-     * 对于未支付的订单，商户可通过此接口关闭订单。
-     * 关单后，订单状态从未支付（NOTPAY）流转为已关闭（CLOSED）。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070360
-     */
-    closeOrder(outTradeNo: string, request: CloseOrderRequest): Promise<WxPayResponse>;
-    /**
-     * 申请退款
-     *
-     * 当订单状态为支付成功（SUCCESS）时，商户可通过此接口申请退款。
-     * 仅支持支付成功后 1 年内的订单。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070371
-     */
-    createRefund(request: CreateRefundRequest): Promise<WxPayResponse<CreateRefundResponse>>;
-    /**
-     * 查询退款单
-     *
-     * 通过商户退款单号查询退款状态。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070374
-     */
-    queryRefund(params: QueryRefundParams): Promise<WxPayResponse<QueryRefundResponse>>;
-    /**
-     * 申请异常退款
-     *
-     * 当退款状态为 ABNORMAL 时，可通过此接口发起异常退款处理。
-     * 支持退款至用户银行卡或退款至交易商户银行账户两种方式。
-     *
-     * @param refundId - 微信支付退款单号
-     * @param request - 异常退款请求参数
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070379
-     */
-    applyAbnormalRefund(refundId: string, request: ApplyAbnormalRefundRequest): Promise<WxPayResponse<ApplyAbnormalRefundResponse>>;
-    /**
-     * 申请交易账单
-     *
-     * 商户可通过此接口获取交易账单的下载链接。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070395
-     */
-    tradeBill(params: TradeBillParams): Promise<WxPayResponse<TradeBillResponse>>;
-    /**
-     * 申请资金账单
-     *
-     * 商户可通过此接口获取资金账单的下载链接。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070400
-     */
-    fundFlowBill(params: FundFlowBillParams): Promise<WxPayResponse<FundFlowBillResponse>>;
-    /**
-     * 下载账单
-     *
-     * 通过申请账单接口返回的 download_url，以 GET 方式下载账单原始文件。
-     * 下载地址 5 分钟内有效，请及时下载。
-     * 返回的 data 为 Buffer，可能为 GZIP 压缩格式，需要自行解压。
-     *
-     * @param downloadUrl - 申请账单返回的 download_url
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070401
-     */
-    downloadBill(downloadUrl: string): Promise<WxPayResponse<Buffer>>;
 }
 
 /**
@@ -5530,9 +5366,7 @@ declare class AppService {
  *
  * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791877
  */
-declare class NativeService {
-    private readonly client;
-    constructor(client: WxPayClient);
+declare class NativeService extends BasePaymentService {
     /**
      * Native 支付下单
      *
@@ -5545,79 +5379,63 @@ declare class NativeService {
      * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791877
      */
     createOrder(request: CreateNativeOrderRequest): Promise<WxPayResponse<CreateNativeOrderResponse>>;
+}
+
+/**
+ * 合单支付服务抽象类
+ *
+ * 提供所有合单支付渠道通用的查询、关闭、退款、账单等方法，避免代码重复。
+ * 子类只需实现 createOrder 方法即可获得完整的合单支付服务能力。
+ */
+declare abstract class BaseCombineService {
+    protected readonly client: WxPayClient;
+    constructor(client: WxPayClient);
     /**
-     * 查询订单
-     *
-     * 支持通过微信支付订单号或商户订单号查询订单状态。
+     * 查询合单订单
      *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791879 (微信支付订单号查询订单)
-     * @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>>;
+    queryOrderById(params: QueryCombineOrderParams): Promise<WxPayResponse<QueryCombineOrderResponse>>;
     /**
-     * 关闭订单
-     *
-     * 对于未支付的订单，商户可通过此接口关闭订单。
-     * 关单后，订单状态从未支付（NOTPAY）流转为已关闭（CLOSED）。
+     * 关闭合单订单
      *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791881
+     * 对于未支付的合单订单，商户可通过此接口关闭订单。
      */
-    closeOrder(outTradeNo: string, request: CloseOrderRequest): Promise<WxPayResponse>;
+    closeOrder(params: CloseCombineOrderParams, request: CloseCombineOrderRequest): Promise<WxPayResponse>;
     /**
      * 申请退款
      *
-     * 当订单状态为支付成功（SUCCESS）时，商户可通过此接口申请退款。
-     * 仅支持支付成功后 1 年内的订单。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791883
+     * 当子单状态为支付成功（SUCCESS）时，商户可通过此接口对子单申请退款。
      */
     createRefund(request: CreateRefundRequest): Promise<WxPayResponse<CreateRefundResponse>>;
     /**
      * 查询退款单
      *
      * 通过商户退款单号查询退款状态。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791884
      */
     queryRefund(params: QueryRefundParams): Promise<WxPayResponse<QueryRefundResponse>>;
     /**
      * 申请异常退款
      *
      * 当退款状态为 ABNORMAL 时，可通过此接口发起异常退款处理。
-     * 支持退款至用户银行卡或退款至交易商户银行账户两种方式。
-     *
-     * @param refundId - 微信支付退款单号
-     * @param request - 异常退款请求参数
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791885
      */
     applyAbnormalRefund(refundId: string, request: ApplyAbnormalRefundRequest): Promise<WxPayResponse<ApplyAbnormalRefundResponse>>;
     /**
      * 申请交易账单
      *
      * 商户可通过此接口获取交易账单的下载链接。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791887
      */
     tradeBill(params: TradeBillParams): Promise<WxPayResponse<TradeBillResponse>>;
     /**
      * 申请资金账单
      *
      * 商户可通过此接口获取资金账单的下载链接。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791888
      */
     fundFlowBill(params: FundFlowBillParams): Promise<WxPayResponse<FundFlowBillResponse>>;
     /**
      * 下载账单
      *
      * 通过申请账单接口返回的 download_url，以 GET 方式下载账单原始文件。
-     * 下载地址 5 分钟内有效，请及时下载。
-     * 返回的 data 为 Buffer，可能为 GZIP 压缩格式，需要自行解压。
-     *
-     * @param downloadUrl - 申请账单返回的 download_url
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791889
      */
     downloadBill(downloadUrl: string): Promise<WxPayResponse<Buffer>>;
 }
@@ -5632,6 +5450,9 @@ declare class NativeService {
  * - 申请退款
  * - 查询退款
  * - 申请异常退款
+ * - 申请交易账单
+ * - 申请资金账单
+ * - 下载账单
  *
  * 合单支付允许一笔支付中包含 2-10 个子单，适用于多商户场景。
  * 各子单商户号需与合单发起方 APPID 绑定。
@@ -5643,9 +5464,7 @@ declare class NativeService {
  * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421222 (查询合单订单)
  * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421225 (关闭合单订单)
  */
-declare class CombineService {
-    private readonly client;
-    constructor(client: WxPayClient);
+declare class CombineService extends BaseCombineService {
     /**
      * JSAPI 合单下单
      *
@@ -5662,66 +5481,6 @@ declare class CombineService {
      * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556926
      */
     createOrder(request: CreateCombineOrderRequest): Promise<WxPayResponse<CreateCombineOrderResponse>>;
-    /**
-     * 查询合单订单
-     *
-     * 通过合单商户订单号查询合单订单的支付状态及各子单详情。
-     *
-     * 订单状态（sub_orders[].trade_state）：
-     * - SUCCESS：支付成功（终态）
-     * - NOTPAY：未支付
-     * - CLOSED：已关闭（终态）
-     *
-     * 注意：请勿使用非合单支付的查单接口查询合单订单。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421222
-     */
-    queryOrderById(params: QueryCombineOrderParams): Promise<WxPayResponse<QueryCombineOrderResponse>>;
-    /**
-     * 关闭合单订单
-     *
-     * 对于未支付的合单订单，商户可通过此接口关闭订单。
-     * 关单后，所有子单状态从未支付（NOTPAY）流转为已关闭（CLOSED）。
-     *
-     * 关键约束：
-     * - 只能整单关闭，不支持关闭部分子单
-     * - combine_appid、sub_orders 中的 mchid 和 out_trade_no 必须与下单时完全一致
-     * - 仅支持未支付状态的订单
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421225
-     */
-    closeOrder(params: CloseCombineOrderParams, request: CloseCombineOrderRequest): Promise<WxPayResponse>;
-    /**
-     * 申请退款
-     *
-     * 当子单状态为支付成功（SUCCESS）时，商户可通过此接口对子单申请退款。
-     * 仅支持支付成功后 1 年内的订单。
-     *
-     * 注意：合单支付的订单无法通过合单总单号 combine_out_trade_no 退款，
-     * 需要传入子单的 transaction_id 或 out_trade_no。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421249
-     */
-    createRefund(request: CreateRefundRequest): Promise<WxPayResponse<CreateRefundResponse>>;
-    /**
-     * 查询退款单
-     *
-     * 通过商户退款单号查询退款状态。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421261
-     */
-    queryRefund(params: QueryRefundParams): Promise<WxPayResponse<QueryRefundResponse>>;
-    /**
-     * 申请异常退款
-     *
-     * 当退款状态为 ABNORMAL 时，可通过此接口发起异常退款处理。
-     * 支持退款至用户银行卡或退款至交易商户银行账户两种方式。
-     *
-     * @param refundId - 微信支付退款单号
-     * @param request - 异常退款请求参数
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421269
-     */
-    applyAbnormalRefund(refundId: string, request: ApplyAbnormalRefundRequest): Promise<WxPayResponse<ApplyAbnormalRefundResponse>>;
 }
 
 /**
@@ -5734,6 +5493,9 @@ declare class CombineService {
  * - 申请退款（基于子单）
  * - 查询退款单
  * - 申请异常退款
+ * - 申请交易账单
+ * - 申请资金账单
+ * - 下载账单
  *
  * 合单支付允许一笔支付中包含 2-10 个子单，适用于多商户场景。
  * 各子单商户号需与合单发起方 APPID 绑定。
@@ -5750,9 +5512,7 @@ declare class CombineService {
  * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421148 (合单退款)
  * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421156 (查询退款单)
  */
-declare class CombineH5Service {
-    private readonly client;
-    constructor(client: WxPayClient);
+declare class CombineH5Service extends BaseCombineService {
     /**
      * H5 合单下单
      *
@@ -5772,83 +5532,6 @@ declare class CombineH5Service {
      * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556961
      */
     createOrder(request: CreateH5CombineOrderRequest): Promise<WxPayResponse<CreateH5CombineOrderResponse>>;
-    /**
-     * 查询合单订单
-     *
-     * 通过合单商户订单号查询合单订单的支付状态及各子单详情。
-     * 合单支付订单需使用合单查单接口，不可使用非合单支付的查单接口。
-     *
-     * 订单状态（sub_orders[].trade_state）：
-     * - SUCCESS：支付成功（终态）
-     * - NOTPAY：未支付
-     * - CLOSED：已关闭（终态）
-     *
-     * 典型使用场景：
-     * - 用户支付后从收银台返回商户页面时，确认订单支付状态
-     * - 未收到支付成功回调通知时，主动查询确认订单状态
-     * - 关单前确认订单仍为未支付状态
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421126
-     */
-    queryOrderById(params: QueryCombineOrderParams): Promise<WxPayResponse<QueryCombineOrderResponse>>;
-    /**
-     * 关闭合单订单
-     *
-     * 对于未支付的合单订单，商户可通过此接口关闭订单。
-     * 关单后，所有子单状态从未支付（NOTPAY）流转为已关闭（CLOSED）。
-     *
-     * 关键约束：
-     * - 只能整单关闭，不支持关闭部分子单
-     * - combine_appid、sub_orders 中的 mchid 和 out_trade_no 必须与下单时完全一致
-     * - 仅支持未支付状态的订单
-     * - 关单后订单为失败终态
-     *
-     * 典型使用场景：
-     * - 用户超过商户系统内部规定的支付时间
-     * - 超过下单时设置的 time_expire 时间
-     * - 因特殊原因需在可支付时间范围内关闭订单
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421130
-     */
-    closeOrder(params: CloseCombineOrderParams, request: CloseCombineOrderRequest): Promise<WxPayResponse>;
-    /**
-     * 申请退款（基于子单）
-     *
-     * 合单支付的订单退款，无法通过合单商户订单号（combine_out_trade_no）退款，
-     * 只能根据单个子单进行退款。传入子单的 out_trade_no 或 transaction_id。
-     *
-     * 当子单状态为支付成功（SUCCESS）时，商户可通过此接口申请退款。
-     * 仅支持支付成功后 1 年内的订单。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421148
-     */
-    createRefund(request: CreateRefundRequest): Promise<WxPayResponse<CreateRefundResponse>>;
-    /**
-     * 查询退款单
-     *
-     * 通过商户退款单号查询退款状态。
-     * 退款申请成功后，可通过此接口确认退款是否到账。
-     *
-     * 退款状态：
-     * - SUCCESS：退款成功
-     * - CLOSED：退款关闭
-     * - PROCESSING：退款处理中
-     * - ABNORMAL：退款异常
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421156
-     */
-    queryRefund(params: QueryRefundParams): Promise<WxPayResponse<QueryRefundResponse>>;
-    /**
-     * 申请异常退款
-     *
-     * 当退款状态为 ABNORMAL 时，可通过此接口发起异常退款处理。
-     * 支持退款至用户银行卡或退款至交易商户银行账户两种方式。
-     *
-     * @param refundId - 微信支付退款单号
-     * @param request - 异常退款请求参数
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421164
-     */
-    applyAbnormalRefund(refundId: string, request: ApplyAbnormalRefundRequest): Promise<WxPayResponse<ApplyAbnormalRefundResponse>>;
 }
 
 /**
@@ -5881,9 +5564,7 @@ declare class CombineH5Service {
  * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556587 (查询退款单)
  * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556692 (下载交易账单)
  */
-declare class CombineAppService {
-    private readonly client;
-    constructor(client: WxPayClient);
+declare class CombineAppService extends BaseCombineService {
     /**
      * APP 合单下单
      *
@@ -5904,118 +5585,6 @@ declare class CombineAppService {
      * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556944
      */
     createOrder(request: CreateAppCombineOrderRequest): Promise<WxPayResponse<CreateAppCombineOrderResponse>>;
-    /**
-     * 查询合单订单
-     *
-     * 通过合单商户订单号查询合单订单的支付状态及各子单详情。
-     * 合单支付订单需使用合单查单接口，不可使用非合单支付的查单接口。
-     *
-     * 订单状态（sub_orders[].trade_state）：
-     * - SUCCESS：支付成功（终态）
-     * - NOTPAY：未支付
-     * - CLOSED：已关闭（终态）
-     *
-     * 典型使用场景：
-     * - 用户支付后从微信收银台返回商户 APP 时，OpenSDK 回调 onResp 后确认订单支付状态
-     * - 未收到支付成功回调通知时，主动查询确认订单状态
-     * - 关单前确认订单仍为未支付状态
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012557006
-     */
-    queryOrderById(params: QueryCombineOrderParams): Promise<WxPayResponse<QueryCombineOrderResponse>>;
-    /**
-     * 关闭合单订单
-     *
-     * 对于未支付的合单订单，商户可通过此接口关闭订单。
-     * 关单后，所有子单状态从未支付（NOTPAY）流转为已关闭（CLOSED）。
-     *
-     * 关键约束：
-     * - 只能整单关闭，不支持关闭部分子单
-     * - combine_appid、sub_orders 中的 mchid 和 out_trade_no 必须与下单时完全一致
-     * - 仅支持未支付状态的订单
-     * - 关单后订单为失败终态
-     *
-     * 典型使用场景：
-     * - 用户超过商户系统内部规定的支付时间
-     * - 超过下单时设置的 time_expire 时间
-     * - 因特殊原因需在可支付时间范围内关闭订单
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012577452
-     */
-    closeOrder(params: CloseCombineOrderParams, request: CloseCombineOrderRequest): Promise<WxPayResponse>;
-    /**
-     * 申请退款（基于子单）
-     *
-     * 合单支付的订单退款，无法通过合单商户订单号（combine_out_trade_no）退款，
-     * 只能根据单个子单进行退款。传入子单的 out_trade_no 或 transaction_id。
-     *
-     * 当子单状态为支付成功（SUCCESS）时，商户可通过此接口申请退款。
-     * 仅支持支付成功后 1 年内的订单。
-     *
-     * 注意：
-     * - 一笔订单最多支持 50 次部分退款，间隔至少 1 分钟
-     * - 重试时必须使用原商户退款单号，避免重复退款
-     * - 接口返回成功仅表示受理成功，最终结果以回调通知和查询接口为准
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556524
-     */
-    createRefund(request: CreateRefundRequest): Promise<WxPayResponse<CreateRefundResponse>>;
-    /**
-     * 查询退款单
-     *
-     * 通过商户退款单号查询退款状态。
-     * 退款申请成功后，可通过此接口确认退款是否到账。
-     *
-     * 退款状态：
-     * - SUCCESS：退款成功
-     * - CLOSED：退款关闭
-     * - PROCESSING：退款处理中
-     * - ABNORMAL：退款异常
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556587
-     */
-    queryRefund(params: QueryRefundParams): Promise<WxPayResponse<QueryRefundResponse>>;
-    /**
-     * 申请异常退款
-     *
-     * 当退款状态为 ABNORMAL 时，可通过此接口发起异常退款处理。
-     * 支持退款至用户银行卡或退款至交易商户银行账户两种方式。
-     *
-     * @param refundId - 微信支付退款单号
-     * @param request - 异常退款请求参数
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013420988
-     */
-    applyAbnormalRefund(refundId: string, request: ApplyAbnormalRefundRequest): Promise<WxPayResponse<ApplyAbnormalRefundResponse>>;
-    /**
-     * 申请交易账单
-     *
-     * 合单支付的订单账单是以子单为维度，每笔子单都会记录在各个子单商户账单内，
-     * 需要各个子单商户自己进行下载。
-     *
-     * 商户可通过此接口获取交易账单的下载链接，下载地址 5 分钟内有效。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556692
-     */
-    tradeBill(params: TradeBillParams): Promise<WxPayResponse<TradeBillResponse>>;
-    /**
-     * 申请资金账单
-     *
-     * 商户可通过此接口获取资金账单的下载链接，下载地址 5 分钟内有效。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556748
-     */
-    fundFlowBill(params: FundFlowBillParams): Promise<WxPayResponse<FundFlowBillResponse>>;
-    /**
-     * 下载账单
-     *
-     * 通过申请账单接口返回的 download_url，以 GET 方式下载账单原始文件。
-     * 下载地址 5 分钟内有效，请及时下载。
-     * 返回的 data 为 Buffer，可能为 GZIP 压缩格式，需要自行解压。
-     *
-     * @param downloadUrl - 申请账单返回的 download_url
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012085923
-     */
-    downloadBill(downloadUrl: string): Promise<WxPayResponse<Buffer>>;
 }
 
 /**
@@ -6032,158 +5601,44 @@ declare class CombineAppService {
  * - 申请资金账单
  * - 下载账单
  *
- * 合单支付允许一笔支付中包含 2-10 个子单，适用于多商户场景。
- * 各子单商户号需与合单发起方 APPID 绑定。
- *
- * 小程序合单支付流程：
- * 1. 调用 createOrder 获取 prepay_id
- * 2. 使用 buildMiniProgramBridgeConfig 生成 wx.requestPayment 调起参数
- * 3. 用户支付完成后，通过 requestPayment 回调、支付成功通知或主动查询确认订单状态
- * 4. 退款时需基于子单进行退款，无法通过合单商户订单号退款
- *
- * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556931 (小程序合单下单)
- * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421401 (查询合单订单)
- * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421404 (关闭合单订单)
- * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421410 (申请退款)
- * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421421 (查询退款单)
- * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421450 (下载交易账单)
- */
-declare class CombineMiniProgramService {
-    private readonly client;
-    constructor(client: WxPayClient);
-    /**
-     * 小程序合单下单
-     *
-     * 商户通过此接口生成小程序合单预付单并获取 prepay_id。
-     * 获取 prepay_id 后，配合 buildMiniProgramBridgeConfig 生成调起支付参数，
-     * 通过小程序 wx.requestPayment() 方法唤起微信支付收银台。
-     *
-     * prepay_id 有效期为 2 小时，超过 2 小时需使用原下单参数重新请求。
-     *
-     * 关键约束：
-     * - combine_mchid 需先申请发起合单支付权限
-     * - sub_orders 中的 mchid 需先申请接收合单支付权限
-     * - 合单发起方和子单参与方需绑定同一个 combine_appid
-     * - combine_appid 必须为小程序 AppID
-     * - combine_payer_info.openid 在小程序场景下可选（由运行环境隐式提供）
-     * - 子单数量为 2-10 笔
-     * - time_expire 不能早于下单时间后 1 分钟，不能超过下单时间后 7 天
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556931
-     */
-    createOrder(request: CreateMiniProgramCombineOrderRequest): Promise<WxPayResponse<CreateMiniProgramCombineOrderResponse>>;
-    /**
-     * 查询合单订单
-     *
-     * 通过合单商户订单号查询合单订单的支付状态及各子单详情。
-     * 合单支付订单需使用合单查单接口，不可使用非合单支付的查单接口。
-     *
-     * 订单状态（sub_orders[].trade_state）：
-     * - SUCCESS：支付成功（终态）
-     * - NOTPAY：未支付
-     * - CLOSED：已关闭（终态）
-     *
-     * 典型使用场景：
-     * - 用户支付后从收银台返回小程序页面时，requestPayment 回调后确认订单支付状态
-     * - 未收到支付成功回调通知时，主动查询确认订单状态
-     * - 关单前确认订单仍为未支付状态
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421401
-     */
-    queryOrderById(params: QueryCombineOrderParams): Promise<WxPayResponse<QueryCombineOrderResponse>>;
-    /**
-     * 关闭合单订单
-     *
-     * 对于未支付的合单订单，商户可通过此接口关闭订单。
-     * 关单后，所有子单状态从未支付（NOTPAY）流转为已关闭（CLOSED）。
-     *
-     * 关键约束：
-     * - 只能整单关闭，不支持关闭部分子单
-     * - combine_appid、sub_orders 中的 mchid 和 out_trade_no 必须与下单时完全一致
-     * - 仅支持未支付状态的订单
-     * - 关单后订单为失败终态
-     *
-     * 典型使用场景：
-     * - 用户超过商户系统内部规定的支付时间
-     * - 超过下单时设置的 time_expire 时间
-     * - 因特殊原因需在可支付时间范围内关闭订单
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421404
-     */
-    closeOrder(params: CloseCombineOrderParams, request: CloseCombineOrderRequest): Promise<WxPayResponse>;
-    /**
-     * 申请退款（基于子单）
-     *
-     * 合单支付的订单退款，无法通过合单商户订单号（combine_out_trade_no）退款，
-     * 只能根据单个子单进行退款。传入子单的 out_trade_no 或 transaction_id。
-     *
-     * 当子单状态为支付成功（SUCCESS）时，商户可通过此接口申请退款。
-     * 仅支持支付成功后 1 年内的订单。
-     *
-     * 注意：
-     * - 一笔订单最多支持 50 次部分退款，间隔至少 1 分钟
-     * - 重试时必须使用原商户退款单号，避免重复退款
-     * - 接口返回成功仅表示受理成功，最终结果以回调通知和查询接口为准
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421410
-     */
-    createRefund(request: CreateRefundRequest): Promise<WxPayResponse<CreateRefundResponse>>;
-    /**
-     * 查询退款单
-     *
-     * 通过商户退款单号查询退款状态。
-     * 退款申请成功后，可通过此接口确认退款是否到账。
-     *
-     * 退款状态：
-     * - SUCCESS：退款成功
-     * - CLOSED：退款关闭
-     * - PROCESSING：退款处理中
-     * - ABNORMAL：退款异常
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421421
-     */
-    queryRefund(params: QueryRefundParams): Promise<WxPayResponse<QueryRefundResponse>>;
-    /**
-     * 申请异常退款
-     *
-     * 当退款状态为 ABNORMAL 时，可通过此接口发起异常退款处理。
-     * 支持退款至用户银行卡或退款至交易商户银行账户两种方式。
-     *
-     * @param refundId - 微信支付退款单号
-     * @param request - 异常退款请求参数
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421429
-     */
-    applyAbnormalRefund(refundId: string, request: ApplyAbnormalRefundRequest): Promise<WxPayResponse<ApplyAbnormalRefundResponse>>;
-    /**
-     * 申请交易账单
-     *
-     * 合单支付的订单账单是以子单为维度，每笔子单都会记录在各个子单商户账单内，
-     * 需要各个子单商户自己进行下载。
-     *
-     * 商户可通过此接口获取交易账单的下载链接，下载地址 5 分钟内有效。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421450
-     */
-    tradeBill(params: TradeBillParams): Promise<WxPayResponse<TradeBillResponse>>;
+ * 合单支付允许一笔支付中包含 2-10 个子单，适用于多商户场景。
+ * 各子单商户号需与合单发起方 APPID 绑定。
+ *
+ * 小程序合单支付流程：
+ * 1. 调用 createOrder 获取 prepay_id
+ * 2. 使用 buildMiniProgramBridgeConfig 生成 wx.requestPayment 调起参数
+ * 3. 用户支付完成后，通过 requestPayment 回调、支付成功通知或主动查询确认订单状态
+ * 4. 退款时需基于子单进行退款，无法通过合单商户订单号退款
+ *
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556931 (小程序合单下单)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421401 (查询合单订单)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421404 (关闭合单订单)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421410 (申请退款)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421421 (查询退款单)
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421450 (下载交易账单)
+ */
+declare class CombineMiniProgramService extends BaseCombineService {
     /**
-     * 申请资金账单
+     * 小程序合单下单
      *
-     * 商户可通过此接口获取资金账单的下载链接，下载地址 5 分钟内有效。
+     * 商户通过此接口生成小程序合单预付单并获取 prepay_id。
+     * 获取 prepay_id 后，配合 buildMiniProgramBridgeConfig 生成调起支付参数，
+     * 通过小程序 wx.requestPayment() 方法唤起微信支付收银台。
      *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421456
-     */
-    fundFlowBill(params: FundFlowBillParams): Promise<WxPayResponse<FundFlowBillResponse>>;
-    /**
-     * 下载账单
+     * prepay_id 有效期为 2 小时，超过 2 小时需使用原下单参数重新请求。
      *
-     * 通过申请账单接口返回的 download_url，以 GET 方式下载账单原始文件。
-     * 下载地址 5 分钟内有效，请及时下载。
-     * 返回的 data 为 Buffer，可能为 GZIP 压缩格式，需要自行解压。
+     * 关键约束：
+     * - combine_mchid 需先申请发起合单支付权限
+     * - sub_orders 中的 mchid 需先申请接收合单支付权限
+     * - 合单发起方和子单参与方需绑定同一个 combine_appid
+     * - combine_appid 必须为小程序 AppID
+     * - combine_payer_info.openid 在小程序场景下可选（由运行环境隐式提供）
+     * - 子单数量为 2-10 笔
+     * - time_expire 不能早于下单时间后 1 分钟，不能超过下单时间后 7 天
      *
-     * @param downloadUrl - 申请账单返回的 download_url
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421461
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556931
      */
-    downloadBill(downloadUrl: string): Promise<WxPayResponse<Buffer>>;
+    createOrder(request: CreateMiniProgramCombineOrderRequest): Promise<WxPayResponse<CreateMiniProgramCombineOrderResponse>>;
 }
 
 /**
@@ -6217,9 +5672,7 @@ declare class CombineMiniProgramService {
  * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421346 (查询退款单)
  * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421361 (下载交易账单)
  */
-declare class CombineNativeService {
-    private readonly client;
-    constructor(client: WxPayClient);
+declare class CombineNativeService extends BaseCombineService {
     /**
      * Native 合单下单
      *
@@ -6241,118 +5694,6 @@ declare class CombineNativeService {
      * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556982
      */
     createOrder(request: CreateNativeCombineOrderRequest): Promise<WxPayResponse<CreateNativeCombineOrderResponse>>;
-    /**
-     * 查询合单订单
-     *
-     * 通过合单商户订单号查询合单订单的支付状态及各子单详情。
-     * 合单支付订单需使用合单查单接口，不可使用非合单支付的查单接口。
-     *
-     * 订单状态（sub_orders[].trade_state）：
-     * - SUCCESS：支付成功（终态）
-     * - NOTPAY：未支付
-     * - CLOSED：已关闭（终态）
-     *
-     * 典型使用场景：
-     * - 用户扫码支付后，轮询确认订单支付状态
-     * - 未收到支付成功回调通知时，主动查询确认订单状态
-     * - 关单前确认订单仍为未支付状态
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421316
-     */
-    queryOrderById(params: QueryCombineOrderParams): Promise<WxPayResponse<QueryCombineOrderResponse>>;
-    /**
-     * 关闭合单订单
-     *
-     * 对于未支付的合单订单，商户可通过此接口关闭订单。
-     * 关单后，所有子单状态从未支付（NOTPAY）流转为已关闭（CLOSED）。
-     *
-     * 关键约束：
-     * - 只能整单关闭，不支持关闭部分子单
-     * - combine_appid、sub_orders 中的 mchid 和 out_trade_no 必须与下单时完全一致
-     * - 仅支持未支付状态的订单
-     * - 关单后订单为失败终态
-     *
-     * 典型使用场景：
-     * - 用户超过商户系统内部规定的支付时间
-     * - 超过下单时设置的 time_expire 时间
-     * - 因特殊原因需在可支付时间范围内关闭订单
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421330
-     */
-    closeOrder(params: CloseCombineOrderParams, request: CloseCombineOrderRequest): Promise<WxPayResponse>;
-    /**
-     * 申请退款（基于子单）
-     *
-     * 合单支付的订单退款，无法通过合单商户订单号（combine_out_trade_no）退款，
-     * 只能根据单个子单进行退款。传入子单的 out_trade_no 或 transaction_id。
-     *
-     * 当子单状态为支付成功（SUCCESS）时，商户可通过此接口申请退款。
-     * 仅支持支付成功后 1 年内的订单。
-     *
-     * 注意：
-     * - 一笔订单最多支持 50 次部分退款，间隔至少 1 分钟
-     * - 重试时必须使用原商户退款单号，避免重复退款
-     * - 接口返回成功仅表示受理成功，最终结果以回调通知和查询接口为准
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421340
-     */
-    createRefund(request: CreateRefundRequest): Promise<WxPayResponse<CreateRefundResponse>>;
-    /**
-     * 查询退款单
-     *
-     * 通过商户退款单号查询退款状态。
-     * 退款申请成功后，可通过此接口确认退款是否到账。
-     *
-     * 退款状态：
-     * - SUCCESS：退款成功
-     * - CLOSED：退款关闭
-     * - PROCESSING：退款处理中
-     * - ABNORMAL：退款异常
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421346
-     */
-    queryRefund(params: QueryRefundParams): Promise<WxPayResponse<QueryRefundResponse>>;
-    /**
-     * 申请异常退款
-     *
-     * 当退款状态为 ABNORMAL 时，可通过此接口发起异常退款处理。
-     * 支持退款至用户银行卡或退款至交易商户银行账户两种方式。
-     *
-     * @param refundId - 微信支付退款单号
-     * @param request - 异常退款请求参数
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421352
-     */
-    applyAbnormalRefund(refundId: string, request: ApplyAbnormalRefundRequest): Promise<WxPayResponse<ApplyAbnormalRefundResponse>>;
-    /**
-     * 申请交易账单
-     *
-     * 合单支付的订单账单是以子单为维度，每笔子单都会记录在各个子单商户账单内，
-     * 需要各个子单商户自己进行下载。
-     *
-     * 商户可通过此接口获取交易账单的下载链接，下载地址 5 分钟内有效。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421361
-     */
-    tradeBill(params: TradeBillParams): Promise<WxPayResponse<TradeBillResponse>>;
-    /**
-     * 申请资金账单
-     *
-     * 商户可通过此接口获取资金账单的下载链接，下载地址 5 分钟内有效。
-     *
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421365
-     */
-    fundFlowBill(params: FundFlowBillParams): Promise<WxPayResponse<FundFlowBillResponse>>;
-    /**
-     * 下载账单
-     *
-     * 通过申请账单接口返回的 download_url，以 GET 方式下载账单原始文件。
-     * 下载地址 5 分钟内有效，请及时下载。
-     * 返回的 data 为 Buffer，可能为 GZIP 压缩格式，需要自行解压。
-     *
-     * @param downloadUrl - 申请账单返回的 download_url
-     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013421368
-     */
-    downloadBill(downloadUrl: string): Promise<WxPayResponse<Buffer>>;
 }
 
 /**
@@ -8668,6 +8009,92 @@ interface PartnerTransferQueryResponse {
     /** 更新时间 */
     update_time?: string;
 }
+/** 服务商申请电子回单请求（商户单号） */
+interface ApplyPartnerTransferElecSignByOutBillNoRequest {
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 商户单号 */
+    out_bill_no: string;
+}
+/** 服务商申请电子回单请求（微信单号） */
+interface ApplyPartnerTransferElecSignByTransferBillNoRequest {
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 微信转账单号 */
+    transfer_bill_no: string;
+}
+/** 服务商发起免确认收款授权请求 */
+interface CreatePartnerTransferAuthorizationRequest {
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 商户侧授权单号 */
+    out_authorization_no: string;
+    /** 商户应用唯一标识 */
+    appid: string;
+    /** 收款用户在商户appid下的唯一标识 */
+    openid: string;
+    /** 转账场景ID */
+    transfer_scene_id: string;
+    /** 用户展示名称 */
+    user_display_name: string;
+    /** 用户收款时感知到的收款原因 */
+    user_recv_perception?: string;
+    /** 授权结果异步通知回调地址 */
+    authorization_notify_url: string;
+    /** 用户端场景信息 */
+    scene_info?: {
+        /** 用户终端IP */
+        client_ip?: string;
+        /** 用户设备ID */
+        device_id?: string;
+        /** 设备类型 */
+        device_type?: 'IOS' | 'ANDROID' | 'HARMONY' | 'OTHER';
+    };
+}
+/** 服务商查询授权结果请求 */
+interface QueryPartnerTransferAuthorizationRequest {
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 商户侧授权单号 */
+    out_authorization_no: string;
+    /** 是否显示授权信息 */
+    is_display_authorization?: boolean;
+}
+/** 服务商用户授权后转账请求 */
+interface CreatePartnerTransferAfterAuthorizationRequest {
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 商户AppID */
+    appid: string;
+    /** 商户单号 */
+    out_bill_no: string;
+    /** 转账场景ID */
+    transfer_scene_id: string;
+    /** 收款用户姓名（需加密） */
+    user_name?: string;
+    /** 转账金额，单位为分 */
+    transfer_amount: number;
+    /** 转账备注 */
+    transfer_remark: string;
+    /** 用户收款感知 */
+    user_recv_perception?: string;
+    /** 转账场景报备信息 */
+    transfer_scene_report_infos?: {
+        info_type: string;
+        info_content: string;
+    }[];
+    /** 微信免确认收款授权单号（与out_authorization_no二选一） */
+    authorization_id?: string;
+    /** 商户侧授权单号（与authorization_id二选一） */
+    out_authorization_no?: string;
+}
+/** 服务商解除免确认收款授权请求 */
+interface ClosePartnerTransferAuthorizationRequest {
+    /** 特约商户号 */
+    sub_mchid: string;
+    /** 商户侧授权单号 */
+    out_authorization_no: string;
+}
 /**
  * 服务商商家转账服务
  *
@@ -8695,6 +8122,14 @@ declare class PartnerTransferService {
      * @returns 转账单详情
      */
     queryTransferByOutBillNo(outBillNo: string, subMchid: string): Promise<WxPayResponse<PartnerTransferQueryResponse>>;
+    /**
+     * 通过微信单号查询转账单
+     *
+     * @param transferBillNo - 微信转账单号
+     * @param subMchid - 特约商户号
+     * @returns 转账单详情
+     */
+    queryTransferByTransferBillNo(transferBillNo: string, subMchid: string): Promise<WxPayResponse<PartnerTransferQueryResponse>>;
     /**
      * 撤销转账
      *
@@ -8702,6 +8137,106 @@ declare class PartnerTransferService {
      * @param subMchid - 特约商户号
      */
     cancelTransfer(outBillNo: string, subMchid: string): Promise<WxPayResponse>;
+    /**
+     * 商户单号申请电子回单
+     *
+     * 申请条件：
+     * - 转账单据状态为 SUCCESS
+     * - 传入了收款用户姓名
+     * - 六个月内的转账单据
+     *
+     * 回单有效期为90天，过期需重新申请。
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012716452
+     */
+    applyElecSignByOutBillNo(request: ApplyPartnerTransferElecSignByOutBillNoRequest): Promise<WxPayResponse<ApplyMerchantTransferElecSignResponse>>;
+    /**
+     * 商户单号查询电子回单
+     *
+     * 当申请单状态为 FINISHED 时，返回回单文件的下载地址和摘要信息。
+     * 下载地址有效期为10分钟，过期后需重新调用此接口获取。
+     *
+     * @param outBillNo - 商户单号
+     * @param subMchid - 特约商户号
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012716436
+     */
+    queryElecSignByOutBillNo(outBillNo: string, subMchid: string): Promise<WxPayResponse<QueryMerchantTransferElecSignResponse>>;
+    /**
+     * 微信单号申请电子回单
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012716456
+     */
+    applyElecSignByTransferBillNo(request: ApplyPartnerTransferElecSignByTransferBillNoRequest): Promise<WxPayResponse<ApplyMerchantTransferElecSignResponse>>;
+    /**
+     * 微信单号查询电子回单
+     *
+     * @param transferBillNo - 微信转账单号
+     * @param subMchid - 特约商户号
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4012716455
+     */
+    queryElecSignByTransferBillNo(transferBillNo: string, subMchid: string): Promise<WxPayResponse<QueryMerchantTransferElecSignResponse>>;
+    /**
+     * 下载电子回单
+     *
+     * 通过申请电子回单接口返回的 download_url，以 GET 方式下载回单原始文件。
+     * 下载地址有效期为 10 分钟，过期后需重新调用查询接口获取。
+     * 返回的 data 为 PDF 文件的 Buffer。
+     *
+     * @param downloadUrl - 查询电子回单返回的 download_url
+     * @returns 电子回单文件 Buffer
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4013866774
+     */
+    downloadElecSign(downloadUrl: string): Promise<WxPayResponse<Buffer>>;
+    /**
+     * 发起转账并完成免确认收款授权
+     *
+     * 在发起转账的同时申请免确认收款授权，用户确认收款时可同时完成授权。
+     * 授权成功后，后续转账无需用户逐笔确认。
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4014399293
+     */
+    createTransferWithAuthorization(request: CreateTransferWithAuthorizationRequest & {
+        sub_mchid: string;
+    }): Promise<WxPayResponse<CreateTransferWithAuthorizationResponse>>;
+    /**
+     * 发起免确认收款授权
+     *
+     * 直接申请免确认收款授权，不发起转账。
+     * 用户需在24小时内完成授权，未确认记录保留30天。
+     * 同一微信号在同商户下待确认+已授权状态的授权单最多5个。
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4015901167
+     */
+    createAuthorization(request: CreatePartnerTransferAuthorizationRequest): Promise<WxPayResponse<CreateMerchantTransferAuthorizationResponse>>;
+    /**
+     * 商户单号查询授权结果
+     *
+     * @param request - 查询请求参数
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4014399423
+     */
+    queryAuthorizationByOutAuthorizationNo(request: QueryPartnerTransferAuthorizationRequest): Promise<WxPayResponse<QueryMerchantTransferAuthorizationResponse>>;
+    /**
+     * 用户授权后转账
+     *
+     * 用户完成授权后，商户可直接发起转账，无需用户逐笔确认收款。
+     * 需要提供 authorization_id 或 out_authorization_no（二选一）。
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4014399371
+     */
+    createTransferAfterAuthorization(request: CreatePartnerTransferAfterAuthorizationRequest): Promise<WxPayResponse<CreateTransferAfterAuthorizationResponse>>;
+    /**
+     * 解除免确认收款授权
+     *
+     * 商户可调用此接口帮助用户发起解除授权。
+     * 用户也可通过微信支付入账消息的收款设置操作关闭授权。
+     *
+     * @see https://pay.weixin.qq.com/doc/v3/partner/4015653811
+     */
+    closeAuthorization(request: ClosePartnerTransferAuthorizationRequest): Promise<WxPayResponse<CloseMerchantTransferAuthorizationResponse>>;
 }
 
 /** 批量转账明细输入 */