VibeFox Montonio 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.

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

Montonio-Konto: Sie benötigen den Zugriffsschlüssel und den geheimen Schlüssel Ihres Shops aus dem Montonio Partner System. Sandbox- und Live-Schlüssel sind verschieden, Sie brauchen also für jede verwendete Umgebung ein Paar. Sonst muss in Montonio nichts eingerichtet werden: Die Benachrichtigungsadresse wird mit jeder Zahlung übermittelt.

Öffentliche Website: Ihre Website muss aus dem Internet erreichbar sein, um Montonio-Benachrichtigungen zu empfangen. Andernfalls werden Bestellungen trotzdem bestätigt, sobald der Kunde in den Shop zurückkehrt.

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

Installation

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Montonio > Manage oder klicken Sie auf der Seite Plugins 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. Öffnen Sie im Montonio Partner System Stores > your store > API keys und kopieren Sie den Sandbox-Zugriffsschlüssel und den geheimen Sandbox-Schlüssel. Fügen Sie sie in die Einstellungen ein und lassen Sie Sandbox mode aktiviert.

6. Aktivieren Sie Enable/Disable und testen Sie eine Zahlung in der Sandbox. Geben Sie danach die Live-Schlüssel ein und deaktivieren Sie Sandbox mode.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Montonio. Oberhalb der Felder warnt die Seite, wenn die Schlüssel der aktuellen Umgebung fehlen (die Zahlungsart wird dann an der Kasse ausgeblendet), und wenn die Shop-Währung weder EUR noch PLN ist. Solange die Sandbox aktiv ist, zeigt sie Sandbox mode is on: payments are simulated and no real money is charged. an. In der Liste der Zahlungsarten ist Montonio als einrichtungsbedürftig markiert, bis beide Schlüssel der aktuellen Umgebung eingetragen sind.

Allgemein

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

Title: der Name der Zahlungsart, den der Kunde an der Kasse sieht. Standard: Bank payment (Montonio).

Description: der Text, der an der Kasse unter der Zahlungsart angezeigt wird. Standard: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.

API-Schlüssel

Die Schlüssel erhalten Sie im Montonio Partner System 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. Dieser Bereich der Einstellungen zeigt außerdem die Benachrichtigungs-URL. Sie sieht so aus: https://your-site/wc-api/wc_mnt_payment/. Sie müssen sie nirgends eintragen: Das Plugin übermittelt sie mit jeder Zahlung an Montonio.

Sandbox mode: Use the Montonio sandbox (test payments, no real money). Dies schaltet sowohl die API-Adresse von Montonio als auch das Schlüsselpaar um. Standard: aktiv. Deaktivieren Sie dies erst, nachdem Sie die Live-Schlüssel eingetragen haben.

Sandbox access key: der Zugriffsschlüssel (UUID) Ihres Shops in der Montonio-Sandbox.

Sandbox secret key: der geheime Schlüssel Ihres Shops in der Montonio-Sandbox.

Live access key: der Zugriffsschlüssel (UUID) Ihres Shops in der Live-Umgebung von Montonio.

Live secret key: der geheime Schlüssel Ihres Shops in der Live-Umgebung von Montonio.

Erweitert

Debug log: Log payment events schreibt alle Zahlungsereignisse nach WooCommerce > Status > Logs, Quelle wcp_montonio_payment. Fehler werden immer protokolliert, auch wenn diese Option aus ist. Schlüssel, Token und Kundendaten werden nie protokolliert. Standard: aus.

Delete data: Delete the gateway settings and logs when the plugin is deleted. Das Deaktivieren des Plugins löscht nie etwas. Bestelldaten (Montonio-UUIDs, Notizen) bleiben immer erhalten. Standard: aus.

Zahlungsbenachrichtigungen

Montonio informiert Ihren Shop über jede Zahlung mit einem signierten Token. Das Token kommt auf zwei Wegen: per Server-zu-Server-Benachrichtigung an die Benachrichtigungs-URL und mit dem Kunden, wenn er in den Shop zurückkehrt. Beide werden geprüft: die Signatur mit Ihrem geheimen Schlüssel, das Ablaufdatum, Ihr Zugriffsschlüssel und ob die Zahlung eine ist, die Ihr Shop für diese Bestellung in derselben Umgebung erstellt hat. Tokens, die die Prüfung nicht bestehen, werden abgelehnt. Jeder Status wird nur einmal angewendet, sodass wiederholte Benachrichtigungen keine Notizen, E-Mails oder Bestandsänderungen auslösen.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Bank payment (Montonio)) und gibt die Bestellung auf. Das Plugin erstellt eine Montonio-Zahlung für den Bestellbetrag in der Bestellwährung und leitet den Kunden zur Zahlungsseite von Montonio weiter. Dort wählt der Kunde eine Bank und zahlt. 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 in Englisch. Im Sandbox-Modus zeigt die Kasse unter der Beschreibung SANDBOX MODE — test payment, no real money is charged. an.

