wxpay-nodejs-sdk 0.2.4 → 0.2.5

package/dist/index.mjs

@@ -1,8 +1,15 @@
-import fs from 'fs';
+import fs2 from 'fs';
 import os from 'os';
 import crypto2 from 'crypto';
+import zlib from 'zlib';
 
 // src/core/client.ts
+
+// package.json
+var version = "0.2.5";
+
+// src/version.ts
+var SDK_VERSION = version;
 var CertificateManager = class {
   /** 平台证书缓存 Map<序列号, 证书信息> */
   certificates = /* @__PURE__ */ new Map();
@@ -57,6 +64,7 @@ var CertificateManager = class {
    * 获取用于验签的公钥
    *
    * 优先返回微信支付公钥（公钥模式），否则根据证书序列号查找平台证书。
+   * 在组合模式下，如果证书未找到，会回退到微信支付公钥。
    *
    * @param serialNo - 证书序列号或公钥ID
    * @returns PEM 格式的公钥，不存在则返回 null
@@ -69,7 +77,12 @@ var CertificateManager = class {
       return this.wxpayPublicKey;
     }
     const cert = this.certificates.get(serialNo);
-    if (!cert) return null;
+    if (!cert) {
+      if (this.wxpayPublicKey) {
+        return this.wxpayPublicKey;
+      }
+      return null;
+    }
     const { ciphertext, nonce, associatedData, algorithm } = cert.encryptCertificate;
     if (algorithm === "RAW_PUBLIC_KEY") {
       return Buffer.from(ciphertext, "base64").toString("utf-8");
@@ -90,6 +103,17 @@ var CertificateManager = class {
       return null;
     }
   }
+  /**
+   * 判断当前是否为组合验签模式
+   *
+   * 当同时配置了微信支付公钥和平台证书时，返回 true。
+   * 组合模式用于平台证书→微信支付公钥的灰度迁移期间。
+   *
+   * @returns 是否为组合模式
+   */
+  isCombinedMode() {
+    return this.wxpayPublicKey !== null && this.certificates.size > 0;
+  }
   /**
    * 更新平台证书
    */
@@ -256,7 +280,6 @@ var MalformedMessageException = class extends WxPayError {
 };
 
 // src/utils/http.ts
-var SDK_VERSION = "0.2.1";
 function getUserAgent() {
   const platform = os.platform();
   const arch = os.arch();
@@ -458,14 +481,12 @@ var WxPayClient = class _WxPayClient {
   static PRODUCTION_BACKUP = "https://api2.mch.weixin.qq.com";
   /** 沙箱环境 API 地址 */
   static SANDBOX_BASE = "https://api.mch.weixin.qq.com/sandboxnew";
-  /** SDK 版本号 */
-  static SDK_VERSION = "0.2.1";
   /** 动态 User-Agent 字符串 */
   static USER_AGENT = (() => {
     const platform = os.platform();
     const arch = os.arch();
     const nodeVersion = process.version;
-    return `wxpay-nodejs-sdk/${_WxPayClient.SDK_VERSION} (${platform} ${arch}) Node.js/${nodeVersion}`;
+    return `wxpay-nodejs-sdk/${SDK_VERSION} (${platform} ${arch}) Node.js/${nodeVersion}`;
   })();
   /** 商户号 */
   mchid;
@@ -476,6 +497,7 @@ var WxPayClient = class _WxPayClient {
   baseUrl;
   backupUrl;
   enableResponseVerification;
+  customFetch;
   /** 平台证书管理器 */
   certificates;
   constructor(options) {
@@ -487,6 +509,7 @@ var WxPayClient = class _WxPayClient {
     this.baseUrl = options.sandbox ? _WxPayClient.SANDBOX_BASE : _WxPayClient.PRODUCTION_BASE;
     this.backupUrl = options.sandbox ? null : _WxPayClient.PRODUCTION_BACKUP;
     this.enableResponseVerification = options.enableResponseVerification ?? true;
+    this.customFetch = options.customFetch ?? fetch;
     this.certificates = new CertificateManager(this.apiV3Key, options.platformCertificates);
     if (options.wxpayPublicKeyId && options.wxpayPublicKey) {
       const publicKey = this.resolvePublicKey(options.wxpayPublicKey);
@@ -568,7 +591,7 @@ var WxPayClient = class _WxPayClient {
       controller.abort();
     }, this.timeout);
     try {
-      const response = await fetch(url, {
+      const response = await this.customFetch(url, {
         method,
         headers,
         signal: controller.signal
@@ -695,7 +718,7 @@ var WxPayClient = class _WxPayClient {
       controller.abort();
     }, this.timeout);
     try {
-      const response = await fetch(url, {
+      const response = await this.customFetch(url, {
         method: "POST",
         headers,
         body,
@@ -771,7 +794,7 @@ var WxPayClient = class _WxPayClient {
         controller.abort();
       }, this.timeout);
       try {
-        const response = await fetch(url, {
+        const response = await this.customFetch(url, {
           method,
           headers,
           body: bodyStr || void 0,
@@ -822,7 +845,7 @@ var WxPayClient = class _WxPayClient {
     if (Buffer.isBuffer(key)) return key;
     if (key.startsWith("-----BEGIN")) return key;
     try {
-      return fs.readFileSync(key, "utf-8");
+      return fs2.readFileSync(key, "utf-8");
     } catch {
       return key;
     }
@@ -834,7 +857,7 @@ var WxPayClient = class _WxPayClient {
     if (Buffer.isBuffer(key)) return key.toString("utf-8");
     if (key.startsWith("-----BEGIN")) return key;
     try {
-      return fs.readFileSync(key, "utf-8");
+      return fs2.readFileSync(key, "utf-8");
     } catch {
       return key;
     }
@@ -964,56 +987,422 @@ var CertificateService = class {
     return decrypted.toString("utf-8");
   }
 };
-
-// src/services/jsapi.ts
-var JsapiService = class {
-  client;
-  constructor(client) {
-    this.client = client;
-  }
-  /**
-   * JSAPI/小程序下单
-   *
-   * 商户通过此接口生成预付单并获取 prepay_id。
-   * prepay_id 有效期为 2 小时，超过 2 小时需重新请求。
-   *
-   * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791856
-   */
-  async createOrder(request) {
-    return this.client.post("/v3/pay/transactions/jsapi", request);
-  }
-  /**
-   * 查询 JSAPI 支付订单
-   *
-   * 支持通过微信支付订单号或商户订单号查询订单状态。
-   *
-   * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791858 (微信支付订单号查询订单)
-   * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791859 (商户订单号查询订单)
-   */
-  async queryOrderById(params) {
-    if (params.transactionId) {
-      return this.client.get(
-        `/v3/pay/transactions/id/${params.transactionId}`,
-        { mchid: this.client.mchid }
-      );
+function generateAppPaySign(appId, timeStamp, nonceStr, prepayId, privateKey) {
+  const signString = `${appId}
+${timeStamp}
+${nonceStr}
+prepay_id=${prepayId}
+`;
+  const signer = crypto2.createSign("RSA-SHA256");
+  signer.update(signString);
+  signer.end();
+  return signer.sign(privateKey, "base64");
+}
+function buildAppBridgeConfig(appId, partnerId, prepayId, privateKey) {
+  const timeStamp = String(Math.floor(Date.now() / 1e3));
+  const nonceStr = generateNonceStr();
+  const sign2 = generateAppPaySign(appId, timeStamp, nonceStr, prepayId, privateKey);
+  return {
+    appId,
+    partnerId,
+    prepayId,
+    packageValue: "Sign=WXPay",
+    nonceStr,
+    timeStamp,
+    sign: sign2
+  };
+}
+function generatePaySign(appId, timeStamp, nonceStr, prepayId, privateKey) {
+  const signString = `${appId}
+${timeStamp}
+${nonceStr}
+prepay_id=${prepayId}
+`;
+  const signer = crypto2.createSign("RSA-SHA256");
+  signer.update(signString);
+  signer.end();
+  return signer.sign(privateKey, "base64");
+}
+function generateNonceStr() {
+  return crypto2.randomUUID().replace(/-/g, "");
+}
+function buildJsapiBridgeConfig(appId, prepayId, privateKey) {
+  const timeStamp = String(Math.floor(Date.now() / 1e3));
+  const nonceStr = generateNonceStr();
+  const paySign = generatePaySign(appId, timeStamp, nonceStr, prepayId, privateKey);
+  return {
+    appId,
+    timeStamp,
+    nonceStr,
+    package: `prepay_id=${prepayId}`,
+    signType: "RSA",
+    paySign
+  };
+}
+function buildMiniProgramBridgeConfig(appId, prepayId, privateKey) {
+  const timeStamp = String(Math.floor(Date.now() / 1e3));
+  const nonceStr = generateNonceStr();
+  const paySign = generatePaySign(appId, timeStamp, nonceStr, prepayId, privateKey);
+  return {
+    timeStamp,
+    nonceStr,
+    package: `prepay_id=${prepayId}`,
+    signType: "RSA",
+    paySign
+  };
+}
+function generatePayScorePaySign(appId, timeStamp, nonceStr, serviceId, outOrderNo, privateKey) {
+  const packageStr = `service_id=${serviceId}&out_order_no=${outOrderNo}&need_sign_type=RSA`;
+  const signString = `${appId}
+${timeStamp}
+${nonceStr}
+${packageStr}
+`;
+  const signer = crypto2.createSign("RSA-SHA256");
+  signer.update(signString);
+  signer.end();
+  return signer.sign(privateKey, "base64");
+}
+function buildPayScoreJsapiBridgeConfig(appId, mchId, serviceId, outOrderNo, privateKey) {
+  const timestamp = String(Math.floor(Date.now() / 1e3));
+  const nonceStr = generateNonceStr();
+  const sign2 = generatePayScorePaySign(
+    appId,
+    timestamp,
+    nonceStr,
+    serviceId,
+    outOrderNo,
+    privateKey
+  );
+  return {
+    appid: appId,
+    mchid: mchId,
+    service_id: serviceId,
+    out_order_no: outOrderNo,
+    timestamp,
+    nonce_str: nonceStr,
+    sign_type: "RSA",
+    sign: sign2
+  };
+}
+function buildPayScoreMiniProgramBridgeConfig(mchId, serviceId, outOrderNo, appId, privateKey) {
+  const timestamp = String(Math.floor(Date.now() / 1e3));
+  const nonceStr = generateNonceStr();
+  const sign2 = generatePayScorePaySign(
+    appId,
+    timestamp,
+    nonceStr,
+    serviceId,
+    outOrderNo,
+    privateKey
+  );
+  return {
+    mchid: mchId,
+    service_id: serviceId,
+    out_order_no: outOrderNo,
+    timestamp,
+    nonce_str: nonceStr,
+    sign_type: "RSA",
+    sign: sign2
+  };
+}
+function buildPayScoreAppBridgeConfig(appId, mchId, serviceId, outOrderNo, privateKey) {
+  const timestamp = String(Math.floor(Date.now() / 1e3));
+  const nonceStr = generateNonceStr();
+  const sign2 = generatePayScorePaySign(
+    appId,
+    timestamp,
+    nonceStr,
+    serviceId,
+    outOrderNo,
+    privateKey
+  );
+  return {
+    appid: appId,
+    mchid: mchId,
+    service_id: serviceId,
+    out_order_no: outOrderNo,
+    timestamp,
+    nonce_str: nonceStr,
+    sign_type: "RSA",
+    sign: sign2
+  };
+}
+function buildMerchantTransferJsapiBridgeConfig(mchId, appId, packageInfo) {
+  return {
+    mchId,
+    appId,
+    package: packageInfo
+  };
+}
+function buildMerchantTransferMiniProgramBridgeConfig(mchId, appId, packageInfo) {
+  return {
+    mchId,
+    appId,
+    package: packageInfo
+  };
+}
+function buildMerchantTransferAuthorizationJsapiBridgeConfig(mchId, appId, packageInfo) {
+  return {
+    mchId,
+    appId,
+    package: packageInfo
+  };
+}
+var PARKING_SERVICE_APPID = "wxbcad394b3d99dac9";
+var PARKING_SERVICE_PATH = "/pages/auth-creditpay/auth-creditpay";
+var PARKING_REPAY_APPID = "wx5e73c65404eee268";
+var PARKING_REPAY_PATH = "pages/invest_list/invest_list";
+function buildParkingQueryString(mchid, openid, plateNumber, plateColor) {
+  const params = new URLSearchParams({
+    mchid,
+    openid,
+    plate_number: plateNumber,
+    plate_color: plateColor,
+    trade_scene: "PARKING"
+  });
+  return params.toString();
+}
+function buildParkingMiniProgramBridgeConfig(mchid, openid, plateNumber, plateColor) {
+  return {
+    appId: PARKING_SERVICE_APPID,
+    path: PARKING_SERVICE_PATH,
+    extraData: {
+      mchid,
+      openid,
+      plate_number: plateNumber,
+      plate_color: plateColor,
+      trade_scene: "PARKING"
     }
-    if (params.outTradeNo) {
-      return this.client.get(
-        `/v3/pay/transactions/out-trade-no/${params.outTradeNo}`,
-        { mchid: this.client.mchid }
-      );
+  };
+}
+function buildParkingH5BridgeUrl(mchid, openid, plateNumber, plateColor) {
+  const queryString = buildParkingQueryString(mchid, openid, plateNumber, plateColor);
+  return `${PARKING_SERVICE_PATH}?${queryString}`;
+}
+function buildParkingAppBridgePath(mchid, openid, plateNumber, plateColor) {
+  const queryString = buildParkingQueryString(mchid, openid, plateNumber, plateColor);
+  return `${PARKING_SERVICE_PATH}?${queryString}`;
+}
+function buildParkingRepayBridgeConfig(mchid, openid) {
+  return {
+    appId: PARKING_REPAY_APPID,
+    path: PARKING_REPAY_PATH,
+    extraData: {
+      mchid,
+      nonce_str: generateNonceStr(),
+      openid
     }
-    throw new Error("outTradeNo \u6216 transactionId \u5FC5\u987B\u63D0\u4F9B\u5176\u4E2D\u4E00\u4E2A");
-  }
-  /**
-   * 关闭订单
-   *
-   * 对于未支付的订单，商户可通过此接口关闭订单。
-   * 关单后，订单状态从未支付（NOTPAY）流转为已关闭（CLOSED）。
-   *
-   * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791860
-   */
-  async closeOrder(outTradeNo, request) {
+  };
+}
+var H5_COUPON_URL = "https://action.weixin.qq.com/busifavor/getcouponinfo";
+function buildH5CouponUrl(params, signKey) {
+  const signFields = {
+    stock_id: params.stock_id,
+    out_request_no: params.out_request_no,
+    send_coupon_merchant: params.send_coupon_merchant,
+    open_id: params.open_id
+  };
+  if (params.coupon_code) {
+    signFields["coupon_code"] = params.coupon_code;
+  }
+  const sortedKeys = Object.keys(signFields).sort();
+  const signStr = sortedKeys.map((k) => `${k}=${signFields[k]}`).join("&") + `&key=${signKey}`;
+  const sign2 = crypto2.createHmac("sha256", signKey).update(signStr).digest("hex").toUpperCase();
+  const urlParams = new URLSearchParams({
+    stock_id: params.stock_id,
+    out_request_no: params.out_request_no,
+    sign: sign2,
+    send_coupon_merchant: params.send_coupon_merchant,
+    open_id: params.open_id
+  });
+  if (params.coupon_code) {
+    urlParams.set("coupon_code", params.coupon_code);
+  }
+  if (params.customize_send_time) {
+    urlParams.set("customize_send_time", params.customize_send_time);
+  }
+  return `${H5_COUPON_URL}?${urlParams.toString()}#wechat_pay&wechat_redirect`;
+}
+function buildPayScoreDetailJsapiBridgeConfig(appId, mchId, serviceId, outOrderNo, privateKey) {
+  const timestamp = String(Math.floor(Date.now() / 1e3));
+  const nonceStr = generateNonceStr();
+  const sign2 = generatePayScorePaySign(
+    appId,
+    timestamp,
+    nonceStr,
+    serviceId,
+    outOrderNo,
+    privateKey
+  );
+  return {
+    appid: appId,
+    mchid: mchId,
+    service_id: serviceId,
+    out_order_no: outOrderNo,
+    timestamp,
+    nonce_str: nonceStr,
+    sign_type: "RSA",
+    sign: sign2
+  };
+}
+function buildPayScoreDetailMiniProgramBridgeConfig(mchId, serviceId, outOrderNo, appId, privateKey) {
+  const timestamp = String(Math.floor(Date.now() / 1e3));
+  const nonceStr = generateNonceStr();
+  const sign2 = generatePayScorePaySign(
+    appId,
+    timestamp,
+    nonceStr,
+    serviceId,
+    outOrderNo,
+    privateKey
+  );
+  return {
+    mchid: mchId,
+    service_id: serviceId,
+    out_order_no: outOrderNo,
+    timestamp,
+    nonce_str: nonceStr,
+    sign_type: "RSA",
+    sign: sign2
+  };
+}
+function buildPayScoreDetailAppBridgeConfig(appId, mchId, serviceId, outOrderNo, privateKey) {
+  const timestamp = String(Math.floor(Date.now() / 1e3));
+  const nonceStr = generateNonceStr();
+  const sign2 = generatePayScorePaySign(
+    appId,
+    timestamp,
+    nonceStr,
+    serviceId,
+    outOrderNo,
+    privateKey
+  );
+  return {
+    appid: appId,
+    mchid: mchId,
+    service_id: serviceId,
+    out_order_no: outOrderNo,
+    timestamp,
+    nonce_str: nonceStr,
+    sign_type: "RSA",
+    sign: sign2
+  };
+}
+var MED_INS_APPID = "wxbcad394b3d99dac9";
+var MED_INS_PATH = "/pages/med-ins/pay/pay";
+function buildMedInsMiniProgramBridgeConfig(mchid, mixTradeNo) {
+  return {
+    appId: MED_INS_APPID,
+    path: MED_INS_PATH,
+    extraData: {
+      mchid,
+      mix_trade_no: mixTradeNo
+    }
+  };
+}
+function buildMedInsJsapiBridgeConfig(appId, mchId, mixTradeNo, privateKey) {
+  const timestamp = String(Math.floor(Date.now() / 1e3));
+  const nonceStr = generateNonceStr();
+  const packageStr = `mchid=${mchId}&mix_trade_no=${mixTradeNo}`;
+  const signString = `${appId}
+${timestamp}
+${nonceStr}
+${packageStr}
+`;
+  const signer = crypto2.createSign("RSA-SHA256");
+  signer.update(signString);
+  signer.end();
+  const sign2 = signer.sign(privateKey, "base64");
+  return {
+    appid: appId,
+    mchid: mchId,
+    mix_trade_no: mixTradeNo,
+    timestamp,
+    nonce_str: nonceStr,
+    sign_type: "RSA",
+    sign: sign2
+  };
+}
+
+// src/services/jsapi.ts
+var JsapiService = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * JSAPI/小程序下单
+   *
+   * 商户通过此接口生成预付单并获取 prepay_id。
+   * prepay_id 有效期为 2 小时，超过 2 小时需重新请求。
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791856
+   */
+  async createOrder(request) {
+    return this.client.post("/v3/pay/transactions/jsapi", request);
+  }
+  /**
+   * 查询 JSAPI 支付订单
+   *
+   * 支持通过微信支付订单号或商户订单号查询订单状态。
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791858 (微信支付订单号查询订单)
+   * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791859 (商户订单号查询订单)
+   */
+  async queryOrderById(params) {
+    if (params.transactionId) {
+      return this.queryOrderByTransactionId(params.transactionId);
+    }
+    if (params.outTradeNo) {
+      return this.queryOrderByOutTradeNo(params.outTradeNo);
+    }
+    throw new Error("outTradeNo \u6216 transactionId \u5FC5\u987B\u63D0\u4F9B\u5176\u4E2D\u4E00\u4E2A");
+  }
+  /**
+   * 通过商户订单号查询订单
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791859
+   */
+  async queryOrderByOutTradeNo(outTradeNo) {
+    return this.client.get(`/v3/pay/transactions/out-trade-no/${outTradeNo}`, {
+      mchid: this.client.mchid
+    });
+  }
+  /**
+   * 通过微信支付订单号查询订单
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791858
+   */
+  async queryOrderByTransactionId(transactionId) {
+    return this.client.get(`/v3/pay/transactions/id/${transactionId}`, {
+      mchid: this.client.mchid
+    });
+  }
+  /**
+   * JSAPI 下单并生成调起支付参数
+   *
+   * 封装了下单和调起支付参数生成两个步骤，一次调用即可获得
+   * prepay_id 和前端 WeixinJSBridge.invoke() 所需的全部参数。
+   *
+   * @param request - 下单请求参数（需包含 appid）
+   * @param privateKey - 商户私钥
+   * @returns 下单响应 + 调起支付参数
+   */
+  async prepayWithRequestPayment(request, privateKey) {
+    const response = await this.createOrder(request);
+    const bridgeConfig = buildJsapiBridgeConfig(request.appid, response.data.prepay_id, privateKey);
+    return { ...response, bridgeConfig };
+  }
+  /**
+   * 关闭订单
+   *
+   * 对于未支付的订单，商户可通过此接口关闭订单。
+   * 关单后，订单状态从未支付（NOTPAY）流转为已关闭（CLOSED）。
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/merchant/4012791860
+   */
+  async closeOrder(outTradeNo, request) {
     return this.client.post(`/v3/pay/transactions/out-trade-no/${outTradeNo}/close`, request);
   }
   /**
@@ -1117,19 +1506,23 @@ var H5Service = class {
    */
   async queryOrderById(params) {
     if (params.transactionId) {
-      return this.client.get(
-        `/v3/pay/transactions/id/${params.transactionId}`,
-        { mchid: this.client.mchid }
-      );
+      return this.queryOrderByTransactionId(params.transactionId);
     }
     if (params.outTradeNo) {
-      return this.client.get(
-        `/v3/pay/transactions/out-trade-no/${params.outTradeNo}`,
-        { mchid: this.client.mchid }
-      );
+      return this.queryOrderByOutTradeNo(params.outTradeNo);
     }
     throw new Error("outTradeNo \u6216 transactionId \u5FC5\u987B\u63D0\u4F9B\u5176\u4E2D\u4E00\u4E2A");
   }
+  async queryOrderByOutTradeNo(outTradeNo) {
+    return this.client.get(`/v3/pay/transactions/out-trade-no/${outTradeNo}`, {
+      mchid: this.client.mchid
+    });
+  }
+  async queryOrderByTransactionId(transactionId) {
+    return this.client.get(`/v3/pay/transactions/id/${transactionId}`, {
+      mchid: this.client.mchid
+    });
+  }
   /**
    * 关闭订单
    *
@@ -1242,19 +1635,33 @@ var AppService = class {
    */
   async queryOrderById(params) {
     if (params.transactionId) {
-      return this.client.get(
-        `/v3/pay/transactions/id/${params.transactionId}`,
-        { mchid: this.client.mchid }
-      );
+      return this.queryOrderByTransactionId(params.transactionId);
     }
     if (params.outTradeNo) {
-      return this.client.get(
-        `/v3/pay/transactions/out-trade-no/${params.outTradeNo}`,
-        { mchid: this.client.mchid }
-      );
+      return this.queryOrderByOutTradeNo(params.outTradeNo);
     }
     throw new Error("outTradeNo \u6216 transactionId \u5FC5\u987B\u63D0\u4F9B\u5176\u4E2D\u4E00\u4E2A");
   }
+  async queryOrderByOutTradeNo(outTradeNo) {
+    return this.client.get(`/v3/pay/transactions/out-trade-no/${outTradeNo}`, {
+      mchid: this.client.mchid
+    });
+  }
+  async queryOrderByTransactionId(transactionId) {
+    return this.client.get(`/v3/pay/transactions/id/${transactionId}`, {
+      mchid: this.client.mchid
+    });
+  }
+  async prepayWithRequestPayment(request, privateKey) {
+    const response = await this.createOrder(request);
+    const bridgeConfig = buildAppBridgeConfig(
+      request.appid,
+      this.client.mchid,
+      response.data.prepay_id,
+      privateKey
+    );
+    return { ...response, bridgeConfig };
+  }
   /**
    * 关闭订单
    *
@@ -1370,19 +1777,23 @@ var NativeService = class {
    */
   async queryOrderById(params) {
     if (params.transactionId) {
-      return this.client.get(
-        `/v3/pay/transactions/id/${params.transactionId}`,
-        { mchid: this.client.mchid }
-      );
+      return this.queryOrderByTransactionId(params.transactionId);
     }
     if (params.outTradeNo) {
-      return this.client.get(
-        `/v3/pay/transactions/out-trade-no/${params.outTradeNo}`,
-        { mchid: this.client.mchid }
-      );
+      return this.queryOrderByOutTradeNo(params.outTradeNo);
     }
     throw new Error("outTradeNo \u6216 transactionId \u5FC5\u987B\u63D0\u4F9B\u5176\u4E2D\u4E00\u4E2A");
   }
+  async queryOrderByOutTradeNo(outTradeNo) {
+    return this.client.get(`/v3/pay/transactions/out-trade-no/${outTradeNo}`, {
+      mchid: this.client.mchid
+    });
+  }
+  async queryOrderByTransactionId(transactionId) {
+    return this.client.get(`/v3/pay/transactions/id/${transactionId}`, {
+      mchid: this.client.mchid
+    });
+  }
   /**
    * 关闭订单
    *
@@ -2634,8 +3045,6 @@ var ParkingService = class {
     );
   }
 };
-
-// src/services/bill.ts
 var BillService = class {
   constructor(client) {
     this.client = client;
@@ -2717,6 +3126,45 @@ var BillService = class {
       tar_type: params.tar_type
     });
   }
+  /**
+   * 申请单个子商户资金账单
+   *
+   * 服务商调用该接口获取单个子商户资金账单的下载链接。
+   * 返回的账单文件使用 AES-256-GCM 加密，需用子商户的 API 证书私钥解密。
+   *
+   * @param params - 账单请求参数
+   * @returns 加密账单下载信息
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071235
+   */
+  async applySubMerchantFundFlowBill(params) {
+    return this.client.get("/v3/bill/sub-merchant-fundflowbill", {
+      sub_mchid: params.sub_mchid,
+      bill_date: params.bill_date,
+      account_type: params.account_type,
+      algorithm: params.algorithm,
+      tar_type: params.tar_type
+    });
+  }
+  /**
+   * 申请二级商户资金账单
+   *
+   * 电商平台调用该接口获取二级商户资金账单的下载链接。
+   * 返回的账单文件使用 AES-256-GCM 加密，需用平台的 API 证书私钥解密。
+   *
+   * @param params - 账单请求参数
+   * @returns 加密账单下载信息
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071235
+   */
+  async applyEcommerceFundFlowBill(params) {
+    return this.client.get("/v3/ecommerce/bill/fundflowbill", {
+      bill_date: params.bill_date,
+      account_type: params.account_type,
+      tar_type: params.tar_type,
+      algorithm: params.algorithm
+    });
+  }
   /**
    * 下载账单文件
    *
@@ -2754,6 +3202,41 @@ var BillService = class {
   async downloadBill(downloadUrl) {
     return this.client.downloadRaw(downloadUrl);
   }
+  /**
+   * 下载账单文件并自动解压、校验摘要
+   *
+   * 封装了完整的账单下载流程：
+   * 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,
+   * );
+   * ```
+   */
+  async downloadAndVerifyBill(downloadUrl, expectedDigest) {
+    const response = await this.client.downloadRaw(downloadUrl);
+    let data = response.data;
+    if (data.length >= 2 && data[0] === 31 && data[1] === 139) {
+      data = zlib.gunzipSync(data);
+    }
+    if (expectedDigest) {
+      const actualDigest = crypto2.createHash("sha1").update(data).digest("hex");
+      if (actualDigest.toLowerCase() !== expectedDigest.toLowerCase()) {
+        throw new Error(`\u8D26\u5355\u6458\u8981\u6821\u9A8C\u5931\u8D25: \u671F\u671B ${expectedDigest}, \u5B9E\u9645 ${actualDigest}`);
+      }
+    }
+    return { ...response, data };
+  }
 };
 var SUPPORTED_SIGNATURE_TYPES = /* @__PURE__ */ new Set(["WECHATPAY2-SHA256-RSA2048"]);
 var DEFAULT_SIGNATURE_TYPE = "WECHATPAY2-SHA256-RSA2048";
@@ -4537,344 +5020,922 @@ var MerchantExclusiveCouponService = class {
     return this.client.get(`/v3/marketing/busifavor/users/coupons/${couponId}`, params);
   }
 };
-function generateAppPaySign(appId, timeStamp, nonceStr, prepayId, privateKey) {
-  const signString = `${appId}
-${timeStamp}
-${nonceStr}
-prepay_id=${prepayId}
-`;
-  const signer = crypto2.createSign("RSA-SHA256");
-  signer.update(signString);
-  signer.end();
-  return signer.sign(privateKey, "base64");
-}
-function buildAppBridgeConfig(appId, partnerId, prepayId, privateKey) {
-  const timeStamp = String(Math.floor(Date.now() / 1e3));
-  const nonceStr = generateNonceStr();
-  const sign2 = generateAppPaySign(appId, timeStamp, nonceStr, prepayId, privateKey);
-  return {
-    appId,
-    partnerId,
-    prepayId,
-    packageValue: "Sign=WXPay",
-    nonceStr,
-    timeStamp,
-    sign: sign2
-  };
-}
-function generatePaySign(appId, timeStamp, nonceStr, prepayId, privateKey) {
-  const signString = `${appId}
-${timeStamp}
-${nonceStr}
-prepay_id=${prepayId}
-`;
-  const signer = crypto2.createSign("RSA-SHA256");
-  signer.update(signString);
-  signer.end();
-  return signer.sign(privateKey, "base64");
-}
-function generateNonceStr() {
-  return crypto2.randomUUID().replace(/-/g, "");
-}
-function buildJsapiBridgeConfig(appId, prepayId, privateKey) {
-  const timeStamp = String(Math.floor(Date.now() / 1e3));
-  const nonceStr = generateNonceStr();
-  const paySign = generatePaySign(appId, timeStamp, nonceStr, prepayId, privateKey);
-  return {
-    appId,
-    timeStamp,
-    nonceStr,
-    package: `prepay_id=${prepayId}`,
-    signType: "RSA",
-    paySign
-  };
-}
-function buildMiniProgramBridgeConfig(appId, prepayId, privateKey) {
-  const timeStamp = String(Math.floor(Date.now() / 1e3));
-  const nonceStr = generateNonceStr();
-  const paySign = generatePaySign(appId, timeStamp, nonceStr, prepayId, privateKey);
-  return {
-    timeStamp,
-    nonceStr,
-    package: `prepay_id=${prepayId}`,
-    signType: "RSA",
-    paySign
-  };
-}
-function generatePayScorePaySign(appId, timeStamp, nonceStr, serviceId, outOrderNo, privateKey) {
-  const packageStr = `service_id=${serviceId}&out_order_no=${outOrderNo}&need_sign_type=RSA`;
-  const signString = `${appId}
-${timeStamp}
-${nonceStr}
-${packageStr}
-`;
-  const signer = crypto2.createSign("RSA-SHA256");
-  signer.update(signString);
-  signer.end();
-  return signer.sign(privateKey, "base64");
-}
-function buildPayScoreJsapiBridgeConfig(appId, mchId, serviceId, outOrderNo, privateKey) {
-  const timestamp = String(Math.floor(Date.now() / 1e3));
-  const nonceStr = generateNonceStr();
-  const sign2 = generatePayScorePaySign(
-    appId,
-    timestamp,
-    nonceStr,
-    serviceId,
-    outOrderNo,
-    privateKey
-  );
-  return {
-    appid: appId,
-    mchid: mchId,
-    service_id: serviceId,
-    out_order_no: outOrderNo,
-    timestamp,
-    nonce_str: nonceStr,
-    sign_type: "RSA",
-    sign: sign2
-  };
-}
-function buildPayScoreMiniProgramBridgeConfig(mchId, serviceId, outOrderNo, appId, privateKey) {
-  const timestamp = String(Math.floor(Date.now() / 1e3));
-  const nonceStr = generateNonceStr();
-  const sign2 = generatePayScorePaySign(
-    appId,
-    timestamp,
-    nonceStr,
-    serviceId,
-    outOrderNo,
-    privateKey
-  );
-  return {
-    mchid: mchId,
-    service_id: serviceId,
-    out_order_no: outOrderNo,
-    timestamp,
-    nonce_str: nonceStr,
-    sign_type: "RSA",
-    sign: sign2
-  };
-}
-function buildPayScoreAppBridgeConfig(appId, mchId, serviceId, outOrderNo, privateKey) {
-  const timestamp = String(Math.floor(Date.now() / 1e3));
-  const nonceStr = generateNonceStr();
-  const sign2 = generatePayScorePaySign(
-    appId,
-    timestamp,
-    nonceStr,
-    serviceId,
-    outOrderNo,
-    privateKey
-  );
-  return {
-    appid: appId,
-    mchid: mchId,
-    service_id: serviceId,
-    out_order_no: outOrderNo,
-    timestamp,
-    nonce_str: nonceStr,
-    sign_type: "RSA",
-    sign: sign2
-  };
-}
-function buildMerchantTransferJsapiBridgeConfig(mchId, appId, packageInfo) {
-  return {
-    mchId,
-    appId,
-    package: packageInfo
-  };
-}
-function buildMerchantTransferMiniProgramBridgeConfig(mchId, appId, packageInfo) {
-  return {
-    mchId,
-    appId,
-    package: packageInfo
-  };
-}
-function buildMerchantTransferAuthorizationJsapiBridgeConfig(mchId, appId, packageInfo) {
-  return {
-    mchId,
-    appId,
-    package: packageInfo
-  };
-}
-var PARKING_SERVICE_APPID = "wxbcad394b3d99dac9";
-var PARKING_SERVICE_PATH = "/pages/auth-creditpay/auth-creditpay";
-var PARKING_REPAY_APPID = "wx5e73c65404eee268";
-var PARKING_REPAY_PATH = "pages/invest_list/invest_list";
-function buildParkingQueryString(mchid, openid, plateNumber, plateColor) {
-  const params = new URLSearchParams({
-    mchid,
-    openid,
-    plate_number: plateNumber,
-    plate_color: plateColor,
-    trade_scene: "PARKING"
-  });
-  return params.toString();
-}
-function buildParkingMiniProgramBridgeConfig(mchid, openid, plateNumber, plateColor) {
-  return {
-    appId: PARKING_SERVICE_APPID,
-    path: PARKING_SERVICE_PATH,
-    extraData: {
-      mchid,
-      openid,
-      plate_number: plateNumber,
-      plate_color: plateColor,
-      trade_scene: "PARKING"
-    }
-  };
-}
-function buildParkingH5BridgeUrl(mchid, openid, plateNumber, plateColor) {
-  const queryString = buildParkingQueryString(mchid, openid, plateNumber, plateColor);
-  return `${PARKING_SERVICE_PATH}?${queryString}`;
-}
-function buildParkingAppBridgePath(mchid, openid, plateNumber, plateColor) {
-  const queryString = buildParkingQueryString(mchid, openid, plateNumber, plateColor);
-  return `${PARKING_SERVICE_PATH}?${queryString}`;
-}
-function buildParkingRepayBridgeConfig(mchid, openid) {
-  return {
-    appId: PARKING_REPAY_APPID,
-    path: PARKING_REPAY_PATH,
-    extraData: {
-      mchid,
-      nonce_str: generateNonceStr(),
-      openid
-    }
-  };
-}
-var H5_COUPON_URL = "https://action.weixin.qq.com/busifavor/getcouponinfo";
-function buildH5CouponUrl(params, signKey) {
-  const signFields = {
-    stock_id: params.stock_id,
-    out_request_no: params.out_request_no,
-    send_coupon_merchant: params.send_coupon_merchant,
-    open_id: params.open_id
-  };
-  if (params.coupon_code) {
-    signFields["coupon_code"] = params.coupon_code;
+
+// src/services/refund.ts
+var RefundService = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 申请退款
+   *
+   * 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，
+   * 卖家可以通过退款接口将支付款退还给买家。
+   * 支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。
+   * 一笔退款失败后重新提交，要采用原来的退款单号。
+   *
+   * @param request - 退款请求参数，包含商户订单号、退款单号、退款金额等信息
+   * @returns 退款申请结果，包含微信退款单号、退款状态等
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071036
+   */
+  async create(request) {
+    return this.client.post("/v3/refund/domestic/refunds", request);
+  }
+  /**
+   * 查询单笔退款（通过商户退款单号）
+   *
+   * 提交退款申请后，通过调用该接口查询退款状态。
+   * 退款有一定延时，建议在提交退款申请后1分钟再查询退款状态。
+   *
+   * @param params - 查询参数，需包含 outRefundNo（商户退款单号）
+   * @returns 退款单详情，包含退款状态、退款金额、退款渠道等
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071041
+   */
+  async queryByOutRefundNo(params) {
+    return this.client.get(
+      `/v3/refund/domestic/refunds/${params.outRefundNo}`
+    );
+  }
+  /**
+   * 发起异常退款
+   *
+   * 当退款因为用户账户异常而无法原路退回时，可使用此接口将退款资金
+   * 退到用户的其他银行卡或商户的银行账户。
+   *
+   * @param refundId - 微信支付退款单号
+   * @param request - 异常退款请求参数，包含退款方式、收款账户信息等
+   * @returns 异常退款处理结果
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/merchant/4013071193
+   */
+  async applyAbnormalRefund(refundId, request) {
+    return this.client.post(
+      `/v3/refund/domestic/refunds/${refundId}/apply-abnormal-refund`,
+      request
+    );
+  }
+};
+
+// src/services/partner-jsapi.ts
+var PartnerJsapiService = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 服务商 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
+   */
+  async createOrder(request) {
+    return this.client.post(
+      "/v3/pay/partner/transactions/jsapi",
+      request
+    );
+  }
+  /**
+   * 通过商户订单号查询订单
+   *
+   * @param params - 查询参数，需包含 out_trade_no、sp_mchid、sub_mchid
+   * @returns 订单详情
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4012739008
+   */
+  async queryOrderByOutTradeNo(params) {
+    return this.client.get(
+      `/v3/pay/partner/transactions/out-trade-no/${params.out_trade_no}`,
+      { sp_mchid: params.sp_mchid, sub_mchid: params.sub_mchid }
+    );
+  }
+  /**
+   * 通过微信支付订单号查询订单
+   *
+   * @param params - 查询参数，需包含 transaction_id、sp_mchid、sub_mchid
+   * @returns 订单详情
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4012738964
+   */
+  async queryOrderByTransactionId(params) {
+    return this.client.get(
+      `/v3/pay/partner/transactions/id/${params.transaction_id}`,
+      { sp_mchid: params.sp_mchid, sub_mchid: params.sub_mchid }
+    );
+  }
+  /**
+   * 关闭订单
+   *
+   * 对于未支付的订单，服务商可通过此接口代特约商户关闭订单。
+   *
+   * @param outTradeNo - 商户订单号
+   * @param request - 关单请求参数，需包含 sp_mchid、sub_mchid
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4012739019
+   */
+  async closeOrder(outTradeNo, request) {
+    return this.client.post(
+      `/v3/pay/partner/transactions/out-trade-no/${outTradeNo}/close`,
+      request
+    );
+  }
+  /**
+   * 服务商 JSAPI 下单并生成调起支付参数
+   *
+   * 封装了下单和调起支付参数生成两个步骤，一次调用即可获得
+   * prepay_id 和前端 WeixinJSBridge.invoke() 所需的全部参数。
+   *
+   * @param request - 下单请求参数
+   * @param privateKey - 商户私钥，用于生成调起支付签名
+   * @returns 下单响应 + 调起支付参数
+   */
+  async prepayWithRequestPayment(request, privateKey) {
+    const response = await this.createOrder(request);
+    const bridgeConfig = buildJsapiBridgeConfig(
+      request.sp_appid,
+      response.data.prepay_id,
+      privateKey
+    );
+    return { ...response, bridgeConfig };
+  }
+};
+
+// src/services/partner-app.ts
+var PartnerAppService = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 服务商 APP 下单
+   *
+   * @param request - 下单请求参数
+   * @returns 下单结果，包含 prepay_id
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4013080231
+   */
+  async createOrder(request) {
+    return this.client.post(
+      "/v3/pay/partner/transactions/app",
+      request
+    );
+  }
+  /**
+   * 通过商户订单号查询订单
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4013080235
+   */
+  async queryOrderByOutTradeNo(params) {
+    return this.client.get(
+      `/v3/pay/partner/transactions/out-trade-no/${params.out_trade_no}`,
+      { sp_mchid: params.sp_mchid, sub_mchid: params.sub_mchid }
+    );
+  }
+  /**
+   * 通过微信支付订单号查询订单
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4013080234
+   */
+  async queryOrderByTransactionId(params) {
+    return this.client.get(
+      `/v3/pay/partner/transactions/id/${params.transaction_id}`,
+      { sp_mchid: params.sp_mchid, sub_mchid: params.sub_mchid }
+    );
+  }
+  /**
+   * 关闭订单
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4013080236
+   */
+  async closeOrder(outTradeNo, request) {
+    return this.client.post(
+      `/v3/pay/partner/transactions/out-trade-no/${outTradeNo}/close`,
+      request
+    );
+  }
+  /**
+   * 服务商 APP 下单并生成调起支付参数
+   *
+   * @param request - 下单请求参数
+   * @param privateKey - 商户私钥
+   * @returns 下单响应 + 调起支付参数
+   */
+  async prepayWithRequestPayment(request, privateKey) {
+    const response = await this.createOrder(request);
+    const bridgeConfig = buildAppBridgeConfig(
+      request.sp_appid,
+      this.client.mchid,
+      response.data.prepay_id,
+      privateKey
+    );
+    return { ...response, bridgeConfig };
+  }
+};
+
+// src/services/partner-h5.ts
+var PartnerH5Service = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 服务商 H5 下单
+   *
+   * @param request - 下单请求参数，需包含 scene_info.h5_info
+   * @returns 下单结果，包含 h5_url
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4012738604
+   */
+  async createOrder(request) {
+    return this.client.post(
+      "/v3/pay/partner/transactions/h5",
+      request
+    );
+  }
+  /**
+   * 通过商户订单号查询订单
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4012759661
+   */
+  async queryOrderByOutTradeNo(params) {
+    return this.client.get(
+      `/v3/pay/partner/transactions/out-trade-no/${params.out_trade_no}`,
+      { sp_mchid: params.sp_mchid, sub_mchid: params.sub_mchid }
+    );
+  }
+  /**
+   * 通过微信支付订单号查询订单
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4012738969
+   */
+  async queryOrderByTransactionId(params) {
+    return this.client.get(
+      `/v3/pay/partner/transactions/id/${params.transaction_id}`,
+      { sp_mchid: params.sp_mchid, sub_mchid: params.sub_mchid }
+    );
+  }
+  /**
+   * 关闭订单
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4012759669
+   */
+  async closeOrder(outTradeNo, request) {
+    return this.client.post(
+      `/v3/pay/partner/transactions/out-trade-no/${outTradeNo}/close`,
+      request
+    );
+  }
+};
+
+// src/services/partner-native.ts
+var PartnerNativeService = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 服务商 Native 下单
+   *
+   * @param request - 下单请求参数
+   * @returns 下单结果，包含 code_url
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4012738659
+   */
+  async createOrder(request) {
+    return this.client.post(
+      "/v3/pay/partner/transactions/native",
+      request
+    );
+  }
+  /**
+   * 通过商户订单号查询订单
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4012759714
+   */
+  async queryOrderByOutTradeNo(params) {
+    return this.client.get(
+      `/v3/pay/partner/transactions/out-trade-no/${params.out_trade_no}`,
+      { sp_mchid: params.sp_mchid, sub_mchid: params.sub_mchid }
+    );
+  }
+  /**
+   * 通过微信支付订单号查询订单
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4012738971
+   */
+  async queryOrderByTransactionId(params) {
+    return this.client.get(
+      `/v3/pay/partner/transactions/id/${params.transaction_id}`,
+      { sp_mchid: params.sp_mchid, sub_mchid: params.sub_mchid }
+    );
+  }
+  /**
+   * 关闭订单
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4012759725
+   */
+  async closeOrder(outTradeNo, request) {
+    return this.client.post(
+      `/v3/pay/partner/transactions/out-trade-no/${outTradeNo}/close`,
+      request
+    );
+  }
+};
+
+// src/services/partner-transfer.ts
+var PartnerTransferService = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 服务商发起商家转账
+   *
+   * @param request - 转账请求参数
+   * @returns 转账结果
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4012716434
+   */
+  async createTransfer(request) {
+    return this.client.post(
+      "/v3/fund-app/mch-transfer/partner/transfer-bills",
+      request
+    );
+  }
+  /**
+   * 通过商户单号查询转账单
+   *
+   * @param outBillNo - 商户转账单号
+   * @param subMchid - 特约商户号
+   * @returns 转账单详情
+   */
+  async queryTransferByOutBillNo(outBillNo, subMchid) {
+    return this.client.get(
+      `/v3/fund-app/mch-transfer/partner/transfer-bills/out-bill-no/${outBillNo}`,
+      { sub_mchid: subMchid }
+    );
+  }
+  /**
+   * 撤销转账
+   *
+   * @param outBillNo - 商户转账单号
+   * @param subMchid - 特约商户号
+   */
+  async cancelTransfer(outBillNo, subMchid) {
+    return this.client.post(
+      `/v3/fund-app/mch-transfer/partner/transfer-bills/out-bill-no/${outBillNo}/cancel`,
+      { sub_mchid: subMchid }
+    );
+  }
+};
+
+// src/services/transfer-batch.ts
+var TransferBatchService = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 发起批量转账
+   *
+   * @param request - 批量转账请求参数
+   * @returns 批量转账结果
+   */
+  async initiateBatchTransfer(request) {
+    return this.client.post("/v3/transfer/batches", request);
+  }
+  /**
+   * 通过微信批次单号查询批次单
+   *
+   * @param batchId - 微信批次单号
+   * @param params - 可选查询参数
+   * @returns 批次单详情
+   */
+  async getTransferBatchByNo(batchId, params) {
+    return this.client.get(
+      `/v3/transfer/batches/batch-id/${batchId}`,
+      params
+    );
+  }
+  /**
+   * 通过商家批次单号查询批次单
+   *
+   * @param outBatchNo - 商家批次单号
+   * @param params - 可选查询参数
+   * @returns 批次单详情
+   */
+  async getTransferBatchByOutNo(outBatchNo, params) {
+    return this.client.get(
+      `/v3/transfer/batches/out-batch-no/${outBatchNo}`,
+      params
+    );
+  }
+  /**
+   * 通过微信明细单号查询明细单
+   *
+   * @param batchId - 微信批次单号
+   * @param detailId - 微信明细单号
+   * @returns 明细单详情
+   */
+  async getTransferDetailByNo(batchId, detailId) {
+    return this.client.get(
+      `/v3/transfer/batches/batch-id/${batchId}/details/detail-id/${detailId}`
+    );
+  }
+  /**
+   * 通过商家明细单号查询明细单
+   *
+   * @param outBatchNo - 商家批次单号
+   * @param outDetailNo - 商家明细单号
+   * @returns 明细单详情
+   */
+  async getTransferDetailByOutNo(outBatchNo, outDetailNo) {
+    return this.client.get(
+      `/v3/transfer/batches/out-batch-no/${outBatchNo}/details/out-detail-no/${outDetailNo}`
+    );
+  }
+};
+
+// src/services/partner-transfer-batch.ts
+var PartnerTransferBatchService = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 发起服务商批量转账
+   *
+   * @param request - 批量转账请求参数
+   * @returns 批量转账结果
+   */
+  async initiateBatchTransfer(request) {
+    return this.client.post(
+      "/v3/partner-transfer/batches",
+      request
+    );
+  }
+  /**
+   * 通过微信批次单号查询批次单
+   *
+   * @param batchId - 微信批次单号
+   * @param params - 可选查询参数
+   * @returns 批次单详情
+   */
+  async getTransferBatchByNo(batchId, params) {
+    return this.client.get(
+      `/v3/partner-transfer/batches/batch-id/${batchId}`,
+      params
+    );
+  }
+  /**
+   * 通过商家批次单号查询批次单
+   *
+   * @param outBatchNo - 商家批次单号
+   * @param params - 可选查询参数
+   * @returns 批次单详情
+   */
+  async getTransferBatchByOutNo(outBatchNo, params) {
+    return this.client.get(
+      `/v3/partner-transfer/batches/out-batch-no/${outBatchNo}`,
+      params
+    );
+  }
+  /**
+   * 通过微信明细单号查询明细单
+   *
+   * @param batchId - 微信批次单号
+   * @param detailId - 微信明细单号
+   * @returns 明细单详情
+   */
+  async getTransferDetailByNo(batchId, detailId) {
+    return this.client.get(
+      `/v3/partner-transfer/batches/batch-id/${batchId}/details/detail-id/${detailId}`
+    );
+  }
+  /**
+   * 通过商家明细单号查询明细单
+   *
+   * @param outBatchNo - 商家批次单号
+   * @param outDetailNo - 商家明细单号
+   * @returns 明细单详情
+   */
+  async getTransferDetailByOutNo(outBatchNo, outDetailNo) {
+    return this.client.get(
+      `/v3/partner-transfer/batches/out-batch-no/${outBatchNo}/details/out-detail-no/${outDetailNo}`
+    );
+  }
+};
+
+// src/services/ecommerce-profitsharing.ts
+var EcommerceProfitSharingService = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 请求分账
+   *
+   * @param request - 分账请求参数
+   * @returns 分账结果
+   */
+  async createOrder(request) {
+    return this.client.post(
+      "/v3/ecommerce/profitsharing/orders",
+      request
+    );
+  }
+  /**
+   * 查询分账结果
+   *
+   * @param subMchid - 特约商户号
+   * @param transactionId - 微信支付订单号
+   * @param outOrderNo - 商户分账单号
+   * @returns 分账结果详情
+   */
+  async queryOrder(subMchid, transactionId, outOrderNo) {
+    return this.client.get(
+      "/v3/ecommerce/profitsharing/orders",
+      { sub_mchid: subMchid, transaction_id: transactionId, out_order_no: outOrderNo }
+    );
+  }
+  /**
+   * 请求分账回退
+   *
+   * @param request - 分账回退请求参数
+   * @returns 回退结果
+   */
+  async createReturnOrder(request) {
+    return this.client.post(
+      "/v3/ecommerce/profitsharing/returnorders",
+      request
+    );
+  }
+  /**
+   * 查询分账回退结果
+   *
+   * @param subMchid - 特约商户号
+   * @param orderId - 微信分账单号
+   * @param outReturnNo - 商户回退单号
+   * @returns 回退结果详情
+   */
+  async queryReturnOrder(subMchid, orderId, outReturnNo) {
+    return this.client.get(
+      "/v3/ecommerce/profitsharing/returnorders",
+      { sub_mchid: subMchid, order_id: orderId, out_return_no: outReturnNo }
+    );
+  }
+  /**
+   * 完结分账
+   *
+   * @param request - 完结分账请求参数
+   */
+  async finishOrder(request) {
+    return this.client.post("/v3/ecommerce/profitsharing/finish-order", request);
+  }
+  /**
+   * 请求售后服务分账
+   *
+   * @param request - 售后服务分账请求参数
+   * @returns 售后服务分账结果
+   */
+  async createAfterSalesOrder(request) {
+    return this.client.post(
+      "/v3/ecommerce/profitsharing/after-sales-orders",
+      request
+    );
+  }
+  /**
+   * 查询售后服务分账结果
+   *
+   * @param subMchid - 子商户号
+   * @param transactionId - 微信支付订单号
+   * @returns 售后服务分账结果详情
+   */
+  async queryAfterSalesOrder(subMchid, transactionId) {
+    return this.client.get(
+      "/v3/ecommerce/profitsharing/after-sales-orders",
+      { sub_mchid: subMchid, transaction_id: transactionId }
+    );
+  }
+  /**
+   * 查询订单剩余待分金额
+   *
+   * @param transactionId - 微信支付订单号
+   * @returns 订单剩余待分金额
+   */
+  async queryOrderAmount(transactionId) {
+    return this.client.get(
+      `/v3/ecommerce/profitsharing/orders/${transactionId}/amounts`
+    );
+  }
+  /**
+   * 添加分账接收方
+   *
+   * @param request - 添加接收方请求参数
+   * @returns 添加接收方结果
+   */
+  async addReceiver(request) {
+    return this.client.post(
+      "/v3/ecommerce/profitsharing/receivers/add",
+      request
+    );
+  }
+  /**
+   * 删除分账接收方
+   *
+   * @param request - 删除接收方请求参数
+   * @returns 删除接收方结果
+   */
+  async deleteReceiver(request) {
+    return this.client.post(
+      "/v3/ecommerce/profitsharing/receivers/delete",
+      request
+    );
+  }
+};
+
+// src/services/ecommerce-refund.ts
+var EcommerceRefundService = class {
+  client;
+  constructor(client) {
+    this.client = client;
   }
-  const sortedKeys = Object.keys(signFields).sort();
-  const signStr = sortedKeys.map((k) => `${k}=${signFields[k]}`).join("&") + `&key=${signKey}`;
-  const sign2 = crypto2.createHmac("sha256", signKey).update(signStr).digest("hex").toUpperCase();
-  const urlParams = new URLSearchParams({
-    stock_id: params.stock_id,
-    out_request_no: params.out_request_no,
-    sign: sign2,
-    send_coupon_merchant: params.send_coupon_merchant,
-    open_id: params.open_id
-  });
-  if (params.coupon_code) {
-    urlParams.set("coupon_code", params.coupon_code);
+  /**
+   * 申请退款
+   *
+   * @param request - 退款请求参数
+   * @returns 退款结果
+   *
+   * @see https://pay.weixin.qq.com/doc/v3/partner/4013080625
+   */
+  async create(request) {
+    return this.client.post("/v3/ecommerce/refunds/apply", request);
   }
-  if (params.customize_send_time) {
-    urlParams.set("customize_send_time", params.customize_send_time);
+  /**
+   * 查询单笔退款（通过商户退款单号）
+   *
+   * @param subMchid - 特约商户号
+   * @param outRefundNo - 商户退款单号
+   * @returns 退款详情
+   */
+  async queryByOutRefundNo(subMchid, outRefundNo) {
+    return this.client.get(
+      `/v3/ecommerce/refunds/out-refund-no/${outRefundNo}`,
+      { sub_mchid: subMchid }
+    );
   }
-  return `${H5_COUPON_URL}?${urlParams.toString()}#wechat_pay&wechat_redirect`;
+  /**
+   * 查询单笔退款（通过微信支付退款单号）
+   *
+   * @param subMchid - 特约商户号
+   * @param refundId - 微信支付退款单号
+   * @returns 退款详情
+   */
+  async queryByRefundId(subMchid, refundId) {
+    return this.client.get(`/v3/ecommerce/refunds/id/${refundId}`, {
+      sub_mchid: subMchid
+    });
+  }
+  /**
+   * 垫付退款回补
+   *
+   * 当电商平台已垫付退款给用户，后续从二级商户处回补该笔退款资金。
+   *
+   * @param request - 垫付回补请求参数
+   * @returns 垫付回补结果
+   */
+  async createReturnAdvance(request) {
+    return this.client.post(
+      `/v3/ecommerce/refunds/${request.refund_id}/return-advance`,
+      { sub_mchid: request.sub_mchid }
+    );
+  }
+  /**
+   * 查询垫付回补结果
+   *
+   * @param subMchid - 特约商户号
+   * @param refundId - 微信退款单号
+   * @returns 垫付回补结果
+   */
+  async queryReturnAdvance(subMchid, refundId) {
+    return this.client.get(
+      `/v3/ecommerce/refunds/${refundId}/return-advance`,
+      { sub_mchid: subMchid }
+    );
+  }
+};
+
+// src/services/ecommerce-subsidy.ts
+var EcommerceSubsidyService = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 请求补差
+   *
+   * @param request - 补差请求参数
+   * @returns 补差结果
+   */
+  async create(request) {
+    return this.client.post(
+      "/v3/ecommerce/subsidies/create",
+      request
+    );
+  }
+  /**
+   * 请求补差回退
+   *
+   * @param request - 补差回退请求参数
+   * @returns 回退结果
+   */
+  async returnSubsidy(request) {
+    return this.client.post(
+      "/v3/ecommerce/subsidies/return",
+      request
+    );
+  }
+  /**
+   * 取消补差
+   *
+   * @param request - 取消补差请求参数
+   * @returns 取消补差结果
+   */
+  async cancelSubsidy(request) {
+    return this.client.post(
+      "/v3/ecommerce/subsidies/cancel",
+      request
+    );
+  }
+};
+
+// src/services/brand-profitsharing.ts
+var BrandProfitSharingService = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 请求分账
+   *
+   * @param request - 分账请求参数
+   * @returns 分账结果
+   */
+  async createOrder(request) {
+    return this.client.post(
+      "/v3/brand/profitsharing/orders",
+      request
+    );
+  }
+  /**
+   * 查询分账结果
+   *
+   * @param brandMchid - 品牌主商户号
+   * @param subMchid - 特约商户号
+   * @param transactionId - 微信支付订单号
+   * @param outOrderNo - 商户分账单号
+   * @returns 分账结果详情
+   */
+  async queryOrder(brandMchid, subMchid, transactionId, outOrderNo) {
+    return this.client.get("/v3/brand/profitsharing/orders", {
+      brand_mchid: brandMchid,
+      sub_mchid: subMchid,
+      transaction_id: transactionId,
+      out_order_no: outOrderNo
+    });
+  }
+  /**
+   * 请求分账回退
+   *
+   * @param request - 分账回退请求参数
+   * @returns 回退结果
+   */
+  async createReturnOrder(request) {
+    return this.client.post(
+      "/v3/brand/profitsharing/returnorders",
+      request
+    );
+  }
+  /**
+   * 查询分账回退结果
+   *
+   * @param brandMchid - 品牌主商户号
+   * @param subMchid - 特约商户号
+   * @param orderId - 微信分账单号
+   * @param outReturnNo - 商户回退单号
+   * @returns 回退结果详情
+   */
+  async queryReturnOrder(brandMchid, subMchid, orderId, outReturnNo) {
+    return this.client.get(
+      "/v3/brand/profitsharing/returnorders",
+      {
+        brand_mchid: brandMchid,
+        sub_mchid: subMchid,
+        order_id: orderId,
+        out_return_no: outReturnNo
+      }
+    );
+  }
+  /**
+   * 完结分账
+   *
+   * @param request - 完结分账请求参数
+   */
+  async finishOrder(request) {
+    return this.client.post("/v3/brand/profitsharing/finish-order", request);
+  }
+  /**
+   * 查询最大分账比例
+   *
+   * @param brandMchid - 品牌主商户号
+   * @returns 最大分账比例
+   */
+  async queryBrandMerchantRatio(brandMchid) {
+    return this.client.get(
+      `/v3/brand/profitsharing/brand-configs/${brandMchid}`
+    );
+  }
+  /**
+   * 查询订单剩余待分金额
+   *
+   * @param transactionId - 微信支付订单号
+   * @returns 订单剩余待分金额
+   */
+  async queryOrderAmount(transactionId) {
+    return this.client.get(
+      `/v3/brand/profitsharing/orders/${transactionId}/amounts`
+    );
+  }
+  /**
+   * 添加分账接收方
+   *
+   * @param request - 添加接收方请求参数
+   * @returns 添加接收方结果
+   */
+  async addReceiver(request) {
+    return this.client.post(
+      "/v3/brand/profitsharing/receivers/add",
+      request
+    );
+  }
+  /**
+   * 删除分账接收方
+   *
+   * @param request - 删除接收方请求参数
+   * @returns 删除接收方结果
+   */
+  async deleteReceiver(request) {
+    return this.client.post(
+      "/v3/brand/profitsharing/receivers/delete",
+      request
+    );
+  }
+};
+function loadCertificate(certificate) {
+  return new crypto2.X509Certificate(certificate);
 }
-function buildPayScoreDetailJsapiBridgeConfig(appId, mchId, serviceId, outOrderNo, privateKey) {
-  const timestamp = String(Math.floor(Date.now() / 1e3));
-  const nonceStr = generateNonceStr();
-  const sign2 = generatePayScorePaySign(
-    appId,
-    timestamp,
-    nonceStr,
-    serviceId,
-    outOrderNo,
-    privateKey
-  );
-  return {
-    appid: appId,
-    mchid: mchId,
-    service_id: serviceId,
-    out_order_no: outOrderNo,
-    timestamp,
-    nonce_str: nonceStr,
-    sign_type: "RSA",
-    sign: sign2
-  };
+function loadCertificateFromPath(path) {
+  return new crypto2.X509Certificate(fs2.readFileSync(path, "utf-8"));
 }
-function buildPayScoreDetailMiniProgramBridgeConfig(mchId, serviceId, outOrderNo, appId, privateKey) {
-  const timestamp = String(Math.floor(Date.now() / 1e3));
-  const nonceStr = generateNonceStr();
-  const sign2 = generatePayScorePaySign(
-    appId,
-    timestamp,
-    nonceStr,
-    serviceId,
-    outOrderNo,
-    privateKey
-  );
-  return {
-    mchid: mchId,
-    service_id: serviceId,
-    out_order_no: outOrderNo,
-    timestamp,
-    nonce_str: nonceStr,
-    sign_type: "RSA",
-    sign: sign2
-  };
+function loadPrivateKey(key) {
+  if (Buffer.isBuffer(key)) return key.toString("utf-8");
+  if (key.startsWith("-----BEGIN")) return key;
+  try {
+    return fs2.readFileSync(key, "utf-8");
+  } catch {
+    return key;
+  }
 }
-function buildPayScoreDetailAppBridgeConfig(appId, mchId, serviceId, outOrderNo, privateKey) {
-  const timestamp = String(Math.floor(Date.now() / 1e3));
-  const nonceStr = generateNonceStr();
-  const sign2 = generatePayScorePaySign(
-    appId,
-    timestamp,
-    nonceStr,
-    serviceId,
-    outOrderNo,
-    privateKey
-  );
-  return {
-    appid: appId,
-    mchid: mchId,
-    service_id: serviceId,
-    out_order_no: outOrderNo,
-    timestamp,
-    nonce_str: nonceStr,
-    sign_type: "RSA",
-    sign: sign2
-  };
+function loadPublicKey(key) {
+  if (Buffer.isBuffer(key)) return key.toString("utf-8");
+  if (key.startsWith("-----BEGIN")) return key;
+  try {
+    return fs2.readFileSync(key, "utf-8");
+  } catch {
+    return key;
+  }
 }
-var MED_INS_APPID = "wxbcad394b3d99dac9";
-var MED_INS_PATH = "/pages/med-ins/pay/pay";
-function buildMedInsMiniProgramBridgeConfig(mchid, mixTradeNo) {
-  return {
-    appId: MED_INS_APPID,
-    path: MED_INS_PATH,
-    extraData: {
-      mchid,
-      mix_trade_no: mixTradeNo
-    }
-  };
+function getCertificateSerialNumber(cert) {
+  return cert.serialNumber.toUpperCase();
 }
-function buildMedInsJsapiBridgeConfig(appId, mchId, mixTradeNo, privateKey) {
-  const timestamp = String(Math.floor(Date.now() / 1e3));
-  const nonceStr = generateNonceStr();
-  const packageStr = `mchid=${mchId}&mix_trade_no=${mixTradeNo}`;
-  const signString = `${appId}
-${timestamp}
-${nonceStr}
-${packageStr}
-`;
-  const signer = crypto2.createSign("RSA-SHA256");
-  signer.update(signString);
-  signer.end();
-  const sign2 = signer.sign(privateKey, "base64");
-  return {
-    appid: appId,
-    mchid: mchId,
-    mix_trade_no: mixTradeNo,
-    timestamp,
-    nonce_str: nonceStr,
-    sign_type: "RSA",
-    sign: sign2
-  };
+function isCertificateExpired(cert, now) {
+  const checkTime = now ?? /* @__PURE__ */ new Date();
+  const validTo = new Date(cert.validTo);
+  return checkTime > validTo;
+}
+function isCertificateValid(cert, now) {
+  const checkTime = now ?? /* @__PURE__ */ new Date();
+  const validFrom = new Date(cert.validFrom);
+  const validTo = new Date(cert.validTo);
+  return checkTime >= validFrom && checkTime <= validTo;
 }
 
-export { AppService, BillService, BusinessCircleService, CallbackHandler, CertificateManager, CertificateService, CombineAppService, CombineH5Service, CombineMiniProgramService, CombineNativeService, CombineService, ComplaintService, CouponService, DecryptionException, GoldPlanService, H5Service, HttpException, JsapiService, LoveFeastService, MalformedMessageException, MedInsService, MediaService, MerchantExclusiveCouponService, MerchantTransferService, NativeService, ParkingService, PartnershipService, PayGiftActivityService, PayScoreService, PayrollCardService, ProfitSharingService, RetailStoreService, ScanAndRideService, SecurityService, ServiceException, SmartGuideService, ValidationException, WxPayClient, WxPayError, 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 };
+export { AppService, BillService, BrandProfitSharingService, BusinessCircleService, CallbackHandler, CertificateManager, CertificateService, CombineAppService, CombineH5Service, CombineMiniProgramService, CombineNativeService, CombineService, ComplaintService, CouponService, DecryptionException, EcommerceProfitSharingService, EcommerceRefundService, EcommerceSubsidyService, GoldPlanService, H5Service, HttpException, JsapiService, LoveFeastService, MalformedMessageException, MedInsService, MediaService, MerchantExclusiveCouponService, MerchantTransferService, NativeService, ParkingService, PartnerAppService, PartnerH5Service, PartnerJsapiService, PartnerNativeService, PartnerTransferBatchService, PartnerTransferService, PartnershipService, PayGiftActivityService, PayScoreService, PayrollCardService, ProfitSharingService, RefundService, RetailStoreService, ScanAndRideService, SecurityService, ServiceException, SmartGuideService, TransferBatchService, ValidationException, WxPayClient, WxPayError, 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 };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map