Stripe Connector for Adobe Commerce を設定する

To configure the plugin navigate to the configuration section for it (Stores > Configuration > Sales > Payment Methods):

Stripe モジュールを設定する

API キーを設定するまで Stripe は決済ページに表示されません。Stripe アカウントをまだお持ちでない場合は、オンラインで登録してください。

Install the Adobe Commerce app from the Stripe App Marketplace

Install the app for Adobe Commerce from the Stripe App Marketplace to acquire the newly generated secret and publishable keys. This process bolsters the security of your plugin by simplifying the use of distinct restricted keys for each integration with your Stripe account. This approach eliminates the need to manually create your own restricted key or use a secret key. To install the app and reinforce your account’s security infrastructure:

1. Stripe App Marketplace に移動して、Adobe Commerce アプリをインストールするをクリックします。
2. アプリをインストールする Stripe アカウントを選択します。
3. アプリの権限を確認および承認してからサンドボックスまたは本番環境でアプリをインストールし、インストールをクリックします。
4. アプリをインストールしたら、キーをなくさないように安全な場所に保管します。保管場所を忘れないようにするため、ダッシュボードにキーに関するメモを残すこともできます。
5. Use the newly generated publishable key and secret key to finish the plugin configuration.
6. インストール後にアプリを管理したり、新しいセキュリティキーを生成したりするには、サンドボックスまたは本番環境でアプリケーションの設定ページに移動します。

一般的な設定

• 環境: まず、サンドボックスでシステムをテストすることをお勧めします。本番取引を受け付ける準備ができたら、本番環境に切り替えます。詳しくは、サンドボックスについての記事をご覧ください。
• APIキー: Stripe Adobe Commerce アプリで提供するテストキーと本番キーを入力します。
• Hold Elevated Risk Orders: If Stripe Radar marks a payment with an Elevated Risk status, the module places the order On Hold until you review the payment. See the section Enabling fraud prevention features with Stripe Radar for additional details.
• 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: Authorize the payment amount and place a hold on the card. You can capture the amount later by issuing an invoice.
  • 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 で銀行振込を受け付ける際には、顧客が自身のオンラインバンクインターフェイスで、または銀行支店から対面で振り込める仮想銀行口座の番号を提供します。この仮想口座番号が自動消し込みに使用されます。お客様の実際の口座情報が顧客に公開されることはありません。

The plugin supports bank transfers for a subset of currencies. The supported currencies are the settlement currencies of your Stripe account, rather than the currency which the customer selects at your checkout. This means that if your Stripe account settlement currency is USD, then only customers paying in USD are able to see the bank transfer payment method on your checkout.

• 有効化： 銀行振込を有効にすると、銀行振込は 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 (ソート順序フィールドを使用) を選択すると、ウォレットにソート順序を割り当てることができます。

If you enable Express Checkout and the wallet buttons don’t appear, refer to the troubleshooting page.

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 インスタンスで開発者モードが使用されている場合のみです。