VibeFox Cardcom for OpenCart — Hilfe

Anforderungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 oder neuer (getestet mit 4.1.0.3).

PHP: 8.0 oder neuer.

HTTPS: Ihr Shop muss über HTTPS aus dem Internet erreichbar sein, damit Cardcom die Zahlungsbenachrichtigung senden kann.

Währung: die Bestellwährung (die Währung, in der der Kunde einkauft) muss ILS, USD, EUR oder GBP sein. Bei jeder anderen Währung wird die Zahlungsart in der Kasse ausgeblendet.

Cardcom-Konto: für Live-Zahlungen benötigen Sie ein Cardcom-Händlerkonto mit Terminalnummer, API-Benutzername und API-Passwort. Für Zahlungen werden nur die Terminalnummer und der API-Benutzername benötigt. Das API-Passwort wird nur für Erstattungen aus OpenCart verwendet. Der Testmodus funktioniert ohne Cardcom-Konto.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert für eine Domain.

Installation

Der Download ist eine einzige ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 wcp_cardcom_payment_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_cardcom_payment_gateway.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen derselbe.

OpenCart 3

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_cardcom_payment_gateway-oc3-(version).ocmod.zip. 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 aus diesem Paket in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Cardcom Payment 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 in License key im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Aktivieren Sie Enable/Disable, lassen Sie Test Mode eingeschaltet und klicken Sie auf Save. Führen Sie eine Testbestellung mit der Karte 4580 0000 0000 0000, einem beliebigen zukünftigen Ablaufdatum und der CVV 123 durch.

5. Für echte Zahlungen schalten Sie Test Mode aus, tragen die Terminal Number, den API Username und das API Password ein, die Sie von Cardcom erhalten haben, und klicken auf Save. Im Cardcom-Dashboard muss nichts eingerichtet werden: Die Benachrichtigungs- und Rückkehradressen werden bei jeder Zahlung übermittelt.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_cardcom_payment_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Erweiterungscode 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 Cardcom Payment Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel ein, testen Sie die Zahlung und tragen Sie die Live-Zugangsdaten ein wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Notification URL ist anders (siehe Notification URL).

Eine neue Installation startet mit ausgeschalteter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Cardcom Payment Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite eine Warnung, solange der Testmodus eingeschaltet ist. Im Live-Modus warnt sie, wenn die Terminalnummer oder der API-Benutzername fehlt (Cardcom wird dann in der Kasse ausgeblendet), wenn in den Live-Feldern das öffentliche Testterminal 1000 / CardTest1994 steht (Cardcom wird dann ebenfalls in der Kasse ausgeblendet, da kein echtes Geld belastet würde), und erinnert daran, dass ohne API-Passwort keine Erstattungen aus OpenCart möglich sind. Außerdem warnt sie, wenn die Standardwährung Ihres Shops nicht unterstützt wird. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein (höchstens 128 Zeichen), Sort Order muss eine ganze Zahl sein, Total muss eine Zahl von 0 oder mehr sein, und die Geozone und Bestellstatus müssen vorhanden sein; andernfalls wird nichts gespeichert. Wenn Sie den Live-Modus mit fehlenden oder Testzugangsdaten speichern, werden die Einstellungen mit einer Warnung gespeichert, dass die Zahlungsart in der Kasse ausgeblendet bleibt, bis Ihre eigene Terminalnummer und Ihr eigener API-Benutzername eingetragen sind.

Cardcom

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

Title: der Name der Zahlungsart, den der Kunde in der Kasse sieht. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Credit Card (Cardcom). Pflichtfeld.

Description: der Text, den der Kunde im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche sieht. Standard: Pay securely with your credit card via Cardcom.

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

Geo Zone: Cardcom nur für Zahlungsadressen in der gewählten Geozone anbieten. 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 Cardcom angeboten wird. Lassen Sie das Feld leer, um Cardcom bei jedem Betrag anzubieten.

Testmodus

Der Testmodus verwendet das öffentliche Cardcom-Testterminal 1000 (API-Benutzer CardTest1994). Es wird kein echtes Geld belastet, und ein Cardcom-Konto ist nicht erforderlich. Testkarte: 4580 0000 0000 0000, ein beliebiges zukünftiges Ablaufdatum und die CVV 123. Im Testmodus zeigt der Schritt Confirm Order außerdem eine Zeile mit dieser Testkarte an.

Test Mode: aktiviert den Testmodus (Terminal 1000, kein echtes Geld). Standard: an. Schalten Sie ihn aus, um echte Zahlungen mit den unten stehenden Live-Zugangsdaten anzunehmen. Erstattungen werden immer mit den Zugangsdaten des Modus gesendet, in dem die Bestellung bezahlt wurde.

