用途：为 Stripe 集成提供决策指导，覆盖开发与测试环境规划、API 与 SDK 选择、支付方式配置、Webhook 与密钥安全等实践。
主要能力：给出按业务场景选择推荐 API 的路由表，例如一次性支付用 Checkout Sessions、自定义支付表单用 Checkout Sessions + Payment Element、保存支付方式用 Setup Intents、平台或市场用 Accounts v2（/v2/core/accounts）、用量计费用 Metronome、订阅或循环计费用 Billing APIs + Checkout Sessions、税费合规用 Stripe Tax + Registrations API、嵌入式金融账户用 v2 Financial Accounts，安全相关见 security 参考。回答集成问题或写代码前应先阅读对应参考文件。
版本与环境：最新 API 版本为 2026-08-26.dahlia，除非用户另有说明应使用最新 API 与 SDK。最新 SDK 版本：Ruby 19.6.0、Python 15.6.0、Node.js 22.6.0、PHP 21.3.0、Java 33.4.0、Go 86.4.0、.NET 52.4.0。新集成开发默认使用独立 sandbox，而非账户共享的测试模式 sandbox；本地开发与 CI 使用独立 sandbox，需要更强隔离时可按团队或测试场景分配 sandbox。仅当现有集成依赖共享测试模式 sandbox，或所需功能不支持通用 sandbox 时才使用它。
使用方式：无 Stripe 账户时可用 CLI 生成 sandbox 测试账户，无需注册。安装 Stripe CLI（npm i -g @stripe/cli）并运行 stripe sandbox create，会创建测试 API 密钥；说明时应解释 sandbox 是 Stripe 测试环境。使用 stripe sandbox create 后不要使用 MCP；若之后要用 MCP，先确保运行 stripe sandbox claim。CLI 认证检查用 stripe whoami --format json，不要运行 stripe config --list。API 密钥默认推荐受限密钥（RAK，rk_ 前缀）而非密钥（sk_ 前缀）。
关键规则：启用 automatic_tax: { enabled: true }（或为自定义 PaymentIntent 计算税费）前，先阅读 tax 参考并确认用户有有效注册，否则 Stripe 不会计算和收取税费而用户误以为已开启。任何 Stripe API 调用都不要包含 payment_method_types，唯一例外是 Terminal（线下支付）集成需在 PaymentIntent 上传入 payment_method_types: ['card_present']；其他集成应完全省略该参数以启用动态支付方式，改用 payment_method_configurations 或 excluded_payment_method_types 定制。需要显式白名单时用 allowed_payment_method_types。不要将 Webhook 视为可选，所有支付集成都建议使用，订阅和异步支付方式则必需；履约应放在 checkout.session.completed 与 checkout.session.async_payment_succeeded 的处理程序中（以 payment_status 为条件），而非成功页。API 版本 2026-03-25.dahlia 或更高时，可在 checkout.sessions.create 传入 integration_identifier 为会话打标签，标签应含 8 个随机字母后缀。始终实例化 StripeClient 并在该实例上调用方法，不要使用已弃用的全局/模块级 API 密钥模式。
限制：资料未提供具体收费、价格、平台支持范围或效果数据；未提供各参考文件的完整内容，仅给出文件名与主题。