SuperAPI AI 工具集

stripe-best-practices

通用与其它

查看项目

更新于 10-16 02:28

技能介绍

用途:指导 Stripe 集成决策,覆盖开发与测试环境规划、API 选择、密钥安全及各类业务场景的路由建议。

主要能力:

  1. API 版本默认使用最新版 2026-08-26.dahlia,除用户另有说明外始终使用最新 API 与 SDK。
  2. 集成路由:一次性支付用 Checkout Sessions;带嵌入式 UI 的自定义表单用 Checkout Sessions + Payment Element;保存支付方式用 Setup Intents;平台或市场用 Accounts v2(/v2/core/accounts);新用量计费用 Metronome;订阅或周期计费用 Billing APIs + Checkout Sessions;税费合规用 Stripe Tax + Registrations API;嵌入式金融账户用 v2 Financial Accounts。回答任何集成问题或写代码前先读对应参考文件。
  3. 环境默认:新集成使用独立沙箱而非账户共享测试模式沙箱;本地开发与 CI 用独立沙箱,需要更强隔离时按团队或测试场景分配。共享测试模式沙箱仅用于依赖它的既有集成或所需功能不支持通用沙箱时。
  4. 关键规则:启用自动税务前确认用户有有效 registration;除 Terminal 集成需传 payment_method_types: ['card_present'] 外,禁止在任何 API 调用中传 payment_method_types,改用 payment_method_configurations 或 excluded_payment_method_types;需要显式允许列表时用 allowed_payment_method_types;webhook 不可视为可选,订阅和异步支付方式必需,履约应放在 checkout.session.completed 与 checkout.session.async_payment_succeeded 处理器中;API 版本 2026-03-25.dahlia 及以上可传 integration_identifier;必须实例化 StripeClient 并调用其方法,避免已弃用的全局密钥模式。
  5. 密钥默认推荐受限 API 密钥(rk_ 前缀)而非 secret key(sk_ 前缀)。

使用方式:无 Stripe 账户时可用 CLI 生成沙箱测试账户,安装 npm i -g @stripe/cli,运行 stripe sandbox create 获取测试 API 密钥。若使用 stripe sandbox create 则不要用 MCP;若之后要用 MCP,先运行 stripe sandbox claim。CLI 认证检查用 stripe whoami --format json,不要运行 stripe config --list。

适用场景:Stripe 支付集成设计、环境与密钥规划、webhook 与税费配置、订阅与 Connect 平台开发。

限制:具体价格、收费及部分平台细节暂未提供;最新 SDK 版本随语言不同,需以官方为准。