mcpField
S
sumup-best-practices

sumup-best-practices

github.com/sumup開発560 回インストール3 週間前に更新
リポジトリ

sumup-best-practices について

SumUp 連携のアーキテクチャとセキュリティを判断する AI エージェント向けスキルです。対面・オンライン・併用の決済経路や認証方式、運用上の制約を選ぶための指針を示し、実装手順は扱いません。

主な機能

  1. 01対面・オンライン・併用の要件分類
  2. 02適切な SumUp 連携経路の選択
  3. 03API key と OAuth 認証の比較
  4. 04決済セキュリティと運用制約の確認
  5. 05リスクと検証計画の提示

活用シーン

  1. 01対面またはオンライン決済方式の選定
  2. 02単一・複数加盟店アプリの認証方式決定
  3. 03Webhook の再試行と冪等処理の評価
  4. 04決済導入前の検証計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sumup/sumup-skills --skill sumup-best-practices

インストール後、Claude Code で/sumup-best-practicesを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yamlassets/small-logo.svg

詳細

SumUp の連携に関する判断とベストプラクティス

知識や API は変更される可能性があります。古い記憶よりも、常に最新の SumUp ドキュメント（Markdown 形式）を優先してください。

実装手順の案内ではなく、アーキテクチャとセキュリティに関する判断にこのスキルを使用してください。

クイック判断ツリー

Need to accept a payment?
├─ In-person (card-present)
│  ├─ Native mobile app controls reader directly -> iOS Terminal SDK / Android Reader SDK
│  ├─ POS/backend controls Solo from non-native environment -> Cloud API
│  └─ Legacy handoff to SumUp app is mandatory -> Payment Switch
└─ Online (card-not-present)
   ├─ Fastest redirect flow, no embed required -> Hosted Checkout
   ├─ Embedded payment form with low PCI scope -> Card Widget
   ├─ Mobile app checkout UX -> Swift Checkout SDK / React Native SDK
   ├─ Save card and charge later -> Customers + tokenization
   └─ Custom orchestration needs -> Checkouts API + 3DS + webhooks

まずはこちら

  1. リクエストを terminal、online、hybrid に分類します。
  2. 実現可能な中で、最も複雑さの低い方法を最初に選びます。
    • 独自のオーケストレーションを構築する前に、Hosted Checkout または Card Widget を優先します。
    • ネイティブではない Solo の制御には、Cloud API を優先します。
  3. 認証モデルを選択します。
    • 単一加盟店のサーバー連携には API キーを使用します。
    • 委任型または複数加盟店向けのアプリには OAuth 2.0 を使用します。
  4. 制限付きアクセスとアフィリエイトの前提条件を確認します。
    • 必要に応じて payments スコープを有効化します。
    • カード提示型決済では、Affiliate Key とアプリ／バンドル識別子を一致させます。
  5. 運用上の制約を確認します。
    • 通貨と加盟店の整合性
    • Webhook エンドポイントの準備状況と冪等性
    • レガシーとの互換性要件

必ず守るルール

  • API キーと OAuth シークレットはサーバー側のみに保管します。
  • PAN やカード情報の生データを直接扱わないでください。
  • オンライン決済のチェックアウトはサーバー間で作成します。
  • 独自のカード処理より、ホスト型、ウィジェット型、SDK のチェックアウト UI を優先します。
  • 非推奨のエンドポイントは使用しないでください。
  • 一意の取引参照値（checkout_reference、foreignTransactionId、または同等の値）を使用します。
  • Webhook コールバックは通知として扱い、決済を確定する前に API で最終状態を確認します。
  • 再試行や重複配信を想定し、バックエンドで冪等性を確保します。

必須の回答要件

ガイダンスを提供する際は、必ず次の内容を返してください。

  1. 選択した連携方法と、その理由の簡潔な説明。
  2. 推奨する認証情報モデル（API キーと OAuth のどちらか）と、必要なスコープ。
  3. 選択した方法のセキュリティ対策チェックリスト。
  4. リスクとトレードオフ、および別の方法を選ぶべき状況。
  5. 本番環境への展開前に行う最低限の検証計画。

実装スキルへの引き継ぎ

  • エンドツーエンドの実装手順には sumup を使用します。
  • SDK／API の移行には upgrade-sumup を使用します。
  • 障害の原因究明には sumup-debug を使用します。
  • サンドボックスと QA の設定には sumup-testing を使用します。

コメント

Markdown 対応