VibeFox Mollie for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

Shop-Währung: die Warenkorbwährung 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 Zahlungsoption im Bestellvorgang 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 werden Bestellungen trotzdem angelegt, 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 nötig. Die Zahlungsarten selbst werden in Ihrem Mollie-Konto aktiviert.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer Domain.

Installation

1. Gehen Sie im Back Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls aus.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox Mollie Gateway in der Modulliste und klicken Sie auf Configure.

3. Fügen Sie Ihren VibeFox-Lizenzschlüssel in das Feld License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Geben Sie Ihre Test- und Live-API-Schlüssel ein (siehe Konfiguration). 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 danach aus.

Bei der Installation legt das Modul zwei Bestellstatus an, Awaiting Mollie payment und Mollie payment on hold. PrestaShop bietet ein neues Zahlungsmodul für alle Währungen, Länder und Kundengruppen an. Sie können dies unter Payment > Preferences einschränken.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Mollie Gateway > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder 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 Zahlungsoption im Bestellvorgang ausgeblendet.

Beim Speichern wird ein API-Schlüssel, der nicht mit test_ oder live_ beginnt, gefolgt von mindestens 30 Buchstaben und Ziffern, nicht gespeichert: Es erscheint eine Fehlermeldung, und der zuvor gespeicherte Schlüssel bleibt erhalten.

Bestellvorgang

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

Title: der Titel der Zahlungsart, der dem Kunden im Bestellvorgang angezeigt wird. Er ist auch der Name der Zahlungsart, der in der Bestellung gespeichert wird. Standard: Mollie. Pflichtfeld.

Description: die Beschreibung der Zahlungsart, die dem Kunden im Bestellvorgang angezeigt wird. Standard: Pay securely via Mollie.

API-Schlüssel

Ihre API-Schlüssel finden Sie im Mollie Dashboard unter Developers > API keys; der 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 Mollie-Testkasse können Sie das Ergebnis der Zahlung wählen. Kunden sehen unter der Zahlungsoption Test mode: no real payment will be made. Zahlungen, die im anderen Modus getätigt wurden, verwenden für Statusprüfungen und Erstattungen weiterhin den Schlüssel ihres eigenen Modus. Standard: on.

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. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten.

Clear saved keys: Markieren Sie einen Schlüssel und klicken Sie auf Save, um ihn zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Webhook: zeigt die Webhook-URL an. Eine Einrichtung ist nicht nötig: Das Modul sendet diese URL bei jeder Zahlung an Mollie. Mit suchmaschinenfreundlichen URLs sieht sie so aus: https://your-shop/module/wcp_mollie_gateway/webhook, gegebenenfalls mit einem Sprachcode. Sie muss aus dem Internet erreichbar sein, sonst werden Bestellungen erst angelegt, wenn der Kunde von Mollie zurückkehrt.

Bestellungen

Order Status After Payment: der Bestellstatus, der nach einer erfolgreichen Zahlung gesetzt wird. Der Status wird in einem Schritt gesetzt.

Processing: die Bestellung wird Payment accepted (Standard).

Completed: die Bestellung wird Delivered.

Banküberweisungen warten in Awaiting Mollie payment. Autorisierte Zahlungen sowie Abweichungen bei Betrag oder Währung gehen in Mollie payment on hold.

Erweitert

Logging: schreibt API-Aufrufe und Webhooks in logs/molg_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. Fehler und Warnungen werden immer protokolliert, auch wenn dies ausgeschaltet ist. API-Schlüssel und Kundendaten werden nie protokolliert. Standard: off.

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

Delete Data on Uninstall: ist dies eingeschaltet, werden die Moduleinstellungen und das Protokoll bei der Deinstallation des Moduls gelöscht. Die bei Bestellungen gespeicherten Mollie-Zahlungs-IDs, die Erstattungsdatensätze und die Bestellstatus des Moduls bleiben immer erhalten. Standard: off.

Bestellvorgang

Im Zahlungsschritt wählt der Kunde die Zahlungsoption (standardmäßig Mollie) und bestätigt. Das Modul erstellt eine Mollie-Zahlung über den Warenkorbbetrag in der Warenkorbwährung (JPY und ISK ohne Dezimalstellen) mit der Beschreibung Order # und der Warenkorbnummer und leitet den Kunden zur gehosteten Mollie-Checkoutseite weiter. Dort wählt der Kunde eine der in Ihrem Mollie-Konto aktivierten Zahlungsarten und bezahlt. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Mollie-Webhooks sind nicht signiert und enthalten nur die Zahlungs-ID. Deshalb vertraut das Modul einem Webhook nie von selbst: Es akzeptiert nur Zahlungs-IDs, die es selbst angelegt hat, ruft die Zahlung mit dem Schlüssel des Modus ab, in dem sie getätigt wurde, prüft, ob die Zahlung zum Warenkorb gehört, und vergleicht den bezahlten Betrag und die Währung mit dem Warenkorbbetrag. Die Bestellung wird erst als bezahlt markiert, wenn Mollie dies auf diesem Weg bestätigt. Das Modul verarbeitet folgende Mollie-Zahlungsstatus:

