Tests, Fehlerbehebung und Updates¶
Vor der Freigabe für Kundenzahlungen¶
Verwende eine Shop-Testkopie, eine gültige Aktivierung und ein ausdrücklich zugewiesenes Saferpay-Testterminal. Eine mame-Staging-URL allein macht ein Live-Terminal nicht zur Testumgebung. Verwende Produktiv-Callback-Zugangsdaten nur mit einer vereinbarten Testeinrichtung.
Prüfe mit dem tatsächlichen Checkout, den verwendeten Währungen und Versandregeln:
- Erfolgreiche Zahlung, Abbruch, Ablehnung und verzögertes/ausstehendes Ergebnis.
- Rückleitung, authentifizierten Statusabgleich und signierte Webhooks, auch wenn Kunden das Zahlungsfenster schliessen.
- Nur Autorisierung, vollständigen/teilweisen Einzug, Stornierung und vollständige/teilweise Rückerstattung bei den vertraglich dafür geeigneten Zahlungsmitteln.
- Korrekte Bestell-, Transaktions-, Rechnungs-, Gutschrift- und Gesamtbeträge; keine doppelte Belastung durch wiederholte Rückleitung oder Benachrichtigung.
- Gast- und Kundenkonto-Checkout, ausdrückliche Speicherzustimmung sowie Verwendung und Entfernung gespeicherter Zahlungsmittel.
- Jede aktivierte Zahlungsart/Gruppe, Rabatte, Versand und Steuerfälle. Wiederhole dies mit dem tatsächlich verwendeten Luma-/Hyvä-Checkout auf Mobilgerät und Desktop.
- Website-Scope, Sprache, deutsche Ansprache und Lizenzkapazität, besonders bei mehreren Websites.
Eine Abnahme gilt nur für die tatsächlich geprüften Versionen und Zahlungsarten. Adobe Commerce benötigt eine eigene Prüfung inklusive aktivierter Commerce-Module und tatsächlicher Deployment-Konfiguration.
Fehlerbehebung¶
| Symptom | Prüfen |
|---|---|
| Composer-Authentifizierung scheitert | Gültige Modul-Lizenz, separate Downloads-Zugangsdaten, Repository-Host und gespeicherte Authentifizierung. Zahlungs-API-Zugangsdaten sind kein Composer-Zugang. |
| Ein Adapter lässt sich nicht installieren | Eigene Hyvä-Abhängigkeiten/-Lizenzen und passende Core-/Theme-/Checkout-Vorgaben. Zusammenpassende Pakete gemeinsam installieren. |
| Keine Saferpay-Zahlungsart sichtbar | Richtige Website, aktive Verbindung, aktiver Shop/Terminal, Synchronisation, aktivierte Zahlungsoptionen, Rechnungsland, Währung und Bestellgrenzen. |
| Eine Methode fehlt nach einer Änderung | Neue Verbindung prüfen/synchronisieren. Alte Terminal-Fähigkeiten werden bei geänderten Zugangsdaten bewusst nicht weiterverwendet. |
| Popup wird nicht abgeschlossen | Popup-Erlaubnis, gleiches Konto, Website-URL, Lizenzkapazität und aktuelle Einstellungen. Nach Ablauf oder Website-Änderung neu starten. |
| Zahlung bleibt ausstehend | Magento-Cron, Callback-Erreichbarkeit, Signaturschlüssel und authentifizierten Status. Vor erneutem Bezahlen die Wiederherstellung prüfen. |
| Einzug/Refund ist ungeklärt | Bestehenden Vorgang und bestätigte Beträge abgleichen. Journal erhalten; keinen zweiten Vorgang auf Verdacht starten. |
| Alte Hyvä-Darstellung oder Texte | Aktives Child-Theme neu bauen, richtige Sprachen bereitstellen und Magento-/Browser-Caches aktualisieren. |
Nutze Sales > Saferpay payment recovery und das bereinigte Modul-Log var/log/mame_saferpay.log. Ein Serveradministrator kann einen bekannten Versuch oder die begrenzte Menge ausstehender Versuche abgleichen:
php bin/magento mame:saferpay:reconcile ATTEMPT_UUID
php bin/magento mame:saferpay:reconcile
Teile dem Support nur bereinigte Fehlertexte, Modul-/Magento-Versionen, Bestell-/Versuchsreferenzen und den Zeitpunkt mit. Sende keine API-Secrets, Lizenz-/Webhook-Schlüssel oder vollständigen Zahlungs-Payloads.
Composer-Updates¶
Sichere Datenbank, Dateien, composer.json/composer.lock und den geschützten Magento-Verschlüsselungsschlüssel. Teste die freigegebene Version zuerst in Staging. Composer-Updates laufen über dein Deployment; das Modul aktualisiert sich beim Upload einer Version zu mame nicht selbst.
Für den Standard-Checkout:
composer update mamedev/module-saferpay --with-all-dependencies
Für Hyvä Theme und Hyvä Checkout alle installierten Begleitmodule einbeziehen:
composer update mamedev/module-saferpay mamedev/module-saferpay-hyva mamedev/module-saferpay-hyva-checkout --with-all-dependencies
Die Versionsvorgaben müssen die freigegebene Version erlauben. Prüfe Änderungen an der Lock-Datei und die Abhängigkeiten vor dem Deployment. Führe anschliessend aus:
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f de_CH en_US
php bin/magento cache:flush
Bei Hyvä vor der Bereitstellung statischer Dateien die Konfiguration neu erzeugen und das aktive Child-Theme bauen, wie in der Installationsanleitung. Verwende die tatsächlichen Shop-Sprachen und deine üblichen Wartungs-/Worker-Abläufe. Prüfe danach Versionen, Verbindung, Checkout und Wiederherstellung ausstehender Zahlungen.
ZIP-Updates und Rollback¶
Lade das freigegebene Core-Modul und die passenden installierten Adapter unter Downloads herunter. Ersetze die Dateien am vorhandenen Pfad app/code/Mame/… und entferne überholte Quelldateien im Rahmen eines kontrollierten Deployments. Erhalte Umgebungskonfiguration, Zugangsdaten, Verschlüsselungsschlüssel und alle Zahlungstabellen. Führe dieselben Magento-/Hyvä-Schritte und Abnahmetests aus. Vermeide doppelte Composer- und app/code-Installationen.
Stelle bei Bedarf nur eine kompatible, getestete Code-/Datenbanksicherung wieder her. Eine Datenbank-Wiederherstellung macht eine Provider-Belastung oder -Rückerstattung nicht rückgängig; gleiche Vorgänge seit dem Backup ab. Das Deaktivieren oder Entfernen von Quelldateien erlaubt kein Löschen der Zahlungshistorie und keine vorsorglichen Gegenbuchungen.