用途:帮助开发者正确接入 Stripe 支付能力,把收款、订阅与账单流程做扎实,减少重复扣款、Webhook 失败、订阅状态漂移等问题。
主要能力:涵盖一次性支付、订阅管理、账单门户、Webhook、Checkout Sessions、Payment Intents、Stripe Connect、按量计费(metered billing)、催缴(dunning)管理与支付失败处理。
核心实践:所有支付操作用幂等键防止重复扣款;把 Webhook 当作状态转移而非触发器;开发期全程使用测试模式和真实测试卡;以 Webhook 而非 API 响应为准判断支付状态;在 Checkout Session 中传递 metadata;处理全部订阅类 Webhook;单独处理 invoice.payment_failed;测试与正式环境使用不同密钥和代码路径。
已知注意点:必须验证 Webhook 签名;注意 JSON 中间件提前解析请求体会导致无法验证签名(资料以 Next.js App Router 场景举例);不要仅信任 API 响应;订阅状态检查需刷新;本地订阅状态避免与 Stripe 状态漂移。
要求:资料列出依赖 supabase-backend;相关技能包括 nextjs-supabase-auth、supabase-backend、webhook-patterns、security。具体命令、代码示例与安装方式资料未提供。