VibeFox Montonio for OpenCart — Hilfe

Voraussetzungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 und neuer (getestet mit 4.1.0.3).

PHP: 8.0 oder neuer.

Währung: Die Währung der Kasse muss EUR oder PLN sein. Bei jeder anderen Währung wird die Zahlungsart an der Kasse ausgeblendet.

Montonio-Konto: Sie benötigen den Access Key und den Secret Key Ihres Shops aus dem Montonio Partner System. Sandbox- und Live-Schlüssel sind verschieden, daher brauchen Sie ein Schlüsselpaar für jede Umgebung, die Sie verwenden. In Montonio muss sonst nichts eingerichtet werden: Die Benachrichtigungsadresse wird bei jeder Zahlung übermittelt.

Öffentliche Website: Ihr Shop muss aus dem Internet erreichbar sein, um Benachrichtigungen von Montonio zu empfangen. Andernfalls erhalten Bestellungen ihren Status trotzdem, sobald der Kunde in den Shop zurückkehrt.

VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. Ein Schlüssel funktioniert für eine Domain.

Installation

Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 wcp_montonio_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_montonio_payment.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.

OpenCart 3

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_montonio_payment-oc3-(version).ocmod.zip aus. Die Erweiterung enthält keine OCMOD-Modifikationen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload aus diesem Paket in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und suchen Sie VibeFox Montonio Payment. Klicken Sie auf Install (die grüne Schaltfläche +). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

3. Klicken Sie auf Edit (die Schaltfläche mit dem Stift), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel in das Feld License key im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Öffnen Sie im Montonio Partner System Stores > your store > API keys und kopieren Sie den Sandbox-Access-Key und den Sandbox-Secret-Key. Fügen Sie sie in die Einstellungen ein und lassen Sie Sandbox mode eingeschaltet.

5. Aktivieren Sie Enable/Disable, klicken Sie auf Save und testen Sie eine Zahlung in der Sandbox mit einer Bestellung in EUR. Geben Sie danach die Live-Schlüssel ein und schalten Sie Sandbox mode aus.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_montonio_payment.ocmod.zip aus. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. Klicken Sie daneben auf Install (die grüne Schaltfläche +).

3. Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und suchen Sie VibeFox Montonio Payment. Klicken Sie auf Install (die grüne Schaltfläche +) und dann auf Edit (die Schaltfläche mit dem Stift).

4. Geben Sie den Lizenzschlüssel und die Montonio-Schlüssel wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Notification URL unterscheidet sich (siehe Notification URL).

Nach einer Neuinstallation ist die Zahlungsart zunächst deaktiviert und der Sandbox-Modus eingeschaltet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Montonio Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn die Schlüssel der aktuellen Umgebung fehlen (die Zahlungsart wird dann an der Kasse ausgeblendet) und wenn die Standardwährung des Shops nicht EUR oder PLN ist. Solange der Sandbox-Modus aktiv ist, zeigt sie außerdem Der Sandbox-Modus ist aktiv: Zahlungen werden simuliert und es wird kein echtes Geld abgebucht. an. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title 1 bis 128 Zeichen lang sein, Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total muss eine Zahl größer oder gleich 0 sein, und die Geo Zone sowie die Bestellstatus müssen existieren. Ist ein Wert fehlerhaft, wird nichts gespeichert und die Seite nennt das betreffende Feld.

Montonio

Enable/Disable: Enable Montonio bank payments schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: Der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird außerdem in der Bestellung gespeichert und auf der Montonio-Seite angezeigt. Standard: Bank payment (Montonio). Pflichtfeld, bis zu 128 Zeichen.

Description: Der Text, den der Kunde im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche sieht. Standard: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.

Sort Order: Die Position von Montonio unter den Zahlungsarten an der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

Geo Zone: Montonio nur für Rechnungsadressen in der ausgewählten Geo Zone anbieten. Standard: All zones. Geo Zones werden unter System > Localisation > Geo Zones eingerichtet.

