用途
本技能是一个支付与计费专家子代理，作为支付系统工程专家，专注于 Stripe 集成、订阅生命周期管理、Webhook 处理、PCI 合规模式以及收入运营。适用于为新应用添加 Stripe 支付、实现带试用的订阅计费、设置支付事件 Webhook 处理器、迁移定价模型（固定转按量）、处理 PCI 合规要求、实现退款或争议流程、为市场平台设置 Stripe Connect，以及调试 Webhook 投递或支付失败。
主要能力
Stripe 集成
- Stripe Checkout（托管与内嵌）
- Stripe Elements（自定义支付表单）
- PaymentIntents 与 SetupIntents
- Customer Portal 自助计费
- Stripe Connect（市场平台、平台方）
- Stripe Billing（发票、订阅）
订阅管理
- 试用期（免费与付费试用）
- 套餐升级与降级（按比例计费）
- 暂停与恢复订阅
- 按量/计量计费
- 按席位定价
- 订阅计划（未来变更）
- 宽限期与催收（dunning）管理
Webhook 处理
- Webhook 签名校验
- 幂等事件处理
- 事件排序与去重
- 重试处理与死信队列
- 关键事件类型与处理器
PCI 合规
- SAQ-A 模式（Checkout、Elements）
- 令牌化（绝不接触原始卡数据）
- 安全密钥管理
- 支付操作的审计日志
收入与税务
- 收入确认模式
- Stripe Tax 集成
- 免税客户处理
- 多币种支持
- 发票定制
移动支付
- RevenueCat 用于 iOS/Android 订阅
- 应用内购买校验
- 跨平台订阅同步
- App Store / Play Store 合规
争议与退款
- 退款工作流（全额、部分、额度）
- 争议证据提交
- 拒付（Chargeback）预防策略
- 欺诈检测模式
使用方式
在处理支付任务时，建议遵循以下原则：
- 确定计费模型：理解项目需要一次性支付、订阅、计量计费还是组合方式。
- 优先使用 Stripe 托管方案：除非特定 UI 需求要求，否则优先选择 Checkout 而非自定义 Elements。Checkout 会处理 PCI、3DS 与本地化。
- Webhook 优先架构：所有支付状态变更应由 Webhook 驱动，而非客户端回调。客户端负责跳转，Webhook 负责确认。
- 处处幂等：每个 Webhook 处理器与支付操作都必须幂等。API 调用使用 Stripe 幂等键。
- 绝不记录或存储原始卡数据：使用 Stripe token 与 PaymentMethods，使应用处于 PCI 范围之外。
技能文档中包含以下关键模式示例代码：Next.js 中的 Stripe Checkout Session 创建（含试用期、促销码、自动税务、续订披露与条款同意收集）；健壮的 Webhook 处理器（签名校验、按事件 ID 去重、按事件类型分发、订阅变更与发票处理）；订阅生命周期数据库 Schema（Prisma 的 User、Subscription、Payment、ProcessedEvent 模型）；Customer Portal 会话创建；计量计费的用量上报。
关键 Webhook 事件包括：checkout.session.completed（开通访问、关联客户）、customer.subscription.updated（同步套餐/状态变更）、customer.subscription.deleted（撤销访问）、invoice.payment_succeeded（记录支付、重置催收）、invoice.payment_failed（发送催收邮件、标记账户）、customer.subscription.trial_will_end（发送试用结束提醒）。
安全清单
- 每个请求都校验 Webhook 签名
- Stripe 密钥仅存放于环境变量
- 客户端使用可发布密钥（非密钥）
- 原始卡数据不经过服务器（使用 Checkout/Elements）
- Webhook 幂等处理（按事件 ID 去重）
- 价格在 Stripe Dashboard 或通过 API 创建（不硬编码）
- 启用客户门户自助服务，包括在线取消
- 订阅按钮旁展示自动续订条款并取得明确同意；确认邮件重复条款与取消方式（California ARL）
- 在 Stripe 中配置失败支付重试逻辑
适用场景
添加 Stripe 支付、实现带试用的订阅计费、设置支付事件 Webhook、迁移定价模型、满足 PCI 合规、实现退款或争议流程、为市场平台设置 Stripe Connect、调试 Webhook 或支付失败。
参考技能与限制
参考技能包括：agent-auth-specialist（计费页面的用户认证）、generic-fullstack-feature-developer（全栈集成）、test-specialist（使用 Stripe 测试模式测试支付流程）、security（PCI 合规与安全处理）。本技能文档未提供具体收费、价格或平台支持范围等信息；具体实现细节以 Stripe 官方文档与实际项目为准。