# Verwenden Sie die Stripe-App für Adobe Commerce (Magento 2) Erfahren Sie, wie Sie die Stripe-App für Adobe Commerce (Magento 2) installieren, aktualisieren und deinstallieren. > Wir empfehlen Ihnen, das Modul vor der Installation in Ihrer Produktionsumgebung zu testen. Wenn bei der Installation ein Problem auftritt, finden Sie weitere Informationen unter [Fehlerbehebung](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/troubleshooting.md). ## Modul installieren #### Über den Marketplace (empfohlen) 1. Geben Sie über den [Adobe Marketplace](https://marketplace.magento.com/stripe-stripe-payments.html) eine Bestellung für das Modul auf. 1. Öffnen Sie ein Terminal und führen Sie den folgenden Befehl in Ihrem Adobe Commerce-Verzeichnis aus: ```bash composer require stripe/stripe-payments ``` In dieser Phase müssen Sie Ihren Nutzernamen und Ihr Passwort übermitteln. Geben Sie Ihre [Adobe Commerce-Authentifizierungsschlüssel](https://devdocs.magento.com/guides/v2.3/install-gde/prereq/connect-auth.html) an. Sie können die Speicherung Ihrer Anmeldedaten akzeptieren, wenn Sie von Composer dazu aufgefordert werden. Wenn Sie Ihre Schlüssel gespeichert haben und die Fehlermeldung `Invalid Credentials` angezeigt wird, aktualisieren Sie Ihre Schlüssel in `~/.composer/auth.json` oder löschen Sie diese Datei und führen Sie den Befehl erneut aus. 1. Richten Sie das Modul ein, indem Sie die folgenden Befehle ausführen: ```bash php bin/magento setup:upgrade php bin/magento cache:flush php bin/magento cache:clean ``` 1. Wenn Sie Adobe Commerce im Produktionsmodus ausführen, müssen Sie die statischen Dateien des Moduls ebenfalls kompilieren und bereitstellen. ```bash php bin/magento setup:di:compile php bin/magento setup:static-content:deploy ``` #### Aus dem Raw-Paket 1. Laden Sie die [aktuelle Version](https://github.com/stripe/stripe-magento2-releases/raw/master/stripe-magento2-latest.tgz) des Moduls von Stripe herunter. 1. Extrahieren Sie das Modul in Ihr Adobe Commerce-Verzeichnis. ```bash tar -xvf stripe-magento2-latest.tgz ``` 1. Installieren Sie die Stripe-PHP-Bibliothek. ```bash composer require stripe/stripe-php:~17.6 ``` 1. Richten Sie das Modul ein. ```bash php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento cache:flush ``` 1. Wenn Sie Adobe Commerce im Produktionsmodus ausführen, müssen Sie die statischen Dateien des Moduls ebenfalls kompilieren und bereitstellen. ```bash php bin/magento setup:di:compile php bin/magento setup:static-content:deploy ``` ## Modul aktualisieren Vor dem Upgrade: - Sichern Sie Ihre Dateien und die Datenbank. - Starten Sie mit Ihrer Sandbox-Umgebung. - Behalten Sie eine Kopie jeder Anpassung, die Sie am ursprünglichen Code des Moduls vorgenommen haben. - Sehen Sie sich das [ÄNDERUNGSPROTOKOLL](https://github.com/stripe/stripe-magento2-releases/blob/master/CHANGELOG.md) an. Patch-Releases (x.x.Y) sind abwärtskompatibel und benötigen nach dem Upgrade Ihrerseits keine zusätzliche Entwicklung. Durch Minor- und Major-Releases können neue Funktionen hinzugefügt und Code in abwärtskompatibler Weise geändert werden. Wenn Sie den Code des Moduls angepasst haben, müssen Sie diese Anpassungen nach dem Upgrade portieren und mögliche Konflikte beheben. #### Über den Marketplace Führen Sie die folgenden Befehle aus: ```bash composer remove stripe/stripe-payments composer require stripe/stripe-payments php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:clean ``` #### Aus dem Raw-Paket Führen Sie die folgenden Befehle aus: ```bash php bin/magento module:disable --clear-static-content StripeIntegration_Payments rm -rf app/code/StripeIntegration/Payments tar -xvf stripe-magento2-latest.tgz php bin/magento module:enable StripeIntegration_Payments php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:flush php bin/magento cache:cleanStripeIntegration_Payments ``` ## Modul deinstallieren Vor der Deinstallation: - Sichern Sie Ihre Dateien und die Datenbank. - Behalten Sie eine Kopie jeder Anpassung, die Sie am ursprünglichen Code des Moduls vorgenommen haben, falls Sie es später erneut installieren müssen. #### Über den Marketplace Führen Sie die folgenden Befehle aus: ```bash composer remove stripe/stripe-payments php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:clean ``` #### Aus dem Raw-Paket Führen Sie die folgenden Befehle aus: ```bash php bin/magento module:disable --clear-static-content StripeIntegration_Payments composer remove stripe/stripe-php rm -rf app/code/StripeIntegration/Payments php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:flush php bin/magento cache:clean ``` ## Lebenszyklus-Richtlinie Die neueste Version des Moduls unterstützt die folgenden Versionen von Adobe Commerce: | Freigabe | Support | | ---------------------------- | ----------------------------------------------------------------------------------------- | | Adobe Commerce 2.0 - 2.3.6 | Nicht mehr unterstützt. Die letzte kompatible Version ist `stripe/stripe-payments:2.9.5`. | | Adobe Commerce 2.3.7 - 2.4.x | Zurzeit unterstützt, siehe nachfolgend unsere eigene Lebenszyklus-Richtlinie. | Für `stripe/stripe-payments:4.5.x` und höher bieten wir Fehlerbehebungen und Sicherheitspatches an. Stripe empfiehlt, ein Upgrade auf die neueste veröffentlichte Version des Moduls durchzuführen. Alle Releases sind im Adobe Marketplace und im GitHub-Repository [stripe-magento2-releases](https://github.com/stripe/stripe-magento2-releases) verfügbar. ## Versionshistorie Erfahren Sie mehr über die Änderungen an der Abwärtskompatibilität von Adobe Commerce-App-Versionen (Magento 2). ### Version 4.1 Mit der Version 4.1.0 werden Änderungen am Umgang mit Szenarien eingeführt, in denen Bestellungen aufgegeben und in Rechnung gestellt werden können, ohne dass Zahlungen eingezogen werden müssen. Zu diesen Szenarien gehören: - Kauf von Testabonnements. - Abonnements mit zukünftigen Startdaten. - Upgrades oder Downgrades bestehender Abonnementpläne. Zuvor hat das Modul diese Bestellungen automatisch zurückerstattet und mit einer Offline-Gutschrift abgeschlossen. Um nun die Steuerberichterstattung zu verbessern: - Automatische Rückerstattungen werden eingestellt. - Bestellposten in diesen Szenarien haben einen benutzerdefinierten Preis von 0. - Diese Artikel sind von der Versandkostenberechnung ausgenommen. Dies führt zu Bestellungen mit Null-Beträgen der Zwischensummen, Versandkosten und Steuerbeträge. Wenn reguläre Produkte mit Abonnements gekauft werden, spiegeln die genannten Beträge nur die regulären Bestellposten wider. Diese Änderungen stellen sicher, dass die Gesamtsumme der Bestellung mit dem am Bestelldatum eingezogenen Zahlungsbetrag übereinstimmt. Darüber hinaus ändert Version 4.1 die Handhabung von anteiligen Erfassungen und Rückerstattungen: - Zuvor erstellten anteilige Erfassungen oder Rückerstattungen aus dem Stripe-Dashboard automatisch Rechnungen oder Gutschriften in Magento. - Diese Dokumente enthielten keine Bestellposten, sondern manuelle Summen, Anpassungsgebühren oder Rückerstattungen. - Dieser Ansatz verursachte Probleme bei der Steuerberichterstattung. In Version 4.1: - Nur vollständige Erfassungen und vollständige Rückerstattungen führen zu automatischen Rechnungen oder Gutschriften. - Für teilweise Erfassungen oder Rückerstattungen sollten Händler/innen das Admin-Panel von Magento verwenden. - Dies gewährleistet eine korrekte Aufschlüsselung der Steuern auf Dokumenten und eine korrekte Berichterstattung an die Stripe API. ## See also - [Stripe-App für Adobe Commerce konfigurieren](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/configuration.md) - [Admin-Panel von Adobe Commerce verwenden](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/admin.md) - [Fehlerbehebung](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/troubleshooting.md)