VibeFox Mollie for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.

PHP: 8.0 oder neuer.

Shop-Währung: eine der von Mollie unterstützten Währungen: 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 in der Kasse ausgeblendet. Welche Zahlungsarten Mollie anbietet, hängt von der Währung und von Ihrem Konto ab.

Internetzugang zu Ihrer Website: Mollie sendet Webhooks an Ihren Shop, daher muss die Website aus dem Internet erreichbar sein. Ohne Webhooks werden Bestellungen trotzdem aktualisiert, 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_. Die Zahlungsarten selbst aktivieren Sie in Ihrem Mollie-Konto.

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

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins aus und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_mollie_gateway per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Mollie > Manage oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

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

6. Aktivieren Sie Enable/Disable. Lassen Sie Test Mode aktiviert, bis Sie eine Testzahlung durchgeführt haben, und deaktivieren Sie es dann.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Mollie. Oberhalb der Felder warnt die Seite, wenn Mollie aktiviert ist, der API-Schlüssel des aktuellen Modus aber leer ist, und wenn Mollie die Shop-Währung nicht unterstützt. In beiden Fällen wird die Zahlungsart in der Kasse ausgeblendet. In der Liste der Zahlungsarten ist Mollie als einrichtungsbedürftig markiert, bis der aktuelle Modus einen API-Schlüssel hat, und zeigt Test mode, solange der Testmodus aktiv ist.

Beim Speichern wird ein API-Schlüssel, der nicht mit test_ oder live_ beginnt und danach nicht mindestens 30 Buchstaben und Ziffern enthält, nicht gespeichert: Es erscheint eine Fehlermeldung, und der bisherige Wert bleibt erhalten.

Kasse

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

Title: der Titel der Zahlungsart, der dem Kunden in der Kasse angezeigt wird. Standard: Mollie.

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

API-Schlüssel

Ihre API-Schlüssel finden Sie unter Mollie Dashboard > Developers > API keys. Eine Webhook-Einrichtung ist nicht nötig: Das Plugin sendet seine Webhook-URL mit jeder Zahlung. Die URL wird in diesem Abschnitt angezeigt und sieht so aus: https://your-site/?wc-api=molg_mollie_webhook. Sie muss aus dem Internet erreichbar sein, sonst werden Bestellungen nur aktualisiert, wenn der Kunde von Mollie zurückkehrt.

Test Mode: Enable test mode verwendet für neue Zahlungen den Test-API-Schlüssel. Es werden keine echten Zahlungen abgewickelt. Auf der Mollie-Testzahlungsseite können Sie das Ergebnis wählen (paid, failed, cancelled, expired). Kunden sehen in der Kasse Test mode: no real payment will be made.. Zahlungen, die im anderen Modus erfolgt sind, verwenden für Statusprüfungen und Erstattungen weiterhin den Schlüssel ihres eigenen 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_).

Bestellungen

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

Processing: der WooCommerce-Standard (Standard). Bestellungen mit nur virtuellen, herunterladbaren Produkten werden Abgeschlossen.

Completed: jede bezahlte Bestellung wird Abgeschlossen.

Erweitert

Logging: Enable debug logging schreibt API-Aufrufe und Webhooks nach WooCommerce > Status > Logs, Quelle wcp_mollie_gateway. Fehler werden immer protokolliert. API-Schlüssel und Kundendaten werden nie protokolliert. Standard: aus.

Delete Data on Uninstall: Remove the plugin settings and logs when uninstalling. Wenn aktiviert, werden die Plugin-Einstellungen und seine Protokolldateien beim Löschen des Plugins entfernt. Die in den Bestellungen gespeicherten Mollie-Zahlungs-IDs bleiben erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Mollie) und gibt die Bestellung auf. Das Plugin erstellt 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-Checkoutseite weiter. Dort wählt der Kunde eine der in Ihrem Mollie-Konto aktivierten Zahlungsarten und bezahlt.

Mollie-Webhooks enthalten keine Signatur, nur die Zahlungs-ID. Deshalb vertraut das Plugin einem Webhook nie allein: Es ruft die Zahlung mit Ihrem eigenen API-Schlüssel von der Mollie-API ab, prüft, dass die Zahlung zur Bestellung gehört, und vergleicht den bezahlten Betrag und die Währung mit der Bestellung. Die Bestellung wird erst als bezahlt markiert, nachdem Mollie dies so bestätigt hat. Das Plugin verarbeitet folgende Mollie-Zahlungsstatus:

paid: die Zahlung wurde geleistet. Die Bestellung wird als bezahlt markiert, wenn Betrag und Währung übereinstimmen.

authorized: die Zahlung wurde autorisiert, aber nicht erfasst. Die Bestellung wird mit einer Notiz auf Wartend gesetzt; erfassen Sie die Zahlung im Mollie Dashboard.

open (bank transfer): Mollie wartet auf das Geld. Die Bestellung wird auf Wartend gesetzt, damit WooCommerce sie nicht als unbezahlt storniert.

open, pending: die Zahlung ist noch nicht abgeschlossen. Die Bestellung ändert sich nicht.

failed, expired, canceled: der letzte Zahlungsversuch war nicht erfolgreich. Eine unbezahlte Bestellung wird als Fehlgeschlagen markiert.

chargeback: Mollie meldet einen zurückgebuchten Betrag. Es wird eine Notiz hinzugefügt und die Bestellung auf Wartend gesetzt.

Wenn der Kunde zurückkehrt, prüft das Plugin die letzte Zahlung auf die gleiche Weise über die Mollie-API. Eine bezahlte Zahlung führt zur Seite „Bestellung eingegangen“. Wurde die Zahlung abgebrochen, ist fehlgeschlagen, abgelaufen oder noch nicht abgeschlossen, gelangt der Kunde zur Seite Pay for order mit einer Meldung, 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.

