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

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

Währung: Die Warenkorbwährung muss ILS, USD, EUR oder GBP sein. Für jede andere Währung wird die Zahlungsart an 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 PrestaShop verwendet. Der Testmodus funktioniert ohne Cardcom-Konto.

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

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

3. Fügen Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

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

5. Für echte Zahlungen deaktivieren Sie Test Mode, geben die Terminal Number, den API Username und das API Password ein, die Sie von Cardcom erhalten haben, und klicken auf Save.

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

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Cardcom Payment Gateway > Configure. Jeder Abschnitt hat seine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder 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 an der Kasse ausgeblendet), wenn in den Live-Feldern das öffentliche Testterminal 1000 / CardTest1994 steht (Cardcom wird dann ebenfalls an der Kasse ausgeblendet, weil kein echtes Geld belastet würde), und erinnert daran, dass ohne API-Passwort keine Erstattungen aus PrestaShop möglich sind. Sie warnt außerdem, wenn die Standardwährung Ihres Shops nicht unterstützt wird. Wenn Sie den Live-Modus mit fehlenden oder Testzugangsdaten speichern, zeigt eine Fehlermeldung an, dass das Gateway an der Kasse ausgeblendet bleibt, bis Ihre eigene Terminalnummer und Ihr eigener API-Benutzername eingegeben sind.

Cardcom

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

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

Description: der Text, der an der Kasse unter der Zahlungsart angezeigt wird. Standard: Pay securely with your credit card via Cardcom.

Testmodus

Der Testmodus nutzt das öffentliche Cardcom-Testterminal 1000 (API-Benutzer CardTest1994). Es wird kein echtes Geld belastet und kein Cardcom-Konto benötigt. Testkarte: 4580 0000 0000 0000, beliebiges zukünftiges Ablaufdatum, CVV 123. Im Testmodus zeigt die Kasse außerdem eine Zeile mit dieser Testkarte an.

Test Mode: aktiviert den Testmodus (Terminal 1000, kein echtes Geld). Standard: ein. 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. Geben Sie etwas anderes ein, wird ein Fehler angezeigt und der bisherige Wert 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 PrestaShop benötigt. Das gespeicherte Passwort wird 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 the saved API password: Haken Sie das Kästchen an und klicken Sie auf Save, um das Passwort zu entfernen. Ein leeres Feld behält den gespeicherten Wert bei.

Zahlungsseite

Notification URL: Cardcom sendet Zahlungsbenachrichtigungen (IndicatorUrl) an diese Adresse. Mit SEO-freundlichen URLs sieht sie so aus: https://your-shop/module/wcp_cardcom_payment_gateway/webhook, gegebenenfalls mit einem Sprachcode wie /en/. Die Adresse wird bei jeder Zahlung automatisch zusammen mit der Warenkorb-ID an Cardcom übergeben. In Cardcom ist daher nichts einzurichten. Sie muss über HTTPS aus dem Internet erreichbar sein.

Operation: was Cardcom auf der Zahlungsseite tut.

Max Installments: die höchstmögliche Anzahl an Ratenzahlungen (Zahlungen), die der Kunde auf der Cardcom-Seite wählen kann: 1 bis 36. 1 bedeutet keine Ratenzahlung. Standard: 1.

Success Order Status: der Bestellstatus nach einer bestätigten Zahlung. Die Bestellung wird direkt in diesem Status angelegt.

Zahlungen, die nicht zur Bestellung passen, werden immer auf Cardcom payment on hold gesetzt.

Erweitert

Debug log: protokolliert API-Anfragen und Benachrichtigungen in logs/cardcom_p_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. Fehler werden immer protokolliert. Zugangsdaten, Kartentoken und Karteninhaberdaten werden nie geschrieben. Standard: aus.

Log: zeigt die Größe und die neuesten Einträge des Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Delete on Uninstall: Wenn diese Option eingeschaltet ist, werden beim Deinstallieren des Moduls die Einstellungen und Protokolle dauerhaft entfernt. Bestellungen, die Cardcom-Transaktionen und Erstattungen sowie der Bestellstatus Cardcom payment on hold bleiben immer erhalten, damit alte Bestellungen auch nach einer Neuinstallation erstattet werden können. Standard: aus.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsart (standardmäßig Credit Card (Cardcom)) und sieht den Hinweis You will be redirected to the secure Cardcom payment page. Nach der Bestätigung erstellt das Modul eine Cardcom-Zahlungsseite für den Warenkorbbetrag in der Warenkorbwährung und leitet den Kunden dorthin weiter. Zu diesem Zeitpunkt existiert noch keine Bestellung. Die Seite öffnet sich auf Hebräisch, wenn die Sprache des Kunden Hebräisch ist, andernfalls auf Englisch. Die Produkte aus dem Warenkorb werden als Produktname an Cardcom übergeben. Der Kunde gibt die Kartendaten ein und wählt, sofern Ratenzahlung erlaubt ist, die Anzahl der Zahlungen.

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 das Modul entnimmt diesem Aufruf nur den Code der Zahlungsseite. Es prüft, dass dieser Code von Ihrem Shop für diesen Warenkorb ausgestellt wurde, und fragt dann per Server-zu-Server-Verbindung das tatsächliche Ergebnis bei Cardcom ab. Trifft die Benachrichtigung verspätet ein, läuft dieselbe Prüfung ab, sobald der Kunde zurückkehrt. Die Bestellung wird dann angelegt, und der Kunde sieht die übliche Bestellbestätigungsseite mit Your payment with Cardcom has been received. Hat Cardcom die Zahlung beim Zurückkehren des Kunden noch nicht bestätigt, zeigt eine Seite Payment confirmation den Text Your payment is being confirmed by Cardcom. You will receive an e-mail as soon as it is confirmed. mit einer Schaltfläche Check again an; die Benachrichtigung legt die Bestellung an, sobald sie eintrifft.

