sumup

SumUp 決済連携を構築する

依頼されたフローと既存の実装に沿って作業してください。タスクで変更が求められていない限り、選択済みの連携方法とインストール済みの SDK バージョンを維持してください。不足している加盟店、プラットフォーム、または認証情報の詳細を尋ねる前に、利用可能なコードと設定を確認してください。不足情報によって作業が妨げられる場合にのみ質問してください。

ドキュメントインデックス、API リファレンスインデックス、または OpenAPI 仕様で、現在の仕様を確認してください。メソッド名とリクエストモデルは、インストール済み SDK の型を使って検証してください。現在の情報源にアクセスできない場合は、同梱のガイダンスと検証済みの動作を区別してください。

該当するリファレンスを選ぶ

タスクに必要なリファレンスを開いてください。フローによっては、チャネルのガイドとバックエンドまたはコールバックの詳細の両方が必要です。以下のパスは、このスキルディレクトリからの相対パスです。

タスク	リファレンス
ホスト型決済ページにリダイレクトする	ホスト型チェックアウト
ウェブサイトに決済フォームを埋め込む	カードウィジェット
ウェブサイトに Apple Pay または Google Pay のボタンを追加する	Swift Checkout JavaScript SDK
モバイル決済シートを表示する	React Native チェックアウト
カードを保存する、または保存済みトークンで請求する	トークン化
オンラインチェックアウトを作成、処理、または取得する	Checkouts API
ネイティブアプリをリーダーに接続する	iOS または Android
スマートフォンで非接触決済を受け付ける	Android Tap to Pay または iPhone ガイド
POS／バックエンドから Solo リーダーを操作する	Cloud API
コールバックまたは 3DS に対応する	Webhook と 3DS
状態が不確かな決済または返金から復旧する	安全な再試行
認証情報、スコープ、またはアフィリエイトの設定を確認する	認可
言語別の例、APM、テスト、またはレガシー Payment Switch を探す	リファレンスインデックス

決済のルール

• オンラインチェックアウトはバックエンドで作成してください。秘密の sup_sk_ キーと OAuth クライアントシークレットはバックエンドに保管し、サポート対象のフロントエンドチェックアウト SDK では公開用の sup_pk_ 加盟店キーを使用してください。
• 生のカード情報を扱う仕組みを導入するより、サポート対象のホステッド型、ウィジェット型、または SDK による決済情報の収集を優先してください。Swift Checkout はブラウザー用 JavaScript SDK であり、ネイティブ iOS SDK ではありません。
• 加盟店が所有する API キーを使用し、委任された加盟店へのアクセスには OAuth を使用してください。選択したエンドポイントの権限と、認証情報が適用される加盟店のコンテキストを確認してください。
• 端末を使うフローでは、必須の Affiliate Key と一致するアプリ識別子を指定してください。Android Tap-to-Pay には、専用の SDK とアフィリエイトのメタデータが必要です。
• 結果を処理する前に、決済試行の参照情報と返された ID を永続化してください。確認済みの新しい試行には固有の参照情報を割り当ててください。checkout_reference は重複決済の確認に代わるものではありません。
• オンライン注文では、対象のチェックアウトを取得し、フルフィルメントの前に status: "PAID" であること、加盟店、参照情報、金額、通貨が一致することを確認してください。リダイレクトやクライアントコールバックは決済の証明にはなりません。
• Cloud API のチェックアウト受け付けは非同期です。その client_transaction_id を照合し、最終的な取引結果を確認してください。
• コールバックは通知として扱い、注文の更新は冪等にしてください。オンラインチェックアウトのコールバックでは HMAC 署名が規定されていないため、選択した製品で指定されている場合に限り、署名を検証してください。
• タイムアウト、応答の消失、または 5xx の後は、再実行する前に既存の決済または返金の状態を確認してください。チェックアウトの作成時に ID が返されなかった場合は、元の checkout_reference を使って検索してください。
• 新しい作業では、非推奨ではない現行のエンドポイントを使用してください。今回の変更と無関係な移行は別途行ってください。

影響を受けるフローの検証

プロジェクトで既に使われているチェックと、関連するサンドボックスのシナリオを使用してください。決済フローを変更する場合は、成功、拒否（仕様に記載されている場合は 11.00）、および影響を受けるコールバック、認証、キャンセル、不確定な結果の経路を検証してください。リーダーを使うテストとオンラインのテストカードでは、セットアップが異なります。実行したチェックと、デバイス、認証情報、または実際のプロバイダーでの検証が引き続き必要な項目を明記してください。

インストールされている場合、sumup-best-practices、sumup-debug、sumup-testing、sumup-mcp、upgrade-sumup は、それぞれ選択、診断、テスト、MCP、移行をカバーします。これらの作業が依頼された場合は使用してください。ただし、このスキルを利用する前提条件ではありません。範囲の狭い質問には、統合計画全体を示さず、直接回答してください。