SuperAPI AI 工具集

stripe-integration

编程与开发

查看项目

更新于 10-16 09:47

技能介绍

用途:该技能面向支付工程实践,用于指导在应用中正确实现 Stripe 支付流程,覆盖收款、订阅、账单门户、Webhook、Checkout 会话、PaymentIntent、计量计费、Stripe Connect、催缴(dunning)与支付失败处理。

主要能力:包含 stripe-payments、subscription-management、billing-portal、stripe-webhooks、checkout-sessions、payment-intents、stripe-connect、metered-billing、dunning-management、payment-failure-handling。

必要用法与模式:所有支付操作使用幂等键以防重复扣款;将 Webhook 视为状态转换而非触发器,采用 Webhook 优先架构;开发全程使用 Stripe 测试模式与真实测试卡;Checkout Session 需传递 metadata;处理全部订阅相关 Webhook;分别管理测试与正式环境密钥。

已知的限制与风险点:不验证 Webhook 签名、JSON 中间件在验签前解析请求体、支付操作缺少幂等键、仅信任 API 响应而不依赖 Webhook 判断支付状态、本地订阅状态与 Stripe 状态漂移、未处理支付失败与催缴、测试与正式模式代码路径不一致,均属高危问题。资料提到依赖 supabase-backend,并可与 nextjs-supabase-auth、webhook-patterns、security 配合使用。除上述内容外,具体代码示例、价格与收费等细节暂未提供。