Live-Zugangsdaten

Terminalnummer, API-Benutzername und API-Passwort stellt Cardcom mit Ihrem Händlerkonto bereit: im Cardcom-Dashboard unter den API-Einstellungen oder über den Cardcom-Support. Diese Felder werden nur im Live-Modus verwendet.

Terminal Number: Ihre Cardcom-Terminalnummer. Sie darf nur Ziffern enthalten. Wenn Sie etwas anderes eingeben, werden die übrigen Einstellungen mit einer Warnung gespeichert und die bisherige Terminalnummer bleibt erhalten.

API Username: Ihr Cardcom-API-Benutzername (ApiName) für dieses Terminal. Leerzeichen werden beim Speichern entfernt.

API Password: Ihr Cardcom-API-Passwort. Es wird nur für Erstattungen aus OpenCart benötigt. Das gespeicherte Passwort wird nie wieder angezeigt: Das Feld bleibt leer und zeigt Gespeichert — leer lassen, um es beizubehalten. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um es zu entfernen, setzen Sie unter dem Feld das Häkchen bei Clear the saved API password und klicken Sie auf Save.

Zahlungsseite

Notification URL: Cardcom sendet Zahlungsbenachrichtigungen (IndicatorUrl) an diese Adresse. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_cardcom_payment_gateway/webhook, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_cardcom_payment_gateway/payment/wcp_cardcom_payment_gateway.webhook. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Die Adresse wird bei jeder Zahlung zusammen mit der Bestellnummer automatisch an Cardcom übergeben, daher muss in Cardcom nichts eingestellt werden. Sie muss über HTTPS aus dem Internet erreichbar sein.

Operation: was Cardcom auf der Zahlungsseite tut.

Max Installments: die maximale Anzahl an Ratenzahlungen (Teilzahlungen), die der Kunde auf der Cardcom-Seite wählen kann, von 1 bis 36. 1 bedeutet keine Ratenzahlung. Standard: 1.

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung). Die Bestellung erhält erst einen Status, nachdem Cardcom die Zahlung bestätigt hat. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Success Order Status: der Status, der nach einer bestätigten Zahlung gesetzt wird. Standard: Verarbeitung.

On Hold (Review) Status: Zahlungen, die nicht zur Bestellung passen (Betrag, Währung, keine Transaktionsnummer), erhalten diesen Status und eine Notiz mit dem Grund. Standard: Ausstehend, da OpenCart keinen Status In Wartestellung hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Refunded Status: wird gesetzt, nachdem die Zahlung auf der Bestellseite vollständig erstattet wurde. Standard: Erstattet.

Erweitert

Debug log: protokolliert API-Anfragen und Benachrichtigungen in cardcom_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden, und bei 5 MB wird sie rotiert. Fehler werden immer protokolliert. Zugangsdaten, Karten-Token und Angaben zum Karteninhaber werden nie geschrieben. 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 on Uninstall: wenn eingeschaltet, entfernt die Deinstallation der Erweiterung die Einstellungen und Protokolle dauerhaft. Bestellungen sowie Cardcom-Transaktionen und -Erstattungen bleiben immer erhalten, sodass alte Bestellungen auch nach einer Neuinstallation erstattet werden können. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Das API-Passwort wird nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Das gespeicherte API-Passwort bleibt erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit Card (Cardcom)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis Sie werden zur sicheren Cardcom-Zahlungsseite weitergeleitet. OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Cardcom-Zahlungsseite für den Bestellbetrag in der Bestellwährung und leitet den Kunden dorthin weiter. Die Seite öffnet sich auf Hebräisch, wenn die Bestellsprache Hebräisch ist, andernfalls auf Englisch. Die Bestellpositionen werden als Produktname an Cardcom übergeben. Der Kunde gibt die Kartendaten ein und wählt, falls Ratenzahlungen erlaubt sind, die Anzahl der Zahlungen. Auf OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart, im Fenster Payment method options, und klickt unten auf der Kassenseite auf Confirm Order.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Cardcom die Zahlung bestätigt. Cardcom ruft die Benachrichtigungsadresse auf, und die Erweiterung entnimmt diesem Aufruf nur den Code der Zahlungsseite. Sie prüft, dass dieser Code von Ihrem Shop für diese Bestellung ausgestellt wurde, und fragt dann bei Cardcom das tatsächliche Ergebnis Server-zu-Server ab. Kommt die Benachrichtigung verspätet, läuft dieselbe Prüfung ab, wenn der Kunde zurückkehrt. Die Bestellung erhält ihren Status dann auf die übliche OpenCart-Weise mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung mit Ihre Zahlung mit Cardcom ist eingegangen. Hat Cardcom die Zahlung beim Zurückkehren des Kunden noch nicht bestätigt, zeigt eine Seite Payment confirmation den Hinweis Ihre Zahlung wird von Cardcom bestätigt. Sie erhalten eine E-Mail, sobald sie bestätigt ist. mit den Schaltflächen Check again und Back to checkout; die Benachrichtigung setzt den Bestellstatus, sobald sie eintrifft. Auf OpenCart 4 sendet der Browser die Shop-Sitzung nicht, wenn Cardcom den Kunden zurückschickt; die Erweiterung zeigt daher zuerst eine kurze Seite, die dieselbe Rückkehradresse erneut von Ihrem Shop aus öffnet: Der Kunde behält Warenkorb und Anmeldung.

