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

Währung: Die Warenkorb-Währung muss EUR oder PLN sein. Bei jeder anderen Währung wird die Zahlungsart in 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, daher brauchen Sie für jede verwendete Umgebung ein Paar. In Montonio muss sonst nichts eingerichtet werden: Die Benachrichtigungsadresse wird mit jeder Zahlung übermittelt.

Öffentliche Website: Ihr Shop muss über das Internet erreichbar sein, um Montonio-Benachrichtigungen zu empfangen. Andernfalls werden Bestellungen trotzdem angelegt, wenn der Kunde in den Shop zurückkehrt.

VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. 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.

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

3. Geben Sie Ihren VibeFox-Lizenzschlüssel im Feld License key im Lizenzblock oben auf der Seite Configure 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-Zugriffsschlüssel und den geheimen Schlüssel. Fügen Sie sie in die Einstellungen ein und lassen Sie Sandbox mode eingeschaltet.

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

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

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Montonio Payment > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder warnt die Seite, wenn die Schlüssel der aktuellen Umgebung fehlen (die Zahlungsart wird dann in der Kasse ausgeblendet), wenn die Shop-Währung nicht EUR oder PLN ist, und zeigt Sandbox mode is on: payments are simulated and no real money is charged. an, solange die Sandbox aktiv ist. Title darf nicht leer sein.

Montonio

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

Title: der Name der Zahlungsart, den Kunden in der Kasse sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: Bank payment (Montonio). Pflichtfeld.

Description: der Text, der in 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 finden 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.

Sandbox mode: verwendet die Sandbox von Montonio (Testzahlungen, kein echtes Geld). Dabei werden sowohl die API-Adresse von Montonio als auch das Schlüsselpaar umgeschaltet. Standard: an. Schalten Sie es erst aus, nachdem Sie die Live-Schlüssel eingegeben haben. Zahlungen, die in der anderen Umgebung gemacht wurden, verwenden für Bestätigungen und Erstattungen weiterhin die Schlüssel ihrer eigenen Umgebung.

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.

Gespeicherte geheime Schlüssel werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie einen neuen Wert nur ein, wenn Sie ihn ändern möchten.

Clear saved secret keys: Setzen Sie den Haken bei einem Schlüssel und klicken Sie auf Save, um ihn zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Notification URL: die Adresse, an die Montonio Zahlungsbenachrichtigungen sendet. Mit schönen URLs sieht sie so aus: https://your-shop/module/wcp_montonio_payment/webhook. Sie müssen sie nirgends eingeben: Das Modul übermittelt sie mit jeder Zahlung an Montonio.

Erweitert

Debug log: schreibt Zahlungsereignisse in logs/wc_mnt_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. Fehler und Warnungen werden immer protokolliert, auch wenn diese Option aus ist. Schlüssel, Token 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 an, entfernt die Deinstallation des Moduls die Modul-Einstellungen und sein Protokoll. Das Deaktivieren des Moduls 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 Benachrichtigungsadresse und mit dem Kunden, wenn er in den Shop zurückkehrt. Beides wird geprüft: die Signatur mit dem geheimen Schlüssel der Umgebung, in der die Zahlung erstellt wurde, die Ablaufzeit, Ihr Zugriffsschlüssel und dass die Zahlung von Ihrem Shop für diesen Warenkorb erstellt wurde. Ein Token, das mit dem Schlüssel der anderen Umgebung signiert wurde, wird abgelehnt. Jeder Status wird nur einmal angewendet, sodass wiederholte Benachrichtigungen keine Notizen, E-Mails oder Bestandsänderungen auslösen. Die Benachrichtigungsadresse funktioniert auch, während der Shop im Wartungsmodus ist, und wird nicht durch die Länderbeschränkung Ihres Shops blockiert.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsart (standardmäßig Bank payment (Montonio)) und bestätigt. Das Modul erstellt eine Montonio-Zahlung für den Warenkorbbetrag in der Warenkorb-Währung und schickt den Kunden zur Zahlungsseite von Montonio. Dort wählt der Kunde eine Bank und zahlt. Banken des Rechnungslandes des Kunden werden zuerst angezeigt (für PLN-Warenkörbe Polen). Die Zahlung erscheint als Order mit der Warenkorbnummer. Die Montonio-Seite öffnet sich in der Shopsprache, wenn diese Deutsch, Englisch, Estnisch, Finnisch, Litauisch, Lettisch, Polnisch oder Russisch ist, andernfalls auf Englisch. Im Sandbox-Modus zeigt die Kasse unter der Beschreibung SANDBOX MODE — test payment, no real money is charged. an. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Die Bestellung wird erst als bezahlt markiert, wenn Montonio sie bestätigt: per Benachrichtigung oder mit der Rückkehr des Kunden. Danach wird die Bestellung angelegt, und der Kunde sieht die übliche Bestellbestätigungsseite mit Your Montonio bank payment has been received. Wenn die Bank die Zahlung noch nicht bestätigt hat oder die Bestellung wartet, 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, dass die Zahlung bei der Rückkehr des Kunden noch aussteht, zeigt eine Seite Payment confirmation denselben Text und eine Schaltfläche Check again. Die Schaltfläche fragt bei Montonio den aktuellen Status der Zahlung ab. Die Benachrichtigung legt die Bestellung an, sobald sie eintrifft.

