# Stripe-App für Shopware 6 installieren und konfigurieren

Erfahren Sie, wie Sie die Stripe App für Shopware 6 installieren und konfigurieren.

Verwenden Sie die Stripe-App für [Shopware 6](https://www.shopware.com/en/), um [Stripe Elements](https://docs.stripe.com/payments/elements.md) zu integrieren und mehr als 25 Zahlungsmethoden mit einer einzigen Integration zu akzeptieren Um Stripe mit [Shopware 6](https://www.shopware.com/en/) zu verwenden, müssen Sie die Stripe-App installieren und konfigurieren.

## Connector installieren

1. Gehen Sie im Shopware-Backoffice zu **Erweiterungen** > **Meine Erweiterungen** > **Shopware-Konto**, geben Sie Ihre Zugangsdaten ein und klicken Sie auf **Anmelden**.

2. Gehen Sie zu **Erweiterungen** > **Store** und geben Sie in der Suchleiste „Stripe“ ein.

3. Klicken Sie auf **Stripe** > **Erweiterung hinzufügen** > **Kostenlose Erweiterung hinzufügen**.

4. Klicken Sie auf **Erweiterung installieren**.

Nach Abschluss der Installation ist Stripe unter **Meine Erweiterungen** verfügbar. Testen Sie die App vor der Bereitstellung in der Produktion, da sich Ihre Umgebung von der Umgebung anderer Nutzer/innen unterscheiden kann.

> Duplizieren Sie Ihren Produktionsshop nicht, um ihn als Staging-Umgebung zu verwenden. Dies kann aufgrund der Shopware-App-Infrastruktur die mit dem ursprünglichen Produktionsshop verknüpften Daten beschädigen.

### Stripe als Zahlungsmethode hinzufügen

Wenn die Installation abgeschlossen ist, sehen Sie sich die App auf Ihrer Erweiterungsseite im Admin-Bereich von Shopware an.

1. Wählen Sie in der Seitenleiste des Admin-Bereichs unter **Verkaufskanäle** Ihren [Verkaufskanal](https://docs.shopware.com/en/shopware-6-en/settings/saleschannel) aus, um Stripe als Zahlungsmethode hinzuzufügen.

2. Wählen Sie unter **Zahlung und Versand** die Option **Zahlung mit Stripe** aus dem Dropdown-Menü **Zahlungsmethoden** aus.

3. (Optional) Um Stripe beim Bezahlvorgang zuerst anzuzeigen, wählen Sie *Zahlung mit Stripe*\* aus der Dropdown-Liste **Standard-Zahlungsmethode**.

4. Klicken Sie auf **Speichern**.

### App aktualisieren

Verwenden Sie den Shopware-Admin-Bereich, um die App zu aktualisieren, wenn eine neue Version verfügbar ist. Wählen Sie unter **Erweiterungen** die Option **Meine Erweiterungen**. Um den Aktualisierungsprozess zu starten, wählen Sie **Aktualisieren** auf der Registerkarte **Apps** für die Stripe App.

## App konfigurieren

Verwenden Sie den Shopware-Admin-Bereich, um die App zu konfigurieren:

1. Wählen Sie in der Seitenleiste des Admin-Bereichs unter **Erweiterungen** die Option **Meine Erweiterungen** aus.

2. Klicken Sie auf der Registerkarte **Apps** für die Stripe-App auf das Überlaufmenü (⋯) und wählen Sie **Erweiterung öffnen** aus.

3. Konfigurieren Sie die Stripe-App für Shopware 6:

   - [Mit Stripe verbinden, um Zahlungen anzunehmen](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#connect-stripe)
   - [Zahlungsformular auswählen](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#payment-form)
   - [Zahlungsformular anpassen](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#customize-payment-form)
   - [Erfassen Sie die Postleitzahl Ihres Kunden/Ihrer Kundin](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#postal-code)
   - [Wählen Sie aus, wie die Gelder erfasst werden sollen](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#capture-funds)

## Verbinden Sie sich mit Stripe, um Zahlungen zu akzeptieren

Verbinden Sie Shopware mit Ihrem Stripe-Konto, um mit der Annahme von Zahlungen zu beginnen. Wenn Sie eine Verbindung zu einem neuen Konto herstellen, müssen Sie Ihre bevorzugten Zahlungsmethoden wieder aktivieren.

1. Klicken Sie auf der Seite **Stripe Configuration** (Stripe-Konfiguration) auf **Connect with Stripe in Live Mode** (Mit Stripe im Live-Modus verbinden). Wenn Sie verschiedene App-Funktionen testen möchten, ohne Live-Zahlungen zu verarbeiten, verwenden Sie **Connect with Stripe in Test Mode** (Mit Stripe im Test-Modus verbinden).

2. Geben Sie Ihre Unternehmensdaten an, um [Ihr Stripe-Konto zu erstellen](https://dashboard.stripe.com/register).

3. Nachdem Sie Ihr Stripe-Konto erstellt haben, melden Sie sich bei Ihrem [Stripe-Dashboard](https://dashboard.stripe.com/) an.

4. Im Stripe Dashboard:

   - Wählen Sie unter **Einstellungen** > **Zahlungsmethoden** in der Dropdown-Liste **Ihre Plattform auswählen** Ihr Shopware-Konto aus.

   - Aktivieren Sie Ihre bevorzugten Zahlungsmethoden einzeln oder über die Schaltfläche **Alle aktivieren**.

Die Zahlungsmethoden, die Sie für Ihre Shopware-App auswählen, unterscheiden sich von den [Zahlungsmethoden Ihres Stripe-Kontos](https://docs.stripe.com/payments/payment-methods/integration-options.md).

## Mehrere Kanäle verbinden

Sie können separate Stripe-Konten verwenden, um sich mit verschiedenen Sales-Kanälen zu verbinden.

- Die Registerkarte **Sales-Kanäle** wird für jeden Kanal auf der Seite Stripe-Konfiguration angezeigt:

  - Eine Schaltfläche für **Mit Stripe im Test-Modus verbinden**
  - Eine Schaltfläche für **Mit Stripe im Live-Modus verbinden**
  - Der entsprechende Stripe-Kontoname und die Stripe-Konto-ID.

- Ihr Hauptkonto ist standardmäßig verbunden. Deaktivieren Sie das Kontrollkästchen **Standardkonto verwenden** und klicken Sie auf **Mit Stripe verbinden […]**, um das jeweilige Stripe-Konto für jeden Vertriebskanal anzugeben.

## Wählen Sie Ihr Zahlungsformular

Konfigurieren Sie das Zahlungsformular, das Ihren Kund/innen während des Bezahlvorgangs angezeigt wird. Unter **Einstellungen für das Zahlungsformular** können Sie zwischen den folgenden Optionen wählen:

- **Integriertes Zahlungsformular**: Das [Zahlungselement](https://docs.stripe.com/payments/payment-element.md) ist eine einbettbare Komponente der Benutzeroberfläche, mit der Sie mehr als 25 Zahlungsmethoden mit einer einzigen Integration akzeptieren können.
- **Weiterleitung zu Stripe**: Mit [Stripe Checkout](https://docs.stripe.com/payments/checkout.md) können Sie Ihre Kundinnen/Kunden auf eine von Stripe gehostete, anpassbare Bezahlvorgang-Seite umleiten, um die Zahlung abzuschließen.

## Zahlungsformular anpassen

Das Erscheinungsbild des integrierten Zahlungsformulars können Sie folgendermaßen konfigurieren:

- Wählen Sie ein vorgefertigtes Design: **Stripe**, **Nacht**, **Flach** oder **Keine Auswahl**.
- Positionieren Sie das Zahlungsformular: **Über den Shopware-Zahlungsmethoden**, **Unter den Shopware-Zahlungsmethoden** oder **Bei den Shopware-Zahlungsmethoden**.
- Verwenden Sie die [Elements Appearance API](https://docs.stripe.com/elements/appearance-api.md), um einzelne Aspekte des Zahlungsformulars anzupassen, indem Sie `Resources/app/storefront/src/StripePaymentsApp/stripe.appearance.js` in Ihrem lokalen Projekt bearbeiten.

Sie können das Erscheinungsbild des Bezahlvorgangs im [Dashboard](https://docs.stripe.com/payments/checkout/customization.md) anpassen.

## Erfassen Sie die Postleitzahl Ihres/Ihrer Kund/in

Sie können festlegen, ob die Postleitzahl Ihres/Ihrer Kund/in beim Bezahlvorgang erfasst werden soll oder nicht, indem Sie das Feld **Die Postleitzahl niemals erfassen** verwenden. Stripe empfiehlt, die Postleitzahl zu erfassen und zu überprüfen, um die Anzahl der abgelehnten Karten zu verringern.

- (Empfohlen) **Deaktivieren** Sie dieses Feld, wenn Sie beim Bezahlvorgang eine Postleitzahl eingeben möchten. Dies gilt für Karten, die in Kanada, dem Vereinigten Königreich oder den Vereinigten Staaten ausgestellt wurden.

- **Wählen** Sie dieses Feld aus, wenn Sie beim Bezahlvorgang keine Postleitzahl eingeben möchten.

## Wählen Sie aus, wie die Gelder erfasst werden sollen

Sie können festlegen, wie Sie Gelder autorisieren und erfassen möchten.

- **Gleichzeitige Autorisierung und Erfassung**: Die ausstellende Bank bestätigt, dass der/die Karteninhaber/in zahlen kann, und überweist die Gelder nach der Bestätigung automatisch.

- **Getrennte Autorisierung und Erfassung**: Die Autorisierung erfolgt zuerst, die Erfassung später. Um Gelder zu erfassen, ändern Sie den Status der Zahlung im Shopware-Admin-Bereich von `Authorized` zu `Paid` oder `Partially paid`.

## See also

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