# Stripe Modul für PrestaShop installieren und konfigurieren Installieren und konfigurieren Sie das PrestaShop-Modul über den Stripe App Marketplace. Verwenden Sie das Stripe-Module für [PrestaShop](https://www.prestashop.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 [PrestaShop](https://www.prestashop.com/en) zu verwenden, müssen Sie die Stripe App installieren und dann konfigurieren. ## Modul installieren Installieren Sie die App für PrestaShop aus dem Stripe App Marketplace, um die neu generierten geheimen und veröffentlichbaren Schlüssel zu erhalten. Dieser Vorgang erhöht die Sicherheit Ihres Plugins, indem die Verwendung unterschiedlicher eingeschränkter Schlüssel für jede Integration mit Ihrem Stripe-Konto vereinfacht wird. Durch dieses Verfahren wird es überflüssig, manuell einen eigenen eingeschränkten Schlüssel zu erstellen oder einen geheimen Schlüssel zu verwenden. So installieren Sie die App und verstärken die Sicherheitsinfrastruktur Ihres Kontos: 1. Navigieren Sie zum [Stripe App Marketplace](https://marketplace.stripe.com/) und klicken Sie dann auf [PrestaShop-App installieren](https://marketplace.stripe.com/apps/install/link/com.stripe.PrestaShop.commerce). 1. Wählen Sie das Stripe-Konto aus, in dem Sie die App installieren möchten. 1. Überprüfen und genehmigen Sie die App-Berechtigungen, installieren Sie die App in einer *Sandbox* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes) oder im Live-Modus und klicken Sie dann auf **Installieren**. 1. Bewahren Sie die Schlüssel nach der Installation der App an einem sicheren Ort auf, an dem Sie sie nicht verlieren. Um sich daran zu erinnern, wo Sie sie gespeichert haben, können Sie [eine Notiz zu dem Schlüssel im Dashboard hinterlassen](https://docs.stripe.com/keys.md#reveal-an-api-secret-key-live-mode). 1. Verwenden Sie den neu generierten veröffentlichbaren Schlüssel und den Geheimschlüssel, um die App-Konfiguration abzuschließen. 1. Um die App zu verwalten oder nach der Installation neue Sicherheitsschlüssel zu generieren, rufen Sie die Seite mit den Anmeldeformular in einer Sandbox oder im [Live-Modus](https://dashboard.stripe.com/settings/apps/com.stripe.PrestaShop.commerce) auf. Sie können das Modul auch manuell installieren. [Laden Sie die ZIP-Datei](https://addons.prestashop.com/en/payment-card-wallet/24922-stripe-official-sca-ready.html) herunter und laden Sie das Modul im PrestaShop-Dashboard unter **Modul-Manager** hoch. ## Modul aktualisieren Verwenden Sie das PrestaShop-Dashboard, um das Modul zu aktualisieren, wenn eine neue Version verfügbar ist. Wählen Sie unter **Module** die Option **Modul-Manager**. Klicken Sie auf der Registerkarte **Module** für das Stripe-Modul auf **Upgrade** und dann auf **Trotzdem aktualisieren**. Wenn die Aktualisierung abgeschlossen ist, wird im Dashboard eine Benachrichtigung angezeigt. ## Modul konfigurieren Verwenden Sie das PrestaShop-Dashboard, um das Modul zu konfigurieren: 1. Wählen Sie unter **Module** die Option **Module Manager** (Modul-Manager). 1. Klicken Sie auf der Registerkarte **Module** für das **Stripe-Zahlungsmodul** auf **Konfigurieren**. 1. Konfigurieren Sie die Stripe-App für PrestaShop: - [Mit Stripe verbinden, um Zahlungen anzunehmen](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#connect-stripe) - [Zahlungsformular auswählen](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#payment-form) - [Zahlungsformular anpassen](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#customize-payment-form) - [Postleitzahl Ihres Kunden/Ihrer Kundin erfassen](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#postal-code) - [Auswählen, wie die Gelder erfasst werden sollen](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#capture-funds) - [Zahlungsmethoden des Kunden/der Kundin speichern](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#payment-methods) - [Auswählen, wann die Bestellung erstellt wird](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#order-creation) - [Erweiterte Protokollierung aktivieren](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#extended-logging) - [Herstellen einer Verbindung mit Cloud Sync und PrestaShop-Konto](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#cloudsync-prestashopaccount) ## Verbinden Sie sich mit Stripe, um Zahlungen zu akzeptieren Verbinden Sie PrestaShop mit Ihrem Stripe-Konto, um mit der Annahme von Zahlungen zu beginnen. 1. Klicken Sie auf der Seite **Stripe konfigurieren** auf **Mit Stripe verbinden**. 1. Navigieren Sie im PrestaShop-Dashboard zur Seite **Stripe Configure** (Stripe konfigurieren) und fügen Sie dann den Schlüssel aus dem Stripe PrestaShop-Modul in das entsprechende Feld ein. ## Zahlungsformular auswählen 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 1. Klicken Sie auf die Optionsschaltfläche **Integriertes Zahlungsformular**, um die Optionen zum Anpassen anzuzeigen. 1. Wählen Sie ein [Layout](https://docs.stripe.com/payments/payment-element.md#layout) für das **Integrierte Zahlungsformular** aus: - **Akkordeon mit Optionsschaltflächen** - **Akkordeon ohne Optionsschaltflächen** - **Registerkarten** 1. Wählen Sie aus, wo das Zahlungsformular positioniert werden soll: - **Am oberen Ende der PrestaShop-Zahlungsmethoden** - **Am unteren Ende der PrestaShop-Zahlungsmethoden** - **Mit den PrestaShop-Zahlungsmethoden** 1. Wählen Sie ein vorgefertigtes Design, das zu Ihrer Website passt: - **Stripe** - **Flach** - **Nachtmodus** - **Keine** Sie können auch [das Erscheinungsbild und das Verhalten des Bezahlvorgangs anpassen](https://docs.stripe.com/payments/checkout/customization.md). ## Express Checkout Element Mit dem Express Checkout Element können Sie Schaltflächen für One-Click-Zahlungen mit Link, Apple Pay, Google Pay und Amazon Pay anzeigen. Stripe sortiert die Schaltflächen für Zahlungen dynamisch nach Standort des Kunden/der Kundin, erkannter Umgebung und anderen optimierten Konversionsfaktoren. Im Backoffice können Sie das Express Checkout Element anpassen, nachdem Sie **Express Checkout aktivieren** aktiviert haben. 1. Geben Sie an, wo die Schaltflächen für die Zahlung mit einem Klick angezeigt werden sollen: - Auf der **Produktseite** - Auf der Seite mit dem **Warenkorb** 1. Wählen Sie verschiedene Themen und Typen für die Schaltflächen für Apple Pay und Google Pay. Sowohl eingeloggte Nutzer/innen als auch Gastkonten können über die Express Checkout-Schaltflächen einkaufen. Gastkonten können ihre Adressen über die Zahlungsschnittstelle eingeben. ## 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 Über das Feld **Getrennte Autorisierung und Erfassung aktivieren** können Sie angeben, wie Sie die Gelder autorisieren und erfassen möchten. - **Deaktivieren** Sie dieses Feld, um die gleichzeitige Autorisierung und Erfassung zu verwenden. Die ausstellende Bank bestätigt, dass der/die Karteninhaber/in zahlen kann, und überweist den Betrag nach der Bestätigung automatisch. - **Aktivieren** Sie dieses Feld, um eine getrennte Autorisierung und Erfassung zu verwenden. Die Autorisierung erfolgt zuerst, die Erfassung später. In der Regel können Sie eine Zahlung innerhalb eines Zeitfensters von 7 Tagen genehmigen. Führen Sie einen der folgenden Schritte aus, um Gelder zu erfassen: - Ändern Sie im PrestaShop-Dashboard den Zahlungsstatus der Bestellung von `Authorized` in den Status, den Sie im Feld **Catch-Status** angeben. Sie können z. B. `Shipped` als Catch-Status verwenden. Die Erfassung erfolgt automatisch, wenn sich der Status ändert. Wenn die Erfassung nicht erfolgreich ist, ändert sich der Status in den angegebenen Wert im Feld **Zum folgenden Bestellstatus wechseln, wenn die Autorisierung abläuft, bevor sie erfasst wird.**. - Wählen Sie im Stripe-Dashboard unter **Zahlungen** die Option **Alle Zahlungen**. Wählen Sie auf der Registerkarte **Nicht erfasst** die Bestellung aus und klicken Sie dann auf **Erfassen**. ## Zahlungsmethoden des Kunden/der Kundin speichern Mit der Einstellung **Zahlungsmethoden auf Kundenebene speichern** können Sie Kundinnen/Kunden erlauben, ihre Zahlungsdaten für einen schnelleren Bezahlvorgang zu speichern: - **Off**: Zahlungsmethoden werden nicht gespeichert. - **On-Session**: Kundinnen und Kunden werden beim Bezahlvorgang gefragt, ob sie ihre Zahlungsdaten für die zukünftige Verwendung speichern möchten. - **Off-Session**: Kundinnen und Kunden werden beim Bezahlvorgang gefragt, ob sie ihre Zahlungsdaten für die spätere Nutzung speichern möchten. Sie werden außerdem darüber informiert, dass sie durch die Angabe ihrer Karteninformationen zukünftige Abbuchungen gemäß Ihren Bedingungen autorisieren. Dies ist beispielsweise nützlich für Abonnementverlängerungen, Mahngebühren, Nebenkosten (z. B. Mietwagen) oder MOTO-Zahlungen. ## Wählen Sie, wann die Bestellung erstellt wird Sie können im Feld **Zahlungsablauf** angeben, wann die Bestellung während des Zahlungsvorgangs erstellt werden soll: - (Empfohlen) **Erstellen Sie die Bestellung, nachdem die Zahlung eingeleitet wurde**: Erstellt die Bestellung, wenn der Kunde/die Kundin auf die Schaltfläche **Bestellung aufgeben** klickt. - (Legacy) **Bestellung anlegen, nachdem die Zahlung bestätigt wurde**: Legt die Bestellung an, nachdem Stripe die Zahlung bestätigt hat. ## Erweiterte Protokollierung aktivieren Sie können **Erweiterte Protokollierung** aktivieren, um detaillierte Aktivitäten zur einfacheren Fehlerbehebung zu erfassen. Wenn diese Option deaktiviert ist, zeichnet das Modul nur Standard-Logs auf. ## Mit Cloud Sync und PrestaShop-Konto verbinden PrestaShop empfiehlt, Stripe mit **Cloud Sync** und **PrestaShop Account** zu verbinden, um die Daten Ihres Shops zu sichern und mit der Cloud von PrestaShop zu synchronisieren. Dies ermöglicht eine zentralisierte Verwaltung und Leistungsüberwachung in Echtzeit. 1. Klicken Sie auf der Seite **Stripe Configure** im Abschnitt **Link\** auf ** Verbinden Sie Ihren Shop mit einem PrestaShop-Konto\**. 1. Klicken Sie auf **Akzeptieren und verknüpfen**. 1. Klicken Sie auf **Installation fortsetzen**. Ein grünes Häkchen und eine Meldung bestätigen, dass Sie Ihren Shop erfolgreich mit dem PrestaShop-Konto verknüpft haben. 1. Klicken Sie auf der Seite **Stripe Configure** im Abschnitt **Ihre Daten mit dem Zahlungsmodul von Stripe teilen** auf **„Meine Daten freigeben“**. 1. Klicken Sie auf **Zulassen**. Ein grünes Häkchen und eine Meldung bestätigen, dass die Datensynchronisierung erfolgreich war. Wenn in Prestashop 1.7 **Multishop** und **Alle Shops** ausgewählt ist, bleibt das Dialogfeld zur Installation von Abhängigkeiten möglicherweise stehen. Klicken Sie zum Fortfahren entweder auf **Überspringen** oder wählen Sie einen bestimmten Shop aus, um auf die App-Konfiguration zuzugreifen. ## Rückerstattungen Um eine Zahlung zu erstatten, benötigen Sie die Stripe-Zahlungs-ID für die Bestellung. 1. Wählen Sie im PrestaShop-Dashboard unter **Orders** (Bestellungen) die Option **Orders** (Bestellungen) aus. 1. Suchen Sie die Bestellung, die Sie erstatten möchten, und kopieren Sie die **Zahlungs-ID** unter **Stripe**. 1. Um eine vollständige oder teilweise Rückerstattung zu veranlassen, gehen Sie wie folgt vor: 1. Gehen Sie im **Stripe-Zahlungsmodul** zur Registerkarte **Rückerstattung**. 1. Fügen Sie in das Feld **Stripe-Zahlungs-ID** die Zahlungs-ID ein. 1. Wählen Sie **Vollständige Rückerstattung** oder **Teilrückerstattung** aus. Wenn Sie eine Teilerstattung veranlassen möchten, müssen Sie den zu erstattenden Betrag angeben. 1. Klicken Sie auf **Rückerstattung anfordern**. ## Payment Method Messaging Element Das **Payment Method Messaging Element** ist eine dynamische Komponente der Nutzeroberfläche, die Kundinnen und Kunden vor dem Bezahlvorgang über verfügbare **Jetzt kaufen, später bezahlen**-Optionen informiert. - **Funktionalität:** Die Komponente zeigt automatisch lokalisierte Ratenzahlungspläne an, die auf dem Standort, der Währung und der Gesamtsumme der Bestellung des Kunden/der Kundin basieren. - **Platzierung:** Wird auf der **Produktseite** und der **Warenkorbseite** angezeigt. - **Design:** Übernimmt automatisch das Design Ihrer Website, sodass sich ein nahtloses Erscheinungsbild ergibt.