Total: Der Warenkorbbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor Montonio angeboten wird. Lassen Sie das Feld leer, um Montonio bei jedem Betrag anzubieten.

API-Schlüssel

Die Schlüssel erhalten Sie im Montonio Partner System (die Seite enthält einen Link dorthin) unter Stores > your store > API keys. Sandbox- und Live-Schlüssel sind verschieden. Die Sandbox verwendet nur die Sandbox-Schlüssel, der Live-Modus nur die Live-Schlüssel.

Sandbox mode: Verwendet die Montonio-Sandbox (Testzahlungen, kein echtes Geld). Dabei werden sowohl die API-Adresse von Montonio als auch das Schlüsselpaar umgeschaltet. Standard: eingeschaltet. Schalten Sie ihn erst aus, wenn Sie die Live-Schlüssel eingegeben haben. Zahlungen, die in der anderen Umgebung erfolgt sind, verwenden für Bestätigungen und Erstattungen weiterhin die Schlüssel ihrer eigenen Umgebung. Solange er eingeschaltet ist, sehen Kunden im Schritt Confirm Order den Hinweis SANDBOX-MODUS: Testzahlung, es wird kein echtes Geld abgebucht.

Sandbox access key: der Access Key (UUID) Ihres Shops in der Montonio-Sandbox.

Sandbox secret key: der Secret Key Ihres Shops in der Montonio-Sandbox.

Live access key: der Access Key (UUID) Ihres Shops in der Live-Umgebung von Montonio.

Live secret key: der Secret Key Ihres Shops in der Live-Umgebung von Montonio.

Gespeicherte Secret Keys werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Gespeichert — zum Beibehalten leer lassen. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Secret Key zu entfernen, setzen Sie unter dem Feld das Häkchen bei Clear the saved key on save und klicken Sie auf Save.

Notification URL: Die Adresse, an die Montonio Zahlungsbenachrichtigungen sendet. In OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_montonio_payment/notification, in OpenCart 4 so: https://your-store/index.php?route=extension/wcp_montonio_payment/payment/wcp_montonio_payment.notification. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Sie müssen sie nirgends eingeben: Die Erweiterung übermittelt sie bei jeder Zahlung an Montonio.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine unvollständige Bestellung). Die Bestellung erhält erst dann einen Status, wenn Montonio die Zahlung bestätigt hat. Jedes Feld unten listet Ihre Bestellstatus aus OpenCart auf.

Order Status After Payment: Der Status nach einer verifizierten Montonio-Zahlung. Standard: Verarbeitung.

Payment On Hold Status: Die Zahlung benötigt Aufmerksamkeit (siehe Bestellstatus). Standard: Ausstehend, da OpenCart keinen Status für eine Zahlung in Wartestellung hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Payment Failed Status: Wird gesetzt, wenn die Bank eine Zahlung ablehnt, die als autorisiert zurückgehalten war. Standard: Fehlgeschlagen.

Refunded Status: Wird gesetzt, nachdem die Zahlung von der Bestellseite aus vollständig erstattet wurde. Standard: Erstattet.

Erweitert

Debug log: Schreibt Zahlungsereignisse in wc_mnt_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über den Webbrowser öffnen; bei 5 MB wird sie nach wc_mnt_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Schlüssel, Tokens und Kundendaten werden nie protokolliert. Standard: aus.

Log: Zeigt die Größe und die neuesten Einträge des Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Delete data: Wenn eingeschaltet, entfernt das Deinstallieren der Erweiterung die Einstellungen des Gateways und das Protokoll. Das Deaktivieren der Erweiterung löscht nie etwas. Bestelldaten (Montonio-UUIDs, Notizen) bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Access Keys und Secret Keys werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Access Keys und Secret Keys bleiben erhalten.

Zahlungsbenachrichtigungen