Zahlt der Kunde erneut, wird die noch offene Mollie-Zahlung über den gleichen Betrag wiederverwendet, anstatt eine zweite zahlbare Zahlung zu erstellen. Hat sich der Bestellbetrag 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 als bezahlt markiert.

Kann Mollie die Zahlung nicht starten, sieht der Kunde eine kurze 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 in den Bestellnotizen und im Protokoll ergänzt.

Die Zahlungsart funktioniert in der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Der Kunde wählt die Mollie-Zahlungsart auf der Mollie-Seite, nicht in Ihrer Kasse. Das Plugin bietet keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten oder Mandate, keine Mollie Components (Kartenfelder auf Ihrer Website), keine Apple-Pay- oder PayPal-Express-Buttons und keine Orders API. Zahlungsarten, die Bestellpositionen benötigen (zum Beispiel einige Varianten von Klarna, Billie oder in3), werden für diese Zahlungen daher von Mollie nicht angeboten. Autorisierte Zahlungen werden im Mollie Dashboard erfasst oder storniert, nicht aus WooCommerce heraus.

Bestellungen und Erstattungen

Bestellstatus

Pending payment: der Kunde wurde zu Mollie weitergeleitet und hat noch nicht bezahlt.

Processing or Completed: die Zahlung ist bestätigt. Der Status richtet sich nach Order Status After Payment. Die Bestellnotiz zeigt die Mollie-Zahlung, die Zahlungsart und den Modus. Die Transaktions-ID ist die Mollie-Zahlungs-ID (tr_...), mit der die Bestellung bezahlt wurde.

On hold: eine Banküberweisung wartet auf das Geld, eine autorisierte Zahlung wartet auf die Erfassung, oder Mollie hat eine Rückbuchung gemeldet. Wartend wird auch gesetzt, wenn der bezahlte Betrag oder die Währung von der Bestellung abweicht, wenn eine Testzahlung bei einem Shop im Live-Modus bezahlt wurde (es ist kein Geld eingegangen) oder wenn die Zahlung nach der Stornierung der Bestellung eingegangen ist. Die Bestellnotiz erklärt dies. Prüfen Sie die Zahlung im Mollie Dashboard und bearbeiten Sie danach die Bestellung oder erstatten Sie die Zahlung.

Failed: der letzte Zahlungsversuch ist fehlgeschlagen, abgelaufen oder wurde storniert. Eine bezahlte Bestellung wird nie verändert. Der Kunde kann erneut bezahlen.

Wird eine zweite Zahlung derselben Bestellung bezahlt, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, die doppelte Zahlung im Mollie Dashboard zu erstatten.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Mollie (die Schaltfläche zeigt Ihren Title). Vollständige und teilweise Erstattungen werden unterstützt. 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 erfolgte; dieser Schlüssel muss daher hinterlegt sein. Die Schaltfläche ist nur bei Bestellungen mit einer bezahlten Mollie-Zahlung verfügbar. Lehnt Mollie die Erstattung ab, zeigt WooCommerce die Fehlermeldung von Mollie an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Mollie-Erstattungs-ID in den Bestellnotizen vermerkt.

Im Mollie Dashboard erstellte Erstattungen und Rückbuchungen werden nicht in WooCommerce-Erstattungen umgewandelt. Eine Rückbuchung fügt nur eine Notiz hinzu.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Mollie. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel funktioniert für eine Domain. Das Entfernen des Schlüssels von einer Website gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Mollie Kunden in der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsart weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Wenn eine Lizenz abläuft, arbeitet das Plugin weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

Mollie erscheint nicht in 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 Shop-Währung (bzw. die Bestellwährung auf der Seite Pay for order) von Mollie unterstützt wird. Die Einstellungsseite zeigt für jedes dieser Probleme eine Warnung an.

Die Zahlung ist erfolgt, aber die Bestellung bleibt auf Pending payment: der Webhook kann Ihre Website nicht erreichen. Die in den Einstellungen angezeigte Webhook-URL muss aus dem Internet erreichbar sein (kein Wartungsmodus, keine Basisauthentifizierung und keine Firewall, die den Zugriff blockiert). Die Bestellung wird außerdem aktualisiert, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Webhook answers Unknown payment.: die Zahlungs-ID ist Mollie für Ihren Test- oder Live-API-Schlüssel nicht bekannt, zum Beispiel eine Zahlung eines anderen Mollie-Kontos.

Webhook answers Payment ID mismatch.: die Zahlung gehört laut ihren Daten nicht zur Bestellung. Die Bestellung wird nicht verändert.

Webhook answers Failed to fetch payment.: die Mollie-API war nicht erreichbar. Mollie wiederholt den Webhook später.

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.

Die Zahlung wird nicht erstellt: die Bestellnotiz und das Protokoll zeigen den 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. Aktivieren Sie Logging und sehen Sie unter WooCommerce > Status > Logs nach, Quelle wcp_mollie_gateway.

Die Bestellung ist On hold: lesen Sie die Bestellnotiz. Der Grund ist eine Abweichung von Betrag oder Währung, eine Testzahlung im Live-Modus, eine Zahlung nach der Stornierung, eine Banküberweisung, eine Autorisierung ohne Erfassung oder eine Rückbuchung.

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 hinterlegt. Geben Sie ihn ein und versuchen Sie es erneut.

Andere Währungen: Entwickler können die Währungsliste mit dem Filter molg_supported_currencies ändern.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen und die Protokolldateien werden nur entfernt, wenn Delete Data on Uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen, Mollie-Zahlungs-IDs und Transaktions-IDs.

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