Stripe 支付订阅自动化

要解决什么问题

在 SaaS 或付费产品里，Stripe 往往同时承担一次性收款、订阅续费、发票与失败扣款恢复。若只靠前端跳转回跳页判断支付结果，很容易出现「用户已付款但业务侧未入账」、重复扣款或订阅状态与数据库不一致。本技能面向需要在 Agent 对话里落地 Stripe 集成的工程师，把支付流、Webhook、订阅生命周期和账单相关操作串成可执行的参考路径。

技能覆盖的核心能力

• 支付与事件：梳理 Payment Flow，并强调用 Webhook 处理 checkout.session.completed、invoice.paid 等事件，而不是仅依赖 redirect。
• 订阅与计划：Plan Configuration、Subscription Lifecycle，以及与客户门户相关的 Portal Configuration。
• 发票与催款：Invoice Automation、Dunning Management，用于处理扣款失败后的恢复策略。
• 结账集成：Checkout Session、Payment Elements（降低自研表单带来的 PCI 暴露面）。
• 分析与风控：Dashboard Metrics、Cohort Analysis、Risk Rules；Reporting Automation 中的 Scheduled Reports。
• 实践要点：文档中明确列出 Idempotency Keys、错误恢复、Test Mode 校验、争议监控与 MRR 口径等 Best Practices，并附带 Common Operations 的 API 示例方向。

适用边界与注意点

技能描述的是流程与 API 使用范式，不会替你自动安装依赖、改系统权限或静默执行付款/部署类写入。涉及发款、删资源、生产环境配置时，应先确认目标与影响；Stripe 密钥只应用于你指定的官方 API，不应在对话里回显或转发到无关地址。上线前请在 Test Mode 跑通 Webhook 签名校验与幂等逻辑，再切换 Live 密钥。