Stripe Connector for Adobe Commerce konfigurieren

Richten Sie Zahlungsmethoden und andere Optionen mit dem Stripe Connector for Adobe Commerce ein.

To configure the plugin navigate to the configuration section for it (Stores > Configuration > Sales > Payment Methods):

Konfiguration des Stripe-Moduls

Stripe wird auf Ihrer Bezahlseite erst angezeigt, nachdem Sie Ihre API-Schlüssel konfiguriert haben. Wenn Sie noch kein Stripe-Konto haben, können Sie sich online registrieren.

Install the Adobe Commerce app from the Stripe App Marketplace

Install the app for Adobe Commerce from the Stripe App Marketplace to acquire the newly generated secret and publishable keys. This process bolsters the security of your plugin by simplifying the use of distinct restricted keys for each integration with your Stripe account. This approach eliminates the need to manually create your own restricted key or use a secret key. To install the app and reinforce your account’s security infrastructure:

Navigieren Sie zum Stripe App Marketplace und klicken Sie dann auf Adobe Commerce-App installieren.
Wählen Sie das Stripe-Konto aus, in dem Sie die App installieren möchten.
Überprüfen und genehmigen Sie die App-Berechtigungen, installieren Sie die App in einer Sandbox oder im Live-Modus und klicken Sie dann auf Installieren.
Nach der Installation der App sollten Sie die Schlüssel an einem sicheren Ort aufbewahren, an dem Sie sie nicht verlieren können. Um sich besser daran zu erinnern, wo Sie sie aufbewahrt haben, können Sie eine Notiz auf dem Schlüssel im Dashboard hinterlassen.
Use the newly generated publishable key and secret key to finish the plugin configuration.
Um die App zu verwalten oder nach der Installation neue Sicherheitsschlüssel zu generieren, navigieren Sie in einer Sandbox oder im Live-Modus zur Seite mit den Anwendungseinstellungen.

Allgemeine Einstellungen

Modus: Wir empfehlen, die Integration zunächst in einer Sandbox zu testen. Wechseln Sie in den Live-Modus, wenn Sie bereit sind, Live-Transaktionen anzunehmen. Weitere Informationen zu Sandboxes.
API-Schlüssel: Geben Sie die Test- und die Live-Schlüssel ein, die Stripe Ihnen in der Adobe Commerce-App zur Verfügung stellt.
Hold Elevated Risk Orders: If Stripe Radar marks a payment with an Elevated Risk status, the module places the order On Hold until you review the payment. See the section Enabling fraud prevention features with Stripe Radar for additional details.
Zahlungsbeleg-E-Mails: Wenn diese Option aktiviert ist, sendet Stripe nach erfolgreicher Zahlung eine Zahlungsbeleg-E-Mail an die Kundin/den Kunden. Die Formatierungen und das Branding der E-Mails können Sie über Ihre Stripe-Kontoeinstellungen anpassen.

Zahlungen

