用途：指导开发者升级 Stripe API 版本、服务端 SDK、Stripe.js 与移动端 SDK。资料指出最新 API 版本为 2026-03-25.dahlia，除非用户指定其他目标版本。
主要能力：区分向后兼容变更（新增资源、可选参数、响应属性、不透明字符串长度、新 webhook 事件类型）与破坏性变更（字段重命名或移除、行为修改、端点或参数移除）。说明动态类型语言（Ruby、Python、PHP、Node.js）可全局配置或按请求覆盖 api_version；强类型语言（Java、Go、.NET）使用与 SDK 发布日匹配的固定版本，不应另设版本，而应升级 SDK。Stripe.js 采用常青模型，按半年发布主版本（Acacia、Basil、Clover、Dahlia），每个版本自动配对对应 API 版本且不可覆盖；v3 仍被无限期支持。移动端 iOS/Android 遵循语义化版本，React Native 使用 0.x.y 模型，所有移动 SDK 与后端 API 版本兼容。
使用方式：建议在代码中显式指定 API 版本而非依赖账户默认值。升级清单包括查阅 API Changelog 与升级指南、更新服务端 SDK 包版本（如 npm update stripe、pip install --upgrade stripe）、更新 apiVersion 参数、用 Stripe-Version 头测试、更新 webhook 处理器、按需更新 Stripe.js 与移动 SDK 版本，并将对象 ID 存储为最多 255 字符且区分大小写。测试可用 curl 加 -H "Stripe-Version: 2026-03-25.dahlia"，或在代码中设置 apiVersion。
适用场景与限制：适用于 Stripe 集成升级与版本迁移。webhook 监听器需优雅处理未知事件类型，升级前应测试新版本结构；破坏性变更按产品领域标记，多个 API 版本可共存以支持分阶段采用。资料未提供具体价格、平台支持范围或效果数据。