VibeFox Mollie for OpenCart — Hilfe

Anforderungen

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 eine der von Mollie unterstützten Währungen sein: AED, AUD, BGN, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, ILS, ISK, JPY, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TWD, USD, ZAR. Bei anderen Währungen wird die Zahlungsart an der Kasse ausgeblendet. Welche Zahlungsarten Mollie anbietet, hängt von der Währung und von Ihrem Konto ab.

Internetzugang zu Ihrem Shop: Mollie sendet Webhooks an Ihren Shop, daher muss die Website aus dem Internet erreichbar sein. Ohne Webhooks erhalten Bestellungen ihren Status, wenn der Kunde von Mollie zurückkehrt.

Mollie-Konto: Sie benötigen die API-Schlüssel aus Mollie Dashboard > Developers > API keys. Testschlüssel beginnen mit test_, Live-Schlüssel mit live_. Weitere Schlüssel oder Geheimnisse sind nicht erforderlich. Die Zahlungsarten selbst werden in Ihrem Mollie-Konto aktiviert.

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_mollie_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_mollie_gateway.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_mollie_gateway-oc3-(version).ocmod.zip aus. Die Erweiterung enthält keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments, suchen Sie VibeFox Mollie Gateway und 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 Stift-Schaltfläche), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel im Lizenzbereich oben auf der Seite in License key ein und klicken Sie auf Activate (siehe License key).

4. Geben Sie Ihre Test- und Live-API-Schlüssel ein (siehe Configuration). In Mollie muss kein Webhook eingerichtet werden.

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Lassen Sie Test Mode eingeschaltet, bis Sie eine Testzahlung durchgeführt haben, und schalten Sie es dann aus.

OpenCart 4

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

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

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Mollie Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

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

Nach einer Neuinstallation sind die Zahlungsart ausgeschaltet und der Testmodus eingeschaltet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Mollie Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn Mollie aktiviert ist, aber der API-Schlüssel des aktuellen Modus fehlt, und wenn Mollie die Standardwährung des Shops nicht unterstützt. In beiden Fällen wird die Zahlungsart an der Kasse ausgeblendet. 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 haben, Sort Order muss eine ganze Zahl sein und Total muss eine Zahl von 0 oder größer sein; andernfalls wird nichts gespeichert. Ein API-Schlüssel, der nicht mit test_ oder live_ beginnt, gefolgt von mindestens 30 Buchstaben und Ziffern, wird nicht gespeichert: Die Seite zeigt Settings saved, except the API key shown in red. an, der Fehler nennt den Schlüssel, und der zuvor gespeicherte Schlüssel bleibt erhalten.

Checkout

Enable/Disable: Enable Mollie Gateway schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Titel der Zahlungsart, der dem Kunden an der Kasse angezeigt wird. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Mollie. Pflichtfeld.

Description: der Text, der dem Kunden im Schritt Confirm Order über der Schaltfläche zur Bestätigung angezeigt wird. Standard: Pay securely via Mollie.

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

Geo Zone: bietet Mollie nur für Rechnungsadressen in der ausgewählten Geozone an. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet.

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

API-Schlüssel

Ihre API-Schlüssel finden Sie im Mollie Dashboard unter Developers > API keys; dieser Abschnitt verlinkt auf diese Seite. Test- und Live-Schlüssel sind getrennt.

Test Mode: verwendet den Test-API-Schlüssel für neue Zahlungen. Es werden keine echten Zahlungen verarbeitet. Auf der Testkasse von Mollie können Sie das Ergebnis der Zahlung auswählen. Kunden sehen im Schritt Confirm Order den Hinweis Test mode: no real payment will be made. Zahlungen, die im anderen Modus getätigt wurden, verwenden für Statusabfragen und Erstattungen weiterhin den Schlüssel ihres Modus. Standard: an.

Test API Key: Ihr Mollie-Test-API-Schlüssel (beginnt mit test_).

Live API Key: Ihr Mollie-Live-API-Schlüssel (beginnt mit live_).

Gespeicherte Schlüssel werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. an. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Schlüssel zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved key on save und klicken Sie auf Save.

Webhook

Webhook URL: wird nur zur Information angezeigt. Ein Webhook muss nicht eingerichtet werden: Die Erweiterung sendet diese URL bei jeder Zahlung an Mollie. Unter OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_mollie_gateway/webhook, unter OpenCart 4 so: https://your-store/index.php?route=extension/wcp_mollie_gateway/payment/wcp_mollie_gateway.webhook. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Sie muss aus dem Internet erreichbar sein, sonst erhalten Bestellungen ihren Status erst, wenn der Kunde von Mollie zurückkehrt.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Mollie die Zahlung gemeldet hat. Jedes der folgenden Felder listet Ihre Bestellstatus von OpenCart auf.

