VibeFox Moneris for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer mit der Erweiterung SimpleXML. Das Modul lässt sich auf älteren PHP-Versionen oder ohne SimpleXML nicht installieren.

Shop-Währung: CAD für ein kanadisches Moneris-Konto, USD für ein älteres Moneris-USA-Konto. Die Zahlungsart wird nur angezeigt, wenn die Warenkorbwährung 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. Falls Sie das nicht erfüllen können, verwenden Sie stattdessen eine gehostete Zahlungsseite.

Moneris-Konto: Sie benötigen die Store ID und den API-Token Ihres Moneris-Gateway-Stores aus dem Moneris Merchant Resource Center > Admin > Store Settings. Für Tests ist der öffentliche Moneris-Teststore standardmäßig eingetragen. Testzugangsdaten und Testkarten finden Sie im Moneris-Entwicklerportal.

VibeFox-Lizenzschlüssel: Erwerb über vibefox.net. Ein Schlüssel gilt für eine 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 Moneris 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. 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 aktiviert und verwendet den öffentlichen Teststore (store5 / yesguy für Kanada, monusqa002 / qatoken für die USA).

5. Wählen Sie Purchase oder Pre-Authorization und die Kartenlogos, aktivieren Sie dann Enable / Disable und klicken Sie auf Save.

6. Platzieren Sie eine Testbestellung mit einer Moneris-Testkarte und deaktivieren Sie danach Test mode.

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

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Moneris Gateway > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder zeigt die Seite Moneris gateway is in TEST MODE. No real charges will be made., solange der Testmodus aktiv ist. Im Live-Modus warnt sie, wenn die Live-Felder Moneris-Testzugangsdaten enthalten (die Zahlungsart wird dann auf der Kasse ausgeblendet) und wenn SSL für den Shop nicht aktiviert ist. Sie warnt außerdem, wenn die Standard-Shopwährung nicht die Währung des Moneris-Kontos ist; die Zahlungsart wird dann für andere Währungen auf der Kasse ausgeblendet.

Moneris

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

Title: der Name der Zahlungsart, den der Kunde sieht. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: Credit card (Moneris). Im Testmodus wird (Test Mode) an den Titel angehängt. Pflichtfeld.

Description: der Text, der auf der Kasse oberhalb der Kartenfelder angezeigt wird. Standard: Pay securely with your credit card.

Moneris-Konto

Ihre Store ID und Ihr API-Token finden Sie im Moneris Merchant Resource Center unter Admin > Store Settings. Testzugangsdaten und Testkarten stehen im Moneris-Entwicklerportal. Der Abschnitt verlinkt auf beide.

Land des Moneris-Kontos: kanadische Konten rechnen in CAD ab, US-Konten in USD. Die Zahlungsart wird nur angezeigt, wenn die Warenkorbwährung übereinstimmt. Standard: Canada (CAD).

Canada (CAD): ein kanadisches Moneris-Konto.

United States (USD, legacy Moneris USA accounts): ein Moneris-USA-Konto.

Test mode: verwendet das Moneris-QA-Gateway und die Testzugangsdaten; es werden keine echten Belastungen durchgeführt. Erfassungen, Stornierungen und Erstattungen werden immer an die Umgebung gesendet, in der die Zahlung erfolgt ist. Kunden sehen TEST MODE: use a Moneris test card, no real charges are made. oberhalb der Kartenfelder. Standard: an.

Live Store ID: die Produktions-Store-ID, z. B. monca01234.

Live API Token: der Produktions-API-Token.

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

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

Gespeicherte API-Token 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 tokens: Setzen Sie den Haken bei einem Token und klicken Sie auf Save, um ihn zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Zahlung

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

Purchase (charge immediately): die Karte wird bei der Bestellung belastet. Die Bestellung erhält den Status Payment accepted.

Pre-Authorization (capture later): die Mittel werden nur reserviert und die Bestellung erhält den Status Moneris payment authorized. Erfassen Sie sie mit Capture payment im Moneris-Block der Bestellung oder indem Sie die Bestellung auf einen bezahlten Status setzen (Zahlung akzeptiert, Versandt, Zugestellt). Die Stornierung der Bestellung gibt die Mittel frei.

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

Erweitert

Debug log: protokolliert API-Anfragen und -Antworten in logs/wc_mng_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. Kartennummer, CVV, Ablaufdatum und API-Token werden maskiert. Fehler werden immer protokolliert, auch bei deaktiviertem Debug log. 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 on uninstall: ist die Option aktiv, werden beim Deinstallieren des Moduls die Gateway-Einstellungen und das Protokoll entfernt. Die Moneris-Daten der Bestellungen (für Erstattungen nötig) und die Bestellstatus bleiben immer erhalten. Standard: aus.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsart (standardmäßig Credit card (Moneris)) und gibt Card number, Expiry (MM/YY) und Card code (CVC) im Kartenformular unter der Option ein. Alle drei Felder sind Pflichtfelder. Beim Absenden der Bestellung sendet Ihr Server die Karte für den Warenkorbbetrag an Moneris und erhält das Ergebnis sofort. Es gibt keine Weiterleitung und kein 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 wird nur aus einer genehmigten Antwort von Moneris erstellt. Der Kunde sieht danach die übliche Bestellbestätigungsseite. Bei Pre-Authorization wartet die Bestellung in Moneris payment authorized, bis Sie die Mittel erfassen. Hat Moneris einen anderen Betrag als den Warenkorbbetrag verarbeitet oder hat sich der Warenkorb während der Zahlung geändert, wird die Bestellung mit einer Notiz in Moneris payment on hold angelegt.

