サイバーソース統合チェックアウト

対象者

現在ホスト型チェックアウトを実行しているCyber​​Sourceの運用アカウントを既に保有しており、統合チェックアウトへの移行を希望する加盟店が対象です。新しいCyber​​Sourceアカウントは必要ありません。既存の運用加盟店ID（MID）で新しいサービスを有効にし、 OpenApplyの設定をそのサービスに切り替えるだけです。

⚠️ OpenApplyでは、Cyber​​Sourceモード（ Hosted CheckoutとUnified Checkout ）は、ユーザーごとやセッションごとではなく、学校ごとに設定する単一のオプションです。切り替えた瞬間から、その学校のすべての保護者が統合チェックアウトを使用するようになります。段階的な導入や職員限定のプレビューは提供されていないため、計画的にご利用ください。

チェックリスト

1. 運用中のMIDで統合チェックアウト、支払者認証（3DS）、および意思決定マネージャーを有効にするには、MID構成リクエストを送信してください。
2. サービスが承認されたら、新しいREST APIキーを生成します。
3. トラフィックが少ない時間帯に、ホスト型チェックアウトの認証情報をバックアップし、新しいキーとDecision Managerチェックボックスを使用してOpenApply Unified Checkoutに切り替えます。
4. Unified CheckoutのWebhookを設定する
5. 実際のトランザクションで検証し、その後、切り替えまたはロールバックを維持する。

ステップ1：サービスを有効化する（サービス有効化）

ビジネスセンターで、サポート → サポートセンターを開きます。

これにより、Visa Acceptance Solutionsサポートセンターが開きます。サポートケース → MID構成リクエストへ移動してください。

フォームを送信し、 「サービス有効化」のみにチェックを入れて、以下のリクエストを送信してください。

• 統合チェックアウト（REST API）
• 支払者認証（3DS）
• 意思決定マネージャー（不正防止スクリーニングが必要な場合）

「環境」で「本番環境のみ」にチェックを入れ、「プライベート」はそのままにしてください。

Cyber​​Sourceに関するご質問は、Cyber​​Sourceサポートに直接お問い合わせください。

Cyber​​Sourceはこの処理を社内で行います（同社の公開ドキュメントによると、通常3営業日以内）。ステップ2で作成されたRESTキーとステップ3のDecision Managerチェックボックスは、いずれも加盟店アカウントでこれらのサービスが有効になっていることを前提としているため、この承認が完了するまで、この手順書の他の項目は実行できません。

ステップ2：新しいREST APIキーを生成して保存する

⚠️ Unified Checkout キーと Hosted Checkout キーは、同じ加盟店/プロファイルに属していても、同じキーではありません。Hosted Checkout ではセキュア承認アクセスキーとシークレットキーを使用しますが、Unified Checkout では別の REST API キー (キー ID + 共有シークレット) を使用します。これらは Business Center の異なる場所に保存されており、互換性はありません。

サービスが有効になったら、ビジネスセンター → 支払い設定 → キー管理に移動します。

「+ キーを生成」をクリック：

キータイプとして「REST - 共有シークレット」を選択してください。これは、Unified Checkoutが使用するREST APIに推奨されるタイプです。

その下にある従来のSCMP / SOAPツールキットのオプションは無視してください（Cyber​​Sourceはそれらをサポート終了としています）、 [キーを生成]をクリックします。

世代を確認する：

Cyber​​Sourceは共有シークレットを一度しか表示しないため、キーと共有シークレットをすぐにコピー（またはダウンロード）してください。

ステップ3：ホスト型チェックアウトをバックアップしてから、 OpenApplyを統合チェックアウトに切り替えます。

⚠️ この手順を実行すると、学校に登録されているすべての保護者がすぐに統合チェックアウトに誘導されます。モード設定は学校全体で共有されるため（冒頭の警告を参照）、統合チェックアウトに切り替えずにテストする方法はありません。この手順から手順5までを、アクセスが少ない時間帯にまとめて実行することをお勧めします。

変更を加える前に、 OpenApply管理画面で学校の支払い設定を開き、現在のホスト型チェックアウトの設定（加盟店ID、プロファイルID、アクセスキー、シークレットキー）を安全な場所に記録しておいてください。後でロールバックが必要になった場合に備えておくためです。

次に、モードを「統合チェックアウト」に切り替えて、新しい値を入力します。

• 加盟店ID ：以前と同じ値。加盟店アカウントは変更されません。
• アクセスキー／シークレットキー：ステップ2で生成されたキーIDと共有シークレット（ホスト型チェックアウトのアクセスキー／シークレットキーは再利用しないでください。ステップ2の警告を参照してください）
• このモードではプロファイルIDが表示されなくなることに注意してください。これはホスト型チェックアウト専用のフィールドであり、統合チェックアウトでは使用されません。
• 環境：ライブ環境を選択
• ステップ1のリクエストに含まれていて承認されている場合は、今すぐDecision Managerで画面トランザクションを確認してください（ステップ4の前に実行してください。Webhookサブスクリプションは、セットアップ時にこのチェックボックスに表示されている内容に基づいて構築されます）。

ステップ4：ウェブフックを設定する

まず、手順3で作成した統合チェックアウトの設定を保存してください。保存後、同じ設定画面（上記のスクリーンショットの統合チェックアウトのWebhookセクションを参照）に移動し、 「Webhookを自動的に設定」をクリックします。これにより、暗号化されたWebhook認証情報が生成されて登録され、ヘルスチェックが実行され、サブスクリプションが作成されます。Business Centerで手動で操作する必要はありません。

ステップ5：実際のトランザクションで検証し、その後、切り替えまたはロールバックを維持する。

1. 新しいRESTキーが保存されていること、および本番環境のMIDに対してDecision Manager/3DS/Webhookサブスクリプションがすべて有効になっていることを確認してください。
2. 少額の実際の取引を1件実行し、承認が成功し、 OpenApplyで請求/請求書のステータスが正しく更新されることを確認してください。
3. すべて問題がなければ、切り替えはそのまま有効です。追加の操作は不要で、保護者は統合チェックアウトを通じて支払いを行うようになります。何か問題が見つかった場合は、すぐに元に戻してください。

ロールバック：モードをホスト型チェックアウトに戻し、手順3でバックアップした認証情報を復元します。これにより、学校に登録されているすべての保護者が直ちにホスト型チェックアウトに戻ります。