Montonio informiert Ihren Shop über jede Zahlung mit einem signierten Token. Das Token trifft auf zwei Wegen ein: per Server-zu-Server-Benachrichtigung an die Notification URL und zusammen mit dem Kunden, wenn er in den Shop zurückkehrt. Beides wird geprüft: die Signatur mit dem Secret Key der Umgebung, in der die Zahlung erstellt wurde, die Gültigkeitsdauer, Ihr Access Key und ob die Zahlung von Ihrem Shop für diese Bestellung erstellt wurde. Ein Token, das mit dem Schlüssel der anderen Umgebung signiert wurde, wird abgewiesen. Jeder Status wird nur einmal angewendet, sodass wiederholte Benachrichtigungen keine Notizen, E-Mails oder Bestandsänderungen erzeugen. Die Notification URL funktioniert auch, wenn der Shop im Wartungsmodus ist, weil OpenCart 3 Anfragen von Zahlungserweiterungen durchlässt und OpenCart 4 dafür eine Startaktion der Erweiterung hinzufügt, die außerdem die Rückkehr des Kunden von Montonio ermöglicht.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Bank payment (Montonio)). Im Schritt Confirm Order sieht der Kunde das Montonio-Symbol und Ihre Beschreibung. OpenCart legt in diesem Schritt die Bestellung an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Montonio-Zahlung für den Bestellbetrag in der Bestellwährung und leitet den Kunden auf die Zahlungsseite von Montonio weiter. Dort wählt der Kunde eine Bank und bezahlt. In OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Banken aus dem Land der Rechnungsadresse des Kunden werden zuerst angezeigt (bei PLN-Bestellungen Polen). Die Zahlung erscheint als Order mit der Bestellnummer. Die Montonio-Seite öffnet sich in der Shopsprache, wenn diese Deutsch, Englisch, Estnisch, Finnisch, Litauisch, Lettisch, Polnisch oder Russisch ist, andernfalls auf Englisch.

Die Bestellung wird erst als bezahlt markiert, nachdem Montonio die Zahlung bestätigt hat: per Benachrichtigung oder bei der Rückkehr des Kunden. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung mit Your Montonio bank payment has been received. Hat die Bank die Zahlung noch nicht bestätigt oder ist die Bestellung in Wartestellung, zeigt die Seite We are confirming your payment with Montonio. The order will be updated automatically — please do not pay again. Lehnt die Bank eine autorisierte Zahlung später ab, zeigt die Seite Your Montonio payment was not completed. Please contact us about this order.

Meldet Montonio die Zahlung bei der Rückkehr des Kunden noch als ausstehend, zeigt eine Seite Payment confirmation denselben Text mit einer Schaltfläche Check again und einer Schaltfläche Back to checkout. Check again fragt bei Montonio den aktuellen Status der Zahlung ab. Die Benachrichtigung setzt den Bestellstatus, sobald sie eintrifft.

Wurde die Zahlung abgebrochen oder abgelehnt, kehrt der Kunde mit einer dieser Meldungen zur Kasse zurück: Die Zahlung wurde von der Bank abgebrochen oder abgelehnt. Sie können es erneut versuchen oder eine andere Zahlungsart wählen., Die Zahlung wurde nicht abgeschlossen. Sie können es erneut versuchen oder eine andere Zahlungsart wählen. oder Montonio konnte die Zahlung nicht abschließen. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsart. In OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt. Der Warenkorb bleibt erhalten. OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 behält eine Bestellung für die Kasse bei und bezahlt dieselbe Bestellung erneut mit einer neuen Montonio-Zahlung. Bevor eine neue Zahlung erstellt wird, fragt die Erweiterung Montonio nach dem vorherigen Versuch desselben Warenkorbs. Ist dieser bereits bezahlt, wird die Zahlung bestätigt, der Kunde gelangt zur Erfolgsseite, und es erfolgt keine zweite Zahlung.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel von Ihnen storniert), wird der Kunde mit Ihre vorherige Bestellung wurde ohne Zahlung storniert. Bitte bestätigen Sie die Bestellung erneut, um mit einer neuen Bestellung zu bezahlen. zur Kasse zurückgeschickt, auch wenn er von Montonio zurückkehrt, und die nächste Bestätigung über Confirm Order bezahlt eine neue Bestellung. Bei OpenCart 3 zeigt die Rückkehr mit einer solchen Bestellung die Erfolgsseite mit dem Hinweis, dass die Zahlung nicht abgeschlossen wurde. Ist die Bestellung der Kasse bereits aufgegeben und hat sich der Warenkorb seitdem geändert, lautet die Meldung Ihre vorherige Bestellung wurde bereits aufgegeben. Ihr Warenkorb hat sich seitdem geändert. Bitte bestätigen Sie die Bestellung erneut, um den aktuellen Warenkorb mit einer neuen Bestellung zu bezahlen. Jede Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung benötigt. Eine Bestellung eines Warenkorbs, der bezahlt und danach storniert oder erstattet wurde, hält den Warenkorb nicht mehr.

