SuperAPI AI 工具集

stripe-best-practices

编程与开发

查看项目

更新于 10-16 03:05

技能介绍

用途:为 Stripe 集成决策提供指引,在回答集成问题或编写代码前先查阅对应参考文件。

主要能力与选型建议:一次性支付用 Checkout Sessions;嵌入式支付表单用 Checkout Sessions + Payment Element;保存支付方式用 Setup Intents;Connect 平台或市场用 Accounts v2(/v2/core/accounts);按用量计费(新集成)用 Metronome;订阅或周期计费用 Billing APIs + Checkout Sessions;销售税、VAT 或 GST 合规用 Stripe Tax + Registrations API;嵌入式金融账户或银行用 v2 Financial Accounts;安全相关见安全参考。

版本约定:最新 Stripe API 版本为 2026-07-29.dahlia;除非用户另有说明,应使用最新 API 版本与 SDK。资料给出的 SDK 最新版本为 Ruby 19.4.0、Python 15.4.0、Node.js 22.4.0、PHP 21.1.0、Java 33.2.0、Go 86.2.0、.NET 52.2.0。

必要用法:没有 Stripe 账户时,可安装 Stripe CLI(npm i -g @stripe/cli)并运行 stripe sandbox create 生成可用的 API 密钥,无需注册;使用了该命令就不要用 MCP,若之后再尝试 MCP,需先运行 stripe sandbox claim。CLI 认证检查用 stripe whoami --format json,不要运行 stripe config --list。API 密钥默认推荐受限密钥(RAK,rk_ 前缀)而非密钥(sk_ 前缀)。

关键规则:启用 automatic_tax: { enabled: true } 或为自定义 PaymentIntent 计税前,先阅读税务参考并确认用户有有效注册。除 Terminal(线下支付,需在 PaymentIntent 上传 payment_method_types: ['card_present'])外,任何 Stripe API 调用都不要包含 payment_method_types;如需自定义可用支付方式,改用 payment_method_configurations 或 excluded_payment_method_types。在 API 版本 2026-03-25.dahlia 或更高版本上,向 checkout.sessions.create 传入 integration_identifier,并附带 8 个随机字母后缀。始终实例化 StripeClient 并在该实例上调用方法,不使用已废弃的全局/模块级 API 密钥写法。

适用场景与限制:适用于支付、计费、Connect、税务、Treasury 与安全等集成决策;其他计费细节、参考文件完整内容及更多平台信息暂未提供。