VibeFox Moneris 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: CAD für ein kanadisches Moneris-Konto, USD für ein älteres Moneris-USA-Konto. Die Zahlungsart wird nur angezeigt, wenn die Währung der Kasse der Kontowährung entspricht.

HTTPS und PCI DSS: Kartennummern werden auf Ihrer Kassenseite eingegeben und laufen über Ihren Server. Live-Zahlungen erfordern HTTPS und die Einhaltung von PCI DSS SAQ D. Können Sie das nicht erfüllen, verwenden Sie stattdessen eine gehostete Zahlungsseite.

Moneris-Konto: Sie benötigen die Store ID und das API Token Ihres Moneris-Gateway-Shops aus dem Moneris Merchant Resource Center > Admin > Store Settings. Zum Testen ist der öffentliche Moneris-Testshop standardmäßig eingetragen. Testzugangsdaten und Testkarten finden Sie im Moneris-Developer-Portal.

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 OpenCart-3-Paket wcp_moneris_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_moneris_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_moneris_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 Moneris 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. Wählen Sie das Land des Kontos und geben Sie die Live Store ID und das Live API Token ein. Der Testmodus ist standardmäßig eingeschaltet und verwendet den öffentlichen Testshop (store5 / yesguy für Kanada, monusqa002 / qatoken für die USA).

5. Wählen Sie den Transaktionstyp und die Kartenlogos aus, schalten Sie dann Enable / Disable ein und klicken Sie auf Save.

6. Legen Sie eine Testbestellung mit einer Moneris-Testkarte an und schalten Sie danach Test mode aus.

OpenCart 4

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