Kann Montonio die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche, zum Beispiel Montonio ist vorübergehend nicht verfügbar. Bitte versuchen Sie es in einigen Minuten erneut oder wählen Sie eine andere Zahlungsart. Der technische Grund wird im Protokoll festgehalten.

Die Erweiterung unterstützt nur Banküberweisungen (Zahlungsauslösung). Kartenzahlungen, BLIK, Apple Pay oder Google Pay, Pay Later oder Finanzierung, der Versand von Montonio, Abonnements, gespeicherte Zahlungsarten oder die Auswahl der Bank im eigenen Shop werden nicht unterstützt.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (unvollständige Bestellung): Der Kunde wurde zu Montonio weitergeleitet und hat nicht bezahlt, Montonio meldet die Zahlung als ausstehend, oder die Zahlung wurde abgebrochen bzw. nicht abgeschlossen. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (Standard Verarbeitung): Montonio hat die Zahlung mit dem exakten Bestellbetrag und der exakten Währung bestätigt (PAID). Eine Notiz zeigt die Bank, die Montonio-UUID der Bestellung, den Betrag und die Umgebung.

Payment On Hold Status (Standard Ausstehend): Die Bank hat die Zahlung noch nicht bestätigt (AUTHORIZED); die Bestellung wechselt zu Order Status After Payment, sobald Montonio PAID meldet. Eine Bestellung wird auch in Wartestellung gesetzt, wenn Montonio einen anderen Betrag oder eine andere Währung als den Bestellbetrag gemeldet hat, wenn eine Sandbox-Zahlung eintraf, während der Shop im Live-Modus ist (es wurde kein echtes Geld empfangen), oder wenn die Zahlung eintraf, nachdem der Bestellung bereits ein anderer Status zugewiesen worden war, zum Beispiel storniert. Die Notiz erklärt es. Prüfen Sie die Zahlung im Montonio Partner System und bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.

Payment Failed Status (Standard Fehlgeschlagen): Die Bank hat eine Zahlung abgelehnt, die als autorisiert zurückgehalten war. Nur der letzte Zahlungsversuch der Bestellung kann diesen Status ändern.

Refunded Status (Standard Erstattet): Die Zahlung wurde über die Erweiterung vollständig erstattet.

Bezahlte oder erstattete Bestellungen werden durch spätere Benachrichtigungen nie wieder geöffnet. Trifft eine zweite Zahlung für eine bereits bezahlte Bestellung ein, wird die Bestellung nicht verändert. Eine Notiz fordert Sie auf, die zweite Zahlung im Montonio Partner System zu erstatten.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht.

Registerkarte VibeFox Montonio Payment

