# Install and configure the Stripe app for Shopware 6

Learn how to install and configure the Stripe app for Shopware 6.

Use the Stripe app for [Shopware 6](https://www.shopware.com/en/) to integrate [Stripe Elements](https://docs.stripe.com/payments/elements.md) and accept more than 25 payment methods with a single integration. To use Stripe with [Shopware 6](https://www.shopware.com/en/), you must install and configure the Stripe app.

## Install the connector 

1. On the Shopware backoffice, go to **Extensions** > **My extensions** > **Shopware Account**, fill in your credentials, and click **Login**.

1. Go to **Extensions** > **Store**, and in the search bar enter “Stripe”.

1. Click **Stripe** > **Add extension** > **Add extension for free**.

1. Click **Install extension**.

After the installation finishes, Stripe is available in **My extensions**. Test the app before deploying it to production, because your environment might differ from other users’ environments.

> Don’t duplicate your production shop to use it as a staging environment. This can corrupt the data associated with the original production shop, due to the Shopware App infrastructure.

### Add Stripe as a payment method 

When the installation completes, view the app on your extensions page in the Shopware administration panel.

1. In the admin panel sidebar, under **Sales Channels**, select your [sales channel](https://docs.shopware.com/en/shopware-6-en/settings/saleschannel) to add Stripe as a payment method.

1. Under **Payment and shipping**, select **Pay with Stripe** from the **Payment methods** dropdown.

1. (Optional) To display Stripe first at checkout, select **Pay with Stripe** from the **Default payment method** dropdown.

1. Click **Save**.

### Update the app 

Use the Shopware administration panel to update the app when a new version is available. Under **Extensions**, select **My extensions**. To initialize the update process, select **Update** on the **Apps** tab for the Stripe app.

## Configure the app 

Use the Shopware administration panel to configure the app:

1. In the admin panel sidebar, under **Extensions**, select **My extensions**.

1. On the **Apps** tab, for the Stripe app, click the overflow menu (⋯) and select **Open extension**.

1. Configure the Stripe app for Shopware 6:

   - [Connect to Stripe to accept payments](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#connect-stripe)
   - [Choose your payment form](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#payment-form)
   - [Customize the payment form](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#customize-payment-form)
   - [Collect your customer’s postal code](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#postal-code)
   - [Choose how to capture funds](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#capture-funds)

## Connect to Stripe to accept payments 

Connect Shopware to your Stripe account to start accepting payments. When you connect to a new account, you must reactivate your preferred payment methods.

1. On the **Stripe Configuration** page, click **Connect with Stripe in Live Mode**. If you want to test different app functionality without processing live payments, use **Connect with Stripe in Test Mode**.

1. Provide your business information to [create your Stripe account](https://dashboard.stripe.com/register).

1. After you create your Stripe account, log in to your [Stripe Dashboard](https://dashboard.stripe.com/).

1. In the Stripe Dashboard:

   - Under **Settings** > **Payment methods**, select your Shopware account from the **Select your platform** dropdown.

   - Turn on your preferred payment methods individually or by using the **Turn on all** button.

The payment methods you choose for your Shopware app are separate from your [Stripe account payment methods](https://docs.stripe.com/payments/payment-methods/integration-options.md).

## Connect multiple channels 

You can use separate Stripe accounts to connect to different sales channels.

- For each channel, the **Sales Channels** tab in the Stripe configuration page displays:

  - A **Connect with Stripe in Test mode** button
  - A **Connect with Stripe in Live mode** button
  - The corresponding Stripe account name and Stripe account ID.

- Your main account is connected by default. Uncheck the **Use default account** checkbox and click **Connect with Stripe […]** to specify the Stripe account for each sales channel.

## Choose your payment form 

Configure the payment form that displays to your customers during checkout. Under **Payment form settings**, you can choose from the following:

- **Integrated payment form**: The [Payment Element](https://docs.stripe.com/payments/payment-element.md) is an embeddable UI component that lets you accept 25+ payment methods with a single integration.
- **Redirect to Stripe**: [Stripe Checkout](https://docs.stripe.com/payments/checkout.md) lets you redirect your customers to a Stripe-hosted, customizable checkout page to finalize payment.

## Customize the payment form 

You can configure the appearance of the integrated payment form in the following ways:

- Choose a prebuilt theme: **Stripe**, **Night**, **Flat**, or **None**.
- Position the payment form: **On top of the Shopware payment methods**, **At the bottom of the Shopware payment methods**, or **With the Shopware payment methods**.
- Use the [Elements Appearance API ](https://docs.stripe.com/elements/appearance-api.md) to customize individual aspects of the payment form by editing `Resources/app/storefront/src/StripePaymentsApp/stripe.appearance.js` in your local project.

You can customize the look and feel of Checkout in the [Dashboard](https://docs.stripe.com/payments/checkout/customization.md).

## Collect your customer’s postal code 

You can specify whether or not to collect your customer’s postal code at checkout using the **Never collect the postal code** field. Stripe recommends collecting and verifying postal code information, which can help decrease the card decline rate.

- (Recommended) **Unselect** this field if you want to require a postal code at checkout. This applies to cards issued in Canada, the United Kingdom, or the United States.

- **Select** this field if you don’t want to collect a postal code at checkout.

## Choose how to capture funds 

You can specify how you want to authorize and capture funds.

- **Simultaneous authorization and capture**: The issuing bank confirms that the cardholder can pay, and then transfers the funds automatically after confirmation.

- **Separate authorization and capture**: The authorization occurs first, and the capture occurs later. To capture funds, change the order’s payment status from `Authorized` to `Paid` or `Partially paid` in the Shopware administration panel.

## See also

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