DE
EUR
Zurück

VibeFox Moneris for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

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

PHP: 8.0 oder neuer.

Shop-Währung: CAD für ein kanadisches Moneris-Konto, USD für ein älteres Moneris-USA-Konto. Das Gateway wird nur angezeigt, wenn die Bestellwährung zum Konto passt.

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-Shops aus dem Moneris Merchant Resource Center > Admin > Store Settings. Zum Testen ist der öffentliche Moneris-Teststore standardmäßig eingetragen. Testzugangsdaten und Testkarten finden Sie im Moneris-Entwicklerportal.

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_moneris_gateway per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Moneris > 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. Wählen Sie das Land des Kontos und tragen Sie die Live Store ID und das Live API Token ein. Der Testmodus ist standardmäßig aktiv und verwendet den öffentlichen Teststore (store5 / yesguy für Kanada, monusqa002 / qatoken für die USA).

6. Wählen Sie Purchase oder Pre-Authorization und die Kartenlogos, und aktivieren Sie anschließend Enable / Disable.

7. Führen Sie eine Testbestellung mit einer Moneris-Testkarte durch und deaktivieren Sie danach Test mode.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Moneris. Über den Feldern zeigt die Seite Moneris gateway is in TEST MODE. No real charges will be made. an, solange der Testmodus aktiv ist. Im Live-Modus warnt sie, wenn die Live-Felder Moneris-Testzugangsdaten enthalten (das Gateway wird dann an der Kasse ausgeblendet), und wenn die Website kein HTTPS verwendet. Außerdem warnt sie, wenn die Shop-Währung nicht der Währung des Moneris-Kontos entspricht; das Gateway wird dann an der Kasse ausgeblendet.

Allgemein

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

Title: der Name der Zahlungsart, den der Kunde sieht. Standard: Credit card (Moneris). Im Testmodus wird an der Kasse (Test Mode) an den Titel angehängt.

Description: der Text, der an der Kasse über den Kartenfeldern 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 Bereich enthält Links zu beiden.

Moneris account country: Kanadische Konten rechnen in CAD ab, US-Konten in USD. Das Gateway wird nur angezeigt, wenn die Bestellwährung passt. Standard: Canada (CAD).

Canada (CAD): ein Moneris-Konto für Kanada.
United States (USD, legacy Moneris USA accounts): ein Moneris-USA-Konto.

Test mode: Enable test mode (Moneris QA gateway, test credentials, no real charges). Erstattungen, Erfassungen und Stornierungen gehen immer an die Umgebung, in der die Zahlung erfolgte. Kunden sehen über den Kartenfeldern TEST MODE: use a Moneris test card, no real charges are made.. Standard: aktiv.

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

Live API Token: der API-Token für den Produktivbetrieb.

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.

Zahlung

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

Purchase (charge immediately): die Karte wird bei Bestellung sofort belastet.
Pre-Authorization (capture later): die Mittel werden nur reserviert, und die Bestellung wird auf Wartend gesetzt. Erfassen Sie sie, indem Sie die Bestellung auf In Bearbeitung oder Abgeschlossen setzen oder die Bestellaktion Capture Moneris pre-authorization verwenden. Das Stornieren der Bestellung gibt sie frei.

Card logos: die Kartenmarken-Logos, die neben dem Titel der Zahlungsart angezeigt werden: Visa, Mastercard, Discover, American Express, JCB. Welche Marken akzeptiert werden, hängt von Ihrem Moneris-Konto ab. Standard: Visa and Mastercard.

Erweitert

Debug log: Log API requests and responses (card number, CVV, expiry and API token are masked). Fehler werden immer protokolliert. Das Protokoll finden Sie unter WooCommerce > Status > Logs, Quelle wcp_moneris_gateway. Standard: aus.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Credit card (Moneris)) und gibt Kartennummer, Ablaufdatum und Sicherheitscode im WooCommerce-Kartenformular Ihrer Kassenseite ein. Wenn die Bestellung aufgegeben wird, sendet Ihr Server die Karte für den Bestellbetrag an Moneris und erhält das Ergebnis sofort. Es gibt keine Weiterleitung und kein Webhook. Der Sicherheitscode (CVD) wird immer übermittelt, daher gelten die eFraud-Regeln Ihres Moneris-Shops weiterhin.

Eine genehmigte Zahlung wird nur dann als bezahlt markiert, wenn Moneris die Transaktion als abgeschlossen meldet und der verarbeitete Betrag dem Bestellbetrag entspricht. Anschließend gelangt der Kunde zur Bestellbestätigungsseite. Bei Pre-Authorization bleibt die Bestellung auf Wartend, bis Sie die Mittel erfassen.

Wird die Karte abgelehnt, sieht der Kunde Your card was declined mit dem Grund von Moneris und kann die Kartendaten prüfen oder eine andere Karte verwenden. Kann Moneris die Anfrage nicht verarbeiten (zum Beispiel wegen einer falschen Store ID oder eines falschen API-Tokens), sieht der Kunde The payment could not be processed. Please try again or use another payment method. Der Grund wird den Bestellnotizen und dem Protokoll hinzugefügt. Ein zweiter Klick während einer laufenden Zahlung zeigt A payment for this order is already being processed. Please wait a moment and check your order status before trying again. Eine bezahlte oder vorautorisierte Bestellung wird nie erneut belastet.

