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.
Vorsicht
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.
Modul installieren
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 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.
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.
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. . |
Adobe Commerce 2.3.7 - 2.4.x | Zurzeit unterstützt, siehe nachfolgend unsere eigene Lebenszyklus-Richtlinie. |
Für stripe/stripe-payments:4.
und höher stellen wir neue Funktionen, Fehlerkorrekturen und Sicherheitspatches zur Verfügung. Ältere Versionen wurden abgeschafft. Stripe empfiehlt, so bald wie möglich ein Upgrade durchzuführen. Alle Releases sind im Adobe Marketplace und im GitHub-Repository der 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.