Checkout UI 扩展 API 版本不匹配怎么升级

现象#

扩展在开发店铺正常，上线后报「不支持的 API 版本」，或某些组件渲染不出来。

原因#

• 扩展 toml 里声明的 api_version 与目标能力不匹配
• 使用了新版本才有的组件，但版本号仍是旧的
• 结账扩展需要商家在后台手动启用，未启用时表现像版本问题

处理步骤#

1. 在扩展目录的 shopify.extension.toml 里提升 api_version
2. 按新版本迁移组件与 hooks，删除已废弃的写法
3. 重新 shopify app deploy 并为店铺发布新版本
4. 在后台结账设置里确认扩展已启用，且作用于正确的结账配置

验收标准#

线上结账能正常渲染扩展；无版本相关报错，功能与预览一致。