用途:为 SaaS 产品构建生产级 Stripe 计费集成。支持从零搭建订阅计费,或新增升级/降级、按量计费、功能门控、催款恢复与欧洲 SCA/3D Secure 合规。
主要能力:固定版本 Stripe 客户端与集中式套餐配置;带试用、税费和促销码的 Checkout 会话;订阅状态机(trialing→active→past_due→canceled)及升级降级、按比例计费预览、重新激活;幂等 webhook(签名校验、事件去重、从 API 重新获取、重试安全);按量计量的用量记录与按套餐功能门控、宽限期访问;催款邮件序列与 PSD2/3D Secure 认证流程;本地测试使用 Stripe CLI 转发 webhook、触发事件和测试卡矩阵。
使用方式:先确认三项输入——框架(Next.js/Express/Django)、计费模型(固定订阅/按量计费/试用与按比例计费)、范围(Checkout、幂等 webhook、催款或 SCA/3D Secure)。若信息不清应先询问;如用户要求直接起草,则在产出开头列出假设。按任务加载对应参考文档:payment-flows.md(客户端、Checkout、客户门户、SCA)、subscriptions.md(生命周期、升降级、按量计费、Prisma 模式)、webhooks.md(完整幂等处理器)、testing-and-troubleshooting.md(CLI 测试与排错)。
适用场景:Next.js/Express/Django 上的 SaaS 订阅计费;带正确按比例计费的套餐变更;加固或调试 webhook 端点;按量计费与功能门控;催款恢复或 SCA/3D Secure 合规。
限制:不覆盖 Stripe Connect、无订阅的一次性支付、税费计算与申报、支付欺诈检测与争议管理。具体价格、收费与平台支持范围资料暂未提供。