Wenn die Zahlung nicht abgeschlossen wird oder Cardcom sie ablehnt, kehrt der Kunde zur Kasse zurück, mit Die Kartenzahlung wurde nicht abgeschlossen. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsart. Auf OpenCart 4 wird diese Meldung oberhalb der Kassenseite angezeigt. Die Bestellung bleibt ohne Status und der Warenkorb wird beibehalten. Der Kunde kann es erneut versuchen: OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird, OpenCart 4 behält eine Bestellung für die Kasse bei und aktualisiert sie, und jeder Versuch erhält eine neue Cardcom-Zahlungsseite. Bevor eine neue Seite erstellt wird, werden die offenen Cardcom-Zahlungsseiten dieser Bestellung und der anderen Bestellungen desselben Warenkorbs (gleiche Kundensitzung und gleicher Warenkorbinhalt) aus den letzten 24 Stunden bei Cardcom geprüft. Ist eine davon bezahlt, wird diese Bestellung bestätigt und der Kunde gelangt zur Erfolgsseite, statt doppelt zu bezahlen. Ein Warenkorb, der bereits mit einer anderen Bestellung bezahlt wurde, wird nicht erneut belastet: Der Kunde gelangt zur Erfolgsseite. Eine Ablehnung auf einer älteren Seite wirkt sich nicht auf einen neueren Versuch aus.

Wenn die Bestellung der Kasse inzwischen ohne Zahlung geschlossen wurde (zum Beispiel weil Sie sie storniert haben), schickt Confirm Order oder die Rückkehr von Cardcom den Kunden mit This order can no longer be paid. Please confirm your order again. zurück zur Kasse, und das nächste Confirm Order bezahlt eine neue Bestellung des Warenkorbs. OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird: Hat diese Bestellung bereits einen Status und hat sich der Warenkorb seitdem geändert (andere Produkte oder Mengen), erhält der Kunde dieselbe Meldung, und der geänderte Warenkorb erhält eine neue Bestellung mit eigener Zahlung, während derselbe Warenkorb ohne neue Zahlung zur Erfolgsseite gelangt.

Wenn Cardcom die Zahlungsseite nicht öffnen kann, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche, zum Beispiel Verbindung zu Cardcom nicht möglich. Bitte versuchen Sie es in einem Moment erneut. oder dass Cardcom die Zahlungsseite nicht öffnen konnte, zusammen mit dem Cardcom-Code, und kann eine andere Zahlungsart wählen.

Die Benachrichtigung funktioniert auch, während der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und auf OpenCart 4 fügt die Erweiterung eine Startaktion hinzu, die die Benachrichtigung und die Rückkehr des Kunden durchlässt.

Die Erweiterung nimmt Kartenzahlungen nur auf der Cardcom-Seite an. Sie unterstützt keine gespeicherten Karten oder Ein-Klick-Zahlungen, keine Abonnements, belastet keine gespeicherten Token, hat keine Einstellungen für Cardcom-Rechnungen oder Belege, keine Zahlungen über Bit, Apple Pay, Google Pay oder PayPal per Cardcom, keinen iframe-Modus und keine Vereinbarungen zur späteren Erfassung.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu Cardcom weitergeleitet und hat nicht bezahlt, die Zahlung wurde abgelehnt oder Cardcom hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur angezeigt, wenn der Filter Order Status auf Missing Orders gesetzt ist.

Success Order Status (Standard Verarbeitung): Die Zahlung wurde bestätigt. Eine Notiz zeigt die Cardcom-Transaktion und, sofern Cardcom sie meldet, die letzten vier Ziffern der Karte, die Rechnungsnummer und die Anzahl der Ratenzahlungen sowie die Art der Bestätigung (Benachrichtigung, Rückkehr oder ein neuer Versuch). Testzahlungen sind mit Testmodus: Es wurde kein echtes Geld belastet. gekennzeichnet.

