用途:该技能用于指导在应用中正确集成 Stripe,涵盖从一次性支付到订阅、账单门户、Webhook、计量计费与 Stripe Connect 的完整收款流程,定位为支付工程实践指南。
主要能力:包含 stripe-payments、subscription-management、billing-portal、stripe-webhooks、checkout-sessions、payment-intents、stripe-connect、metered-billing、dunning-management、payment-failure-handling 等能力项。
核心模式:所有支付操作使用幂等键防止重复扣款;将 Webhook 视为状态转换而非触发器;开发全程使用 Stripe 测试模式与真实测试卡。
反模式:不要盲目信任 API 响应;不要跳过 Webhook 签名验证;不要在不刷新的情况下检查订阅状态。
关键风险与处理:未验证 Webhook 签名(critical,始终验证签名);JSON 中间件在 Webhook 验证前解析 body(critical,Next.js App Router 需注意);支付操作未用幂等键(high);用 API 响应而非 Webhook 判断支付状态(critical,采用 Webhook 优先架构);Checkout Session 未传 metadata(high);本地订阅状态与 Stripe 漂移(high,处理所有订阅 Webhook);未处理失败支付与催款(high,处理 invoice.payment_failed);测试与生产模式代码路径不一致(high,分离所有密钥)。
要求:supabase-backend。相关技能:nextjs-supabase-auth、supabase-backend、webhook-patterns、security。
限制:资料未提供具体安装命令、价格、平台支持范围与完整代码示例,相关细节暂未提供。