Antwortet Moneris nicht (Netzwerkfehler oder Zeitüberschreitung), sendet das Plugin eine Status Check an Moneris, um festzustellen, ob die Transaktion durchgegangen ist. Ist auch das nicht möglich, wird die Bestellung mit der Moneris-Bestellnummer auf Wartend gesetzt, und der Kunde wird nicht aufgefordert, ein zweites Mal zu zahlen.

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.

Das Plugin unterstützt keine gespeicherten Karten oder Moneris Vault, keine WooCommerce Subscriptions, 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

Zahlung ausstehend: die Bestellung wurde angelegt, die Karte wurde aber noch nicht belastet, zum Beispiel nach einem abgelehnten Versuch. Die Bestellnotiz zeigt den Moneris-Code und die Meldung. Der Kunde kann erneut zahlen.

In Bearbeitung: der Kauf wurde genehmigt. Bestellungen mit ausschließlich virtuellen, herunterladbaren Produkten werden auf Abgeschlossen gesetzt, dem WooCommerce-Standard. Die Bestellnotiz zeigt den Betrag, die Moneris-Transaktions-ID und den Beleg. Die Transaktions-ID ist die Moneris-Transaktionsnummer.

Wartend: eine Vorautorisierung wurde genehmigt und wartet auf Erfassung, der verarbeitete Betrag wich vom Bestellbetrag ab, oder Moneris hat das Ergebnis nicht bestätigt. Die Bestellnotiz erklärt es.

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

Erfassung und Stornierung

Um eine Vorautorisierung zu erfassen, setzen Sie den Bestellstatus auf In Bearbeitung oder Abgeschlossen oder wählen Sie in den Bestellaktionen Capture Moneris pre-authorization. Erfasst wird der aktuelle Bestellbetrag abzüglich Erstattungen; er darf den autorisierten Betrag nicht überschreiten. Lehnt Moneris die Erfassung ab, wird der Status mit einer Notiz wieder auf Wartend gesetzt, und es wird keine Verarbeitungs- oder Abschluss-E-Mail gesendet. Moneris-Vorautorisierungen verfallen nach einigen Tagen, erfassen Sie sie daher rechtzeitig.

Um die Mittel freizugeben, stornieren Sie die Bestellung oder wählen Sie in den Bestellaktionen Void Moneris pre-authorization (cancel order). Das Setzen der Bestellung auf Erstattet gibt ebenfalls eine offene Vorautorisierung frei. Schlägt die Freigabe fehl, weist eine Notiz Sie darauf hin, sie im Merchant Resource Center freizugeben.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Credit card (Moneris) (die Schaltfläche zeigt Ihren Title). Volle und teilweise Erstattungen werden unterstützt. Eine Vorautorisierung kann erst nach der Erfassung erstattet werden; davor stornieren Sie die Bestellung, um die Mittel freizugeben. Die Erstattung geht an die Umgebung und das Konto, in denen die Zahlung erfolgte; die Zugangsdaten dieses Modus müssen daher eingetragen sein. Akzeptiert Moneris die Erstattung nicht, zeigt WooCommerce Refund failed mit dem Grund an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Moneris-Transaktions-ID in den Bestellnotizen vermerkt.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Moneris. 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 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. 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: Erfassungen, Stornierungen und Erstattungen funktionieren weiterhin.

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

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 einen API-Token hat. Im Live-Modus müssen die Live-Felder Ihre Produktivzugangsdaten enthalten, keine Moneris-Testzugangsdaten. Prüfen Sie, ob die Shop-Währung (bzw. die Bestellwährung auf der Seite Pay for order) die Kontowährung ist: CAD für Kanada, USD für ein US-Konto. Die Einstellungsseite zeigt eine Warnung, wenn die Währung nicht passt.

Die Zahlung ist durchgegangen, die Bestellung bleibt aber auf Zahlung ausstehend oder Wartend: Das Plugin hat kein Webhook; das Ergebnis kommt nur aus der Antwort von Moneris. Ist die Bestellung auf Wartend mit einer Notiz, dass Moneris das Ergebnis nicht bestätigt hat, hat Moneris nicht geantwortet und auch die Status Check ist fehlgeschlagen. Suchen Sie die Moneris-Bestellnummer aus der Notiz 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.

Der Kunde sieht Payment gateway is misconfigured. Please contact the store administrator.: Die Zugangsdaten des aktuellen Modus fehlen, oder der Live-Modus ist aktiv, während in den Live-Feldern Moneris-Testzugangsdaten stehen. Geben Sie Ihre Produktiv-Store-ID und Ihren Produktiv-API-Token ein.

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: Öffnen Sie die Bestellnotizen oder aktivieren Sie Debug log und prüfen Sie WooCommerce > Status > Logs, Quelle wcp_moneris_gateway.

Erfassung schlägt fehl: Die Bestellung hat keine Vorautorisierung, die auf Erfassung wartet, der Bestellbetrag ist null, oder der Betrag ist höher als der autorisierte 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 getätigt, und die Zugangsdaten dieses Modus sind nicht hinterlegt, oder die Zahlung erfolgte über ein Moneris-Konto des anderen Landes. Tragen Sie die Zugangsdaten ein oder verarbeiten Sie die Zahlung im Merchant Resource Center.

Card-Testing-Angriffe: Direkte Kartenformulare sind ein Ziel für Card-Testing. Aktivieren Sie das Rate Limiting der WooCommerce-Kasse und ein CAPTCHA-Plugin sowie die eFraud- oder Velocity-Regeln in Ihrem Moneris-Konto.

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 on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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