Die Bestellung wird nur dann als bezahlt markiert, wenn Montonio sie mit dem Status PAID sowie dem exakten Bestellbetrag und der Währung bestätigt. Nach der Zahlung kehrt der Kunde auf die Bestellbestätigungsseite Ihres Shops zurück. Solange Montonio die Zahlung noch nicht bestätigt hat, zeigt diese Seite Montonio has not confirmed your payment yet. The order is updated as soon as the bank confirms it, and you will receive an e-mail then. Wurde die Zahlung abgebrochen oder abgelehnt, kehrt der Kunde zur Seite Pay for order zurück und sieht eine dieser Meldungen: The payment was cancelled or rejected by the bank. You can try again or choose another payment method., The payment was not completed. You can try again or choose another payment method. oder Montonio could not complete the payment. Please try again or choose another payment method.

Ein Kunde kann eine unbezahlte Bestellung über die Seite Pay for order erneut bezahlen. Bevor eine neue Zahlung erstellt wird, fragt das Plugin Montonio nach der vorherigen Zahlung. Ist diese bereits bezahlt, wird die Bestellung bestätigt und keine zweite Zahlung erstellt.

Kann Montonio die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, zum Beispiel Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method., und kann eine andere Zahlungsart wählen. Der Montonio-Fehler wird in den Bestellnotizen und im Protokoll vermerkt.

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

Das Plugin unterstützt nur Banküberweisungen (Zahlungsauslösung). Es bietet keine Kartenzahlungen, BLIK, Apple Pay oder Google Pay, kein Pay Later oder Finanzierung, keinen Versand über Montonio, keine Abonnements, keine gespeicherten Zahlungsmethoden und keine Bankauswahl auf Ihrer eigenen Website.

Bestellungen und Erstattungen

Bestellstatus

Zahlung ausstehend: Der Kunde wurde zu Montonio weitergeleitet und hat noch nicht bezahlt. Eine Notiz wird hinzugefügt, wenn Montonio die Zahlung als ausstehend meldet.

In Bearbeitung oder Abgeschlossen: Montonio hat die Zahlung bestätigt (PAID). Die Bestellung folgt dem WooCommerce-Standardstatus für bezahlte Bestellungen. Die Bestellnotiz zeigt die Bank, die Montonio-UUID der Zahlung, den Betrag und die Umgebung. Die Transaktions-ID ist die Montonio-UUID der Zahlung.

Wartend: Die Bank hat die Zahlung noch nicht bestätigt (AUTHORIZED); die Bestellung wird bezahlt, sobald Montonio PAID meldet. Eine Bestellung wird auch auf Wartend gesetzt, wenn Montonio einen anderen Betrag oder eine andere Währung als den Bestellbetrag meldet, wenn eine Sandbox-Zahlung eintrifft, während der Shop im Live-Modus läuft, oder wenn die Zahlung nach dem Stornieren der Bestellung eingeht. Die Bestellnotiz erklärt dies. Prüfen Sie die Zahlung im Montonio Partner System und erfüllen Sie die Bestellung oder erstatten Sie die Zahlung.

Fehlgeschlagen: Der Kunde hat die Zahlung nicht abgeschlossen oder die Bank hat sie abgelehnt. Nur die letzte Zahlung einer unbezahlten Bestellung kann die Bestellung fehlschlagen lassen. Der Kunde kann es über die Seite Pay for order erneut versuchen.

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

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Bank payment (Montonio) (die Schaltfläche verwendet den Namen der Zahlungsart). Volle und teilweise Erstattungen werden für über Montonio bezahlte Bestellungen unterstützt. Die Erstattung wird an die Umgebung gesendet, in der die Zahlung erfolgte (Sandbox oder Live), daher müssen die Schlüssel dieser Umgebung eingetragen sein. Akzeptiert Montonio die Erstattung nicht, zeigt WooCommerce den Fehler an und es wird keine Erstattung erfasst. Eine gesendete Erstattung wird mit ihrem Status und der Montonio-Erstattungs-ID in den Bestellnotizen vermerkt.

