upgrade-sumup

SumUp アップグレードおよび移行ガイド

知識や API は変更されることがあります。常に最新の公式ドキュメントとリリースノートを優先してください。

• ドキュメントのルート：https://developer.sumup.com/
• LLM エントリーポイント：https://developer.sumup.com/llms.txt

アップグレード、バージョンの更新、非推奨化、または移行に関するリクエストには、このスキルを使用してください。

サポート対象のアップグレード先

• Node：@sumup/sdk
• Go：sumup-go
• Python：sumup
• PHP、Java、Rust、.NET SDK／クライアント統合
• iOS Terminal SDK
• Android Reader SDK
• Swift Checkout SDK
• React Native SDK
• Checkouts API と関連する Webhook／3DS エンドポイントの使用

アップグレードのワークフロー

1）アップグレード前の棚卸し

以下を記録します。

• サービス／アプリごとの現在の SDK／ライブラリのバージョン。
• 使用しているすべての SumUp エンドポイントとフィールド。
• 認証方式（API キー／OAuth）、スコープ、Webhook 署名の設定。
• 影響を受ける環境（サンドボックス、ステージング、本番環境）。

2）破壊的変更の差分確認

各 SDK またはエンドポイントの移行について、以下を確認します。

• 変更履歴と移行に関する注記を比較します。
• 名前が変更または削除されたフィールド、列挙値、コールバックのシグネチャを特定します。
• 非同期処理／支払いステータスのセマンティクスにおける動作変更を特定します。
• 非推奨のエンドポイントと、必要な置き換え先を特定します。

3）移行の実装

• 変更する対象を一度に一つに絞ってアップグレードします（サーバー SDK、次にモバイル SDK、最後に UI 統合）。
• 必要に応じて互換性アダプターを用意し、アプリケーションコードを SDK の変更から切り離します。
• 非推奨のエンドポイントを現在の同等のエンドポイントに置き換えます。該当する場合は、merchant_code を受け付けるエンドポイントを優先してください。
• 必要がない限り、Webhook の検証と冪等性のロジックは変更しないでください。

4）アップグレード後の検証

• サンドボックスで正常系の支払いを実行します。
• 意図的な失敗（amount = 11）を実行し、注文ステータスが未払いのままであることを確認します。
• 3DS のリダイレクト／チャレンジと、復帰時の処理を確認します。
• Webhook の再試行と冪等な処理を確認します。
• 重複した参照の挙動と照合用フィールドを確認します。

5）段階的な展開とロールバック

• 段階的に展開します（社内 → 少量のトラフィック → 全トラフィック）。
• 実用的な場合は、リリース切り替え機能を追加します。
• メトリクスが安定するまで、以前のバージョンにロールバックできる手段を用意しておきます。

移行チェックリスト

• アクティブなコードパスから、非推奨の SumUp エンドポイントをすべて削除した。
• SDK のメジャー／マイナーバージョンを、すべてのサービス／アプリで一貫して固定した。
• 生成された API クライアントを再生成し、コミットした。
• 新しいレスポンス形式に合わせて、統合テストを更新した。
• 新しいステータスコード／エラーコードを反映するよう、ランブックを更新した。
• 新しい障害パターンに対応するよう、監視アラートを見直した。

回答に必須の内容

アップグレードに関する回答には、必ず以下を含めてください。

1. 現在の状態の概要と対象バージョン。
2. 破壊的変更と影響を受けるコード領域。
3. 最小限かつ安全な移行手順。
4. 強制的な失敗経路を含む検証計画。
5. ロールバック戦略と実施可否の判断基準。