paid: die Zahlung wurde getätigt. Die Bestellung wird im Status Order Status After Payment angelegt, wenn Betrag und Währung übereinstimmen.

authorized: die Zahlung wurde autorisiert, aber nicht erfasst. Die Bestellung wird mit einer Notiz in Mollie payment on hold angelegt; erfassen Sie die Zahlung im Mollie Dashboard, dann wird die Bestellung automatisch als bezahlt markiert.

open (bank transfer): Mollie wartet auf das Geld. Die Bestellung wird in Awaiting Mollie payment angelegt und als bezahlt markiert, sobald Mollie das Geld erhält.

open, pending: die Zahlung ist noch nicht abgeschlossen. Es ändert sich nichts.

failed, expired, canceled: der letzte Zahlungsversuch war nicht erfolgreich. Ohne Bestellung kann der Kunde einfach erneut zahlen; eine auf diese Zahlung wartende Bestellung wird auf Payment error gesetzt.

chargeback: Mollie meldet eine zurückgebuchte Summe. Eine Notiz wird hinzugefügt, und eine bezahlte Bestellung wird auf Halt gesetzt.

Wenn der Kunde zurückkehrt, prüft das Modul die letzte Zahlung des Warenkorbs auf die gleiche Weise über die Mollie-API. Eine bezahlte Zahlung führt zur üblichen Bestellbestätigungsseite 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. Ist die Bestellung auf Halt, zeigt die Seite We are confirming your payment with Mollie. The order will be updated automatically — please do not pay again. Ist die Zahlung einer bestehenden Bestellung fehlgeschlagen oder wurde die Bestellung storniert, zeigt die Seite Your Mollie payment was not completed. Please contact us about this order.

Wurde die Zahlung abgebrochen, ist fehlgeschlagen, abgelaufen oder nicht abgeschlossen, kehrt der Kunde mit einer Meldung zum Bestellvorgang 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. Der Warenkorb bleibt erhalten. Wenn Mollie nicht erreichbar ist oder noch nicht entschieden hat, erscheint eine Seite Payment confirmation, die den Kunden bittet, nicht erneut zu zahlen, und eine Schaltfläche Check again anbietet; der Webhook legt die Bestellung an, sobald er eintrifft.

Zahlt der Kunde erneut, wird die noch offene Mollie-Zahlung mit demselben Betrag wiederverwendet, anstatt eine zweite zahlbare Zahlung anzulegen. Hat sich der Gesamtbetrag des Warenkorbs geändert, wird die alte offene Zahlung bei Mollie storniert, sofern Mollie dies zulässt. Wurde die alte Zahlung inzwischen bezahlt, wird die Bestellung ohne neue Zahlung angelegt.

Kann Mollie die Zahlung nicht starten, bleibt der Kunde im Bestellvorgang mit einer kurzen Meldung, 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 ins Protokoll geschrieben.

Der Webhook funktioniert auch, während der Shop im Wartungsmodus ist, und wird nicht durch die Länderbeschränkung Ihres Shops blockiert.

Der Kunde wählt die Mollie-Zahlungsart auf der Mollie-Seite, nicht im Bestellvorgang Ihres Shops. Das Modul bietet keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten oder Mandate, keine Kartenfelder auf Ihrer Website, keine Apple-Pay- oder PayPal-Express-Buttons 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 aus PrestaShop heraus.

Bestellungen und Erstattungen

Bestellstatus

Noch keine Bestellung: der Kunde wurde zu Mollie weitergeleitet und hat nicht bezahlt, oder Mollie hat die Zahlung noch nicht bestätigt. Es existiert nur der Warenkorb.

Payment accepted oder Delivered: die Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Die Zahlung wird mit der Mollie-Zahlungs-ID (tr_...) als Transaktions-ID erfasst, und eine Notiz zeigt die Mollie-Zahlung, die Zahlungsart und den Modus.

Awaiting Mollie payment: 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: eine autorisierte Zahlung wartet auf die Erfassung, Mollie hat eine Rückbuchung gemeldet, der bezahlte Betrag oder die Währung wich vom Warenkorb ab (zum Beispiel wurde der Warenkorb geändert, nachdem die Zahlung begonnen hatte), eine Testzahlung wurde getätigt, während der Shop im Live-Modus war (es ist kein Geld eingegangen), oder die Zahlung kam, nachdem die Bestellung storniert worden war. Die Notiz erklärt es. Prüfen Sie die Zahlung im Mollie Dashboard und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Payment error: eine Banküberweisung oder Autorisierung einer bestehenden Bestellung ist fehlgeschlagen, abgelaufen oder storniert worden. Eine bezahlte Bestellung wird nie verändert.

Refunded: die Zahlung wurde über das Modul vollständig erstattet.

Wird eine zweite Zahlung desselben Warenkorbs bezahlt, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, die doppelte Zahlung in Ihrem Mollie Dashboard zu erstatten.

Block „Mollie payment“

Die Bestellseite zeigt einen Block Mollie payment mit der Mollie-Zahlungs-ID, der Zahlungsart, dem Zahlungsstatus, dem bezahlten und erstatteten Betrag, einem Kennzeichen Test mode für Testzahlungen, dem Erstattungsverlauf und den Mollie notes der Bestellung. Notizen sind nur im Back Office sichtbar.