On Hold (Review) Status (Standard Ausstehend): Cardcom hat eine Zahlung bestätigt, die nicht zur Bestellung passt, zum Beispiel wurde ein anderer Betrag oder eine andere Währung belastet, oder Cardcom hat keine Transaktionsnummer zurückgegeben. Die Notiz erklärt dies, und der Bestellreiter zeigt es unter Needs review: an. Vergleichen Sie die Zahlung im Cardcom-Dashboard mit der Bestellung und erfüllen Sie dann die Bestellung oder erstatten Sie die Zahlung.

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

Wenn für eine Bestellung, die bereits einen Status hat, eine zweite erfolgreiche Zahlung eingeht (etwa weil der Kunde in zwei Browser-Tabs bezahlt hat), wird die Bestellung nicht verändert. Eine Notiz warnt, dass der Kunde möglicherweise doppelt belastet wurde, und bittet Sie, dies im Cardcom-Dashboard zu erstatten. Dieselbe Notiz wird der bezahlten Bestellung hinzugefügt, wenn derselbe Warenkorb mit einer anderen Bestellung erneut bezahlt wurde (zum Beispiel in einem zweiten Tab); diese andere Bestellung erhält keinen Status.

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

Reiter VibeFox Cardcom Payment Gateway

Öffnen Sie unter Sales > Orders eine mit Cardcom bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Cardcom Payment Gateway die Transaction mit der Kennzeichnung Test mode bei Testzahlungen, die Payment page (LowProfileCode), den Status, die Card, die Installments, die Invoice, das Card token (mit Charge + Save token), den belasteten Betrag Charged, die Order total / refunded, das Erstattungsformular, den Erstattungsverlauf und die Cardcom notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Reiter den Amount ein (der noch nicht erstattete Betrag wird eingetragen), optional einen Reason (optional), und klicken Sie auf Refund via Cardcom. Bestätigen Sie die Abfrage Refund this amount through Cardcom? This cannot be undone. Vollständige und Teilerstattungen werden unterstützt, und für eine Bestellung können mehrere Teilerstattungen erfolgen. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Erstattungen erfolgen in dem Betrag und in der Währung, die Cardcom belastet hat. Nach einer Abweichung bei Betrag oder Währung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, und nicht bis zum Bestellbetrag. Die Erstattung wird mit den Zugangsdaten des Modus gesendet, in dem die Bestellung bezahlt wurde: Testbestellungen werden auch nach dem Wechsel in den Live-Modus über das Cardcom-Testterminal erstattet, und Live-Bestellungen verwenden immer Ihre Live-Zugangsdaten. Live-Erstattungen benötigen den API Username und das API Password. Wenn Cardcom die Erstattung nicht annimmt, zeigt der Reiter den Fehler an, und es wird keine Erstattung verbucht. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen mit der Cardcom-Erstattungstransaktion und dem Grund hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf den Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht.

Produktrücksendungen unter Sales > Returns überweisen über Cardcom kein Geld zurück. Im Cardcom-Dashboard vorgenommene Erstattungen werden nicht an den Shop gemeldet.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Cardcom Payment Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Cardcom Payment Gateway > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, 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-cardcom und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wenn der Schlüssel nicht akzeptiert wird, nennt der Block den Grund, zum Beispiel Schlüssel nicht gefunden, Dieser Schlüssel gehört zu einem anderen Produkt, Domain-Limit erreicht oder Lizenz abgelaufen am mit einem Datum. Nachdem sich die Shop-Adresse geändert hat oder 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 einen aktiven Schlüssel wird Cardcom Kunden in der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, sieht der Kunde Diese Zahlungsart ist nicht verfügbar. Bitte wählen Sie eine andere. Ein Admin-Benutzer, der im Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert als (nicht lizenziert — nur für Admins sichtbar), sodass Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher ist die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint im Admin-Dashboard eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Wenn eine Lizenz abläuft, arbeitet die Erweiterung weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird beim Öffnen des Admin-Dashboards oder der Seite Edit automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht erforderlich. Die Deinstallation der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Cardcom erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Währung des Kunden ILS, USD, EUR oder GBP ist. Prüfen Sie im Live-Modus, ob Terminal Number und API Username mit Ihren eigenen Zugangsdaten ausgefüllt sind und nicht mit dem Testterminal 1000 / CardTest1994. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: Cardcom konnte Ihren Shop nicht erreichen, zum Beispiel wegen einer Firewall, eines Passwortschutzes oder einer lokalen Entwicklungsseite. Die Benachrichtigungsadresse muss über HTTPS aus dem Internet erreichbar sein. Die Bestellung erhält ihren Status auch dann, wenn der Kunde nach der Zahlung in den Shop zurückkehrt. Schalten Sie das Debug log ein und sehen Sie sich das Feld Log auf der Erweiterungsseite an.