2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. 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 Moneris Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und danach auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die Einstellungen wie in den Schritten 3 bis 6 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

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 Moneris Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite Moneris gateway is in TEST MODE. No real charges will be made., solange der Testmodus eingeschaltet ist. Im Live-Modus warnt sie Sie, wenn die Live-Felder Moneris-Testzugangsdaten enthalten (die Zahlungsart wird dann an der Kasse ausgeblendet), und wenn SSL für den Shop nicht aktiviert ist (in OpenCart 4, wenn die Shop-Adresse mit http:// beginnt). Außerdem warnt sie, wenn die Zahlungsart aktiviert ist, aber die Store ID oder das API Token des aktuellen Modus leer ist, und wenn die Standardwährung des Shops nicht die Währung des Moneris-Kontos ist; 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. Ist ein Wert falsch, zeigt die Seite den Fehler an und nichts wird gespeichert.

Moneris

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

Title: der Titel der Zahlungsart, der dem Kunden angezeigt wird. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Kreditkarte (Moneris). Im Testmodus wird dem Titel (Test Mode) hinzugefügt. Pflichtfeld.

Description: der Text, der im Schritt Confirm Order über den Kartenfeldern angezeigt wird. Standard: Pay securely with your credit card.

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

Geo Zone: bietet das Kartenformular 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, bevor die Zahlungsart angeboten wird. Lassen Sie das Feld leer, um sie bei jedem Betrag anzubieten.

Moneris-Konto

Ihre Store ID und Ihr API Token finden Sie im Moneris Merchant Resource Center unter Admin > Store Settings. Testzugangsdaten und Testkarten finden Sie im Moneris-Developer-Portal. Dieser Abschnitt verlinkt beide.

Moneris account country: Kanadische Konten rechnen in CAD ab, US-Konten in USD. Die Zahlungsart wird nur angezeigt, wenn die Bestellwährung übereinstimmt. Standard: Kanada (CAD).

Test mode: verwendet das Moneris-QA-Gateway und die Testzugangsdaten; es werden keine echten Belastungen vorgenommen. Erstattungen, Erfassungen und Stornierungen werden immer an die Umgebung gesendet, in der die Zahlung getätigt wurde. Kunden sehen über den Kartenfeldern TEST MODE: use a Moneris test card, no real charges are made. Standard: an.

Live Store ID: die Store ID für den Produktivbetrieb, zum Beispiel monca01234.

Live API Token: das API Token für den Produktivbetrieb.

Test Store ID: der öffentliche Moneris-Testshop: store5 (Kanada) oder monusqa002 (USA). Standard: store5.

Test API Token: das öffentliche Test-Token: yesguy (Kanada) oder qatoken (USA). Standard: yesguy.

Gespeicherte API Tokens 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 ein gespeichertes Token zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved token on save und klicken Sie auf Save.

Zahlung

Transaction type: wie die Karte belastet wird. Standard: Purchase.

Card logos: die Kartenmarken, die mit der Zahlungsart an der Kasse angezeigt werden: Visa, Mastercard, Discover, American Express, JCB. Welche Marken akzeptiert werden, hängt von Ihrem Moneris-Konto ab. Standard: Visa und Mastercard.

Bestellungen

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

Order Status After Payment: Die Karte wurde belastet (ein Kauf oder die Erfassung einer Vorautorisierung). Standard: In Bearbeitung.

Authorized Status: eine Vorautorisierung: Die Mittel sind nur reserviert, noch nicht belastet. Erfassen Sie sie im Bestell-Tab oder durch Setzen eines bezahlten Status. Standard: Ausstehend.

On Hold (Review) Status: Eine manuelle Prüfung ist erforderlich: Der von Moneris verarbeitete Betrag weicht von der Bestellung ab, oder Moneris hat nicht geantwortet und die Statusprüfung ist ebenfalls fehlgeschlagen (die Karte könnte belastet worden sein). Eine Notiz erklärt den Grund. Standard: Ausstehend, da OpenCart keinen Status „On hold“ hat. Eigene Status können Sie unter System > Localisation > Order Statuses anlegen und hier sowie bei Authorized Status auswählen.

Canceled Status: wird durch Void pre-authorization (cancel order) im Bestell-Tab gesetzt. Wird eine Bestellung auf diesen Status gesetzt, wird eine nicht erfasste Vorautorisierung freigegeben (storniert). Standard: Storniert.

Refunded Status: wird gesetzt, nachdem die Zahlung im Bestell-Tab vollständig erstattet wurde. Wird eine Bestellung auf diesen Status gesetzt, wird auch eine nicht erfasste Vorautorisierung freigegeben. Standard: Erstattet.

Erweitert

Debug log: protokolliert API-Anfragen und -Antworten in wc_mng_debug.log.php im Protokollordner von OpenCart (storage/logs). Die Datei kann nicht über den Browser geöffnet werden. Kartennummer, CVV, Ablaufdatum und API Token werden maskiert. Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. 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 beim Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll entfernt. Die Moneris-Daten der Bestellungen (für Erfassungen und Erstattungen erforderlich) bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. API Tokens werden nicht exportiert.

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit card (Moneris)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung, die Kartenlogos und die Felder Card number, Expiry (MM/YY) und Card code (CVC). Alle drei Felder sind Pflichtfelder. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options; danach erscheinen die Kartenfelder im Block zur Bestellbestätigung unten auf der Kassenseite, oberhalb der Schaltfläche Confirm Order. Wenn der Kunde auf Confirm Order klickt, sendet Ihr Server die Karte für den Bestellbetrag an Moneris und erhält das Ergebnis sofort. Es gibt keine Weiterleitung und keinen Webhook. Die Kartendaten werden nur für diese eine Anfrage verwendet; sie werden nie gespeichert, und das Protokoll zeigt nur die letzten vier Ziffern.

Die Bestellung erhält ihren Status nur durch eine genehmigte Antwort von Moneris, auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Der Warenkorb wird geleert, und der Kunde sieht die OpenCart-Erfolgsseite der Bestellung. Bei einer Vorautorisierung wartet die Bestellung im Authorized Status, bis Sie die Mittel erfassen. Hat Moneris einen anderen Betrag verarbeitet als den Bestellbetrag, erhält die Bestellung den Prüfstatus mit einer Notiz.

Wird die Karte abgelehnt, bleibt der Kunde im Schritt Confirm Order mit Your card was declined und dem Grund von Moneris und kann die Kartendaten prüfen oder eine andere Karte verwenden. Die Bestellung behält keinen Status; der Ablehnungsgrund wird außerdem im Protokoll festgehalten. Konnte Moneris die Anfrage nicht verarbeiten (zum Beispiel eine falsche Store ID oder ein falsches API Token), sieht der Kunde The payment could not be processed. Please try again or use another payment method. Der Grund wird im Protokoll festgehalten. Fehlerhafte Kartenfelder führen zu kurzen Meldungen wie Please enter your card details., Invalid card number. oder Invalid card expiry date., und es wird nichts an Moneris gesendet.

Ein zweiter Klick, während eine Zahlung verarbeitet wird, zeigt A payment for this order is already being processed. Please wait a moment and check your order status before trying again. 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, und nach einer abgelehnten Karte zahlt der Kunde dieselbe Bestellung. In beiden Fällen behandelt die Erweiterung alle Bestellungen eines Warenkorbs als eine Zahlung: Ein Warenkorb, der bereits bezahlt wurde oder dessen Ergebnis unbekannt ist, wird nie erneut belastet, und der Kunde wird zur Erfolgsseite geleitet. OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Hat diese Bestellung bereits einen Status und enthält der Warenkorb wieder Produkte (zum Beispiel wenn die Zahlung durchgegangen ist, die Erfolgsseite aber nicht angezeigt wurde und der Kunde Produkte hinzugefügt hat), oder wurde die Bestellung inzwischen storniert, erstattet oder die Vorautorisierung freigegeben, wird der Kunde auf der Kassenseite im Schritt Confirm Order zurückgeleitet, und das nächste Confirm Order zahlt eine neue Bestellung. Oberhalb der Kassenseite sieht der Kunde This order was cancelled or refunded by the store, so it cannot be paid again. Please check your cart and confirm the new order., wenn die Bestellung geschlossen wurde, oder This order has already been paid, and your cart now holds a new purchase. Please check your cart and confirm the new order., wenn sie für einen früheren Warenkorb bezahlt wurde.

Antwortet Moneris nicht (Netzwerkfehler oder Zeitüberschreitung), sendet die Erweiterung eine Statusprüfung mit derselben Moneris-Bestell-ID an Moneris, um festzustellen, ob die Transaktion durchgegangen ist. Hat Moneris keine solche Transaktion, kann der Kunde erneut bezahlen. Liefert auch die Statusprüfung keine Antwort, erhält die Bestellung den Prüfstatus mit einer Notiz, die die Moneris-Bestell-ID nennt, und der Kunde wird nicht aufgefordert, ein zweites Mal zu bezahlen. Ist die Zahlung durchgegangen, der Bestellstatus konnte aber nicht gesetzt werden, sieht der Kunde Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again.

Die Erweiterung unterstützt keine gespeicherten Karten oder den Moneris Vault, keine Abonnements, kein Apple Pay, Google Pay oder Interac Online, kein Moneris Checkout oder Hosted Tokenization, kein 3-D Secure, AVS oder Kount und keine Preisgestaltung in mehreren Währungen.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Die Karte wurde abgelehnt oder nicht verarbeitet. Der Kunde kann erneut bezahlen. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (Standard In Bearbeitung): Der Kauf wurde genehmigt oder eine Vorautorisierung wurde erfasst. Eine Notiz zeigt den Betrag, die Moneris Trans ID und den Beleg.

Authorized Status (Standard Ausstehend): Eine Vorautorisierung wurde genehmigt und wartet auf die Erfassung.

On Hold (Review) Status (Standard Ausstehend): Der verarbeitete Betrag wich von der Bestellsumme ab, oder Moneris hat das Ergebnis nicht bestätigt. Die Notizen erklären dies.

Canceled Status (Standard Storniert): Bei einer vorautorisierten Bestellung wurden die reservierten Mittel freigegeben (storniert).

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

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

Registerkarte VibeFox Moneris Gateway

Öffnen Sie unter Sales > Orders eine mit Moneris bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Moneris Gateway die Trans ID (und nach einer Erfassung die Trans ID der Vorautorisierung), die Moneris order ID, den Receipt, den Transaction type und dessen Status (nicht erfasst, erfasst oder freigegeben), das Account / environment mit der Kennzeichnung Test mode bei Testzahlungen, die Card mit dem Autorisierungscode, die Beträge Authorized / charged / refunded, die Schaltflächen für Erfassung, Stornierung und Erstattung, den Erstattungsverlauf und die Moneris notes der Bestellung. Bei einer nicht bestätigten Zahlung bittet Sie die Registerkarte, die Moneris-Bestell-ID im Merchant Resource Center nachzuschlagen. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben; Erfassung, Stornierung und Erstattung erfordern das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups).

