Tests, Fehlerbehebung und Updates¶
Vor dem Produktiveinsatz¶
Verwende einen getrennten Testshop und einen geeigneten TWINT-Test- oder Produktivstore. Eine lokale Simulation prüft Magento-Verhalten, ersetzt aber keine Abnahme des gehosteten TWINT-Ablaufs. Verwende keine Kundenzahlung oder deren Webhook erneut als Test.
Prüfe:
- Neuinstallation, Downloadberechtigung und Website-Verbindung funktionieren mit dem vorgesehenen Konto.
- Normale Käufe als Gast und als angemeldeter Kunde werden mit korrektem Betrag, Adresse und Währung sowie genau einer Magento-Bestellung und -Rechnung abgeschlossen.
- Jede aktivierte Express-Position funktioniert mit physischen und virtuellen Produkten, Mengen und erforderlichen Optionen. Produkt-Express erhält den normalen Warenkorb.
- Versandarten, Gutscheine, Steuern, Gratisversand und gegebenenfalls Kantonsauswahl ergeben den erwarteten Endbetrag.
- Der Abbruch einer normalen Zahlung führt zum Checkout, der Express-Abbruch zur Ursprungsseite. Dabei entsteht keine bezahlte Bestellung.
- Offene oder verspätete Ergebnisse, erneutes Laden und doppelte Benachrichtigungen erzeugen keine zweite Zahlung, Bestellung, Rechnung oder weiteren Einzug.
- Zustimmung zum Speichern, späterer Kauf mit gespeicherter Zahlungsart und Widerruf funktionieren in der vorgesehenen TWINT-Umgebung.
- Sofortiger oder verzögerter Einzug sowie vollständige und teilweise Online-Rückerstattungen funktionieren für die aktivierte Konfiguration.
- Produktive HTTPS-Webhooks erreichen die richtige Website und werden authentifiziert. Prüfe asynchrone Aktualisierungen auch unabhängig von der Browserrückleitung.
- Bei Hyvä wiederholst du die relevanten Abläufe auf Desktop und Mobilgerät mit dem bereitgestellten Child-Theme und der installierten Checkout-Version.
Verwende erfundene Testkundendaten. Vergleiche die nativen Bestellungen mit den Transaktionszuständen bei mame und TWINT; ein Screenshot der Erfolgsseite allein reicht nicht aus.
TWINT oder Express erscheint nicht¶
- Prüfe Enable TWINT, Verbindungsstatus, eigene gültige Lizenz sowie aktiven Store und Zahlungskonfiguration im richtigen Website-Geltungsbereich.
- Prüfe CHF und den Warenkorbbetrag. Express benötigt zusätzlich den Hauptschalter und den Schalter der gewünschten Position.
- Prüfe bei Hyvä die erforderlichen Theme-/Checkout-Kompatibilitätsmodule und Abhängigkeiten. Erzeuge die Hyvä-Konfiguration neu, baue das CSS des tatsächlich aktiven Child-Themes und stelle die passenden Sprachdateien bereit.
- Leere die betroffenen Magento-Caches und lade die Seite neu. Behebe bei CSP-/SRI-Fehlern die bereitgestellten Dateien und ihre Integritätsmetadaten, ohne die Schutzfunktion abzuschalten.
- Deaktiviere beim Anbieterwechsel die nicht mehr gewünschten Zahlungsarten in jedem betroffenen Geltungsbereich. Die TWINT-Verbindung wird dadurch nicht automatisch eingerichtet.
Abbruch, fehlgeschlagener QR-Scan oder offene Zahlung¶
Ein QR-Scan oder die Abbruch-Schaltfläche belegt noch kein endgültiges Zahlungsergebnis. Prüfe den authentifizierten Status und die zugehörige Magento-Bestellung beziehungsweise mame-Transaktion. Eine Ablehnung durch den Anbieter, eine unpassende Wallet-/Testumgebung oder eine abgebrochene Autorisierung kann nach Klärung des bisherigen Ergebnisses einen neuen bewussten Kundenschritt erfordern. Nicht jeder QR-Abbruch ist ein Magento- oder Hyvä-Fehler.
Nutze bei einer offenen Zahlung die angebotene Aktualisierung oder manuelle Statusprüfung. Erzeuge keine zweite Bestellung, solange die erste Zahlung ungeklärt ist. Wende dich bei Prüfbedarf mit Bestellnummer, Zeitpunkt, Modulversionen und nicht geheimem Fehlercode an den Support. Sende keine API-Zugangsdaten, Webhook-Schlüssel, aktiven QR-Payloads oder Zahlungsdaten von Kunden.
Webhooks und geplante Wiederaufnahme¶
Das Modul verwendet pro Website einen Endpunkt nach dem Muster /twint/webhook/receive/website/WEBSITE_ID. Halte öffentliches HTTPS erreichbar und prüfe Proxy- und Firewall-Regeln. Ein passwortgeschützter oder ausschliesslich lokaler Shop kann die produktive Webhook-Zustellung nicht nachweisen.
Betreibe Magento Cron und die von deinem Hosting vorgesehenen Worker- und Bereitstellungsabläufe. Starte in einer aus einem anderen Shop kopierten Testdatenbank keine allgemeine Wiederaufnahme vorhandener historischer Zahlungszuordnungen. Für Installationstests eignet sich eine getrennte leere Installation.
Update mit Composer¶
Sichere Datenbank, Dateien und Lockdatei und teste die Aktualisierung in einer Testumgebung. Verwende den üblichen Wartungs- und Worker-Ablauf und aktualisiere die installierten Pakete:
composer update mamedev/module-twint --with-dependencies
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
Nimm bei Hyvä auch die installierten TWINT-Theme-/Checkout-Kompatibilitätspakete in den Composer-Updatebefehl auf. Erzeuge die Hyvä-Konfiguration neu und baue das aktive Child-Theme vor der Magento-Bereitstellung der statischen Dateien. Der Downloads-Dialog bietet die Befehle für das gewählte Frontend. Lasse den Wartungsmodus bei einem Bereitstellungsfehler aktiv und verwende den geprüften Wiederherstellungsplan des Shops.
Die Updateprüfung des Moduls meldet lizenzierte verfügbare Versionen. Sie führt weder Composer aus noch verändert sie den Shop-Code über eine Webanfrage. Prüfe und fixiere die Zielversion im üblichen Bereitstellungsablauf.
Update per ZIP¶
Verwende das geprüfte Paket für jedes installierte Modul, ersetze dessen Dateien am bestehenden Ort unter app/code/Mame/... und führe Magento-Upgrade, DI-Kompilierung, Asset-Bereitstellung und Cache-Aktualisierung aus. Zugangsdaten, Konfiguration und Zahlungshistorie bleiben erhalten. Kombiniere keine app/code- und Composer-Kopie desselben Moduls.
Stelle bei einem Rollback eine zusammengehörige geprüfte Sicherung von Anwendung und Datenbank über dein Hosting wieder her. Das Entfernen der Erweiterung oder ihrer Tabellen ist keine Wiederherstellung einer Zahlung.