Braintree

Braintree bietet ein vollständig anpassbares Checkout-Erlebnis mit Betrugserkennung und PayPal-Integration. Braintree reduziert die PCI-Compliance-Belastung für Händler, da die Transaktion auf dem Braintree-System stattfindet.

Wenn Sie ein Upgrade auf 2.4.x von einer früheren Version von Adobe Commerce und Magento Open Source durchführen und die Braintree-Erweiterung vom Magento Marketetplace installiert haben, lesen Sie die 2.4 Migrationshinweise am Ende dieses Themas.

Änderungen in der neuesten Version

• Funktionen

  • Unterstützung für Multi-Adress-Versand

• Erweiterungen

  • JavaScript-SDKs auf 3.63.0 aktualisiert

  • PHP-SDKs auf 5.2.0 aktualisiert

Schritt 1: Erhalten Sie Ihre Braintree-Anmeldedaten

Gehen Sie zu Braintree Payments und melden Sie sich für ein Konto an.

Schritt 2: Vervollständigen Sie die Grundeinstellungen

1. Gehen Sie in der Seitenleiste von Admin zu Stores > Einstellungen > Konfiguration.

2. Erweitern Sie im linken Bereich Verkauf und wählen Sie Zahlungsmethoden.

   • Wenn Ihre Commerce-Installation mehrere Websites, Shops oder Ansichten hat, wählen Sie in der oberen linken Ecke die Store Ansicht, für die die Konfiguration gilt.

   • Vergewissern Sie sich im Abschnitt Händlerstandort, dass Händlerland auf den Standort Ihres Unternehmens eingestellt ist.

3. Klicken Sie unter Empfohlene Lösungen im Abschnitt Braintree auf Konfigurieren und führen Sie die folgenden Schritte aus:

   Braintree konfigurieren

   • Geben Sie einen Titel ein, um Braintree als Zahlungsoption während der Kaufabwicklung zu identifizieren.

   • Setzen Sie die aktuelle Umgebung für Braintree-Transaktionen auf eine der folgenden Optionen:

     • Sandbox
     • Produktion

     Wenn Sie die Konfiguration in einer Sandbox testen, verwenden Sie nur Kreditkartennummern, die von Braintree empfohlen werden. Wenn Sie bereit sind, mit Braintree live zu gehen, setzen Sie Umgebung auf Produktion.

   • Setzen Sie Payment Action auf eine der folgenden Optionen:

     Nur genehmigen	Genehmigt den Kauf und hält das Geld zurück. Der Betrag wird nicht vom Bankkonto des Kunden abgehoben, bis der Verkauf vom Händler “erfasst” wird.
     Intent Sale	Der Kaufbetrag wird autorisiert und sofort vom Konto des Kunden abgebucht. Hinweis: Dies war Authorize and Capture in 2.3.x und früheren Versionen.

   • Geben Sie die Händler-ID aus Ihrem Braintree-Konto ein.

   • Geben Sie die folgenden Anmeldedaten aus Ihrem Braintree-Konto ein:

     • Öffentlicher Schlüssel
     • Privater Schlüssel

     Grundlegende Einstellungen

   • Setzen Sie Diese Lösung aktivieren auf Ja.

   • Um PayPal als Zahlungsoption mit Braintree einzubeziehen, setzen Sie PayPal über Braintree aktivieren auf Ja.

   • Wenn Sie die Möglichkeit haben möchten, Kundendaten sicher zu speichern, so dass Kunden sie nicht bei jedem Kauf erneut eingeben müssen, setzen Sie Tresor aktiviert auf Ja.

     Grundlegende Einstellungen

Schritt 3: Vervollständigen Sie die erweiterten Einstellungen

1. Erweitern Sie den Abschnitt Erweiterte Braintree-Einstellungen.

2. Geben Sie unter Tresor-Titel einen beschreibenden Titel für Ihre Referenz ein, der den Tresor identifiziert, in dem Ihre Kundenkartendaten gespeichert sind.

3. Geben Sie die Händler-ID aus Ihrem Braintree-Konto ein.

4. Um den Braintree-Betrugsschutz für alle Transaktionen zu verwenden, setzen Sie Erweiterter Betrugsschutz auf Ja.

   Vergewissern Sie sich, dass der erweiterte Betrugsschutz im Abschnitt Einstellungen/Schutz Ihres Kontos aktiviert ist.

5. Wenn Sie möchten, dass das System eine Protokolldatei der Interaktionen zwischen Ihrem Shop und Braintree speichert, setzen Sie Debug auf Ja.

6. Wenn Sie möchten, dass Kunden den dreistelligen Sicherheitscode auf der Rückseite einer Kreditkarte eingeben, setzen Sie CVV Verification auf Ja.

   Wenn Sie die CVV-Verifizierung verwenden, stellen Sie sicher, dass Sie AVS und/oder CVV im Abschnitt Einstellungen/Verarbeitung Ihres Braintree-Kontos aktivieren.

