@creem_io/nextjs

中文文档
0.6.4发布于 2026/09/18MITTypeScriptESM + CJS构建来源已验证近 30 天下载 9795

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

中文使用文档
文档目录5 节
  1. 安装
  2. 最小设置
  3. 出口
  4. 实例与发展
  5. 许可证

@creem_io/nextjs

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

完整文档: 文件:creem.io/code/sdks/nextjs

安装

pnpm add @creem_io/nextjs

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

最小设置

创建检出路径 :

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

绘制出账链接 :

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

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

处理网络呼号 :

// 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 适配器指南 所有道具,路线设置, 访问回调 和安全指导. 见 常见的 用于 webhook 字段名称, 时间戳、取出金额和元数据.

实例与发展

从寄存器根 :

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

许可证

麻省理工学院

版本与发布记录

@creem_io/nextjs 共发布 14 个版本,首次发布于 2025/11/18;过去 12 个月发布了 14 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.6.4latest2026/09/181 个月前
0.6.32026/09/171 个月前
0.6.22026/09/161 个月前
0.6.12026/09/161 个月前
0.5.72026/09/092 个月前
0.5.62026/09/042 个月前

关于 @creem_io/nextjs 的常见问题

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