用途：指导将 Stripe 集成从旧版本升级到新 API 版本，涉及服务端 SDK、Stripe.js 和移动 SDK。
主要能力：区分向后兼容变更（新增资源、可选参数、响应属性、不透明字符串长度变化、新 webhook 事件类型）与破坏性变更（字段更名或移除、行为修改、移除端点或参数），并建议查阅 API Changelog。
使用方式：弱类型语言（Ruby、Python、PHP、Node.js）可全局设置 api_version 或按请求覆盖；强类型语言（Java、Go、.NET）使用与 SDK 发布日匹配的固定版本，应升级 SDK 而非单独设置版本。Stripe.js 按主版本发布（如 dahlia 对应 2026-07-29.dahlia API），可通过 script 标签或 npm 安装，且与 API 版本的配对不可覆盖。移动 SDK 采用语义化版本，React Native 使用 0.x.y 模型。
建议流程：查阅 changelog、更新 SDK 包、更新 apiVersion、用 Stripe-Version 头测试、处理新 webhook 结构、必要时更新 Stripe.js 与移动 SDK，并将对象 ID 存为最长 255 字符。
限制：资料未提供具体价格、平台支持范围或效果保证；强类型语言不可手动指定不同 API 版本；Stripe.js 版本与 API 版本配对不可更改。