7. Wählen Sie unter Kreditkartentypen jede Kreditkarte aus, die von Ihrem Geschäft als Zahlung über Braintree akzeptiert wird.

   Um mehrere Kartentypen auszuwählen, halten Sie die Strg-Taste (PC) oder die Befehlstaste (Mac) gedrückt und klicken Sie auf jede Option.

8. Geben Sie unter Reihenfolge sortieren eine Zahl ein, um die Reihenfolge festzulegen, in der Braintree bei der Auflistung mit anderen Zahlungsmethoden während der Kaufabwicklung erscheint.

   Erweiterte Einstellungen

Schritt 4: Vervollständigen Sie die länderspezifischen Einstellungen

1. Setzen Sie Zahlung aus anwendbaren Ländern auf eine der folgenden Optionen:

   Alle erlaubten Länder	Kunden aus allen Ländern, die in Ihrer Shop-Konfiguration angegeben sind, können diese Zahlungsmethode nutzen.
   Bestimmte Länder	Nach Auswahl dieser Option wird die Liste Zahlung aus bestimmten Ländern angezeigt. Halten Sie die Strg-Taste (PC) oder die Befehlstaste (Mac) gedrückt und wählen Sie jedes Land in der Liste aus, in dem Kunden in Ihrem Shop einkaufen können.

   Länderspezifische Einstellungen

2. So richten Sie Länderspezifische Kreditkartentypen ein:

   • Klicken Sie auf Hinzufügen.

   • Legen Sie das Land fest und wählen Sie jeden zugelassenen Kreditkartentyp.

   • Wiederholen Sie den Vorgang, um die Kreditkarten zu bestimmen, die in den einzelnen Ländern akzeptiert werden.

Schritt 5: Vervollständigen Sie die Einstellungen für PayPal über Braintree

1. Identifizieren Sie Ihre PayPal über Braintree-Konfiguration:

   • Geben Sie einen Titel ein, um die PayPal-Zahlungsoption von Braintree während der Kaufabwicklung zu identifizieren.

   • Geben Sie für Titel des Tresors einen beschreibenden Titel ein, um den Tresor zu identifizieren, in dem Ihre Kundenkartendaten gespeichert werden sollen.

   • Geben Sie für Sortierreihenfolge eine Zahl ein, um die Reihenfolge festzulegen, in der die PayPal-Zahlungsoption von Braintree während der Kaufabwicklung mit anderen Zahlungsoptionen aufgelistet wird.

   • Wenn Ihr Händlername anders angezeigt werden soll als in Ihrer Shop-Konfiguration festgelegt, geben Sie den Namen so ein, wie er im Feld Händlernamen überschreiben erscheinen soll.

2. Setzen Sie Zahlungsaktion auf eine der folgenden Optionen:

   Nur genehmigen	Genehmigt den Kauf und hält das Geld zurück. Der Betrag wird nicht vom Bankkonto des Kunden abgehoben, bis der Verkauf vom Händler “erfasst” wird.
   Autorisieren und Erfassen	Der Kaufbetrag wird autorisiert und sofort vom Konto des Kunden abgebucht.

3. Setzen Sie Zahlung aus anwendbaren Ländern für Braintree-Transaktionen, die von PayPal verarbeitet werden, auf eine der folgenden Optionen:

   Alle erlaubten Länder	Kunden aus allen Ländern, die in Ihrer Shop-Konfiguration angegeben sind, können diese Zahlungsmethode verwenden.
   Bestimmte Länder	Nach Auswahl dieser Option wird die Liste Zahlung aus bestimmten Ländern angezeigt. Halten Sie die Strg-Taste (PC) oder die Befehlstaste (Mac) gedrückt und wählen Sie jedes Land in der Liste aus, in dem Kunden in Ihrem Shop einkaufen können.

4. Um zu verlangen, dass Kunden eine Rechnungsadresse angeben, setzen Sie Rechnungsadresse des Kunden abfragen auf Ja.

Diese Funktion muss zunächst vom technischen Support von PayPal für Ihr Konto aktiviert werden.

1. Wenn Sie möchten, dass Kunden die Lieferadresse während des Abschlusses einer PayPal-Transaktion bearbeiten können, setzen Sie Bearbeiten der beim Checkout eingegebenen Lieferadresse auf der PayPal-Seite zulassen auf Ja.

2. Um eine Protokolldatei der Interaktionen zwischen Ihrem Shop und PayPal über Braintree zu speichern, setzen Sie Debug auf Ja.

3. Wenn Sie den Schritt der Bestellungsprüfung vor dem Absenden der Bestellung umgehen möchten, setzen Sie Bestellungsprüfung überspringen auf Ja.

   Standardmäßig ist die Bestellungsüberprüfung der letzte Schritt des Bezahlvorgangs.