Wurde die Zahlung abgebrochen oder abgelehnt, kehrt der Kunde zur Kasse 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. Der Warenkorb bleibt erhalten. Bevor eine neue Zahlung erstellt wird, fragt das Modul bei Montonio nach der vorherigen. Ist sie bereits bezahlt, wird die Bestellung angelegt und keine zweite Zahlung ausgeführt.

Wenn Montonio die Zahlung nicht starten kann, bleibt der Kunde in der Kasse mit einer kurzen Meldung, zum Beispiel Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method. Der technische Grund wird im Protokoll gespeichert.

Das Modul 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

No order yet: Der Kunde wurde zu Montonio geschickt und hat nicht bezahlt, oder Montonio meldet die Zahlung als ausstehend. Es existiert nur der Warenkorb.

Payment accepted: Montonio hat die Zahlung (PAID) mit dem exakten Warenkorbbetrag und der exakten Währung bestätigt. Die Zahlung wird mit der Montonio-Bestell-UUID als Transaktions-ID erfasst, und eine Notiz zeigt Bank, UUID, Betrag und Umgebung.

Montonio payment on hold: Die Bank hat die Zahlung noch nicht bestätigt (AUTHORIZED); die Bestellung wird zu Payment accepted, sobald Montonio PAID meldet. Eine Bestellung wird auch zurückgehalten, wenn Montonio einen anderen Betrag oder eine andere Währung als den Warenkorbbetrag meldet, wenn eine Sandbox-Zahlung im Live-Modus des Shops eingeht (es wird keine Zahlung erfasst, weil kein Geld eingegangen ist) oder wenn die Zahlung nach dem Abbruch der Bestellung eingeht. Die Notiz erklärt es. Prüfen Sie die Zahlung im Montonio Partner System und versenden Sie die Bestellung oder erstatten Sie die Zahlung.

Payment error: Die Bank hat eine autorisierte Zahlung abgelehnt, oder der Kunde hat sie nicht abgeschlossen. Nur die neueste Zahlung des Warenkorbs kann die Bestellung ändern.

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

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 fordert Sie auf, die zweite Zahlung im Montonio Partner System zu erstatten.

Montonio-Zahlungsblock

Die Bestellseite zeigt einen Block Montonio payment mit der Montonio-Bestell-UUID, der Umgebung (mit einem Abzeichen Sandbox für Testzahlungen), der Bank, dem Zahlungsstatus, dem bezahlten und erstatteten Betrag, dem Erstattungsverlauf und den Montonio notes der Bestellung.

Erstattungen

Geben Sie im Block 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 Frage Refund this amount through Montonio? This cannot be undone. Volle und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, Bestellungen zu bearbeiten; der Zugriff auf die Modulseiten ist nicht nötig. Erstattungen sind auf den von Montonio belasteten Betrag begrenzt. Nach einer Betragsabweichung können Sie also bis zu dem Betrag erstatten, den der Kunde tatsächlich gezahlt hat, nicht bis zum Bestellbetrag. Die Erstattung wird an die Umgebung gesendet, in der die Zahlung erfolgte (Sandbox oder Live), daher müssen die Schlüssel dieser Umgebung eingerichtet sein. Lehnt Montonio die Erstattung ab, zeigt der Block 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 volle Erstattung setzt die Bestellung auf Refunded. Eine teilweise Erstattung ä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, sagt die Notiz, dass das Geld nicht an den Kunden zurückgegeben wurde; prüfen Sie das im Montonio Partner System und korrigieren Sie die Erstattung in PrestaShop.

