SuperAPI AI 工具集

Integrating Stripe Payments

编程与开发

查看项目

更新于 11-13 10:03

技能介绍

用途:本技能用于指导开发者将 Stripe 支付集成到 Convex + Next.js 应用中,支持订阅制(循环计费)和一次性付款两种模式,默认推荐使用托管式 Stripe Checkout 以降低复杂度并提升稳定性和移动端兼容性。技能要求后端为 Convex,非 Convex 项目不适用。

主要能力:技能以阶段化流程覆盖集成全过程。第一阶段为需求访谈,需确认支付类型(订阅或一次性)、后端是否为 Convex、结账方式(推荐托管 Checkout)、价格金额与货币、订阅计费周期、产品名称及付款后用户获得的权益。第二阶段安装依赖,仅需安装服务端 stripe 包(npm install stripe),托管模式无需 @stripe/stripe-js 或 @stripe/react-stripe-js;并在 convex/schema.ts 的 users 表中增加 membershipStatus、membershipExpiry、stripeCustomerId、stripeSubscriptionId 字段及相应索引。第三阶段配置 API 密钥:在 Stripe Dashboard 获取测试密钥,创建产品与价格并复制 Price ID,在 Convex Dashboard 设置 STRIPE_SECRET_KEY、STRIPE_PRICE_ID、STRIPE_WEBHOOK_SECRET,在 .env.local 设置 NEXT_PUBLIC_SITE_URL。第四阶段代码实现:提供 convex/stripe.ts 中创建结账会话、查询结账状态、创建客户门户会话的 action 示例;convex/stripeDb.ts 中按 Clerk ID 查询用户、更新客户 ID、更新会员状态、取消会员、处理付款失败的内部函数;convex/http.ts 中 Webhook 处理示例,涵盖 checkout.session.completed、customer.subscription.updated、customer.subscription.deleted、invoice.payment_failed、invoice.paid 等事件,并强调使用 .convex.site 域名及 constructEventAsync,以及从 subscription.items.data[0] 获取 current_period_end。

使用方式:按技能中的阶段顺序执行:先完成需求访谈,再安装依赖并更新数据库 schema,然后配置 Stripe 产品、价格与环境变量,最后按示例代码创建 Stripe actions、数据库辅助函数和 Webhook 路由,并在 Stripe Dashboard 配置 Webhook 端点。资料中未提供 Webhook 密钥的具体获取步骤之外的更多配置细节。

适用场景:为 Convex + Next.js 应用添加订阅计费、一次性付款、客户自助管理订阅与发票,以及需要避免 Stripe 与 Convex 集成常见错误的项目。

限制:仅适用于 Convex 后端;资料未说明其他后端适配方式。未提供具体价格、收费或效果承诺。资料中部分代码内容在展示中被截断,完整实现需参考原始技能页面。