用途:该技能提供 Clerk Billing 与 Stripe 的完整集成方案,用于订阅管理、定价方案与支付处理。据资料,Clerk Billing 通过直连 Stripe 减少自定义 Webhook 与支付 UI 的需求,并处理界面、权益逻辑和会话感知的计费流程。
主要能力:在 Clerk Dashboard 启用计费并连接 Stripe(支持沙盒模式);配置用户级(B2C)与组织级(B2B)订阅计划、功能与用量限制、免费层和试用;使用 @clerk/nextjs 的 PricingTable 组件渲染定价表与内嵌支付表单;在前后端通过 useAuth/auth 的 has() 校验功能权益;提供订阅管理入口(查看方案、发票、更新支付方式、升降级、取消);可选自定义 Webhook 处理用量、通知与分析;包含脚本、模板与示例。
使用方式:运行 bash ./skills/billing-integration/scripts/setup-billing.sh 启用计费,configure-plans.sh 配置方案;复制 templates 下的 pricing-page.tsx、checkout-flow.tsx、subscription-management.tsx 等模板到项目中。要求 Next.js 13.4+ App Router、@clerk/nextjs 5.0+、Clerk 与 Stripe 账户,并配置 NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY 与 CLERK_SECRET_KEY 等环境变量。
限制:资料未提供具体价格、收费方式或实际效果数据;安全上不应硬编码凭据,API 路由需服务端校验权益并验证 Webhook 签名,生产使用 HTTPS。分类:依据其订阅计费与支付集成用途,归入编程与开发(coding)。