用途：指导将 Stripe 集成升级到目标 API 版本，覆盖服务端 SDK、Stripe.js、移动端 SDK 以及 Webhook 端点与事件目标。
主要能力：确定目标 API 版本（用户指定，或用 Stripe CLI 等工具查询 docs.stripe.com 的当前版本）；对比客户端配置、单请求覆盖和 Webhook 端点中固定的版本；区分快照事件与精简事件（精简事件负载不带版本，无需随 API 版本升级）；给出各语言 SDK 的版本设置方式与升级清单。
使用方式：动态类型语言（Ruby、Python、PHP、Node.js）可全局设置或按请求覆盖，例如 stripe.api_version = '2026-08-26.dahlia'，或 const stripe = require('stripe')('sk_test_xxx', { apiVersion: '2026-08-26.dahlia' })。Java、Go、.NET 等强类型语言应升级 SDK 版本而非覆盖固定版本。测试可用 Stripe-Version 请求头，例如 curl https://api.stripe.com/v1/customers -u sk_test_xxx: -H "Stripe-Version: 2026-08-26.dahlia"。Stripe.js 通过脚本标签或 npm 加载，其版本与 API 版本自动配对且不可覆盖。
适用场景：需要跨版本迁移、验证新版本行为、处理 Webhook 版本差异或升级移动端 SDK 时。
限制：资料中的回退版本 2026-08-26.dahlia 仅为生成时快照，可能过期，仅在无法访问 docs.stripe.com 时使用，不得猜测更新版本号。强类型语言不要设置与 SDK 不匹配的 API 版本。v2 快照事件目标创建后无法更改版本，需新建并测试替代目标。升级后 72 小时内可在 Workbench 回滚。其他细节暂未提供。