Das Modul erstellt keine Gutschriften. Die Standard-Erstattungsschaltflächen von PrestaShop auf der Bestellseite schicken kein Geld über Montonio zurück. Im Montonio Partner System vorgenommene Erstattungen werden den Notizen hinzugefügt, sobald Montonio sie meldet. Bestellstatus und Gutschriften werden nicht automatisch geändert. Aktualisieren Sie sie bei Bedarf manuell.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Montonio Payment ist der erste Block auf Modules > Module Manager > VibeFox Montonio Payment > Configure, oberhalb der Einstellungen. Geben 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 zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-payment-montonio und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Den Schlüssel können nur Mitarbeiter ändern, die das Recht Configure für das Modul haben. 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 einen Domain-Platz in Ihrem Konto freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Domain des Hauptshops, auch bei einer Multistore-Einrichtung. 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 in der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Die PrestaShop-Storefront 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 nicht in der Kasse testen. Eine Erinnerung erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

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

Fehlerbehebung

Montonio erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, 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) und die Warenkorb-Währung EUR oder PLN ist. Die Einstellungsseite zeigt eine Warnung, wenn Schlüssel fehlen oder die Shop-Währung nicht unterstützt wird. Prüfen Sie unter Payment > Preferences, ob das Modul für die Warenkorb-Währung, das Land des Kunden und die Kundengruppe erlaubt ist.

Die Zahlung war erfolgreich, aber es wurde keine Bestellung angelegt: Die Benachrichtigung hat Ihren Shop nicht erreicht. Prüfen Sie, ob der Shop über das Internet erreichbar ist und ob die Schlüssel in den Einstellungen zur Umgebung der Zahlung gehören. Die Bestellung wird auch angelegt, wenn der Kunde nach dem Bezahlen in den Shop zurückkehrt, wenn der Kunde auf Check again klickt und wenn der Kunde versucht, denselben Warenkorb erneut zu bezahlen.

Die Benachrichtigung antwortet Invalid token: Signatur, Ablauf oder Zugriffsschlüssel des Tokens stimmten nicht überein. Prüfen Sie, ob Zugriffsschlüssel und geheimer Schlüssel korrekt kopiert wurden und zur richtigen Umgebung gehören, und ob die Serveruhr stimmt. Ein Token, das mit dem Schlüssel der anderen Umgebung signiert wurde, wird ebenfalls abgelehnt.

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

Die Benachrichtigung antwortet 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 antwortet Temporarily unavailable: Der Warenkorb wurde im selben Moment von einer anderen Anfrage bestätigt, oder die Bestellung konnte nicht angelegt werden (zum Beispiel, weil das Modul deaktiviert ist). Montonio wiederholt die Benachrichtigung. Sehen Sie im Feld Log nach dem Grund.

Der Kunde sieht bei der Wahl von Montonio einen Fehler: Sehen Sie im Feld Log auf der Modulseite nach. 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; das Protokoll nennt den Grund.

Bestellung ist nach der Zahlung Montonio payment on hold: Lesen Sie die Notizen im Block Montonio payment (siehe Bestellstatus) und versenden Sie dann die Bestellung oder erstatten Sie die Zahlung.

Sandbox-Zahlungen bestätigen keine Live-Bestellung: Eine Sandbox-Zahlung schließt nie eine Bestellung ab, solange der Shop im Live-Modus ist; die Bestellung wird stattdessen zurückgehalten. 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- oder Live-Umgebung, und die Schlüssel dieser Umgebung sind nicht gesetzt. Geben Sie sie ein und versuchen Sie es erneut.

Für Entwickler bietet das Modul die Hooks actionWcpMontonioSupportedCurrencies, actionWcpMontonioOrderData und actionWcpMontonioLocale, um die unterstützten Währungen, die Zahlungsdaten und die Sprache der Montonio-Seite zu ändern.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Montonio Payment und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete data eingeschaltet, werden die Modul-Einstellungen und das Protokoll entfernt. Ist es aus, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die Datensätze der Montonio-Zahlungen und -Erstattungen sowie der Bestellstatus Montonio payment on hold bleiben immer erhalten, sodass vorher bezahlte Bestellungen nach einer Neuinstallation weiter erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Montonio ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist weder mit Montonio verbunden noch wird es von Montonio unterstützt.