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 升級期間的資料完整性。