Öffnen Sie unter Sales > Orders eine mit Montonio bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, listet die Registerkarte VibeFox Montonio Payment die Zahlungsversuche der Bestellung mit Datum, der Montonio order UUID (mit dem Hinweis Sandbox bei Testzahlungen), dem Betrag, der Bank, dem Montonio status und dem Ergebnis auf. Darunter stehen die Beträge Paid / refunded, das Erstattungsformular, der Erstattungsverlauf und die Montonio notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie in der Registerkarte VibeFox Montonio Payment den Betrag ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Grund (er wird nur in der Bestellnotiz gespeichert), und klicken Sie auf Refund via Montonio. Bestätigen Sie die Abfrage Diesen Betrag über Montonio erstatten? Dies kann nicht rückgängig gemacht werden. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Erstattungen sind auf den Betrag begrenzt, den Montonio eingezogen hat. Nach einer Betragsabweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht bis zum Bestellbetrag. Die Erstattung wird an die Umgebung gesendet, in der die Zahlung erfolgt ist (Sandbox oder Live), daher müssen die Schlüssel dieser Umgebung eingetragen sein. Lehnt Montonio die Erstattung ab, zeigt die Registerkarte den Fehler, und es wird keine Erstattung erfasst. Eine gesendete Erstattung wird mit ihrem Status und der Montonio-Erstattungs-ID dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte wieder dem Bestand zuzubuchen, genau wie eine manuelle Statusänderung. Eine Teilerstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald Montonio die Zahlung als bezahlt gemeldet hat.

Montonio bestätigt oder lehnt jede Erstattung später per Benachrichtigung ab. Eine Bestätigung wird den Notizen hinzugefügt. Lehnt Montonio die Erstattung ab, weist die Notiz darauf hin, dass das Geld nicht an den Kunden zurückgegeben wurde; prüfen Sie dies im Montonio Partner System und korrigieren Sie die Erstattung in OpenCart.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über Montonio. Erstattungen, die im Montonio Partner System vorgenommen wurden, werden den Notizen hinzugefügt, sobald Montonio sie meldet. Der Bestellstatus wird nicht automatisch geändert. Aktualisieren Sie ihn bei Bedarf manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Montonio Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox Montonio Payment > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-montonio und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Schlüssel nicht gefunden, Dieser Schlüssel gehört zu einem anderen Produkt, Domain-Limit erreicht oder Lizenz abgelaufen am mit einem Datum. Nachdem sich die Shopadresse geändert hat oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Montonio Kunden an der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, sieht der Kunde Diese Zahlungsart ist nicht verfügbar. Bitte wählen Sie eine andere. Ein Admin-Benutzer, der im selben Browser im Admin-Bereich angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (nicht lizenziert — nur für Admins sichtbar), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. In OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin-Bereich nicht, daher ist die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admin-Bereichs eine Erinnerung. Mit × blenden Sie sie 7 Tage lang aus. Bestehende Bestellungen bleiben unberührt: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard oder die Seite Edit im Admin-Bereich öffnen: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job wird nicht benötigt. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Montonio erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und beide Schlüssel der aktuellen Umgebung gesetzt sind: Sandbox access key und Sandbox secret key im Sandbox-Modus, Live access key und Live secret key im Live-Modus. Die Einstellungsseite zeigt eine Warnung, wenn Schlüssel fehlen. Der Kunde muss in EUR oder PLN bezahlen (der im Shop ausgewählten Währung). Prüfen Sie außerdem, ob die Zahlungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: Die Benachrichtigung hat Ihren Shop nicht erreicht. Prüfen Sie, ob der Shop aus dem Internet erreichbar ist und ob die Schlüssel in den Einstellungen zur Umgebung der Zahlung gehören. Die Bestellung erhält ihren Status auch dann, wenn der Kunde nach der Zahlung in den Shop zurückkehrt, wenn er auf Check again klickt und wenn er versucht, denselben Warenkorb erneut zu bezahlen.

Die Benachrichtigung meldet Invalid token: Die Signatur, das Ablaufdatum oder der Access Key des Tokens stimmte nicht überein. Prüfen Sie, ob Access Key und Secret Key korrekt kopiert wurden und zur richtigen Umgebung gehören und ob die Uhrzeit des Servers stimmt. Ein Token, das mit dem Schlüssel der anderen Umgebung signiert wurde, wird ebenfalls abgewiesen.

