upgrade-stripe

此技能提供维护与升级 Stripe 集成的全面指南，涵盖基于日期的 API 版本控制、服务器端 SDK 的迁移策略，以及维护 Stripe.js 与移动开发环境的兼容性。开发人员可利用此代理在不同 API 版本间转换时识别必要的代码更新，理解向后兼容与重大变更之间的差异，并应用 SDK 配置的最佳实践。

• 升级 Stripe API 版本的详细指引，包含使用 Stripe-Version 头的测试策略。

• 针对 Python、Ruby、PHP、Node.js 等动态类型语言与 Java、Go、.NET 等强类型语言的专属 SDK 指导。

• 通过脚本标签或 npm 包更新 Stripe.js 的说明，以及管理关联的 API 版本配对。

• 针对 iOS、Android 与 React Native 移动 SDK 的迁移支持，专注于语义化版本控制与后端兼容性。

• 关于查阅 API 变更日志、更新 Webhook 处理程序以及处理对象 ID 变更的专家建议，以避免服务中断。

• 除非需要特定的旧版本，否则请务必根据最新的建议 API 版本 (2026-04-22.dahlia) 验证您的集成。

• 在更新账户默认值之前，请使用 Stripe-Version 头在测试或开发环境中安全地测试新的 API 版本。

• 强类型 SDK 需要更新 SDK 以锁定新的 API 版本，而动态类型 SDK 则允许全局或单次请求的配置覆盖。

• 请务必查看 Stripe API 变更日志，确认可能损坏现有功能的字段重命名、移除或行为变更。

• 迁移至较新的 Stripe.js 主版本时，请确保您的平台配置符合预定义的 API 版本配对需求。

• 确保数据库结构支持更新后的 Stripe 对象 ID 长度与格式，以维持 API 升级期间的数据完整性。