Aktiviert: Aktivieren oder deaktivieren Sie Stripe als verfügbare Zahlungsmethode für die standardmäßige Bezahlseite, die Bezahlseite für den Mehrfachversand und für den Admin-Bereich.
Zahlungsablauf: Wählen Sie Ihren bevorzugten Zahlungsablauf für die standardmäßige Bezahlseite aus. Durch den eingebetteten Zahlungsablauf integrieren wird ein iFrame-basiertes Payment Element direkt in die Bezahlseite. Durch die Weiterleitung des Zahlungsablaufs leiten wir Kundinnen/Kunden an Stripe Checkout weiter, um ihre Zahlung abzuschließen.
Formularlayout: Zeigen Sie die Zahlungsmethodenauswahl im horizontalen Layout (Registerkarten) oder vertikalem Layout (Akkordeon) an. Für schmale Bereiche empfehlen wir das vertikale Layout, also z. B. auf Mobilgeräten oder dreispaltigen Bezahlseiten. Sie können die beiden Layouts in der interaktiven Nutzeroberflächenkomponente des PaymentElement testen.
Überschrift: Die Überschrift, die der Kundin/dem Kunden auf der Bezahlseite angezeigt werden soll.
Zahlungsaktion: Wählen Sie einen Zahlungsmodus aus:
- Autorisieren und Erfassen: Belasten Sie Kundenkarten unmittelbar nach einem Einkauf.
- Authorize Only: Authorize the payment amount and place a hold on the card. You can capture the amount later by issuing an invoice.
- Bestellung: Speichern Sie die Zahlungsmethode der Kundin/des Kunden, ohne zu versuchen, eine Autorisierung oder Erfassung durchzuführen. Sie können die Zahlung für eine in diesem Modus verarbeitete Bestellung einziehen, indem Sie eine Rechnung über den Verwaltungsbereich ausstellen.
Abgelaufene Autorisierungen: Kartenzahlungen, die Sie nicht sofort erfassen, müssen Sie innerhalb von 7 Tagen erfassen. Jeder Versuch, den Betrag danach zu erfassen, führt zu einem Fehler. Wenn Sie diese Option aktivieren, versucht das Modul, die ursprüngliche Zahlung mit der für diese Bestellung verwendeten Originalkarte neu zu erstellen. Das Modul speichert Karten automatisch im Modus Authorize Only und der Kunde/die Kundin kann sie nicht aus seinem/ihrem Kontobereich löschen, bis Sie die Bestellung entweder in Rechnung stellen oder stornieren.
Automatische Rechnungsstellung: Mit der Option „Nur autorisieren“ wird beim Bezahlvorgang eine neue Rechnung mit dem Status „Ausstehend“ erstellt. Nach der Erfassung dieser Zahlung wechselt der Rechnungsstatus zu „Bezahlt“. Diese Option ist nützlich, wenn „Zahlungsaktion“ auf „Nur autorisieren“ gesetzt ist. Der Abschluss des Bezahlvorgangs hat keine Rechnung zur Folge. Wenn diese Option aktiviert ist, generiert das Modul automatisch beim Abschluss des Bezahlvorgangs eine Rechnung, die Sie per E-Mail an die Kundinnen/Kunden senden können, bevor Sie ihnen den Betrag in Rechnung stellen.
Zahlungsmethode der Kundin/des Kunden speichern: Aktivieren Sie diese Option, damit Kundinnen/Kunden ihre zuletzt verwendete Zahlungsmethode im Stripe-Tresor speichern und später für einen schnelleren Bezahlvorgang wiederverwenden können.
Kartensymbole: Zeigen Sie Kartensymbole basierend auf den Kartenmarken an, die Ihr Stripe-Konto unterstützt.
Optionale Zahlungsbeschreibung in der Abrechnung: Dies ist eine optionale Kurzbeschreibung für die Quelle der Zahlung, die auf Kontoauszügen angezeigt wird. Wenn Sie hier nichts angeben, gilt die Standardbeschreibung, die in Ihrem Stripe-Dashboard konfiguriert ist. Diese Option ist nicht für Multibanco, SEPA-Lastschrift oder Sofort verfügbar.
Sortierreihenfolge: Wenn Sie mehrere Zahlungsmethoden aktiviert haben, bestimmt diese Einstellung die Reihenfolge, in der die Zahlungsmethoden auf der Bezahlseite angezeigt werden.
Zahlungsmethoden filtern: Stripe unterstützt mehrere Konfigurationen von Zahlungsmethoden. Nachdem Sie die Zahlungsmethoden konfiguriert haben, sind sie sofort im Dropdown-Menü verfügbar. Sie können für jede Ansicht Ihres Shops eine andere Konfiguration auswählen, je nach den geschäftlichen Anforderungen. Sie können außerdem eine andere Konfiguration für virtuelle Warenkörbe auswählen, die Zahlungsmethoden herausfiltert, die den Verkauf virtueller Artikel nicht zulassen, wie z. B. Afterpay/Clearpay.

Banküberweisungen

Banküberweisungen bieten Kundinnen/Kunden eine sichere Möglichkeit, Geld über Bankschienen zu senden. Wenn Sie Banküberweisungen mit Stripe annehmen, geben Sie Kundinnen/Kunden eine virtuelle Bankkontonummer, auf die sie Geld von ihrer eigenen Online-Bankschnittstelle oder persönlichen Bankfiliale verschieben können. Mithilfe dieser virtuellen Kontonummer wird der Abgleich automatisiert und verhindert, dass Ihre echten Kontodaten Kundinnen/Kunden zugänglich gemacht werden.

The plugin supports bank transfers for a subset of currencies. The supported currencies are the settlement currencies of your Stripe account, rather than the currency which the customer selects at your checkout. This means that if your Stripe account settlement currency is USD, then only customers paying in USD are able to see the bank transfer payment method on your checkout.

Aktivieren: Wenn Sie Banküberweisungen aktivieren, werden diese als separate Zahlungsmethode im PaymentElement-Formular angezeigt. Das bedeutet, dass Sie einen separaten Titel und eine separate Sortierreihenfolge festlegen können.
Titel: Der Titel, der beim Bezahlvorgang für diese Zahlungsmethode angezeigt werden soll.
Mindestbetrag: Wenn der Warenkorbbetrag unter dem Mindestbetrag liegt, wird die Zahlungsmethode beim Bezahlvorgang ausgeblendet. Der Betrag wird in der konfigurierten Basiswährung des Shops angegeben.
Standard-EU-Land: Obwohl jede/r in der EU eine Bestellung per Banküberweisung aufgeben kann, können virtuelle Bankkonten nur für fünf aller EU-Länder erstellt werden. Wenn sich die Rechnungsadresse des Kunden/der Kundin in einem dieser Länder befindet, wird das virtuelle Bankkonto automatisch für dieses Land erstellt. Wenn nicht, wird der Länderwert, den Sie hier konfigurieren, verwendet, um das virtuelle Bankkonto zu generieren.
Sortierreihenfolge: Die Sortierreihenfolge der Zahlungsmethode im Vergleich zu anderen aktivierten Zahlungsmethoden beim Bezahlvorgang.