Order Status After Payment: der Status nach einer erfolgreichen Zahlung. Standard: In Bearbeitung. Wählen Sie Complete, um bezahlte Bestellungen als abgeschlossen zu markieren.

Awaiting Mollie Payment Status: Der Kunde hat auf der Mollie-Seite eine Banküberweisung gewählt; die Bestellung wird automatisch als bezahlt markiert, sobald Mollie das Geld erhält. Standard: Ausstehend.

Mollie Payment On Hold Status: Die Zahlung muss von Ihnen geprüft werden (siehe Order statuses). Standard: Ausstehend, da OpenCart keinen Status „On hold“ hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Payment Error Status: Die erwartete Banküberweisung oder die autorisierte Zahlung ist fehlgeschlagen, abgelaufen oder abgebrochen worden. Standard: Fehlgeschlagen.

Refunded Status: Die Zahlung wurde auf der Bestellseite vollständig erstattet. Standard: Erstattet.

Erweitert

Logging: schreibt API-Aufrufe und Webhooks in molg_debug.log.php im Protokollordner von OpenCart (storage/logs). Die Datei kann nicht über den Browser geöffnet werden. Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. API-Schlüssel und Kundendaten werden nie protokolliert. Standard: aus.

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

Delete Data on Uninstall: Wenn diese Option eingeschaltet ist, werden die Einstellungen des Gateways und das Protokoll beim Deinstallieren der Erweiterung gelöscht. Mollie-Zahlungs-IDs, die bei Bestellungen gespeichert sind (Zahlungen, Erstattungen), bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. API-Schlüssel werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte API-Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Mollie). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to Mollie to choose a payment method and pay. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Mollie-Zahlung über den Bestellbetrag in der Bestellwährung (JPY und ISK ohne Dezimalstellen) mit der Beschreibung Order # und der Bestellnummer und leitet den Kunden zur gehosteten Mollie-Kasse weiter. Dort wählt der Kunde eine der in Ihrem Mollie-Konto aktivierten Zahlungsarten aus und bezahlt. Auf 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.

Mollie-Webhooks enthalten keine Signatur, sondern nur die Zahlungs-ID. Daher vertraut die Erweiterung einem Webhook nie von sich aus: Sie akzeptiert nur Zahlungs-IDs, die sie selbst erstellt hat, liest die Zahlung über die Mollie-API mit dem Schlüssel des Modus, in dem die Zahlung getätigt wurde, prüft, ob die Zahlung zur Bestellung gehört, und vergleicht den bezahlten Betrag und die Währung mit dem Bestellbetrag. Die Bestellung wird erst dann als bezahlt markiert, wenn Mollie dies auf diese Weise bestätigt. Die Erweiterung verarbeitet diese Zahlungsstatus von Mollie:

Wenn der Kunde zurückkehrt, prüft die Erweiterung die Zahlung auf die gleiche Weise über die Mollie-API. Die Bestellung erhält dann ihren Status auf die übliche Art von OpenCart, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung mit Your payment with Mollie has been received. Bei einer Banküberweisung zeigt die Seite Your order will be processed as soon as Mollie receives your bank transfer. an. Ist die Bestellung im Wartestatus, zeigt die Seite We are confirming your payment with Mollie. The order will be updated automatically — please do not pay again. an. Ist eine erwartete Zahlung fehlgeschlagen, zeigt die Seite Your Mollie payment was not completed. Please contact us about this order. an.

Wurde die Zahlung abgebrochen, ist fehlgeschlagen, abgelaufen oder nicht abgeschlossen, kehrt der Kunde mit einer Meldung zur Kasse zurück, zum Beispiel You cancelled the Mollie payment. You can try again or choose another payment method. oder The Mollie payment has expired. Please try again or choose another payment method. Auf OpenCart 4 werden diese Meldungen über der Kassenseite angezeigt. Der Warenkorb bleibt erhalten. Wenn Mollie nicht erreicht werden kann oder noch keine Entscheidung getroffen hat, erscheint eine Seite Payment confirmation, die den Kunden bittet, nicht erneut zu bezahlen, und eine Schaltfläche Check again anbietet; der Webhook setzt den Bestellstatus, sobald er eintrifft.

OpenCart 3 legt jedes Mal eine neue Bestellung an, 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 Mollie-Zahlung. In beiden Fällen behandelt die Erweiterung alle Bestellungen eines Warenkorbs als eine Zahlung. Wenn der Kunde erneut bezahlt, wird die noch offene Mollie-Zahlung über den gleichen Betrag wiederverwendet, statt eine zweite zahlbare Zahlung zu erstellen. Hat sich die Summe geändert, wird die alte offene Zahlung bei Mollie storniert, sofern Mollie dies zulässt. Wurde eine alte Zahlung inzwischen bezahlt, wird diese Zahlung bestätigt und der Kunde gelangt ohne neue Zahlung zur Erfolgsseite.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel ist ihre Banküberweisung abgelaufen oder Sie haben sie storniert oder erstattet), wird der Kunde mit Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order. zurück zur Kasse geschickt, und das nächste Confirm Order bezahlt eine neue Bestellung. Eine Bestellung des Warenkorbs, die bezahlt und dann storniert oder erstattet wurde, blockiert den Warenkorb nicht mehr.

