支付集成
支付模块是可选的。启用后,登录用户可通过 Stripe Checkout 以一次性 $9.00 USD 升级终身高级版(Lifetime Premium),解锁每月 300 次 AI 录入、高级分析报表与 A4 PDF 导出,以及开放 API / MCP 的重复检测与优化建议端点。必需环境变量
SUPABASE_URL、SUPABASE_PUBLISHABLE_KEY、SUPABASE_SECRET_KEY,并应用至 20260927012800_payment_lifecycle.sql 的数据库迁移)。
支付相关 Functions
create-checkout-session.ts:创建一次性 Stripe Checkout 会话。启用 Supabase 时强制校验用户登录态,由服务端确定用户身份、邮箱与唯一受信任的STRIPE_PRICE_ID(不信任浏览器传入的价格参数),并执行STRIPE_MODE与PRODUCTION_SUPABASE_URL环境隔离校验。checkout-status.ts:用户支付跳回/app后向 Stripe 实时核对会话状态,支持即时银行卡与异步支付方式,绝不单凭回跳 URL 参数直接开通权益。stripe-webhook.ts:校验 Stripe 签名、livemode模式一致性、支付状态与STRIPE_PRICE_ID,并通过幂等事务完成高级版开通以及全额退款、争议扣款时的权益自动对账与回收。未配置 Supabase 的自托管实例仍可使用匿名赞赏模式(不发放高级版)。
Stripe Dashboard 配置步骤
- 创建 Product(例如
SteadyRenew Lifetime Premium)。 - 新建 One-time(一次性) Price:$9.00 USD(请勿复用旧的 $6 Price)。
- 将生成的
price_...填入服务端环境变量STRIPE_PRICE_ID。 - 新建 Webhook Endpoint:
- 勾选
stripe-webhook.ts处理的全部 11 个生命周期事件:- 支付完成:
checkout.session.completed、checkout.session.async_payment_succeeded - 退款状态:
charge.refunded、refund.created、refund.updated、refund.failed - 争议处理:
charge.dispute.created、charge.dispute.updated、charge.dispute.closed、charge.dispute.funds_withdrawn、charge.dispute.funds_reinstated
- 支付完成:
- 将签名密钥写入
STRIPE_WEBHOOK_SECRET。
与开放 API / MCP 限额的关系
Free 与 Premium 账户的开放 API 密钥上限(5 个有效 Key)及请求速率上限(每分钟 60 次)完全一致,不做限流分级。升级终身高级版在 API / MCP 侧解锁的是 /api/v1/analytics/duplicates(重复订阅检测)与 /api/v1/analytics/optimizations(优化建议)两个高阶分析端点。
本地联调 Webhook
启动npm run dev:full 后,使用 Stripe CLI 转发事件到本地: