用途:该技能聚焦 Stripe 集成中真正出问题的“接缝”——数据库里的权益与 Stripe 里的资金如何保持一致。涉及结账(checkout)、订阅生命周期、席位与按比例计费(proration)、取消与挽留、退款、对账,以及支付渠道集中度风险。
主要能力:提供分主题的按需参考文档,包括 stripe-agent-toolchain.md(CLI、MCP、密钥处理)、webhook-events.md(事件目录、载荷结构、顺序与失败语义)、subscription-lifecycle.md(结账、验证、续费、席位、套餐变更、试用、追回)、cancellation-and-retention.md、price-integrity.md、testing-and-local-dev.md、provider-concentration.md。示例为 TypeScript,规则与语言无关。
核心原则:金额、税费、发票、催收与支付方式属于 Stripe;谁可用什么、多少席位、授予什么信用属于你自己的系统,两者只以 id 关联。Webhook 才是支付事实;重定向只能证明浏览器行为。需先占用事件(claim)再处理,用原始请求体校验签名,并按 billing_reason 决定是否授予权益,用标记防止同一周期重复授予。退款金额是累计值,需按增量计算并用比较交换写入。金额以最小货币单位在边界处一次转换。
使用方式与限制:需自行配置 STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET 等环境变量,固定 apiVersion,依赖 SDK 的 maxNetworkRetries 与幂等键,勿手写重试循环。本地开发与测试矩阵见参考文档。关于定价、计量计费、税务与 Connect 的选择,以官方 stripe-best-practices 技能为准。资料未提供价格、收费方式与具体平台支持信息。