Kann Mollie die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung über der Schaltfläche, zum Beispiel The payment provider could not be reached. Please try again in a moment., This payment method is temporarily unavailable. Please choose another payment method. (falscher API-Schlüssel) oder Mollie cannot accept a payment of this amount or currency. Please choose another payment method. Der technische Grund wird im Protokoll festgehalten.

Der Webhook funktioniert auch, während der Shop im Wartungsmodus ist, weil OpenCart 3 Anfragen von Zahlungserweiterungen durchlässt und OpenCart 4 dafür eine Startaktion der Erweiterung ergänzt, die auch die Rückkehr des Kunden von Mollie zulässt.

Der Kunde wählt die Mollie-Zahlungsart auf der Mollie-Seite und nicht in Ihrer Kasse. Die Erweiterung unterstützt keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten oder Mandate, keine Kartenfelder auf Ihrer Website, keine Apple-Pay- oder PayPal-Express-Schaltflächen und keine Orders API. Daher bietet Mollie für diese Zahlungen keine Zahlungsarten an, die Bestellpositionen benötigen (zum Beispiel einige Varianten von Klarna, Billie oder in3). Autorisierte Zahlungen werden im Mollie Dashboard erfasst oder storniert, nicht über OpenCart.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu Mollie weitergeleitet und hat nicht bezahlt, oder Mollie hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (Standard In Bearbeitung): Die Zahlung wurde bestätigt. Eine Notiz zeigt die Mollie-Zahlung (tr_...), die Zahlungsart und den Modus.

Awaiting Mollie Payment Status (Standard Ausstehend): Der Kunde hat auf der Mollie-Seite Banküberweisung gewählt. Die Bestellung wechselt in den bezahlten Status, sobald Mollie das Geld erhält.

Mollie Payment On Hold Status (Standard Ausstehend): Eine autorisierte Zahlung wartet auf Erfassung, Mollie hat eine Rückbuchung gemeldet, der bezahlte Betrag oder die Währung wich von der Bestellung ab, eine Testzahlung wurde bezahlt, während der Shop im Live-Modus ist (es wurde kein Geld empfangen), oder die Zahlung ist eingegangen, nachdem die Bestellung einen anderen Status erhalten hatte (zum Beispiel wurde sie storniert). Die Notiz erklärt dies. Prüfen Sie die Zahlung im Mollie Dashboard und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Payment Error Status (Standard Fehlgeschlagen): Eine Banküberweisung oder Autorisierung einer Bestellung ist fehlgeschlagen, abgelaufen oder abgebrochen worden.

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

OpenCart benachrichtigt den Kunden über diese Statusänderungen auf die übliche Weise. Wird eine zweite Zahlung desselben Warenkorbs bezahlt, bleibt die Bestellung unverändert. Eine Notiz an der bezahlten Bestellung fordert Sie auf, die doppelte Zahlung im Mollie Dashboard zu erstatten.

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

Registerkarte VibeFox Mollie Gateway

Öffnen Sie unter Sales > Orders eine mit Mollie bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Mollie Gateway die Mollie payment-ID mit der Kennzeichnung Test mode bei Testzahlungen, die Method, den Zahlungs-Status, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf (Datum, Erstattungs-ID, Betrag, Modus, Mollie-Status, Grund) und die Mollie notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie auf der Registerkarte VibeFox Mollie Gateway den Amount ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Mollie. Bestätigen Sie die Abfrage Refund this amount through Mollie? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Erstattungen erfolgen in dem Betrag und in der Währung, die Mollie berechnet hat. Nach einer Betragsabweichung können Sie daher bis zu dem erstatten, was der Kunde tatsächlich bezahlt hat, nicht bis zum Bestellbetrag. Die Erstattung wird für die Zahlung gesendet, mit der die Bestellung tatsächlich bezahlt wurde, und mit dem API-Schlüssel des Modus, in dem sie getätigt wurde. Daher muss der Schlüssel dieses Modus eingetragen sein. Lehnt Mollie die Erstattung ab oder meldet sie als fehlgeschlagen oder abgebrochen, zeigt die Registerkarte die Meldung an und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen mit der Mollie-Erstattungs-ID hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf den Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Lagerbestand zurückzubuchen, wie bei einer manuellen Statusänderung. Eine teilweise Erstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald Mollie die Zahlung als bezahlt gemeldet hat.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über Mollie. Im Mollie Dashboard erstellte Erstattungen werden auf der Bestellung nicht angezeigt; eine Rückbuchung fügt eine Notiz hinzu.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich License — VibeFox Mollie Gateway ist der erste Bereich unter Extensions > Extensions > Payments > VibeFox Mollie Gateway > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Bereich den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz aktiv 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-mollie 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 Bereichs folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Bereich den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shop-Adresse 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: die Shop-Adresse aus der OpenCart-Konfiguration. 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 Mollie Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der im Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin-Bereich nicht, daher wird 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. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, aber Updates und Support erfordern 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 der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht erforderlich. Beim Deinstallieren der Erweiterung werden der Lizenzschlüssel und der Lizenzstatus immer entfernt.

