Stripe Connector for Adobe Commerce konfigurieren

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

Um Stripe Connector for Adobe Commerce zu konfigurieren, gehen Sie unter Shops > Konfiguration > Verkauf > Zahlungsmethoden zum entsprechenden Konfigurationsabschnitt:

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.

Stripe Adobe Commerce-App installieren

Verwenden Sie Stripe Apps, um die Sicherheit zu erhöhen und die Verwendung unterschiedlicher eingeschränkter Schlüssel für jede Integration mit Ihrem Stripe-Konto zu vereinfachen. Der Prozess der Installation der Stripe-App und des Erwerbs der neu generierten geheimen und veröffentlichbaren Schlüssel ist für Ihre Integration mit dem Adobe Commerce-Connector von wesentlicher Bedeutung. Dieser Ansatz macht es überflüssig, manuell einen eigenen eingeschränkten Schlüssel zu erstellen oder einen Geheimschlüssel zu verwenden. So integrieren Sie die Adobe Commerce-App und verstärken die Sicherheitsinfrastruktur Ihres Kontos:

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 im Test-Modus oder 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.
Verwenden Sie den neu generierten veröffentlichbaren Schlüssel und den Geheimschlüssel, um die Connector-Konfiguration abzuschließen.
Um die App zu verwalten oder nach der Installation neue Sicherheitsschlüssel zu generieren, navigieren Sie im Test-Modus oder im Live-Modus zur Seite mit den Anwendungseinstellungen.

Allgemeine Einstellungen

Modus: Wir empfehlen, dass Sie die Integration zunächst im Test-Modus testen. Wechseln Sie zum Live-Modus, wenn Sie bereit sind, Live-Transaktionen anzunehmen. Erfahren Sie mehr über das Testen von Zahlungen bei Stripe.
API-Schlüssel: Geben Sie die Test- und Live-Schlüssel ein, die Stripe Ihnen in der Adobe Commerce-App zur Verfügung stellt.
Bestellungen mit erhöhtem Risiko zurückhalten: Wenn Stripe Radar eine Bestellung mit dem Status Elevated Risk kennzeichnet, wird die Bestellung On Hold gesetzt, bis die Zahlung überprüft wurde. Weitere Informationen finden Sie unter Betrugsprävention mit Stripe Radar.
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.
- Nur autorisieren: Autorisieren Sie den Zahlungsbetrag und merken Sie die Karte vor. Sie können den Betrag später erfassen, indem Sie eine Rechnung ausstellen.
- 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.

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.

Wenn Sie Express Checkout aktivieren und die Wallet-Schaltflächen nicht angezeigt werden, finden Sie weitere Informationen auf der Seite zur Fehlerbehebung.

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.