# Shopware 6 用の Stripe アプリをインストールして設定する

Shopware 6 用の Stripe アプリのインストールと設定方法を説明します。

[Shopware 6](https://www.shopware.com/en/)用の Stripe アプリを使用して [Stripe Elements](https://docs.stripe.com/payments/elements.md)を導入し、1 回の導入で 25 種類以上の決済手段を受け付けます。[Shopware 6](https://www.shopware.com/en/)で Stripe を使用するには、Stripe アプリをインストールして設定する必要があります。

## コネクターをインストール

1. Shopware のバックオフィスで、**拡張機能** > **マイ拡張機能** > **Shopware アカウント** に移動し、認証情報を入力して **ログイン** をクリックします。

1. **拡張機能** > **ストア** に移動し、検索バーに「Stripe」と入力します。

1. **Stripe** > **拡張機能の追加** > **拡張機能を無料で追加** をクリックします。

1. **拡張機能をインストール** をクリックします。

インストールが完了すると、**マイ拡張機能** で Stripe を利用できるようになります。環境は他のユーザーの環境と異なる場合がありますので、本番環境にデプロイする前にアプリをテストしてください。

> ステージング環境として使用する目的で本番環境のショップを複製しないでください。Shopware App のインフラストラクチャーが原因で、元の本番環境のショップに関連付けられたデータが破損する可能性があります。

### Stripe を決済手段として追加する

インストールが完了したら、Shopware 管理パネルの拡張機能ページでアプリを表示します。

1. 管理パネルのサイドバーの **販売チャネル** で、決済手段として Stripe を追加する[販売チャネル](https://docs.shopware.com/en/shopware-6-en/settings/saleschannel)を選択します。

1. **決済と配送** で、**決済手段** のドロップダウンから **Stripe で決済** を選択します。

1. (オプション) チェックアウト時に Stripe を最初に表示するには、**デフォルトの決済手段** ドロップダウンから **Stripe で決済** を選択します。

1. **保存**をクリックします。

### アプリを更新する

Shopware の管理画面を使用して、新しいバージョンが利用できるようになったときにアプリを更新します。**拡張機能** で **マイ拡張機能** を選択します。更新プロセスを開始するには、**アプリ** タブで Stripe アプリの **更新** を選択します。

## アプリを設定する

Shopware の管理画面を使用してアプリを設定します。

1. 管理パネルのサイドバーの**拡張機能**の下で、**My extensionss (自分の拡張機能)** を選択します。

1. **Apps (アプリ)** タブで、Stripe アプリのオーバーフローメニュー (⋯) をクリックして **Open extension (拡張機能を開く)** を選択します。

1. Shopware 6 用の Stripe アプリを設定します。

   - [Stripe と連結して決済を受け付ける](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#connect-stripe)
   - [決済フォームを選択する](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#payment-form)
   - [支払いフォームをカスタマイズする](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#customize-payment-form)
   - [顧客の郵便番号を徴収する](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#postal-code)
   - [売上のキャプチャー方法を選択する](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#capture-funds)

## Stripe と連結して決済を受け付ける

Stripe アカウントに Shopware を連携させて決済の受け付けを開始します。新しいアカウントを連携するときは、希望する支払い方法を再度有効にする必要があります。

1. **Stripe Configuration (Stripe 設定)** ページで、**Connect with Stripe in Live Mode (本番環境の Stripe と連携)** をクリックします。本番環境の支払いを処理せずにさまざまなアプリの機能をテストするには、**Connect with Stripe in Test Mode (テスト環境の Stripe と連携)** を使用します。

1. ビジネス情報を入力して [Stripe アカウントを作成](https://dashboard.stripe.com/register)します。

1. Stripe アカウントの作成後に、[Stripe ダッシュボード](https://dashboard.stripe.com/)にログインします。

1. Stripe ダッシュボードで以下を実行します。

   - **設定** > **決済手段** で、**プラットフォームを選択** ドロップダウンから Shopware アカウントを選択します。

   - 希望の支払い方法を個別に有効にするか、**すべて有効にする**ボタンを使用します。

Shopware アプリ用に選択する決済手段は、[Stripe アカウントの決済手段](https://docs.stripe.com/payments/payment-methods/integration-options.md) とは別です。

## 複数のチャネルを連結する

別個の Stripe アカウントを使用して、複数の販売チャネルに関連付けることができます。

- Stripe 設定ページの**販売チャネル**タブには、チャネルごとに以下のものが表示されます。

  - **テスト環境で Stripe と連結**ボタン
  - **本番環境で Stripe と連結**ボタン
  - 対応する Stripe アカウント名と Stripe アカウント ID。

- メインアカウントはデフォルトで連結されます。**デフォルトのアカウントを使用**のチェックを外し、**[…] で Stripe と連結**をクリックして、各販売チャネルの Stripe アカウントを指定します。

## 決済フォームを選択する

購入時に顧客に表示する決済フォームを設定します。**決済フォームの設定**の下で、以下から選択できます。

- **統合された決済フォーム**: [Payment Element](https://docs.stripe.com/payments/payment-element.md) は、一度の導入で 25 種類以上の決済手段の受け付けを可能にする埋め込み可能な UI コンポーネントです。
- **Stripe へのリダイレクト**: [Stripe Checkout](https://docs.stripe.com/payments/checkout.md) を使用すると、顧客が決済を確定できるよう、Stripe がホストするカスタマイズ可能な Checkout ページにリダイレクトできます。

## 決済フォームをカスタマイズする

組み込まれた支払いフォームのデザインは以下のような設定ができます。

- **Stripe**、**夜間**、**フラット**、または**なし**から構築済みのテーマを選択します。
- 支払いフォームの配置: **Shopware 決済手段の上部**、**Shopware 決済手段の下部**、または **Shopware 決済手段に併記**。
- [Elements Appearance API](https://docs.stripe.com/elements/appearance-api.md) を使用して、ローカルプロジェクトで `Resources/app/storefront/src/StripePaymentsApp/stripe.appearance.js` を編集して、支払いフォームの個々の部分をカスタマイズします。

[ダッシュボード](https://docs.stripe.com/payments/checkout/customization.md)で Checkout のデザインをカスタマイズできます。

## 顧客の郵便番号を収集する

**Never collect the postal code (郵便番号を収集しない)** フィールドを使用して、購入時に顧客の郵便番号を収集するかどうかを指定できます。Stripe では、カード支払いの拒否率の削減に役立つため、郵便番号情報を収集して確認することをお勧めしています。

- (推奨) 決済時に郵便番号の入力を求める場合は、このフィールドを**未選択**にします。この設定は、カナダ、イギリス、アメリカで発行されたカードに適用されます。

- 決済時に郵便番号を収集する必要がない場合は、このフィールドを**選択**します。

## 売上のキャプチャー方法を選択する

売上のオーソリとキャプチャー方法を指定できます。

- **オーソリとキャプチャーの同時実行**: カード発行会社はカード保有者が決済可能であることを確認したら、確定後に売上を自動的に送金します。

- **オーソリとキャプチャーの分離**: 最初にオーソリが実行され、後からキャプチャーが実行されます。売上をキャプチャーするには、Shopware の管理画面で注文の決済ステータスを `Authorized` から `Paid` または `Partially paid` に変更します。

## See also

- [概要](https://docs.stripe.com/use-stripe-apps/shopware6.md)