Fehlerbehebung

Mollie erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der aktuelle Modus einen API-Schlüssel hat: Test API Key im Testmodus, Live API Key im Live-Modus. Prüfen Sie, ob die Währung der Kasse von Mollie unterstützt wird, ob die Rechnungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht. Die Einstellungsseite zeigt eine Warnung bei einem fehlenden Schlüssel und bei einer nicht unterstützten Shop-Währung an.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: Der Webhook kann Ihren Shop nicht erreichen. Die unter Webhook URL angezeigte URL muss aus dem Internet erreichbar sein (keine Basis-Authentifizierung oder Firewall, die dazwischenliegt). Die Bestellung erhält ihren Status auch dann, wenn der Kunde nach der Zahlung in den Shop zurückkehrt oder wenn der Kunde auf Check again klickt.

Der Webhook antwortet Unknown payment.: Die Zahlung wurde nicht von diesem Shop erstellt oder Mollie kennt sie nicht für den API-Schlüssel ihres Modus, zum Beispiel eine Zahlung eines anderen Mollie-Kontos.

Der Webhook antwortet Payment ID mismatch.: Die Zahlung gehört nicht zu der Bestellung, für die sie erstellt wurde. Es wird nichts verändert.

Der Webhook antwortet Failed to fetch payment.: Die Mollie-API konnte nicht erreicht werden oder der API-Schlüssel des Zahlungsmodus ist nicht eingetragen. Mollie wiederholt den Webhook später.

Der Webhook antwortet Temporarily unavailable.: Der Warenkorb wurde im selben Moment von einer anderen Anfrage verarbeitet oder der Bestellstatus konnte nicht gesetzt werden. Mollie wiederholt den Webhook. Aktivieren Sie Logging, um den Grund zu sehen.

Die Webhook-URL zeigt im Browser Method not allowed.: Das ist normal. Die URL akzeptiert nur Anfragen von Mollie.

Ein API-Schlüssel wird nicht gespeichert: Der Schlüssel muss mit test_ oder live_ beginnen, gefolgt von mindestens 30 Buchstaben und Ziffern. Kopieren Sie ihn erneut aus dem Mollie Dashboard.

Der Kunde sieht nach Confirm Order einen Fehler: Sehen Sie im Feld Log auf der Seite der Erweiterung nach. Dort stehen der HTTP-Code und die Mollie-Meldung. 401 bedeutet einen falschen API-Schlüssel; 422 weist auf ein Feld der Anfrage hin, zum Beispiel einen Betrag oder eine Währung, die Mollie nicht akzeptiert. This payment method is not available. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt oder die Zahlungsart inzwischen ausgeschaltet wurde: Der Kunde lädt die Kasse neu.

Die Bestellung ist im Status „On hold“: Lesen Sie die Notizen auf der Registerkarte VibeFox Mollie Gateway (siehe Order statuses) und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Kein Erstattungsformular auf der Registerkarte: Die Registerkarte nennt den Grund: Die Zahlung ist noch nicht bezahlt, sie ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern, oder die Zahlung wurde im Test- oder Live-Modus getätigt und der API-Schlüssel dieses Modus ist nicht eingetragen (tragen Sie ihn ein und öffnen Sie die Bestellung erneut).

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse molg_supported_currencies (die Währungsliste) und molg_payment_data (die Zahlungsanfrage und die Bestellung, bevor die Mollie-Zahlung erstellt wird) aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Mollie Gateway auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus des Bereichs Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 seine Ereignisse und seine Startaktion, die den Webhook im Wartungsmodus durchlässt). Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, API-Schlüssel, Logging) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Mollie-Zahlungs-IDs und Erstattungsdatensätze bleiben immer erhalten, sodass bereits bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Unter OpenCart 4 entfernen Sie die Dateien der Erweiterung ebenfalls: Gehen Sie nach der Deinstallation zu Extensions > Installer, klicken Sie in der Liste der installierten Erweiterungen neben VibeFox Mollie Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und dann auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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