Zum Inhalt

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.