Die Benachrichtigung antwortet Missing or invalid lowprofilecode oder Unknown lowprofilecode for this order: Der Aufruf enthielt keinen von Ihrem Shop für diese Bestellung ausgestellten Code der Zahlungsseite. Es wird nichts geändert.

Die Benachrichtigung antwortet Gateway not configured oder Indicator check failed: Die Zugangsdaten des Modus, in dem die Zahlungsseite erstellt wurde, fehlen, oder Cardcom konnte für die Prüfung nicht erreicht werden. Es wird nichts geändert; die Zahlung wird erneut geprüft, wenn der Kunde in den Shop zurückkehrt.

Die Benachrichtigung antwortet Busy, retry: Die Bestellung wurde im selben Moment von einer anderen Anfrage bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. Schalten Sie das Debug log ein, um den Grund zu sehen.

Die Benachrichtigung antwortet ReturnValue mismatch oder Terminal mismatch: Cardcom hat eine Zahlung für eine andere Bestellung oder ein anderes Terminal gemeldet. Es wird nichts geändert. Prüfen Sie, dass Terminal Number das Terminal Ihres Kontos ist.

Die Benachrichtigungs-URL zeigt im Browser Missing or invalid lowprofilecode: Das ist normal. Die URL nimmt nur Aufrufe von Cardcom an.

Der Kunde sieht «Zahlungsfehler: Diese Währung wird von Cardcom nicht unterstützt.»: Die Bestellwährung ist nicht ILS, USD, EUR oder GBP.

Der Kunde sieht «Kartenzahlung ist vorübergehend nicht verfügbar. Bitte wählen Sie eine andere Zahlungsart.»: Der Live-Modus ist eingeschaltet, aber die Terminalnummer oder der API-Benutzername fehlt, oder die Live-Felder enthalten das öffentliche Testterminal.

Der Kunde sieht «Diese Zahlungsart ist nicht verfügbar.» nach Confirm Order: Die Kassensitzung passt nicht mehr zur Bestellung, oder die Zahlungsart wurde inzwischen ausgeschaltet. Der Kunde lädt die Kasse neu.

Der Kunde sieht nach Confirm Order einen anderen Fehler: Schalten Sie das Debug log ein und sehen Sie sich das Feld Log an. Verbindungsprobleme und Cardcom-Fehlercodes werden dort protokolliert.

Die Bestellung steht nach der Zahlung im Prüfstatus: Lesen Sie die Notizen oder Needs review: im Reiter VibeFox Cardcom Payment Gateway. Der bezahlte Betrag oder die Währung wich von der Bestellung ab. Erfüllen Sie die Bestellung oder erstatten Sie die Zahlung.

Im Reiter fehlt das Erstattungsformular: Der Reiter nennt den Grund: Die Transaktion ist noch nicht bestätigt, die Zahlung ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht zur Änderung der Erweiterung, oder die API-Zugangsdaten des Zahlungsmodus fehlen.

Erstattung schlägt fehl mit «API username and API password are required for refunds»: Tragen Sie das API Password (und den API Username) in den Einstellungen ein und versuchen Sie es erneut.

Erstattung schlägt fehl mit «Could not connect to Cardcom»: Prüfen Sie das Cardcom-Dashboard, bevor Sie es erneut versuchen, da die Erstattung möglicherweise durchgeführt wurde oder nicht.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse cardcom_p_supported_currencies aus, die die Währungsliste erweitert (fügen Sie nur Währungen hinzu, die auf Ihrem Cardcom-Terminal aktiviert sind), und cardcom_p_low_profile_params, das die Parameter der Zahlungsseite ändert, bevor sie erstellt wird.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Cardcom Payment 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 im Abschnitt Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (auf OpenCart 4 auch dessen Ereignisse und Startaktion, die Cardcom im Wartungsmodus durchlässt). Wenn Delete on Uninstall eingeschaltet ist, werden die übrigen Einstellungen der Zahlungsschnittstelle (Titel, Beschreibung, Testmodus, Zugangsdaten, Optionen der Zahlungsseite, Protokollierung) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Cardcom-Transaktionen und -Erstattungen bleiben immer erhalten, sodass zuvor bezahlte Bestellungen auch nach einer Neuinstallation 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 in der Liste der installierten Erweiterungen neben VibeFox Cardcom Payment Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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