Stripe Connector for Adobe Commerce を設定する
Stripe Connector for Adobe Commerce を使用して、支払い方法とその他のオプションを設定します。
Stripe Connector for Adobe Commerce を設定するには、その設定セクションに移動します (Stores (店舗) > Configuration (設定) > Sales (販売) > Payment Methods (支払い方法))。
Stripe モジュールを設定する
API キーを設定するまで Stripe は決済ページに表示されません。Stripe アカウントをまだお持ちでない場合は、オンラインで登録してください。
Stripe Adobe Commerce アプリをインストールする
Stripe Apps を使用して、Stripe アカウントのセキュリティを強化し、各システムの個々の制限付きキーを使用しやすくします。Adobe Commerce コネクターの導入には、Stripe App のインストールと新たに生成されるシークレットおよび公開可能キーの取得のプロセスが不可欠です。この方法を使用することで、自社の制限付きキーの作成やシークレットキーの使用を手動で行う必要がなくなります。Adobe Commerce アプリを導入してアカウントのセキュリティインフラを強化するには以下の手順を使用します。
- Stripe App Marketplace に移動して、Adobe Commerce アプリをインストールするをクリックします。
- アプリをインストールする Stripe アカウントを選択します。
- アプリの権限を確認して承認します。テスト環境または本番環境でアプリをインストールして、インストールをクリックします。
- アプリをインストールしたら、キーをなくさないように安全な場所に保管します。保管場所を忘れないようにするため、ダッシュボードにキーに関するメモを残すことができます。
- 新たに生成した公開可能キーとシークレットキーを使用して、Connector の設定を完了します。
- インストール後にアプリを管理したり、新しいセキュリティキーを生成したりするには、テスト環境または本番環境でアプリケーションの設定ページに移動します。
一般的な設定
- Mode (モード): 開始するには、まず、テスト環境で実装内容をテストすることをお勧めします。本番環境の取引を受け付ける準備ができたら、本番環境に切り替えます。Stripe での支払いテストについては、こちらで詳細をご確認ください。
- API キー: Adobe Commerce アプリで、Stripe が提供するテスト環境用のキーと本番環境用のキーを入力します。
- Hold Elevated Risk Orders (比較的高リスクの注文を保留): Stripe Radar が支払いに
Elevated Risk
ステータスのマークを付けると、モジュールは、お客様がその支払いを審査するまで注文をOn Hold
にします。詳細については、Stripe Radar による不正防止機能を有効化するのセクションをご覧ください。 - Receipt Emails (領収書メール): 有効にすると、支払いが成功した後に、Stripe が顧客に支払いの領収書メールを送信します。Stripe アカウント設定から、メールのスタイルとブランドをカスタマイズできます。
Payments
- Enabled (有効): 標準の決済ページ、複数配送の決済ページ、および管理領域で使用できる支払い方法として、Stripe を有効または無効にします。
- Payment flow (決済フロー): 標準の決済ページで優先する決済フローを選択します。 埋め込み決済フローでは、iframe ベースの Payment Element を決済ページに直接埋め込みます。リダイレクト決済フローでは、顧客を Stripe Checkout にリダイレクトして決済を行います。
- Form layout (フォームのレイアウト): 支払い方法セレクターを横型レイアウト (タブ) または縦型レイアウト (アコーディオン) で表示します。モバイルや 3 列の決済ページのような狭いセクションには縦型レイアウトをお勧めします。PaymentElement のインタラクティブな UI コンポーネントで 2 つのレイアウトをテストできます。
- タイトル: 決済ページで顧客に表示するラベル。
- **支払い方法の設定: ** 支払い方法を複数設定することができます。支払い方法を設定すると、その支払い方法がドロップダウンフィールドで直ちに利用可能になります。ビジネス要件に基づいて、ストアのビューごとに異なる設定を選択できます。
- Payment Action (支払いアクション): 支払いモードを選択します。
- Authorize and Capture (オーソリとキャプチャー): 購入後すぐに顧客のカードに請求します。
- Authorize Only (オーソリのみ): 支払い金額をオーソリし、カードを保留にします。この金額は後で請求書を発行してキャプチャーできます。
- Order (注文): オーソリやキャプチャーを行わずに、顧客の支払い方法を保存します。管理エリアから請求書を発行することで、このモードで処理された注文の支払いを回収できます。
- Expired Authorizations (有効期限切れのオーソリ): すぐにキャプチャーされないカード支払いの場合は、7 日以内に支払いをキャプチャーする必要があります。これを過ぎてから金額をキャプチャーしようとしても、エラーが返されます。このオプションを有効にすると、モジュールはその注文に使用された元のカードで元の支払いを再作成しようとします。モジュールはカードを Authorize Only (オーソリのみ) モードで自動的に保存し、注文が請求されるかキャンセルされるまで、顧客がアカウントセクションからカードを削除することはできません。
- Automatic Invoicing (自動請求書): 「Authorize Only (オーソリのみ)」オプションでは、購入時に新しい請求書が Pending ステータスで作成されます。支払いをキャプチャーすると、請求書のステータスは Paid に移行します。このオプションは、「Payment Action (支払いアクション)」が「Authorize Only (オーソリのみ)」に設定されている場合に便利ですが、決済フローが完了しても請求書は作成されません。このオプションを有効にすると、モジュールが購入の完了時に請求書を自動生成するので、請求前に顧客にメールで送信することができます。
- Save customer payment method (顧客の支払い方法を保存): このオプションを有効にすると、顧客が最後に使用した支払い方法が Stripe ボールトに保存され、後で再利用できるため、スピーディーな決済が可能です。
- Card Icons (カードアイコン): Stripe アカウントがサポートしているカードブランドに基づいて、カードアイコンを表示します。
- Optional Statement Descriptor (オプションの明細書表記): 顧客の銀行明細書に表示される支払元を示すオプションの短い説明です。空白のままにすると、Stripe ダッシュボードで設定されたデフォルト表記が適用されます。Multibanco、SEPA ダイレクトデビット、および Sofort ではこのオプションを使用できません。
- Sort Order (並べ替え順序): 複数の支払い方法を有効にしている場合、購入ページでの支払い方法の表示順序がこの設定により決まります。
Express Checkout
Express Checkout を利用すると、顧客は Link、Apple Pay、Google Pay などのワンクリックのウォレットボタンを使用して注文できます。顧客のデバイスでサポートされている場合は、複数のウォレットを任意の順序で表示できます。Adobe Commerce 管理パネルの専用の設定セクションを使用して、設定を行います。
Apple Pay および Google Pay の設定オプション
- Enabled (有効): ウォレットボタンを、選択した場所で利用可能な支払い方法に切り替えます。通常の支払いが無効になっていても、これを有効にすることができます。
- Locations (場所): ウォレットボタンを表示するページを指定します。
- Seller name (販売者名): 支払いモーダルに表示されるビジネス名。
- Button Height (ボタンの高さ): ボタンの高さを、ご使用のテーマの Add to Cart (カートに追加する) および Proceed to Checkout (レジに進む) ボタンに合わせて調整できます。
- ソート順序: デフォルトでは、 Stripe はデバイスのケイパビリティや使用パターンなどの要因に基づいて、最適な順序でウォレットを並べ替えます。各ウォレットの設定内のセクションで Use sort order field (ソート順序フィールドを使用) を選択すると、ウォレットにソート順序を割り当てることができます。
Express Checkout を有効にしているのにウォレットボタンが表示されない場合は、トラブルシューティングページをご覧ください。
Webhook
Stripe は、アカウントでイベントが発生すると、Webhook を使用してアプリケーションに通知します。Webhook は、顧客の銀行が支払いを確定または拒否したときや、サブスクリプションの支払いを回収するときの Magento 注文の更新の際に特に便利です。これらのイベントにより、モジュールは、Magento 注文をフルフィルメントの準備ができた状態としてマークし、それに対する返金を記録し、支払い失敗の理由に関するコメントを追加することができます。
モジュールのバージョン 3 以降、Webhook を手動で設定する必要がなくなります。モジュールは、以下の場合に、Webhook を自動的に確認し、場合によっては設定します。
- モジュールをインストールまたはアップグレードして、
setup:upgrade
コマンドをトリガーする場合。 - Magento 管理で API キーを更新するとき (毎回)。
- Magento 管理でストアの URL を変更するとき (毎回)。
- 1 時間ごとの自動確認時にモジュールがデータベースの変更を検出した場合。これにより、データベースの手動変更、別のサーバーからの移行、バックアップの復元に起因する Webhook の破損を防止できます。
Webhook の更新時に、モジュールは、Stripe アカウントごとに 1 つの Webhook エンドポイントを作成します。たとえば、5 つのストアビューがあり、そのうち 4 つが 1 つの Stripe アカウントを使用していて、最後の 1 つは別の Stripe アカウントを使用している場合、モジュールは 2 つの Webhook エンドポイントを作成します。
これは、ストアビューに別のドメイン名を使用している場合にも適用されます。その場合、モジュールは、ベース URL ではなく、ストアビュードメインの 1 つを使用します。これは、セキュリティ上の理由からファイアウォールの背後にあることが多いベース URL の問題を防止するためです。
モジュールは、Webhook の署名を使用して、イベントがサードパーティーではなく Stripe によって送信されたことを確認します。この保護を無効にできるのは、Magento インスタンスで開発者モードが使用されている場合のみです。