Stripe Connector for Adobe Commerce konfigurieren
Um Stripe Connector for Adobe Commerce zu konfigurieren, gehen Sie unter Stores > Configuration > Sales > Payment Methods (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 geheimen Schlü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 Install the Adobe Commerce app (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.
- 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.
- Verwenden Sie den neu generierten veröffentlichbaren Schlüssel und den geheimen Schlü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
- Mode (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.
- Hold Elevated Risk Orders (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. - Receipt Emails (Zahlungsbeleg-E-Mails): Wenn diese Option aktiviert ist, sendet Stripe nach erfolgreicher Zahlung eine Zahlungsbeleg-E-Mail an den/die Kund/in. Die Formatierungen und das Branding der E-Mails können Sie über Ihre Stripe-Kontoeinstellungen anpassen.
Payments
- Enabled (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.
- Payment flow (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 Kund/innen 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 3-spaltigen Bezahlseiten. Sie können die beiden Layouts in der interaktiven Nutzeroberflächenkomponente des PaymentElement testen.
- Title (Überschrift): Die Überschrift, die dem/der Kund/in auf der Bezahlseite angezeigt werden soll.
- Konfiguration der Zahlungsmethode: Stripe unterstützt mehrere Konfigurationen von Zahlungsmethoden. Nachdem Sie die Zahlungsmethoden konfiguriert haben, sind diese sofort im Dropdown-Menü verfügbar. Sie können je nach Geschäftsanforderungen für jede Ihrer Store-Ansichten eine andere Konfiguration auswählen.
- Payment Action (Zahlungsaktion): Wählen Sie einen Zahlungsmodus aus:
- Authorize and Capture (Autorisieren und Erfassen): Belasten Sie Kundenkarten unmittelbar nach einem Einkauf.
- Authorize Only (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.
- Order (Bestellung): Speichern Sie die Zahlungsmethode des Kunden/der Kundin, 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 (Abgelaufene Autorisierungen): Bei Kartenzahlungen, die Sie nicht sofort erfassen, müssen Sie dies innerhalb von 7 Tagen tun. 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 ursprünglich für diese Bestellung verwendeten Karte wiederherzustellen. Das Modul speichert Karten automatisch im Modus Authorized Only (Nur autorisiert), und der/die Kund/in kann sie erst aus dem Kontobereich löschen, wenn Sie die Bestellung entweder in Rechnung stellen oder stornieren.
- Automatic Invoicing (Automatische Rechnungsstellung): Mit der Option „Authorize only“ (Nur autorisieren) wird beim Bezahlvorgang eine neue Rechnung mit dem Status „Pending“ (Ausstehend) erstellt. Nach der Erfassung dieser Zahlung wechselt der Rechnungsstatus zu „Paid“ (Bezahlt). Diese Option ist nützlich, wenn „Payment Action“ (Zahlungsaktion) auf „Authorize only“ (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 Kund/innen senden können, bevor Sie ihnen den Betrag in Rechnung stellen.
- Save customer payment method (Zahlungsmethode des/der Kund/in speichern): Aktivieren Sie diese Option, damit Kund/innen ihre zuletzt verwendete Zahlungsmethode im Stripe-Tresor speichern und später für einen schnelleren Bezahlvorgang wiederverwenden können.
- Card Icons (Kartensymbole): Zeigen Sie Kartensymbole basierend auf den Kartenmarken an, die Ihr Stripe-Konto unterstützt.
- Optional Statement Descriptor (Optionale Zahlungsbeschreibung): 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 (Sortierreihenfolge): Wenn Sie mehrere Zahlungsmethoden aktiviert haben, legen Sie mit dieser Einstellung fest, in welcher Reihenfolge sie auf der Bezahlseite angezeigt werden.
Express Checkout
Mit Express Checkout können Kundinnen und Kunden Bestellungen über Ein-Klick-Wallet-Schaltflächen wie Link, Apple Pay und Google Pay aufgeben. Wenn es vom Gerät des Kunden/der Kundin unterstützt wird, können Sie mehrere Wallets in beliebiger Reihenfolge anzeigen. Legen Sie Ihre Einstellungen im speziellen Konfigurationsbereich des Admin-Panels von Adobe Commerce fest.
Konfigurationsoptionen für Apple Pay und Google Pay
- Enabled (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.
- Locations (Standorte): Geben Sie die Seiten an, auf denen die Wallet-Schaltflächen angezeigt werden sollen.
- Seller name (Verkäufername): Ihr Firmenname, der im Zahlungsmodal angezeigt wird.
- Button height (Schaltflächen-Höhe): Sie können die Höhe der Schaltfläche anpassen, damit sie mit den Schaltflächen Add to Cart (Zum Warenkorb hinzufügen) und Proceed to Checkout (Weiter zur Kasse) Ihres Designs übereinstimmt.
- Sort order (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 Use sort order field (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 die Bank eines Kunden/einer Kundin 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 Adminbereich von Magento aktualisieren.
- Jedes Mal, wenn Sie die URL eines Stores im Adminbereich 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, 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.