Erfassung und Stornierung

Um eine Vorautorisierung zu erfassen, klicken Sie auf der Registerkarte auf Capture payment und bestätigen Sie Capture the pre-authorized amount through Moneris?, oder ändern Sie den Bestellstatus über Add History auf einen bezahlten Status wie Order Status After Payment oder einen anderen OpenCart-Status für Bearbeitung oder Abschluss. Erfasst wird die Bestellsumme abzüglich Erstattungen; sie darf nicht höher als der autorisierte Betrag sein. Nach einer Erfassung über die Schaltfläche erhält die Bestellung Order Status After Payment. Lehnt Moneris die Erfassung ab, bleibt der Status unverändert, es wird keine E-Mail gesendet, Add History zeigt statt einer Erfolgsmeldung den Grund an, und eine Notiz erklärt es: Moneris: status not changed — the pre-authorization could not be captured mit dem Grund. Vorautorisierungen von Moneris laufen nach einigen Tagen ab, erfassen Sie sie daher rechtzeitig.

Um die Mittel freizugeben, klicken Sie auf Void pre-authorization (cancel order) und bestätigen Sie, oder setzen Sie die Bestellung auf den Canceled Status. Das Setzen der Bestellung auf den Refunded Status gibt ebenfalls eine offene Vorautorisierung frei. Schlägt die Freigabe fehl, bittet Sie eine Notiz, sie im Merchant Resource Center freizugeben.

