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 アカウントを選択します。
- Review and approve the app permissions, install the app in a sandbox or in live mode, then click Install.
- アプリをインストールしたら、キーをなくさないように安全な場所に保管します。保管場所を忘れないようにするため、ダッシュボードにキーに関するメモを残すこともできます。
- 新たに生成した公開可能キーとシークレットキーを使用して、Connector の設定を完了します。
- To manage the app or generate new security keys after installation, navigate to the application settings page in a sandbox or in live mode.
一般的な設定
- Mode: We recommend that you start by testing the integration in a sandbox. Switch to live mode when you’re ready to accept live transactions. Learn more about sandboxes.
- API keys: Fill in the test and live keys that Stripe provides to you in the Adobe Commerce app.
- 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 (注文): オーソリやキャプチャーを行わずに、顧客の支払い方法を保存します。管理エリアから請求書を発行することで、このモードで処理された注文の支払いを回収できます。
- 有効期限切れのオーソリ: すぐにキャプチャーされないカード支払いの場合は、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 ではこのオプションを使用できません。
- ソート順: 複数の支払い方法を有効にしている場合、購入ページでの支払い方法の表示順序がこの設定により決まります。
- **支払い方法のフィルタリング: ** Stripe では、支払い方法を複数設定することができます。支払い方法を設定すると、その支払い方法がドロップダウンメニューで直ちに利用可能になります。ビジネス要件に基づいて、ストアのビューごとに異なる設定を選択できます。さらに、仮想カート用に別の支払い方法設定を選択できます。これにより、Afterpay/Clearpay (後払い) など、仮想アイテムの販売が許可されない支払い方法が除外されます。
銀行振込
銀行振込は、顧客が銀行ネットワーク上で安全に資金を送金する方法です。Stripe で銀行振込を受け付ける際には、顧客が自身のオンラインバンクインターフェイスで、または銀行支店から対面で振り込める仮想銀行口座の番号を提供します。この仮想口座番号が自動消し込みに使用されます。お客様の実際の口座情報が顧客に公開されることはありません。
コネクターは、通貨のサブセットの銀行振込をサポートしています。サポートされている通貨は、顧客が決済フロー時に選択する通貨ではなく、Stripe アカウントの決済通貨です。つまり、Stripe アカウントの決済通貨が米ドルの場合、米ドルで支払う顧客のみが決済フロー時に銀行振込の決済手段を確認できます。
- 有効化: 銀行振込を有効にすると、銀行振込は PaymentElement フォームに別の決済手段として表示されます。つまり、別のタイトルと並べ替え順序を設定できます。
- タイトル: この決済手段の決済時に表示するタイトルです。
- 最低金額: ショッピングカートの金額が最低金額を下回る場合、決済手段は決済フロー時に非表示になります。金額は、ストアで設定されている基本通貨で指定されます。
- デフォルトの EU 加盟国: EU圏内であれば誰でも銀行振込で注文できますが、仮想銀行口座を生成できるのは EU 加盟国のうち 5 か国のみです。顧客の請求先住所がこれらの国のいずれかにある場合は、その国の仮想銀行口座が自動的に作成されます。そうでない場合は、ここで設定した国の値を使用して仮想銀行口座が生成されます。
- 並べ替え順序: 決済時の決済手段と他の有効な決済手段との並び替え順。
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 (レジに進む) ボタンに合わせて調整できます。
- オーバーフロー:
Automatic
に設定すると、コンテナのサイズに応じてウォレットボタンが自動で折り畳みまたは展開されます。Expanded
に設定すると、コンテナのサイズに関係なく、すべてのウォレットボタンが表示されます。 - ソート順序: デフォルトでは、 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 インスタンスで開発者モードが使用されている場合のみです。