让开源，少一点语言距离。
npm包中文文档

@aios-medical/cashier

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

Unified subscription billing for Node.js and TypeScript. One API across payment providers, with typed errors and NestJS support.

原始使用文档
中文原文
文档目录6 节
  1. Why Cashier
  2. Providers
  3. Packages
  4. Documentation
  5. Contributing
  6. License

Cashier

npm License: MIT

Unified subscription billing for Node.js and TypeScript. One API for every payment provider, with typed errors. Stripe and Recurly are supported today.

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',
});

To switch providers, change default. Your billing code stays the same. Use cashier.use(CashierProvider.Recurly) to run several providers side by side.

Why Cashier

  • One interface. Same methods and the same result shapes on every provider.
  • Consistent data. Amounts in cents, uppercase ISO 4217 currencies, Date timestamps.
  • Typed errors. NotFoundError, PaymentFailedError, RateLimitError and more, with the provider error kept as cause.
  • Framework ready. NestJS and Express packages included.
  • No extra dependencies. Only the provider SDKs you install.

Providers

Stripe v13 and Recurly v4.67 or later. Node.js 20 or later.

Packages

Documentation

Contributing

See CONTRIBUTING.md and SECURITY.md.

License

MIT © AIOS

版本与发布记录

@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 是什么？

Unified subscription billing for Node.js and TypeScript. One API across payment providers, with typed errors and NestJS support.

如何安装 @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 和提交记录判断。