Montonio bestätigt oder lehnt jede Erstattung später per Benachrichtigung ab. Eine Bestätigung wird in den Bestellnotizen vermerkt. 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 WooCommerce.

Im Montonio Partner System vorgenommene Erstattungen werden in den Bestellnotizen vermerkt, sobald Montonio sie meldet. Sie werden nicht automatisch als WooCommerce-Erstattungen erfasst. Erstellen Sie bei Bedarf eine manuelle Erstattung in WooCommerce.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Montonio. 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 gilt 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 Montonio Kunden an 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 Plugin-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, funktioniert das Plugin weiter, für Updates und Support ist aber eine Verlängerung nötig. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

Montonio erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, beide Schlüssel der aktuellen Umgebung eingetragen sind (Sandbox access key und Sandbox secret key im Sandbox-Modus, Live access key und Live secret key im Live-Modus) und die Shop- oder Bestellwährung EUR oder PLN ist. Die Einstellungsseite zeigt eine Warnung, wenn Schlüssel fehlen oder die Währung nicht unterstützt wird.

Die Zahlung ist durchgegangen, die Bestellung bleibt aber auf Zahlung ausstehend: Die Benachrichtigung hat Ihren Shop nicht erreicht. Prüfen Sie, ob die Website aus dem Internet erreichbar ist und ob die Schlüssel in den Einstellungen zur Umgebung der Zahlung gehören. Die Bestellung wird auch bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt, und wenn der Kunde versucht, dieselbe Bestellung erneut zu bezahlen.

Die Benachrichtigung meldet Invalid token: Die Signatur, das Ablaufdatum oder der Zugriffsschlüssel des Tokens stimmten nicht überein. Prüfen Sie, ob Zugriffsschlüssel und geheimer Schlüssel korrekt kopiert sind und zur richtigen Umgebung gehören und ob die Serveruhr stimmt.

Die Benachrichtigung meldet Payment does not belong to this order oder Wrong environment: Die Zahlung wurde nicht von diesem Shop für diese Bestellung erstellt oder in der anderen Umgebung (Sandbox oder Live). Das passiert, wenn zwei Shops dasselbe Montonio-Konto und dieselben Bestellnummern verwenden.

Die Benachrichtigung meldet Gateway not configured: Es sind keine Montonio-Schlüssel eingetragen. Tragen Sie die Schlüssel ein; Montonio wiederholt die Benachrichtigung.

Der Kunde sieht beim Aufgeben der Bestellung einen Fehler: Öffnen Sie die Bestellnotizen oder aktivieren Sie Debug log und prüfen Sie WooCommerce > Status > Logs, Quelle wcp_montonio_payment. This payment method is temporarily unavailable. Please choose another payment method. bedeutet meist falsche oder fehlende Schlüssel. Montonio could not start the payment. Please check your order details or choose another payment method. bedeutet, dass Montonio die Zahlungsdaten abgelehnt hat; die Notiz nennt den Grund.

Bestellung nach der Zahlung auf Wartend: Lesen Sie die Bestellnotiz. Die Bank hat die Zahlung noch nicht bestätigt, der bezahlte Betrag oder die Währung weicht von der Bestellung ab, eine Sandbox-Zahlung kam im Live-Modus an, oder die Zahlung kam nach dem Stornieren der Bestellung. Prüfen Sie die Zahlung im Montonio Partner System.

Sandbox-Zahlungen bestätigen keine Live-Bestellung: Eine Sandbox-Zahlung schließt nie eine Bestellung ab, solange der Shop im Live-Modus läuft; die Bestellung wird stattdessen auf Wartend gesetzt. Stellen Sie Sandbox mode auf die gewünschte Umgebung um und verwenden Sie deren Schlüssel.

Erstattung schlägt mit einer Meldung zur Umgebung fehl: Die Zahlung erfolgte in der Sandbox bzw. im Live-Modus, und die Schlüssel dieser Umgebung sind nicht eingetragen. Tragen Sie sie ein und versuchen Sie es erneut.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel schon 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 Einstellungen des Gateways und die Protokolle werden nur entfernt, wenn Delete data aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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