SuperAPI AI 工具集

billing

通用与其它

查看项目

更新于 10-15 21:51

技能介绍

用途:在 Convex 应用中加入 Stripe 计费/支付/订阅能力,使用组件 @convex-dev/stripe 完成结账、网络钩子与订阅门控。

主要能力:提供 checkout action;通过组件注册的 httpAction webhook 自动完成签名校验;订阅状态保存在组件表中;通过查询在服务端做订阅门控。

必要用法:安装 npm install @convex-dev/stripe;在 convex/convex.config.ts 中 app.use(stripe),注意需从 '@convex-dev/stripe/convex.config.js' 导入(.js 扩展名为 Convex 打包器要求)。将 STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET 存入 Convex 环境变量。在 convex/http.ts 用 httpRouter 与 registerRoutes(http, components.stripe, { webhookPath: '/stripe/webhook' }) 注册路由。在 convex/billing.ts 中创建 StripeSubscriptions 实例,编写 createSubscriptionCheckout action 与 isSubscribed 查询。执行 npx convex dev --once 安装组件并推送函数。在 Stripe Dashboard → Webhooks 添加 https://<deployment>.convex.site/stripe/webhook,订阅 checkout.session.completed、customer.subscription.、invoice.、payment_intent.* 事件,并将签名密钥设为 STRIPE_WEBHOOK_SECRET。

规则与限制:使用 npm 包 @convex-dev/stripe@^0.1.4,由 registerRoutes 内部处理签名验证,不要手写 constructEvent webhook;密钥放 Convex 环境变量;订阅门控应基于服务端存储的订阅状态(isSubscribed 查询读取组件表),而不是客户端声明。

适用场景:需要为 Convex 后端快速接入 Stripe 订阅制付费与权限控制的开发者。

未提供:价格、收费模式、平台与效果等资料暂未提供。