Diese Statusänderungen funktionieren auch, wenn die Erweiterung ausgeschaltet (aber installiert) ist; zuvor erstellte Vorautorisierungen können daher weiterhin erfasst und freigegeben werden.

Erstattungen

Geben Sie auf der Registerkarte VibeFox Moneris Gateway den Amount ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Moneris. Bestätigen Sie die Abfrage Refund this amount through Moneris? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Erstattungen sind auf den Betrag beschränkt, den Moneris tatsächlich belastet hat; nach einer Betragsabweichung können Sie daher bis zu dem erstatten, was der Kunde bezahlt hat, nicht bis zur Bestellsumme. Eine Vorautorisierung kann nur nach ihrer Erfassung erstattet werden; davor stornieren Sie sie, um die Mittel freizugeben. Die Erstattung wird an die Umgebung und das Konto gesendet, in dem die Zahlung getätigt wurde, daher müssen die Zugangsdaten dieses Modus weiterhin eingetragen sein. Akzeptiert Moneris die Erstattung nicht, zeigt die Registerkarte Refund failed mit dem Grund an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Moneris Trans ID dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf den Refunded Status; eine teilweise Erstattung ändert den Status nicht. Erfassung, Stornierung und Erstattung ändern den Bestellstatus direkt, ohne den Kunden zu benachrichtigen und ohne Produkte in den Lagerbestand zurückzubuchen, wie bei einer manuellen Statusänderung.

Produktrücksendungen unter Sales > Returns senden kein Geld über Moneris zurück.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich License — VibeFox Moneris Gateway ist der erste Bereich unter Extensions > Extensions > Payments > VibeFox Moneris 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-moneris 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 Moneris 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. Bei OpenCart 4 steht diese Vorschau nicht zur Verfügung: Der Shop sieht die Admin-Anmeldung nicht, daher ist ohne aktiven Schlüssel die Zahlungsart 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: Erfassungen, Stornierungen und Erstattungen früherer Zahlungen funktionieren weiterhin.

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

