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 (後払い) など、仮想アイテムの販売が許可されない支払い方法が除外されます。

Bank Transfers

銀行振込は、顧客が銀行ネットワーク上で安全に資金を送金する方法です。Stripe で銀行振込を受け付ける際には、顧客が自身のオンラインバンクインターフェイスで、または銀行支店から対面で振り込める仮想銀行口座の番号を提供します。この仮想口座番号が自動消し込みに使用されます。お客様の実際の口座情報が顧客に公開されることはありません。

The connector 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.

Enable: When you enable bank transfers, they appear as a separate payment method to the PaymentElement form. This means that you can set a separate title and sort order for it.
Title: The title you want to display at the checkout for this payment method.
Minimum amount: When the shopping cart amount is less than the minimum amount, the payment method is hidden at the checkout. The amount is specified in the store’s configured base currency.
Default EU Country: Although anyone in the EU can place an order with bank transfers, virtual bank accounts can only be generated for only five out of all the EU countries. If the customer’s billing address is in one of those countries, the virtual bank account is automatically be created for that country. If not, then country value which you configure here is used to generate the virtual bank account.
Sort order: The sort order of the payment method against other enabled payment methods at the checkout.

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

注