SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场stripe-agent

stripe-agent

编程与开发

查看项目

更新于 10-15 09:53

技能介绍

Stripe Agent 是一个面向 Claude 的 Stripe 集成技能，使 Claude 能够与 Stripe API 交互，完成支付与订阅管理。以下按用途、主要能力、使用方式、适用场景和限制说明。

一、用途 该技能用于在 Claude 中处理支付、订阅、账单以及市场平台（Marketplace）管理相关的任务。当 Claude 需要与 Stripe API 打交道时使用本技能。

二、前置条件 需要确保已设置 STRIPE_SECRET_KEY 环境变量。若需处理 webhook，还需设置 STRIPE_WEBHOOK_SECRET：

export STRIPE_SECRET_KEY="sk_test_..." export STRIPE_WEBHOOK_SECRET="whsec_..."

并安装 Stripe SDK（建议使用虚拟环境隔离）：

pip install stripe

三、核心工作流

  1. 客户管理：在任何支付操作之前先创建和管理客户。可通过 stripe.Customer.create() 创建，并支持 retrieve / modify / list 等操作。
  2. 产品与价格：始终先创建 Product，再附加 Price，可使用 lookup_key 便于检索价格。支持循环价格（订阅）和一次性价格。
  3. Checkout 会话（网页端推荐）：使用 Checkout Sessions 提供安全、托管的支付页面，支持订阅模式与 metadata。
  4. 订阅管理：可直接创建订阅（需已有支付方式），支持修改订阅（更改套餐，使用 proration_behavior）、取消订阅（立即取消或到期取消）。
  5. 支付意图（自定义集成）：在需要完全控制支付流程时使用 PaymentIntent，将 client_secret 返回前端。
  6. Webhook 处理：对订阅生命周期至关重要。需要处理的关键事件包括：checkout.session.completed（支付成功）、customer.subscription.created（新订阅）、customer.subscription.updated（套餐变更）、customer.subscription.deleted（取消）、invoice.paid（续费成功）、invoice.payment_failed（支付失败）。使用 stripe.Webhook.construct_event 校验事件。

四、集成与附加能力

  • Firebase 集成模式：将 Stripe customer_id 存储在 Firestore 用户文档中，通过 webhook 将订阅状态同步到 Firestore，并使用 Firebase Security Rules 检查订阅状态。详见 references/firebase-integration.md。
  • 常用操作速查：创建客户、开始订阅、取消订阅、更改套餐、退款（stripe.Refund.create）、获取发票（stripe.Invoice.list）、创建门户会话等。
  • 客户门户（自助服务）：使用 stripe.billing_portal.Session.create 生成门户会话并跳转。
  • 支付链接（无代码支付）：使用 stripe.PaymentLink.create 创建支付链接并分享。

五、测试与错误处理 测试使用测试模式密钥（sk_test_...）与测试卡号，例如 4242424242424242（成功）、4000000000000002（拒付）、4000002500003155（需要 3D Secure）。错误处理方面，可捕获 stripe.error.CardError、InvalidRequestError、AuthenticationError、StripeError 等异常并作相应处理。

六、高级功能 以下主题的详细代码示例见 references/stripe-patterns.md：计量与基于用量的计费（API 调用、席位、分层定价）、Stripe Connect（市场平台：关联账户、平台费用、转账）、税务计算（Stripe Tax，结账自动计税）、3D Secure 与 SCA 合规（欧盟/英国强客户认证）、欺诈防护（Stripe Radar：风险评估、自定义规则）、争议处理（拒付、证据提交）、幂等性（防止重复操作）。

七、脚本与参考资料 脚本包括：scripts/setup_products.py（创建产品与价格）、scripts/webhook_handler.py（Flask webhook 端点）、scripts/sync_subscriptions.py（同步订阅到数据库）、scripts/stripe_utils.py（常用工具函数）。参考资料包括：references/stripe-patterns.md（计量计费、Connect、税务、3DS、Radar、争议、幂等模式）、references/firebase-integration.md（Firebase + Firestore 集成）、references/api-cheatsheet.md（API 快速参考）。

八、适用场景与限制 该技能适用于需要以编程方式处理 Stripe 支付、订阅、账单与市场平台的开发场景，尤其是结合 Claude 自动化处理相关任务时。限制方面：需要在环境中正确配置密钥并安装 SDK；涉及 webhook、退款、Connect 等操作需依赖真实 Stripe 账户配置；使用前应使用测试模式验证。资料未提供价格、收费、平台兼容性、性能或效果方面的说明，上述内容暂未提供。