# @creem\_io/nextjs 中文文档

规范地址：https://npmcn.com/package/%40creem_io/nextjs/

版本：0\.6\.4
npm 元数据更新时间：2026-09-17T19:26:32.943Z
中文译文更新时间：2026-11-11T00:17:04.184Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40creem_io/nextjs
原文对照：https://npmcn.com/package/%40creem_io/nextjs/?lang=original
项目主页：https://github.com/armitage-labs/creem/tree/main/packages/integrations/nextjs
源码仓库：https://github.com/armitage-labs/creem

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：107 kB，10 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：next \>=13\.0\.0，react \>=18\.0\.0
- 首次发布：2025-11-18T10:45:28.139Z
- 最新版本发布：2026-09-17T19:26:32.588Z
- 近 30 天下载量：9795（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

Next.js 应用程序的克里姆支付集成

## 安装

```sh
npm install @creem_io/nextjs
```

也可以使用：`pnpm add @creem_io/nextjs`、`yarn add @creem_io/nextjs`、`bun add @creem_io/nextjs`

## README

# `@creem_io/nextjs`

退站 客户门户 并验证了Next.js App路由器的Webhook助手.

**完整文档:** [文件:creem.io/code/sdks/nextjs](https://docs.creem.io/code/sdks/nextjs)

## 安装

```bash
pnpm add @creem_io/nextjs
```

要求 Next.js 13 或 更新 和 React 18 或 更新 .

## 最小设置

创建检出路径 :

```typescript
// app/checkout/route.ts
import { Checkout } from "@creem_io/nextjs";

export const GET = Checkout({
  apiKey: process.env.CREEM_API_KEY!,
  testMode: true,
  defaultSuccessUrl: "/billing/success",
});
```

绘制出账链接 :

```tsx
import { CreemCheckout } from "@creem_io/nextjs";

export default function PricingPage() {
  return <CreemCheckout productId="prod_...">Subscribe</CreemCheckout>;
}
```

处理网络呼号 :

```typescript
// app/api/webhook/creem/route.ts
import { Webhook } from "@creem_io/nextjs";

export const POST = Webhook({
  webhookSecret: process.env.CREEM_WEBHOOK_SECRET!,
  onCheckoutCompleted: async ({ customer, product }) => {
    console.log(`${customer.email} purchased ${product.name}`);
  },
});
```

召回必须具有先验性,因为webhook的交付可以被重审. 给予或取消应用程序访问需要信任的用户ID; 遵循认证 在使用访问回调前在全指南中检查出模式 .

## 出口

| 导出 | 目的 |
| --- | --- |
| `CreemCheckout` | 构建与您的退出路径的链接 . |
| `CreemPortal` | 建立与您的客户端路径的链接 . |
| `Checkout` | 创建取出会话并重定向到 Creem . |
| `Portal` | 创建客户计费链接并重定向到门户网站. |
| `Webhook` | 验证和发送克里姆网络新闻活动. |

见 [Next.js 适配器指南](https://docs.creem.io/code/sdks/nextjs) 所有道具,路线设置, 访问回调 和安全指导. 见 [常见的](https://docs.creem.io/code/sdks/nextjs#common-gotchas) 用于 webhook 字段名称, 时间戳、取出金额和元数据.

## 实例与发展

-   [可运行示例](https://npmcn.com/package/%40creem_io/nextjs/example)
-   [贡献指南](https://npmcn.com/CONTRIBUTING.md)

从寄存器根 :

```bash
pnpm --filter @creem_io/nextjs build
pnpm --filter @creem_io/nextjs typecheck
pnpm --filter @creem_io/nextjs check:package
```

## 许可证

[麻省理工学院](https://npmcn.com/package/%40creem_io/nextjs/LICENSE)

## 常见问题

### @creem\_io/nextjs 是什么？

Next\.js 应用程序的克里姆支付集成

### 如何安装 @creem\_io/nextjs？

在项目目录运行 npm install @creem\_io/nextjs，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：next（\>=13\.0\.0）、react（\>=18\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @creem\_io/nextjs 支持 TypeScript 吗？

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

### @creem\_io/nextjs 支持 ESM 还是 CommonJS？

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

### @creem\_io/nextjs 可以商用吗？

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

### @creem\_io/nextjs 的下载量有多少？

根据 npm 官方下载统计，@creem\_io/nextjs 在 2026/10/11 – 2026/11/09 这 30 天内被下载 9,795 次，日均约 327 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @creem\_io/nextjs 还在维护吗？

最新版本 0\.6\.4 发布于 2026/09/18（1 个月前）；至今共发布 14 个版本，其中过去 12 个月发布了 14 个；首次发布于 2025/11/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。