Adobe Commerce 用に Stripe プラグインを設定する

プラグイン を設定するには、その設定セクションに移動します (Stores (店舗) > Configuration (設定) > Sales (販売) > Payment Methods (決済手段))。

Stripe モジュールを設定する

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

Stripe App Marketplace から Adobe Commerce アプリをインストールする

Stripe App Marketplace から Adobe Commerce のアプリをインストールして、新しく生成されたシークレットキーと公開可能キーを取得します。この処理するでは、Stripe アカウントとの導入ごとに個別の制限された付きキーの使用が簡素化されるため、プラグインのセキュリティが強化されます。このアプローチにより、独自の制限された付きキーを手動で作成したり、シークレットキーを使用したりする必要がなくなります。アプリをインストールしてアカウントのセキュリティインフラストラクチャーを強化するには、以下のようにします。

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

一般的な設定

• 環境: まず、サンドボックスでシステムをテストすることをお勧めします。本番取引を受け付ける準備ができたら、本番環境に切り替えます。詳しくは、サンドボックスについての記事をご覧ください。
• APIキー: Stripe Adobe Commerce アプリで提供するテストキーと本番キーを入力します。
• 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 (オーソリとキャプチャー): 購入後すぐに顧客のカードに請求します。
  • オーソリのみ: 支払い金額をオーソリし、クレジットカードを保留にします。この金額は後で請求書を発行してキャプチャーできます。
  • 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 で銀行振込を受け付ける際には、顧客が自身のオンラインバンクインターフェイスで、または銀行支店から対面で振り込める仮想銀行口座の番号を提供します。この仮想口座番号が自動消し込みに使用されます。お客様の実際の口座情報が顧客に公開されることはありません。

プラグインは、一部の通貨の銀行振込をサポートしています。サポートされている通貨は、顧客が Checkout で選択する通貨ではなく、Stripe アカウントの売上処理通貨です。このため、Stripe アカウントの売上処理通貨が USD の場合、決済で銀行振込による決済手段が表示されるのは USD で支払う顧客のみです。

• 有効化： 銀行振込を有効にすると、銀行振込は 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 決済を有効にしているのにウォレットボタンが表示されない場合は、トラブルシューティングページをご覧ください。

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