SuperAPI AI 工具集

convex-billing

通用与其它

查看项目

更新于 10-16 03:06

技能介绍

用途:为 Convex 应用接入 Stripe 订阅与支付,覆盖结账、webhook 和基于订阅的服务端门控。

主要能力:使用 @convex-dev/stripe 组件提供结账 action、由组件注册并自动校验签名的 webhook(registerRoutes,无需手写 constructEvent)、订阅状态存于组件表中,并通过 isSubscribed 查询读取组件表做服务端门控。

使用方式:安装组件 npm install @convex-dev/stripe;在 convex/convex.config.ts 中用 app.use(stripe) 启用,注意 import 必须来自 '@convex-dev/stripe/convex.config.js'(.js 扩展名是 Convex 打包器要求);在 Convex 环境变量中配置 STRIPE_SECRET_KEY 与 STRIPE_WEBHOOK_SECRET;创建 convex/http.ts 并以 registerRoutes(http, components.stripe, { webhookPath: "/stripe/webhook" }) 注册路由;在 convex/billing.ts 中定义 createSubscriptionCheckout action 与 isSubscribed 查询,通过 stripeClient.getOrCreateCustomer、createCheckoutSession 创建订阅结账;运行 npx convex dev --once 安装组件并推送函数,确认输出显示已安装组件 stripe;在 Stripe Dashboard 添加 webhook 端点 https://<deployment>.convex.site/stripe/webhook,订阅 checkout.session.completed、customer.subscription.、invoice.、payment_intent.* 事件,并将签名密钥填入 STRIPE_WEBHOOK_SECRET。

适用场景:Convex 后端需要 Stripe 订阅计费与付费访问控制的场景。

限制与说明:需已配置 Convex 认证以获取用户身份,未认证会抛错;结账依赖 SITE_URL 或默认本地地址;门控应基于服务端存储的订阅状态而非客户端声明;其余价格、平台或收费细节暂未提供。