claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 22h ago
スキルOfficialdevelopment

🔄upgrade-sumup

プラグイン
sumup
ライセンス
Apache-2.0
ソース
GitHub で見る ↗

説明

SumUp APIバージョンおよびサーバー/モバイルSDK（@sumup/sdk、sumup-go、sumup Python、PHP、Java、Rust、.NET、iOS Terminal、Android Reader、Swift Checkout、React Native）のアップグレードに関するガイド。 次のような場合に使用: SumUp SDKのバージョンを引き上げる際や、非推奨となったエンドポイントからの移行を行う際。

原文を表示

Guide for upgrading SumUp API versions and server/mobile SDKs (@sumup/sdk, sumup-go, sumup Python, PHP, Java, Rust, .NET, iOS Terminal, Android Reader, Swift Checkout, React Native). Use when bumping SumUp SDK versions or migrating off deprecated endpoints.

ユースケース

  • ✓SumUp SDKのバージョンアップグレード
  • ✓非推奨エンドポイントからの移行
  • ✓サーバー/モバイルSDKの更新

本文（日本語訳）

SumUp アップグレード・移行ガイド

ナレッジおよびAPIは変更される場合があります。常に最新の公式ドキュメントとリリースノートを優先してください。

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

次のような場合に使用: アップグレード、バージョン更新、非推奨化（deprecation）、または移行に関するリクエストがあるとき。

サポートされるアップグレード対象

  • 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 署名の設定
  • 影響を受ける環境（sandbox、staging、production）

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

各 SDK またはエンドポイントの移行において:

  • 変更履歴（changelog）と移行ノートを比較する
  • フィールド名の変更・削除、enum、コールバックシグネチャの変更を特定する
  • 非同期処理や支払いステータスのセマンティクスにおける動作変更を特定する
  • 非推奨エンドポイントと必要な代替先を特定する

3) 移行の実施

  • 一度に一つの対象を移行する（サーバーSDK → モバイルSDK → UI統合の順）
  • 必要に応じて互換性アダプターを設けて、アプリケーションコードをSDKの変更から切り離す
  • 非推奨エンドポイントを現行の同等エンドポイントに置き換える（該当する場合は merchant_code を受け付けるエンドポイントを優先）
  • webhook の検証処理とべき等性（idempotency）ロジックは、変更が必要な場合を除き維持する

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

  • sandbox 環境でハッピーパスの決済を実行する
  • 意図的な失敗（amount = 11）を実行し、注文ステータスが未払いのままであることを確認する
  • 3DS リダイレクト / チャレンジおよび復帰処理を確認する
  • webhook の再試行とべき等処理を確認する
  • 重複リファレンスの動作および照合フィールドを確認する

5) ロールアウトとロールバック

  • 段階的にロールアウトする（社内 → 低トラフィック → 全トラフィック）
  • 実用的な範囲でリリーストグルを追加する
  • メトリクスが安定するまで、以前のバージョンへのロールバック手順を用意しておく

移行チェックリスト

  • [ ] 非推奨の SumUp エンドポイントをすべてのアクティブなコードパスから除去済み
  • [ ] SDK のメジャー / マイナーバージョンがサービス / アプリ間で一貫して固定されている
  • [ ] 生成済みの API クライアントが再生成され、コミット済み
  • [ ] 新しいレスポンス形式に合わせてインテグレーションテストを更新済み
  • [ ] 新しいステータス / エラーコードを反映してランブックを更新済み
  • [ ] 新しい障害パターンに対応してモニタリングアラートを見直し済み

必須レスポンス要件

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

  1. 現状のサマリーおよびターゲットバージョン
  2. 破壊的変更と影響を受けるコードの対象箇所
  3. 安全な移行の最小手順
  4. 強制的な失敗パスを含む検証計画
  5. ロールバック戦略および Go / No-Go 判断基準
原文（English）を表示

SumUp Upgrade and Migration Guide

Knowledge and APIs can change. Always prefer current official docs and release notes.

  • Docs root: https://developer.sumup.com/
  • LLM entrypoint: https://developer.sumup.com/llms.txt

Use this skill when the request is about upgrades, version bumps, deprecations, or migrations.

Supported Upgrade Targets

  • Node: @sumup/sdk
  • Go: sumup-go
  • Python: sumup
  • PHP, Java, Rust, .NET SDK/client integrations
  • iOS Terminal SDK
  • Android Reader SDK
  • Swift Checkout SDK
  • React Native SDK
  • Checkouts API and related webhook/3DS endpoint usage

Upgrade Workflow

1) Pre-upgrade inventory

Capture:

  • Current SDK/library versions by service/app.
  • All used SumUp endpoints and fields.
  • Auth mode (API key/OAuth), scopes, and webhook signature setup.
  • Environments impacted (sandbox, staging, production).

2) Breaking-change diff

For each SDK or endpoint migration:

  • Compare changelog and migration notes.
  • Identify renamed/removed fields, enums, and callback signatures.
  • Identify behavior changes in async/payment status semantics.
  • Identify deprecated endpoints and required replacements.

3) Migration implementation

  • Upgrade one surface at a time (server SDK, then mobile SDK, then UI integration).
  • Keep a compatibility adapter where necessary to isolate application code from SDK changes.
  • Replace deprecated endpoints with current equivalents, preferring endpoints that accept merchant_code where applicable.
  • Keep webhook verification and idempotency logic unchanged unless required.

4) Post-upgrade validation

  • Run happy path payment in sandbox.
  • Run deliberate failure (amount = 11) and verify order state remains unpaid.
  • Verify 3DS redirect/challenge and return handling.
  • Verify webhook retries and idempotent processing.
  • Verify duplicate reference behavior and reconciliation fields.

5) Rollout and rollback

  • Roll out in stages (internal -> low-volume -> full traffic).
  • Add release toggles where practical.
  • Keep previous version rollback path ready until metrics are stable.

Migration Checklist

  • [ ] All deprecated SumUp endpoints removed from active code paths.
  • [ ] SDK major/minor versions pinned consistently across services/apps.
  • [ ] Any generated API clients re-generated and committed.
  • [ ] Integration tests updated for new response shapes.
  • [ ] Runbook updated with new status/error codes.
  • [ ] Monitoring alerts reviewed for new failure signatures.

Required Response Contract

Every upgrade answer should include:

  1. Current state summary and target version.
  2. Breaking changes and affected code surfaces.
  3. Minimal safe migration sequence.
  4. Validation plan including forced-failure path.
  5. Rollback strategy and go/no-go criteria.

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。