Wird die Karte abgelehnt, bleibt der Kunde auf der Kasse mit Your card was declined und dem Grund von Moneris und kann die Kartendaten prüfen oder eine andere Karte verwenden. Es wird keine Bestellung angelegt. Kann Moneris die Anfrage nicht verarbeiten (zum Beispiel bei falscher Store ID oder falschem 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. Falsche Kartendaten führen zu kurzen Meldungen wie Invalid card number. oder Invalid card expiry date., und es wird nichts an Moneris gesendet.

Ein zweiter Klick oder ein zweiter Browser-Tab, 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. Ein Warenkorb, der bereits eine Bestellung hat, wird nie erneut belastet; der Kunde wird zur bestehenden Bestellung geleitet.

Antwortet Moneris nicht (Netzwerkfehler oder Zeitüberschreitung), sendet das Modul einen Status Check mit derselben Moneris-Bestellnummer an Moneris, um herauszufinden, ob die Transaktion durchgegangen ist. Hat Moneris keine solche Transaktion, kann der Kunde erneut zahlen. Bleibt auch der Status Check ohne Antwort, wird die Bestellung mit der Moneris-Bestellnummer in Moneris payment on hold angelegt, und der Kunde wird nicht zu einer zweiten Zahlung aufgefordert.

Das Modul unterstützt keine gespeicherten Karten oder 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 Preise in mehreren Währungen.

Bestellungen und Erstattungen

Bestellstatus

No order yet: die Karte wurde abgelehnt oder nicht verarbeitet. Es existieren nur der Warenkorb und der Versuch im Protokoll. Der Kunde kann erneut zahlen.

Payment accepted: der Kauf wurde genehmigt. Die Zahlung wird mit der Moneris-Transaktionsnummer als Transaktions-ID erfasst.

Moneris payment authorized: eine Vorautorisierung wurde genehmigt und wartet auf die Erfassung. Eine Zahlung ist noch nicht erfasst.

Moneris payment on hold: der verarbeitete Betrag wich vom Warenkorbbetrag ab, der Warenkorb änderte sich während der Zahlung, Moneris bestätigte das Ergebnis nicht oder PrestaShop setzte einen bezahlten Status, obwohl die Erfassung fehlgeschlagen war. Die Notizen erklären es. Bei einem Kauf mit abweichendem Betrag wird die Zahlung mit dem von Moneris verarbeiteten Betrag erfasst.

Canceled: bei einer vorautorisierten Bestellung gibt die Stornierung die reservierten Mittel frei (Void).

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

Moneris-Zahlungsblock

Die Bestellseite zeigt einen Block Moneris payment mit der Moneris-Bestellnummer, Land und Modus des Kontos, einem Test mode-Badge bei Testzahlungen, der Trans ID (und der Trans ID der Vorautorisierung nach einer Erfassung), dem Transaktionstyp und seinem Status (nicht erfasst, erfasst oder freigegeben), Beleg und Kartentyp, dem verarbeiteten Betrag, dem Bestellbetrag und dem erstatteten Betrag, dem Erstattungsverlauf und den Moneris notes der Bestellung. Bei einer nicht bestätigten Zahlung fordert Sie der Block auf, die Moneris-Bestellnummer im Merchant Resource Center nachzuschlagen. Alle Aktionen im Block erfordern nur die Berechtigung zum Bearbeiten von Bestellungen.

Erfassung und Stornierung

Um eine Vorautorisierung zu erfassen, klicken Sie im Block auf Capture payment und bestätigen Sie, oder ändern Sie den Bestellstatus auf einen bezahlten Status wie Zahlung akzeptiert, Versandt oder Zugestellt. Der Bestellbetrag abzüglich Erstattungen wird erfasst; er darf nicht höher sein als der autorisierte Betrag. Nach einer Erfassung über die Schaltfläche wird die Bestellung auf Payment accepted gesetzt; die Zahlung wird mit der Trans ID der Erfassung gespeichert. Lehnt Moneris die Erfassung ab, bleibt der Status unverändert, es wird keine E-Mail zum bezahlten Status gesendet, und eine Notiz erklärt es: Status not changed: the Moneris pre-authorization could not be captured mit dem Grund. Moneris-Vorautorisierungen verfallen nach wenigen Tagen, erfassen Sie sie daher rechtzeitig.

Um die Mittel freizugeben, klicken Sie auf Void pre-authorization (cancel order) oder setzen Sie die Bestellung auf Storniert. Wird die Bestellung auf Erstattet gesetzt, wird eine offene Vorautorisierung ebenfalls freigegeben. Schlägt die Freigabe fehl, weist Sie eine Notiz darauf hin, sie im Merchant Resource Center freizugeben.

Erstattungen

Geben Sie im Block Moneris payment den Betrag ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Grund, und klicken Sie auf Refund via Moneris. Bestätigen Sie die Abfrage Refund this amount through Moneris? This cannot be undone. Volle und teilweise Erstattungen werden unterstützt. Erstattungen sind auf den Betrag begrenzt, den Moneris tatsächlich belastet hat; nach einer Betragsabweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde bezahlt hat, nicht bis zum Bestellbetrag. Eine Vorautorisierung kann erst nach der Erfassung erstattet werden; davor stornieren Sie die Bestellung, um die Mittel freizugeben. Die Erstattung wird an die Umgebung und das Konto gesendet, in dem die Zahlung erfolgt ist, daher müssen deren Zugangsdaten weiterhin eingetragen sein. Akzeptiert Moneris die Erstattung nicht, zeigt der Block Refund failed mit dem Grund, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen mit der Moneris-Trans-ID hinzugefügt. Eine volle Erstattung setzt die Bestellung auf Refunded; eine teilweise Erstattung ändert den Status nicht.

Das Modul erstellt keine Gutschriften. Die Standard-Erstattungsschaltflächen von PrestaShop auf der Bestellseite überweisen kein Geld über Moneris zurück.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Moneris Gateway ist der erste Block auf der Seite Modules > Module Manager > VibeFox Moneris 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-moneris 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 Moneris Kunden auf der Kasse 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 auf der Kasse nicht testen. Ein Hinweis erscheint unter Modules > Module Manager auf dem Reiter Alerts. Bestehende Bestellungen sind nicht betroffen: Erfassungen, Stornierungen und Erstattungen früherer Zahlungen funktionieren weiterhin.

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

Moneris erscheint nicht auf der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist und der aktuelle Modus Store ID und API-Token hat. Im Live-Modus müssen die Live-Felder Ihre Produktionszugangsdaten enthalten, nicht Moneris-Testzugangsdaten. Prüfen Sie, ob die Warenkorbwährung die Kontowährung ist: CAD für Kanada, USD für ein US-Konto. Prüfen Sie unter Payment > Preferences, ob das Modul für diese Währung, das Land des Kunden und die Kundengruppe erlaubt ist.

Die Zahlung ist durchgegangen, aber die Bestellung ist Moneris payment on hold: Das Modul hat kein Webhook; das Ergebnis kommt nur aus der Antwort von Moneris. Lesen Sie die Moneris notes im Block. Hat Moneris das Ergebnis nicht bestätigt, hat Moneris nicht geantwortet und auch der Status Check ist fehlgeschlagen. Suchen Sie die Moneris-Bestellnummer im Merchant Resource Center: Ist die Transaktion dort vorhanden, versenden Sie die Bestellung (und erstatten Sie sie dort bei Bedarf); ist sie nicht vorhanden, stornieren Sie die Bestellung oder bitten Sie den Kunden, erneut zu zahlen. Bei abweichendem Betrag prüfen Sie die Bestellung und wickeln Sie sie ab oder erstatten Sie die Zahlung.

Der Kunde sieht Payment gateway is misconfigured. Please contact the store administrator.: Die Zugangsdaten des aktuellen Modus fehlen, oder der Live-Modus ist aktiv und die Live-Felder enthalten Moneris-Testzugangsdaten. Geben Sie Ihre Produktions-Store-ID und Ihren API-Token ein.

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

Der Kunde sieht beim Bezahlen einen Fehler: Sehen Sie sich das Feld Log auf der Modulseite an. Fehler werden immer geschrieben; aktivieren Sie Debug log, um die vollständigen Anfragen und Antworten zu sehen.

Erfassung schlägt fehl: Die Bestellung hat keine auf Erfassung wartende Vorautorisierung, der Bestellbetrag ist null, oder der Betrag liegt über dem autorisierten Betrag. Moneris-Vorautorisierungen verfallen außerdem nach einigen Tagen.

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

Kartentest-Angriffe: Direkte Kartenformulare sind ein Ziel für Kartentest-Angriffe. Nutzen Sie die eFraud- oder Velocity-Regeln Ihres Moneris-Kontos sowie ein CAPTCHA- oder Rate-Limiting-Modul für Ihren Shop.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Moneris Gateway und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete data on uninstall aktiv, werden die Gateway-Einstellungen und das Protokoll entfernt. Ist die Option aus, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die Moneris-Transaktionen und -Erstattungen sowie die Bestellstatus Moneris payment authorized und Moneris payment on hold bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation weiterhin erfasst oder erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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