Erstattungen

Geben Sie im Block Mollie payment den Betrag ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Grund, und klicken Sie auf Refund via Mollie. Bestätigen Sie die Frage Refund this amount through Mollie? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht zum Bearbeiten von Bestellungen; der Zugriff auf die Modulseiten ist nicht nötig. Erstattungen erfolgen in dem Betrag und in der Währung, die Mollie eingezogen hat. Nach einer Betragsabweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht den Bestellbetrag. Die Erstattung wird für die Zahlung gesendet, die die Bestellung tatsächlich bezahlt hat, mit dem API-Schlüssel des Modus, in dem sie getätigt wurde; dieser Schlüssel muss daher eingerichtet sein. Lehnt Mollie die Erstattung ab, zeigt der Block die Fehlermeldung von Mollie, 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 Refunded. Eine teilweise Erstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald Mollie die Zahlung als bezahlt gemeldet hat.

Das Modul erstellt keine Gutschriften. Die Standard-Erstattungsschaltflächen von PrestaShop auf der Bestellseite überweisen kein Geld über Mollie zurück. Im Mollie Dashboard erstellte Erstattungen werden auf der Bestellung nicht angezeigt; eine Rückbuchung fügt eine Notiz hinzu.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Mollie Gateway ist der erste Block auf der Seite Modules > Module Manager > VibeFox Mollie Gateway > Configure, 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 zur erneuten Prüfung des Status, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-payment-mollie und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nach einer Änderung der Shop-Adresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Mollie Kunden im Bestellvorgang nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Die Storefront von PrestaShop weiß nicht, dass Sie im Back Office angemeldet sind, daher ist die Zahlungsart auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber im Bestellvorgang nicht testen. Ein Hinweis erscheint unter Modules > Module Manager auf dem Reiter Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits begonnene Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Modul weiter, Updates und Support benötigen jedoch eine Verlängerung. Der Status wird während der Arbeit im Back Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Die Deinstallation oder das Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Mollie erscheint nicht im Bestellvorgang: 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 Warenkorbwährung von Mollie unterstützt wird. Die Einstellungsseite zeigt eine Warnung bei fehlendem Schlüssel und bei einer nicht unterstützten Shop-Währung. Prüfen Sie unter Payment > Preferences, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe erlaubt ist.

Die Zahlung wurde durchgeführt, aber es wurde keine Bestellung angelegt: der Webhook kann Ihren Shop nicht erreichen. Die unter Webhook angezeigte URL muss aus dem Internet erreichbar sein (keine Basisauthentifizierung oder Firewall dazwischen). Die Bestellung wird auch angelegt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt oder auf Check again klickt.

Webhook antwortet Unknown payment.: die Zahlung wurde nicht von diesem Shop angelegt oder Mollie kennt sie mit dem API-Schlüssel ihres Modus nicht, zum Beispiel eine Zahlung eines anderen Mollie-Kontos.

Webhook antwortet Payment ID mismatch.: die Zahlung gehört nicht zum Warenkorb, für den sie angelegt wurde. Es wird nichts verändert.

Webhook antwortet Failed to fetch payment.: die Mollie-API war nicht erreichbar, oder der API-Schlüssel des Modus der Zahlung ist nicht gesetzt. Mollie versucht den Webhook später erneut.

Webhook antwortet Temporarily unavailable.: der Warenkorb wurde gleichzeitig von einer anderen Anfrage verarbeitet, oder die Bestellung konnte nicht angelegt werden (zum Beispiel weil das Modul deaktiviert ist). Mollie versucht den Webhook erneut. Schalten Sie Logging ein, 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 bei der Auswahl von Mollie einen Fehler: sehen Sie im Feld Log auf der Modulseite nach. Es zeigt den HTTP-Code und die Meldung von Mollie. 401 bedeutet einen falschen API-Schlüssel; 422 verweist auf ein Feld der Anfrage, zum Beispiel einen Betrag oder eine Währung, die Mollie nicht akzeptiert.

Die Bestellung ist Mollie payment on hold: lesen Sie die Notizen der Bestellung (siehe Bestellstatus) und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Erstattung schlägt mit einer Meldung zum Modus fehl: die Zahlung wurde im Test- oder Live-Modus getätigt, und der API-Schlüssel dieses Modus ist nicht gesetzt. Geben Sie ihn ein und versuchen Sie es erneut.

Andere Währungen oder Zahlungsdaten: Entwickler können die Währungsliste über den Hook actionWcpMollieSupportedCurrencies und die Zahlungsanfrage über den Hook actionWcpMolliePaymentData ändern.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Mollie Gateway und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete Data on Uninstall eingeschaltet, werden die Moduleinstellungen und das Protokoll entfernt. Ist es ausgeschaltet, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die Mollie-Zahlungs-IDs und Erstattungsdatensätze sowie die Bestellstatus Awaiting Mollie payment und Mollie payment on hold bleiben immer erhalten, sodass zuvor bezahlte Bestellungen auch nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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