Wird die Zahlung nicht abgeschlossen oder lehnt Cardcom sie ab, kehrt der Kunde zur Kasse zurück und sieht The card payment was not completed. Please try again or choose a different payment method. Es wird keine Bestellung angelegt, und der Warenkorb bleibt erhalten. Der Kunde kann es erneut versuchen: Jeder Versuch erhält eine neue Cardcom-Zahlungsseite. Eine Zahlung auf einer älteren Zahlungsseite desselben Warenkorbs wird weiterhin erkannt, und eine Ablehnung auf einer älteren Seite wirkt sich nicht auf einen neuen Versuch aus.

Kann Cardcom die Zahlungsseite nicht öffnen, bleibt der Kunde an der Kasse mit einer kurzen Meldung, zum Beispiel Could not connect to Cardcom. Please try again in a moment. oder der Meldung, dass Cardcom die Zahlungsseite nicht öffnen konnte, zusammen mit dem Cardcom-Code, und kann eine andere Zahlungsart wählen.

Die Benachrichtigung funktioniert, während der Shop im Wartungsmodus ist, und wird nicht durch die Ländersperre Ihres Shops blockiert.

Das Modul akzeptiert Kartenzahlungen nur auf der Cardcom-Seite. Es unterstützt keine gespeicherten Karten oder Ein-Klick-Zahlungen, keine Abonnements, belastet keine gespeicherten Token, bietet keine Rechnungs- oder Belegeinstellungen von Cardcom, kein Bit, Apple Pay, Google Pay oder PayPal über Cardcom, keinen iframe-Modus und keine Transaktionen mit späterer Erfassung.

Bestellungen und Erstattungen

Bestellstatus

No order yet: Der Kunde wurde zu Cardcom weitergeleitet und hat noch nicht bezahlt, die Zahlung wurde abgelehnt, oder Cardcom hat die Zahlung noch nicht bestätigt. Es existiert nur der Warenkorb.

Payment accepted, Delivered or Cardcom payment on hold: Die Zahlung wurde bestätigt. Der Status richtet sich nach Success Order Status. Die Zahlung wird mit der Cardcom-Geschäftsnummer (Deal) als Transaktions-ID erfasst. Eine private Bestellnachricht zeigt die Cardcom-Transaktion und, sofern Cardcom sie meldet, die letzten vier Ziffern der Karte, die Rechnungsnummer und die Anzahl der Raten. Testzahlungen werden mit Test mode — no real money was charged. gekennzeichnet.

Cardcom payment on hold after payment: Cardcom hat eine Zahlung bestätigt, die nicht zur Bestellung passt, zum Beispiel weil der Warenkorb geändert wurde, nachdem die Zahlungsseite geöffnet wurde, oder weil ein anderer Betrag oder eine andere Währung belastet wurde. Die Nachricht erklärt dies, und der Cardcom-Block zeigt es unter Needs review an. Die Zahlung wird in dem Betrag erfasst, den Cardcom belastet hat, wenn die Währung mit der Bestellung übereinstimmt. Vergleichen Sie die Zahlung im Cardcom-Dashboard mit der Bestellung und erfüllen Sie dann die Bestellung oder erstatten Sie die Zahlung.

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

Geht eine zweite erfolgreiche Zahlung für einen Warenkorb ein, der bereits eine Bestellung hat (zum Beispiel, wenn der Kunde in zwei Browser-Tabs bezahlt hat), bleibt die Bestellung unverändert. Eine Meldung warnt, dass der Kunde möglicherweise doppelt belastet wurde, und bittet Sie, die Zahlung im Cardcom-Dashboard zu erstatten.

Cardcom-Zahlungsblock

Die Bestellseite zeigt einen Block Cardcom payment mit der Transaktion, dem Code der Zahlungsseite, dem Status, der Karte, den Ratenzahlungen, der Rechnung, dem Kartentoken (bei Charge + Save token), dem belasteten Betrag, dem Bestellbetrag und dem erstatteten Betrag, einem Abzeichen Test mode für Testzahlungen sowie dem Erstattungsverlauf.

