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.
- After you install the app, store the keys in a safe place where you won’t lose them. To help yourself remember where you stored them, you can leave a note on the key in the Dashboard.
- 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 BestellungOn 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.
- Expired authorizations: For card payments that you don’t capture immediately, you must do so within 7 days. Any attempt to capture the amount after that returns an error. By enabling this option, the module attempts to recreate the original payment with the original card used for that order. The module saves cards automatically in
Authorize Only
mode and the customer can’t delete them from their account section until you either invoice or cancel the order. - 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.
- Sort Order: If you’ve enabled multiple payment methods, this setting determines the order to present payment methods on the checkout page.
- Filter payment methods: Stripe supports multiple configurations of payment methods. After you configure the payment methods, they immediately become available in the dropdown menu. You can select a different configuration for each of your store views, based on business requirements. You can additionally select a different payment method configuration for virtual carts, which filters out payment methods that don’t allow selling virtual items, such as 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.
- Overflow: When set to
Automatic
, the wallet buttons collapse or expand, depending on the size of their container. When set toExpanded
, all wallet buttons are visible, regardless of the container size. - 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.