better-wechatpay 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Better WeChat Pay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,391 @@
+# Better WeChat Pay
+
+现代化的微信支付 Node.js SDK - ESM、TypeScript、全支付方式支持
+
+## 目录
+
+- [特性](#特性)
+- [安装](#安装)
+- [快速开始](#快速开始)
+- [环境变量](#环境变量)
+- [支付方式](#支付方式)
+  - [Native 支付（扫码支付）](#native-支付扫码支付)
+  - [APP 支付](#app-支付)
+  - [JSAPI / 小程序支付](#jsapi--小程序支付)
+  - [H5 支付](#h5-支付)
+  - [合单支付](#合单支付)
+- [订单管理](#订单管理)
+- [退款管理](#退款管理)
+- [账单下载](#账单下载)
+- [Webhook 处理](#webhook-处理)
+- [自定义 API 调用](#自定义-api-调用)
+- [调试模式](#调试模式)
+- [示例项目](#示例项目)
+- [文档](#文档)
+- [许可证](#许可证)
+
+## 特性
+
+- ✅ 纯 ESM（ES Modules）
+- ✅ 完整的 TypeScript 类型支持
+- ✅ 支持所有支付方式（Native/APP/JSAPI/小程序/H5）
+- ✅ 双签名验证（新公钥 + 平台证书）
+- ✅ 内置调试模式
+- ✅ 最小依赖（@peculiar/x509、ofetch）
+- ✅ 自动金额格式化（元转分）
+- ✅ 完善的测试覆盖
+
+## 安装
+
+```bash
+npm install better-wechatpay
+```
+
+## 快速开始
+
+```typescript
+import WeChatPay from 'better-wechatpay';
+
+const wechat = new WeChatPay({
+  config: {
+    appId: process.env.WECHAT_PAY_APP_ID,
+    mchId: process.env.WECHAT_PAY_MCH_ID,
+    apiKey: process.env.WECHAT_PAY_API_KEY,
+    privateKey: process.env.WECHAT_PAY_PRIVATE_KEY,
+    publicKey: process.env.WECHAT_PAY_PUBLIC_KEY,
+    notifyUrl: 'https://your-domain.com/webhook/wechat'
+  }
+});
+
+// 创建 Native 支付（扫码支付）
+const payment = await wechat.native.create({
+  out_trade_no: 'order-123',
+  description: '会员订阅',
+  amount: 99.00  // 自动转换为分（9900）
+});
+
+console.log('二维码链接:', payment.code_url);
+```
+
+## 环境变量
+
+必需的环境变量：
+
+```bash
+# 微信支付凭证
+WECHAT_PAY_APP_ID="your_app_id"
+WECHAT_PAY_MCH_ID="your_mch_id"
+WECHAT_PAY_API_KEY="32_character_api_key"
+
+# 证书（PEM 格式，单行）
+WECHAT_PAY_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----
+MIIEvQIBADANBgkq...
+-----END PRIVATE KEY-----"
+
+WECHAT_PAY_PUBLIC_KEY="-----BEGIN CERTIFICATE-----
+MIID8zCCAtugAwIB...
+-----END CERTIFICATE-----"
+
+# 可选：微信支付公钥（推荐）
+WECHAT_PAY_PAYMENT_PUBLIC_KEY="-----BEGIN PUBLIC KEY-----
+MIIEvgIBADAN...
+-----END PUBLIC KEY-----"
+
+WECHAT_PAY_PUBLIC_KEY_ID="public_key_id"
+```
+
+## 支付方式
+
+### Native 支付（扫码支付）
+
+```typescript
+const payment = await wechat.native.create({
+  out_trade_no: 'order-123',
+  description: '会员订阅',
+  amount: 99.00
+});
+// 返回: { code_url: 'weixin://...', out_trade_no: 'order-123' }
+```
+
+### APP 支付
+
+```typescript
+const payment = await wechat.app.create({
+  out_trade_no: 'order-123',
+  description: '会员订阅',
+  amount: 99.00
+});
+// 返回: { prepay_id: '...', out_trade_no: 'order-123' }
+```
+
+### JSAPI / 小程序支付
+
+```typescript
+const payment = await wechat.jsapi.create({
+  out_trade_no: 'order-123',
+  description: '会员订阅',
+  amount: 99.00,
+  openid: 'user_openid'  // 必填
+});
+// 返回: { prepay_id: '...', out_trade_no: 'order-123' }
+```
+
+### H5 支付
+
+```typescript
+const payment = await wechat.h5.create({
+  out_trade_no: 'order-123',
+  description: '会员订阅',
+  amount: 99.00,
+  payer_client_ip: '1.2.3.4',
+  h5_info: {
+    type: 'Wap',
+    app_name: '我的应用',
+    app_url: 'https://example.com'
+  }
+});
+// 返回: { h5_url: 'https://wx.tenpay.com/...', out_trade_no: 'order-123' }
+```
+
+## 通用操作
+
+所有支付方式都支持以下操作：
+
+### 查询订单
+
+```typescript
+// 通过商户订单号查询
+const order = await wechat.native.query({ out_trade_no: 'order-123' });
+
+// 通过微信订单号查询
+const order = await wechat.native.queryByTransactionId({ transaction_id: 'txn-123' });
+
+console.log('订单状态:', order.trade_state);
+console.log('微信订单号:', order.transaction_id);
+console.log('金额:', order.amount.total);
+```
+
+### 关闭订单
+
+```typescript
+await wechat.native.close('order-123');
+```
+
+### 申请退款
+
+```typescript
+const refund = await wechat.native.refund({
+  out_trade_no: 'order-123',
+  out_refund_no: 'refund-123',
+  refund: 99.00,
+  total: 99.00,
+  reason: '商品售后'
+});
+```
+
+### 查询退款
+
+```typescript
+const refund = await wechat.native.queryRefund({ out_refund_no: 'refund-123' });
+```
+
+### 申请账单
+
+```typescript
+// 交易账单
+const tradeBill = await wechat.native.applyTradeBill({
+  bill_date: '2025-01-01',
+  bill_type: 'ALL'
+});
+
+// 资金账单
+const fundBill = await wechat.native.applyFundFlowBill({
+  bill_date: '2025-01-01',
+  account_type: 'BASIC'
+});
+```
+
+## 自定义 API 调用
+
+SDK 暴露了底层 HTTP 客户端，可用于调用未实现的微信支付 API：
+
+```typescript
+const result = await wechat.request<CustomResponse>(
+  'POST',
+  '/v3/custom/endpoint',
+  { custom_param: 'value' }
+);
+```
+
+这对于调用新推出的微信支付 API 或特殊业务场景非常有用。
+
+## Webhook 处理
+
+```typescript
+import { createServer } from 'http';
+
+const server = createServer(async (req, res) => {
+  if (req.url === '/webhook/wechat') {
+    let body = '';
+    req.on('data', chunk => body += chunk);
+    req.on('end', async () => {
+      const result = await wechat.webhook.verify({
+        headers: req.headers as any,
+        body
+      });
+
+      if (result.success) {
+        console.log('Webhook 验证成功:', result.eventType);
+        console.log('解密数据:', result.decryptedData);
+        res.writeHead(200);
+        res.end('OK');
+      } else {
+        console.error('Webhook 签名无效');
+        res.writeHead(400);
+        res.end('Invalid signature');
+      }
+    });
+  }
+});
+
+server.listen(3000);
+```
+
+## 调试模式
+
+启用调试日志：
+
+```typescript
+const wechat = new WeChatPay({
+  config: {
+    /* ... 配置 ... */
+    debug: true
+  }
+});
+
+// 或通过环境变量
+WECHAT_PAY_DEBUG=true node app.js
+```
+
+调试输出包含：
+- 请求详情（URL、方法、请求头、请求体）
+- 响应详情（状态码、响应头、响应体）
+- 签名验证结果
+- 错误详情
+
+## 配置选项
+
+```typescript
+interface WeChatPayConfig {
+  appId: string;              // 应用 ID
+  mchId: string;              // 商户号
+  apiKey: string;             // API 密钥（32位）
+  privateKey: Buffer | string; // 商户私钥
+  publicKey: Buffer | string;  // 商户证书
+  paymentPublicKey?: Buffer | string;  // 微信支付公钥（可选，推荐）
+  publicKeyId?: string;        // 公钥 ID（使用 paymentPublicKey 时必填）
+  notifyUrl?: string;          // 回调通知地址
+  baseUrl?: string;            // API 基础 URL（默认生产环境）
+  debug?: boolean;             // 调试模式
+}
+```
+
+## 安全注意事项
+
+1. **永远不要将证书或密钥提交到版本控制**
+2. **将敏感凭证存储在环境变量中**
+3. **始终验证 Webhook 签名**
+4. **Webhook URL 必须使用 HTTPS**
+5. **定期轮换证书**
+
+详见 [安全指南](docs/security.md)。
+
+## 文档
+
+### 快速入门
+- [快速开始](docs/getting-started.md)
+- [API 参考](docs/api-reference.md)
+- [调试模式](docs/debug-mode.md)
+- [安全指南](docs/security.md)
+- [错误码](docs/error-codes.md)
+
+### 支付方式
+- [Native 支付（扫码支付）](docs/native-payment.md)
+- [APP 支付](docs/app-payment.md)
+- [JSAPI 支付](docs/jsapi-payment.md)
+- [H5 支付](docs/h5-payment.md)
+- [合单支付](docs/combine-payment.md)
+
+## 示例服务器
+
+想要测试完整的支付流程？查看 [示例服务器](examples/demo/QUICKSTART.md) - 一个功能完整的测试服务器：
+
+- ✅ 创建真实支付和二维码
+- ✅ 使用微信扫码完成支付
+- ✅ 处理真实的 Webhook
+- ✅ 查询和管理订单
+- ✅ 测试所有支付状态
+
+**快速启动：**
+```bash
+# 1. 配置环境变量
+cd examples/demo
+cp .env.example .env
+# 编辑 .env，填入你的微信支付凭证
+
+# 2. 启动示例服务器
+npm install
+npm run dev
+
+# 3. 打开 http://localhost:3000
+# 创建支付，扫描二维码，完成支付！
+```
+
+详见 [示例服务器文档](examples/demo/QUICKSTART.md)。
+
+## 框架集成
+
+查看框架集成示例：
+
+### [Next.js](examples/nextjs/)
+现代 React 框架，支持 App Router
+
+```bash
+cd examples/nextjs
+npm install
+npm run dev
+```
+
+### [Nuxt](examples/nuxt/)
+直观的 Vue 全栈开发框架
+
+```bash
+cd examples/nuxt
+npm install
+npm run dev
+```
+
+详见 [所有示例](examples/INDEX.md)。
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 构建 TypeScript
+npm run build
+
+# 运行单元测试
+npm test
+
+# 运行示例服务器（需要微信支付凭证）
+npm run dev
+
+# 类型检查
+npm run typecheck
+```
+
+## 许可证
+
+MIT

package/dist/app/app.d.ts

@@ -0,0 +1,23 @@
+import type { HttpClient } from '../core/client';
+import type { CreateAppPaymentParams, CreateAppPaymentResult, CreateCombineAppPaymentParams, CreateCombineAppPaymentResult } from '../types';
+import { BasePayment } from '../core/base-payment';
+/**
+ * APP支付
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070158
+ */
+export declare class AppPayment extends BasePayment {
+    constructor(client: HttpClient, instance: object);
+    /**
+     * APP下单
+     * 商户系统先调用该接口在微信支付服务后台生成预支付交易单，返回正确的预支付交易会话标识后，
+     * 再按照APP调起支付的规范调起支付。
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070164
+     */
+    create(params: CreateAppPaymentParams): Promise<CreateAppPaymentResult>;
+    /**
+     * APP合单下单
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556944
+     */
+    createCombine(params: CreateCombineAppPaymentParams): Promise<CreateCombineAppPaymentResult>;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/app/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/app/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EAEtB,6BAA6B,EAC7B,6BAA6B,EAE9B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD;;;GAGG;AACH,qBAAa,UAAW,SAAQ,WAAW;gBAC7B,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;IAIhD;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA0C7E;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,6BAA6B,GAAG,OAAO,CAAC,6BAA6B,CAAC;CAwCnG"}

package/dist/app/app.js

@@ -0,0 +1,89 @@
+import { BasePayment } from '../core/base-payment';
+import { logger } from '../core/debug';
+/**
+ * APP支付
+ * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070158
+ */
+export class AppPayment extends BasePayment {
+    constructor(client, instance) {
+        super(client, instance);
+    }
+    /**
+     * APP下单
+     * 商户系统先调用该接口在微信支付服务后台生成预支付交易单，返回正确的预支付交易会话标识后，
+     * 再按照APP调起支付的规范调起支付。
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4013070164
+     */
+    async create(params) {
+        logger.log(this.instance, 'Creating APP payment:', params);
+        const data = this.removeUndefined({
+            appid: this.client.getAppId(),
+            mchid: this.client.getMerchantId(),
+            description: params.description,
+            out_trade_no: params.out_trade_no,
+            time_expire: params.time_expire,
+            attach: params.attach,
+            notify_url: this.client.getNotifyUrl(),
+            goods_tag: params.goods_tag,
+            support_fapiao: params.support_fapiao,
+            amount: {
+                total: this.formatAmount(params.amount),
+                currency: params.currency || 'CNY'
+            },
+            detail: params.detail ? {
+                cost_price: params.detail.cost_price,
+                invoice_id: params.detail.invoice_id,
+                goods_detail: params.detail.goods_detail
+            } : undefined,
+            scene_info: {
+                payer_client_ip: params.payer_client_ip || params.scene_info?.payer_client_ip || '127.0.0.1',
+                device_id: params.scene_info?.device_id,
+                store_info: params.scene_info?.store_info
+            },
+            settle_info: params.settle_info
+        });
+        const result = await this.client.request('POST', '/v3/pay/transactions/app', data);
+        return {
+            prepay_id: result.prepay_id,
+            out_trade_no: params.out_trade_no
+        };
+    }
+    /**
+     * APP合单下单
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012556944
+     */
+    async createCombine(params) {
+        logger.log(this.instance, 'Creating APP combine payment:', params);
+        const data = this.removeUndefined({
+            combine_appid: this.client.getAppId(),
+            combine_mchid: this.client.getMerchantId(),
+            combine_out_trade_no: params.combine_out_trade_no,
+            time_expire: params.time_expire,
+            notify_url: params.notify_url || this.client.getNotifyUrl(),
+            scene_info: params.payer_client_ip || params.scene_info ? {
+                payer_client_ip: params.payer_client_ip || params.scene_info?.payer_client_ip || '127.0.0.1',
+                device_id: params.scene_info?.device_id,
+                store_info: params.scene_info?.store_info
+            } : undefined,
+            sub_orders: params.sub_orders.map((order) => ({
+                mchid: order.mchid,
+                attach: order.attach,
+                out_trade_no: order.out_trade_no,
+                description: order.description,
+                amount: {
+                    total_amount: this.formatAmount(order.amount.total_amount),
+                    currency: order.amount.currency || 'CNY'
+                },
+                detail: order.detail,
+                goods_tag: order.goods_tag,
+                settle_info: order.settle_info
+            }))
+        });
+        const result = await this.client.request('POST', '/v3/combine-transactions/app', data);
+        return {
+            prepay_id: result.prepay_id,
+            combine_out_trade_no: params.combine_out_trade_no
+        };
+    }
+}
+//# sourceMappingURL=app.js.map

package/dist/app/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/app/app.ts"],"names":[],"mappings":"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"}

package/dist/config/loader.d.ts

@@ -0,0 +1,3 @@
+import { WeChatPayConfig, WeChatPayOptions } from '../types/index';
+export declare function loadConfig(options: WeChatPayOptions | WeChatPayConfig): WeChatPayConfig;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,GAAG,eAAe,CA4BvF"}

package/dist/config/loader.js

@@ -0,0 +1,30 @@
+export function loadConfig(options) {
+    if (options.configPath) {
+        throw new Error('Loading config from file is not yet implemented');
+    }
+    let config;
+    if (options.config) {
+        config = options.config;
+    }
+    else {
+        config = options;
+    }
+    if (!config.appId)
+        throw new Error('appId is required');
+    if (!config.mchId)
+        throw new Error('mchId is required');
+    if (!config.apiKey)
+        throw new Error('apiKey is required');
+    if (!config.privateKey)
+        throw new Error('privateKey is required');
+    if (!config.publicKey)
+        throw new Error('publicKey is required');
+    if (config.debug === undefined) {
+        config.debug = process.env.WECHAT_PAY_DEBUG === 'true';
+    }
+    if (!config.baseUrl) {
+        config.baseUrl = 'https://api.mch.weixin.qq.com';
+    }
+    return config;
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,OAA2C;IACpE,IAAK,OAA4B,CAAC,UAAU,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,MAAuB,CAAC;IAE5B,IAAK,OAA4B,CAAC,MAAM,EAAE,CAAC;QACzC,MAAM,GAAI,OAA4B,CAAC,MAAO,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,OAA0B,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAClE,IAAI,CAAC,MAAM,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAEhE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,MAAM,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,OAAO,GAAG,+BAA+B,CAAC;IACnD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/base-payment.d.ts

@@ -0,0 +1,70 @@
+import type { HttpClient } from './client';
+import type { QueryOrderParams, QueryOrderResult, QueryOrderByTransactionIdParams, QueryCombineOrderParams, QueryCombineOrderResult, CloseCombineOrderParams, RefundParams, RefundResult, QueryRefundParams, AbnormalRefundParams, ApplyTradeBillParams, BillResult, ApplyFundFlowBillParams } from '../types';
+/**
+ * 支付基类
+ * 包含所有支付方式共用的方法：查询、关闭、退款、账单等
+ */
+export declare abstract class BasePayment {
+    protected client: HttpClient;
+    protected instance: object;
+    protected constructor(client: HttpClient, instance: object);
+    /**
+     * 通过商户订单号查询订单
+     */
+    query(params: QueryOrderParams): Promise<QueryOrderResult>;
+    /**
+     * 关闭订单
+     */
+    close(out_trade_no: string): Promise<void>;
+    /**
+     * 查询合单订单
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012557006
+     */
+    queryCombineOrder(params: QueryCombineOrderParams): Promise<QueryCombineOrderResult>;
+    /**
+     * 关闭合单订单
+     * @see https://pay.weixin.qq.com/doc/v3/merchant/4012557007
+     */
+    closeCombineOrder(params: CloseCombineOrderParams): Promise<void>;
+    /**
+     * 通过微信支付订单号查询订单
+     */
+    queryByTransactionId(params: QueryOrderByTransactionIdParams): Promise<QueryOrderResult>;
+    /**
+     * 申请退款
+     */
+    refund(params: RefundParams): Promise<RefundResult>;
+    /**
+     * 查询单笔退款
+     */
+    queryRefund(params: QueryRefundParams): Promise<RefundResult>;
+    /**
+     * 发起异常退款
+     */
+    applyAbnormalRefund(params: AbnormalRefundParams): Promise<RefundResult>;
+    /**
+     * 申请交易账单
+     */
+    applyTradeBill(params: ApplyTradeBillParams): Promise<BillResult>;
+    /**
+     * 申请资金账单
+     */
+    applyFundFlowBill(params: ApplyFundFlowBillParams): Promise<BillResult>;
+    /**
+     * 解析退款结果
+     */
+    protected parseRefundResult(result: any): RefundResult;
+    /**
+     * 金额转换：元 → 分
+     */
+    protected formatAmount(amount: number): number;
+    /**
+     * 递归移除对象中的 undefined 值
+     */
+    protected removeUndefined<T extends object>(obj: T): T;
+    /**
+     * 构建 URL 查询字符串，自动过滤 undefined 值
+     */
+    protected buildQueryString(params: Record<string, string | undefined>): string;
+}
+//# sourceMappingURL=base-payment.d.ts.map

package/dist/core/base-payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-payment.d.ts","sourceRoot":"","sources":["../../src/core/base-payment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEhB,+BAA+B,EAC/B,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EACV,uBAAuB,EACxB,MAAM,UAAU,CAAC;AAGlB;;;GAGG;AACH,8BAAsB,WAAW;IAE7B,SAAS,CAAC,MAAM,EAAE,UAAU;IAC5B,SAAS,CAAC,QAAQ,EAAE,MAAM;IAF5B,SAAS,aACG,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM;IAG5B;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuBhE;;OAEG;IACG,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhD;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAkB1F;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAevE;;OAEG;IACG,oBAAoB,CAAC,MAAM,EAAE,+BAA+B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuB9F;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAwBzD;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAWnE;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC;IAoB9E;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAqBvE;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IAuB7E;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,YAAY;IA6BtD;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI9C;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;IA2BtD;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM;CAW/E"}