Erstattungen

Geben Sie im Block Cardcom payment den Betrag ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Grund, und klicken Sie auf Refund via Cardcom. Bestätigen Sie die Frage Refund this amount through Cardcom? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt, und für eine Bestellung können mehrere Teilerstattungen vorgenommen werden. Sie benötigen das Recht, Bestellungen zu bearbeiten; der Zugriff auf die Modulseiten ist nicht erforderlich. Erstattungen erfolgen in dem Betrag und 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, nicht den Bestellbetrag. Die Erstattung wird mit den Zugangsdaten des Modus gesendet, in dem die Bestellung bezahlt wurde: Testbestellungen werden über das Cardcom-Testterminal erstattet, auch nachdem Sie auf den Live-Modus umgestellt haben, und Live-Bestellungen verwenden immer Ihre Live-Zugangsdaten. Für Live-Erstattungen werden API Username und API Password benötigt. Akzeptiert Cardcom die Erstattung nicht, zeigt der Block den Fehler an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Bestellnachrichten mit der Cardcom-Erstattungstransaktion und dem Grund hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded. Eine Teilerstattung ändert den Status nicht.

Das Modul erstellt keine Gutschriften. Die Standard-Erstattungsschaltflächen von PrestaShop auf der Bestellseite senden kein Geld über Cardcom zurück. Erstattungen, die im Cardcom-Dashboard vorgenommen werden, werden dem Shop nicht gemeldet.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Cardcom Payment Gateway ist der erste Block auf Modules > Module Manager > VibeFox Cardcom Payment 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 aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen 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-cardcom 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 einen Domain-Platz in Ihrem Konto freigegeben haben, klicken Sie auf Check now. Kann der Lizenzserver nicht erreicht werden, arbeitet das Modul weiter mit dem zuletzt bekannten Status.

Ein Schlüssel funktioniert für eine Domain: die 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 einen aktiven Schlüssel wird Cardcom Kunden an 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 an der Kasse testen. Ein Hinweis erscheint unter Modules > Module Manager auf dem Reiter Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits begonnene 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 der 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. Ein Cron-Job ist nicht nötig. Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Cardcom wird an der Kasse nicht angezeigt: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Warenkorbwährung 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 unter Payment > Preferences, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe zugelassen ist.

Die Zahlung ist erfolgt, aber es wurde keine Bestellung angelegt: Cardcom konnte Ihren Shop nicht erreichen, zum Beispiel wegen einer Firewall, eines Passwortschutzes oder einer lokalen Entwicklungsumgebung. Die Benachrichtigungsadresse muss über HTTPS aus dem Internet erreichbar sein. Die Bestellung wird auch angelegt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt. Aktivieren Sie Debug log und sehen Sie sich das Feld Log auf der Modulseite an.

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

Die Benachrichtigung antwortet Gateway not configured or 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: Der Warenkorb wurde gerade von einer anderen Anfrage bestätigt, oder die Bestellung konnte nicht angelegt werden (zum Beispiel, weil das Modul deaktiviert ist). Aktivieren Sie Debug log, um den Grund zu sehen.

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

Der Kunde sieht Payment error: this currency is not supported by Cardcom.: Die Warenkorbwährung ist nicht ILS, USD, EUR oder GBP.

Der Kunde sieht Card payment is temporarily unavailable. Please choose another payment method.: Der Live-Modus ist eingeschaltet, aber die Terminalnummer oder der API-Benutzername fehlt, oder die Live-Felder enthalten das öffentliche Testterminal.

Der Kunde sieht beim Auswählen von Cardcom einen Fehler: Aktivieren Sie Debug log und sehen Sie sich das Feld Log an. Dort werden Verbindungsprobleme und Cardcom-Fehlercodes protokolliert.

Bestellung ist nach der Zahlung Cardcom payment on hold: Lesen Sie die Bestellnachricht oder Needs review im Block Cardcom payment. Der gezahlte Betrag oder die Währung wich von der Bestellung ab. Erfüllen Sie die Bestellung oder erstatten Sie die Zahlung.

Erstattung schlägt fehl mit API username and API password are required for refunds: Geben 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 erfolgt ist oder nicht.

Für Entwickler listet die README den Hook actionCardcomSupportedCurrencies, der die Währungsliste erweitert (nur Währungen hinzufügen, die auf Ihrem Cardcom-Terminal aktiviert sind), und actionCardcomLowProfileParams, der die Parameter der Zahlungsseite ändert.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Cardcom Payment Gateway und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete on Uninstall eingeschaltet, werden die Einstellungen und Protokolle entfernt. Ist die Option ausgeschaltet, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die Cardcom-Transaktionen und Erstattungen sowie der Bestellstatus Cardcom payment on hold bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnachrichten und Transaktions-IDs.

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