@aios-medical/cashier

中文文档
1.7.0发布于 2026/10/16MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 2105

为Node.js和TypeScript统一订阅帐单. 一个API跨支付提供者,有打出错误和雀巢JS支持.

中文使用文档
文档目录6 节
  1. 为什么出纳
  2. 供应商
  3. 软件包
  4. 文档
  5. 捐款
  6. 许可证

出纳员

npm License: MIT

为Node.js和TypeScript统一订阅帐单. 每个支付提供者都有一个API,有打出错误. 花纹和回想今天得到支持.

npm install @aios-medical/cashier stripe recurly
import { CashierProvider, createCashier } from '@aios-medical/cashier';

const cashier = createCashier({
  default: CashierProvider.Stripe,
  providers: {
    stripe: { apiKey: process.env.STRIPE_SECRET_KEY! },
    recurly: { apiKey: process.env.RECURLY_API_KEY! },
  },
});

const billing = cashier.use();

const customer = await billing.customers.create({ email: '[email protected]' });

await billing.subscriptions.create({
  customer: customer.id,
  price: 'price_123',
  currency: 'USD',
});

切换提供者, 更改 default你的账单代码不变 使用 cashier.use(CashierProvider.Recurly) 并肩运行多个提供者.

为什么出纳

  • 一个接口. 方法相同,结果也相同,每个供应商都成型.
  • 数据一致. 以美分计的金额,大写 ISO 4217 货币, Date 时间戳.
  • 输入错误 . NotFoundError, (中文(简体) ), PaymentFailedError, (中文(简体) ), RateLimitError 以及更多,将提供者错误保留为 cause。 。 。 .
  • 框架就绪. 包括NestJS和快递包.
  • 没有额外的依赖性. 只有你安装的供应商SDK.

供应商

条纹 页:1 重现 v4.67或后. 节点.js 20或后.

软件包

文档

捐款

见 捐款额 财务报告和审定财务报表 警卫。 。 。 .

许可证

麻省理工学院 阿联酋

版本与发布记录

@aios-medical/cashier 共发布 12 个版本,首次发布于 2026/09/30;过去 12 个月发布了 12 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.7.0latest2026/10/1622 天前
1.6.02026/10/1424 天前
1.5.02026/10/1226 天前
1.4.12026/10/1127 天前
1.4.02026/10/1029 天前
1.3.02026/10/041 个月前

关于 @aios-medical/cashier 的常见问题

@aios-medical/cashier 是什么?

为Node.js和TypeScript统一订阅帐单. 一个API跨支付提供者,有打出错误和雀巢JS支持.

如何安装 @aios-medical/cashier?

在项目目录运行 npm install @aios-medical/cashier,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:stripe(^13.0.0)、recurly(^4.67.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@aios-medical/cashier 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@aios-medical/cashier 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@aios-medical/cashier 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@aios-medical/cashier 可以商用吗?

@aios-medical/cashier 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@aios-medical/cashier 的下载量有多少?

根据 npm 官方下载统计,@aios-medical/cashier 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,105 次,日均约 70 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@aios-medical/cashier 还在维护吗?

最新版本 1.7.0 发布于 2026/10/16(22 天前);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/09/30。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。