4. Um die PayPal-Schaltfläche sowohl auf dem Mini-Warenkorb als auch auf der Warenkorbseite anzuzeigen, setzen Sie Im Warenkorb anzeigen auf Ja.

   PayPal über Braintree-Einstellungen

Schritt 6: Vervollständigen Sie die Einstellungen für die 3D-Verifizierung

1. Wenn Sie einen Verifizierungsschritt für Kunden hinzufügen möchten, die Kreditkarten verwenden, die bei einem Verifizierungsprogramm wie “Verified by VISA” angemeldet sind, setzen Sie 3D Secure Verification auf Yes.

   Während des Prozesses wird der Transaktionsbetrag, der zur Überprüfung eingereicht wird, mit dem Betrag verglichen, der zur Autorisierung gesendet wird.

2. Geben Sie unter Schwellenwert den Mindestauftragsbetrag ein, der erforderlich ist, um die 3D-Verifizierung auszulösen.

3. Setzen Sie Für zutreffende Länder prüfen auf eines der folgenden Kriterien:

   Alle erlaubten Länder	Kunden aus allen Ländern, die in Ihrer Shop-Konfiguration angegeben sind, können diese Zahlungsmethode verwenden.
   Bestimmte Länder	Nach Auswahl dieser Option wird die Liste Zahlung aus bestimmten Ländern angezeigt. Halten Sie die Strg-Taste (PC) oder die Befehlstaste (Mac) gedrückt und wählen Sie jedes Land in der Liste aus, in dem Kunden in Ihrem Shop einkaufen können.

   3D-Verifizierungseinstellungen

Schritt 7: Dynamische Deskriptoren

Die folgenden Deskriptoren werden verwendet, um Käufe auf den Kreditkartenabrechnungen der Kunden zu identifizieren. Sie können die Anzahl der Rückbuchungen reduzieren, indem Sie das Unternehmen, das mit jedem Kauf verbunden ist, eindeutig identifizieren. Wenn dynamische Deskriptoren für Ihr Konto nicht aktiviert sind, wenden Sie sich bitte an [Braintree Support] (mailto:support@getbraintree.com?subject=Support für dynamische Deskriptoren).

1. Geben Sie den dynamischen Deskriptor für Name, Telefon und URL gemäß den folgenden Richtlinien ein:

   Name	Der Deskriptor Name besteht aus zwei Teilen, die durch ein Sternchen (*) getrennt sind. Zum Beispiel: company*myproduct Der erste Teil des Deskriptors identifiziert das Unternehmen oder den DBA, der zweite Teil das Produkt. Die Länge des Unternehmens- und des Produktteils des Deskriptors kann auf folgende Weise zugewiesen werden, so dass eine kombinierte Länge von bis zu zweiundzwanzig Zeichen möglich ist. Zeichen im Namensdeskriptor Option 1: Das Unternehmen muss drei Zeichen lang sein, das Produkt kann bis zu 18 Zeichen lang sein Option 2: Das Unternehmen muss sieben Zeichen lang sein, das Produkt kann bis zu 14 Zeichen lang sein Option 3: Das Unternehmen muss zwölf Zeichen lang sein, das Produkt kann bis zu neun Zeichen lang sein
   Telefon	Der Telefon-Deskriptor muss 10 bis 14 Zeichen lang sein und darf nur Zahlen, Bindestriche, Klammern und Punkte enthalten. Zum Beispiel: 9999999999 (999) 999-9999 999.999.9999
   URL	Der URL-Deskriptor stellt Ihren Domänennamen dar und kann bis zu dreizehn Zeichen lang sein. Zum Beispiel: firma.de

2. Wenn Ihre Braintree-Konfiguration abgeschlossen ist, klicken Sie auf Save Config.

2.4 Migrationshinweise:
Vor der Veröffentlichung von Commerce 2.4.0 haben wir Händlern empfohlen, die Braintree-Kernintegration von Commerce durch die offizielle Braintree-Erweiterung von [Magento Marketetplace] (https://marketplace.magento.com/catalogsearch/result/?q=braintree) zu ersetzen. Ab Commerce 2.4.0 ist die Braintree-Erweiterung in der Version enthalten

Wenn Sie auf Commerce 2.4.x von einer Vor-2.4.0-Version migrieren, in der die Marketplace Braintree-Erweiterung installiert ist, müssen Sie die Marketplace Braintree-Erweiterung deinstallieren (paypal/module-braintree oder gene/module-braintree) und alle Code-Anpassungen aktualisieren, um den PayPal_Braintree -Namensraum statt Magento_Braintree zu verwenden. Die Konfigurationseinstellungen der gebündelten Commerce Braintree Payments-Kernerweiterung und der auf dem Magento Marketetplace vertriebenen Erweiterung bleiben erhalten, und Zahlungen, die mit diesen früheren Versionen der Erweiterung getätigt wurden, können weiterhin wie gewohnt erfasst, storniert oder erstattet werden