Die Benachrichtigung meldet Payment does not belong to this order: Die Zahlung wurde nicht von diesem Shop für diese Bestellung erstellt. Das passiert, wenn zwei Shops dasselbe Montonio-Konto und dieselben Bestellnummern verwenden.

Die Benachrichtigung meldet Gateway not configured: Es sind keine Montonio-Schlüssel gesetzt oder die Schlüssel der Umgebung der Zahlung fehlen. Geben Sie die Schlüssel ein; Montonio wiederholt die Benachrichtigung.

Die Benachrichtigung meldet Temporarily unavailable: Der Warenkorb wurde gerade von einer anderen Anfrage bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. Montonio wiederholt die Benachrichtigung. Den Grund finden Sie im Feld Log.

Der Kunde sieht nach Confirm Order einen Fehler: Sehen Sie im Feld Log auf der Seite der Erweiterung nach. Die Meldung Diese Zahlungsart ist nicht verfügbar. Bitte laden Sie die Kasse neu. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt oder die Zahlungsart inzwischen deaktiviert wurde: Der Kunde soll die Kasse neu laden. Die Meldung Diese Zahlungsart ist vorübergehend nicht verfügbar. Bitte wählen Sie eine andere Zahlungsart. deutet meist auf falsche oder fehlende Schlüssel hin. Die Meldung Montonio konnte die Zahlung nicht starten. Bitte prüfen Sie Ihre Bestelldaten oder wählen Sie eine andere Zahlungsart. bedeutet, dass Montonio die Zahlungsdaten abgelehnt hat; das Protokoll enthält den Grund.

Die Bestellung ist nach der Zahlung im Wartestatus: Lesen Sie die Notizen in der Registerkarte VibeFox Montonio Payment (siehe Bestellstatus) und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Sandbox-Zahlungen bestätigen keine Live-Bestellung: Eine Sandbox-Zahlung bestätigt niemals eine Bestellung, solange der Shop im Live-Modus ist; die Bestellung wird stattdessen in Wartestellung gesetzt. Stellen Sie Sandbox mode auf die gewünschte Umgebung um und verwenden Sie deren Schlüssel.

Kein Erstattungsformular in der Registerkarte: Die Registerkarte nennt den Grund: Die Zahlung ist noch nicht bestätigt, sie ist vollständig erstattet, oder Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern.

Die Erstattung schlägt mit einer Meldung zur Umgebung fehl: Die Zahlung wurde in der Sandbox bzw. im Live-Modus getätigt, und die Schlüssel dieser Umgebung sind nicht gesetzt. Geben Sie sie ein und versuchen Sie es erneut. Die Meldung Die Bestellung wird gerade durch eine Zahlungsbenachrichtigung aktualisiert. Bitte versuchen Sie es gleich noch einmal. bedeutet, dass für dieselbe Bestellung gerade eine Benachrichtigung verarbeitet wird.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse wc_mnt_supported_currencies, wc_mnt_order_data und wc_mnt_locale aus, um die unterstützten Währungen, die Zahlungsdaten und die Sprache der Montonio-Seite zu ändern.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Montonio Payment auf Uninstall (die rote Schaltfläche −). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt außerdem immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus im Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (in OpenCart 4 auch dessen Ereignisse und die Startaktion, die Benachrichtigungen im Wartungsmodus durchlässt). Ist Delete data eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Sandbox-Modus, Schlüssel, Debug-Protokoll) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Datensätze zu Montonio-Zahlungen und -Erstattungen werden immer aufbewahrt, sodass zuvor bezahlte Bestellungen auch nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

In OpenCart 4 entfernen Sie die Dateien der Erweiterung zusätzlich, indem Sie nach der Deinstallation zu Extensions > Installer gehen, neben VibeFox Montonio Payment in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene Schaltfläche −) und anschließend auf Delete (die rote Mülltonnen-Schaltfläche) klicken, um das hochgeladene Paket zu entfernen.

Montonio ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit Montonio verbunden und wird von Montonio nicht unterstützt.