Moneris erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist und der aktuelle Modus eine Store ID und ein API Token hat. Im Live-Modus müssen die Live-Felder Ihre Produktivzugangsdaten enthalten, nicht Moneris-Testzugangsdaten. Prüfen Sie, ob die Währung der Kasse der Kontowährung entspricht (CAD für Kanada, USD für ein US-Konto), ob die Rechnungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist durchgegangen, aber die Bestellung ist im Prüfstatus: Die Erweiterung hat keinen Webhook; das Ergebnis stammt nur aus der Antwort von Moneris. Lesen Sie die Moneris notes auf der Registerkarte. Hat Moneris das Ergebnis nicht bestätigt, hat Moneris nicht geantwortet und auch die Statusprüfung ist fehlgeschlagen. Suchen Sie die Moneris-Bestell-ID im Merchant Resource Center: Ist die Transaktion dort vorhanden, versenden Sie die Bestellung (und erstatten Sie sie bei Bedarf dort); ist sie nicht vorhanden, stornieren Sie die Bestellung oder bitten Sie den Kunden, erneut zu bezahlen. Wich der Betrag ab, prüfen Sie die Bestellung und erfüllen Sie sie oder erstatten Sie die Zahlung.

Der Kunde sieht This payment method is not available. Please reload the checkout page.: Die Kassensitzung passt nicht mehr zur Bestellung, die Zahlungsart wurde inzwischen ausgeschaltet, oder die Zugangsdaten des aktuellen Modus fehlen (oder der Live-Modus verwendet Moneris-Testzugangsdaten).

Der Kunde sieht This payment method does not support the order currency.: Die Bestellwährung ist nicht die Währung des Moneris-Kontos.

Der Kunde sieht beim Bezahlen einen Fehler: Sehen Sie im Feld Log auf der Seite der Erweiterung nach. Fehler werden immer protokolliert; schalten Sie Debug log ein, um die vollständigen Anfragen und Antworten zu sehen.

Erfassung schlägt fehl: Die Bestellung hat keine auf Erfassung wartende Vorautorisierung, die Bestellsumme ist null, oder der Betrag ist höher als der autorisierte Betrag. Vorautorisierungen von Moneris laufen außerdem nach einigen Tagen ab.

Erstattung, Erfassung oder Stornierung schlägt mit einer Meldung zu Modus oder Konto fehl: Die Zahlung wurde im Test- oder Live-Modus getätigt und die Zugangsdaten dieses Modus sind nicht eingetragen, oder die Zahlung wurde mit einem Moneris-Konto des anderen Landes getätigt. Tragen Sie die Zugangsdaten ein oder verarbeiten Sie die Zahlung im Merchant Resource Center.

Kartenprüfungs-Angriffe: Direkte Kartenformulare sind ein Ziel für Kartenprüfungen. Nutzen Sie die eFraud- oder Geschwindigkeitsregeln in Ihrem Moneris-Konto sowie eine CAPTCHA- oder Ratenbegrenzungs-Erweiterung für Ihren Shop.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Moneris 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 die OpenCart-Ereignisse der Erweiterung werden entfernt, sodass Statusänderungen keine Vorautorisierungen mehr erfassen oder freigeben. Ist Delete data on uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Land des Kontos, Testmodus, Store IDs und API Tokens, Transaktionstyp, Kartenlogos, Protokollierung) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Moneris-Transaktionen und Erstattungen bleiben immer erhalten, sodass bereits bezahlte Bestellungen nach einer Neuinstallation weiterhin erfasst oder erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Um auf OpenCart 4 auch die Dateien der Erweiterung zu entfernen, gehen Sie nach der Deinstallation zu Extensions > Installer und klicken Sie in der Liste der installierten Erweiterungen neben VibeFox Moneris Gateway auf Uninstall (die orange −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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