Express Checkout

Mit Express Checkout können Kundinnen und Kunden Bestellungen über Wallet-Schaltflächen für die Zahlung mit einem Klick wie Link, Apple Pay und Google Pay aufgeben. Wenn das Wallet vom Gerät der Kundin/des Kunden unterstützt wird, können Sie mehrere Wallets in beliebiger Reihenfolge anzeigen. Legen Sie Ihre Einstellungen im entsprechenden Konfigurationsabschnitt des Adobe Commerce-Administrationsbereichs fest.

Konfigurationsoptionen für Apple Pay und Google Pay

Aktiviert: Schaltet die Wallet-Schaltfläche als verfügbare Zahlungsmethode für ausgewählte Standorte um. Sie können sie auch dann aktivieren, wenn regelmäßige Zahlungen deaktiviert sind.
Standorte: Geben Sie die Seiten an, auf denen die Wallet-Schaltflächen angezeigt werden sollen.
Verkäufername: Ihr Firmenname, der im Zahlungsmodal angezeigt wird.
Schaltflächen-Höhe: Sie können die Höhe der Schaltfläche anpassen, damit sie mit den Schaltflächen Zum Warenkorb hinzufügen und Weiter zur Kasse Ihres Designs übereinstimmt.
Überlauf: Bei der Einstellung Automatic werden die Wallet-Schaltflächen je nach Größe des Containers reduziert oder erweitert. Bei der Einstellung Expanded sind alle Wallet-Schaltflächen sichtbar, unabhängig von der Containergröße.
Sortierreihenfolge: Standardmäßig ordnet Stripe Wallets in einer optimalen Reihenfolge an, der Faktoren wie Gerätefunktionen und Nutzung zugrunde liegen. Sie können jeder Wallet in ihrem Unterkonfigurationsbereich eine Sortierreihenfolge zuweisen, indem Sie die Option Feld für Sortierreihenfolge verwenden auswählen.

If you enable Express Checkout and the wallet buttons don’t appear, refer to the troubleshooting page.

Webhooks

Stripe verwendet Webhooks, um Ihre Anwendung zu benachrichtigen, wenn ein Ereignis in Ihrem Konto stattfindet. Webhooks sind besonders nützlich für die Aktualisierung von Magento-Bestellungen, wie wenn eine Kundenbank eine Zahlung bestätigt oder ablehnt oder beim Einziehen von Abonnementzahlungen. Dank dieser Ereignisse kann das Modul Magento-Bestellungen als für die Abwicklung bereit markieren, Rückerstattungen dafür erfassen oder Kommentare zu Gründen für fehlgeschlagene Zahlungen hinzufügen.

Ab Version 3 des Moduls müssen Sie Webhooks nicht mehr manuell konfigurieren. Das Modul prüft und konfiguriert Webhooks in den folgenden Fällen automatisch:

Wenn Sie das Modul installieren oder aktualisieren und den Befehl setup:upgrade auslösen.
Jedes Mal, wenn Sie die API-Schlüssel im Admin-Bereich von Magento aktualisieren.
Jedes Mal, wenn Sie die URL eines Stores im Admin-Bereich von Magento ändern.
Wenn das Modul während einer der stündlichen automatischen Prüfungen eine Änderung in der Datenbank feststellt. Dadurch wird verhindert, dass Webhooks aufgrund einer manuellen Änderung an der Datenbank, einer Migration von einem anderen Server oder einer Sicherungswiederherstellung beschädigt werden.

Beim Aktualisieren von Webhooks erstellt das Modul einen einzelnen Webhook-Endpoint pro Stripe-Konto. Wenn Sie beispielsweise fünf Store-Ansichten haben und davon vier ein- und dasselbe Stripe-Konto verwenden und die fünfte ein anderes Stripe-Konto verwendet, erstellt das Modul zwei Webhook-Endpoints.

Dies gilt auch, wenn Sie für Ihre Store-Ansichten unterschiedliche Domain-Namen verwenden. In diesem Fall verwendet das Modul eine der Domains der Store-Ansicht und nicht Ihre Basis-URL. Dadurch sollen Probleme verhindert werden, die entstehen, wenn sich Basis-URLs aus Sicherheitsgründen häufig hinter einer Firewall befinden.

Das Modul verwendet Webhook-Signaturen, um zu verifizieren, dass die Ereignisse von Stripe und nicht von einem Drittanbieter gesendet wurden. Sie können diesen Schutz nur deaktivieren, wenn Ihre Magento-Instanz den Entwicklermodus verwendet.