VibeFox Cardcom for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

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

PHP: 8.0 oder neuer.

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

Währung: Die Bestellwährung muss ILS, USD, EUR oder GBP sein. Bei jeder anderen Währung wird die Zahlungsmethode 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 genügen Terminalnummer und API-Benutzername. Das API-Passwort wird nur für Erstattungen aus WooCommerce verwendet. Der Testmodus funktioniert ohne Cardcom-Konto.

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Cardcom > Manage, oder klicken Sie auf der Plugins-Seite 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. Schalten Sie Enable/Disable ein, lassen Sie Test Mode eingeschaltet und führen Sie eine Testbestellung mit der Karte 4580 0000 0000 0000, einem beliebigen zukünftigen Ablaufdatum und CVV 123 durch.

6. Für echte Zahlungen entfernen Sie das Häkchen bei Test Mode und tragen die Terminal Number, den API Username und das API Password ein, die Sie von Cardcom erhalten haben.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Cardcom. Oberhalb der Felder zeigt die Seite Test mode is on., solange der Testmodus eingeschaltet ist. Im Live-Modus warnt sie, wenn Terminalnummer oder API-Benutzername fehlen (Cardcom wird dann an der Kasse ausgeblendet), und erinnert daran, dass ohne API-Passwort keine Erstattungen aus WooCommerce möglich sind. Sie warnt außerdem, wenn die Shopwährung nicht unterstützt wird. Wenn Sie den Live-Modus ohne Terminalnummer oder API-Benutzername speichern, zeigt eine Fehlermeldung an, dass das Gateway an der Kasse ausgeblendet bleibt, bis beides eingetragen ist.

Allgemein

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

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: Credit Card (Cardcom).

Description: der Text unter der Zahlungsmethode an der Kasse. 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 ein Cardcom-Konto ist nicht nötig. 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: Enable test mode (terminal 1000, no real money). Standard: ein. Entfernen Sie das Häkchen, um mit den unten eingetragenen Live-Zugangsdaten echte Zahlungen 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, wird eine Fehlermeldung 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 WooCommerce benötigt und genau so gespeichert, wie Sie es eingeben.

Zahlungsseite

Cardcom sendet Zahlungsbenachrichtigungen (IndicatorUrl) an die Adresse, die in diesem Abschnitt angezeigt wird. Sie sieht so aus: https://your-site/wc-api/cardcom_p_callback/. Die Adresse wird bei jeder Zahlung automatisch zusammen mit der Bestell-ID an Cardcom übergeben, daher müssen Sie in Cardcom nichts einrichten. Sie muss 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. Der Status wird sofort gesetzt, ohne zweite Statusänderung.

Erweitert

Debug log: Log API requests and notifications schreibt in WooCommerce > Status > Logs, Quelle wcp_cardcom_payment_gateway. Fehler werden immer protokolliert. Zugangsdaten, Kartentoken und Karteninhaberdaten werden nie geschrieben. Standard: aus.

Delete on Uninstall: Delete all plugin data when uninstalling. Ist die Option eingeschaltet, entfernt das Löschen des Plugins dauerhaft die Einstellungen, die an den Bestellungen gespeicherten Cardcom-Daten und die Protokolle. Die Bestellungen selbst bleiben erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig Credit Card (Cardcom)) und gibt die Bestellung auf. Das Plugin erstellt für den Bestellbetrag in der Bestellwährung eine Cardcom-Zahlungsseite und leitet den Kunden dorthin weiter. Die Seite öffnet sich auf Hebräisch, wenn die Sprache der Website Hebräisch ist, andernfalls auf Englisch. Die Artikel der Bestellung werden als Produktname an Cardcom übergeben. Der Kunde gibt seine Kartendaten ein und wählt, falls Ratenzahlungen erlaubt sind, die Anzahl der Zahlungen.

Nach der Zahlung kehrt der Kunde zur Bestellbestätigungsseite Ihres Shops zurück. Die Bestellung wird erst als bezahlt markiert, wenn Cardcom die Zahlung bestätigt. Cardcom ruft die Benachrichtigungsadresse auf, und das Plugin übernimmt aus diesem Aufruf nur den Code der Zahlungsseite. Es prüft, dass dieser Code von Ihrem Shop für genau diese Bestellung ausgestellt wurde, und fragt dann per Server-zu-Server-Verbindung das tatsächliche Ergebnis bei Cardcom ab. Kommt die Benachrichtigung verspätet an, läuft dieselbe Prüfung, sobald der Kunde auf der Bestellbestätigungsseite ankommt.

Wird die Zahlung nicht abgeschlossen, schickt Cardcom den Kunden zurück zur Kasse (oder zur Seite Pay for order). Dort sieht er The card payment was not completed. Please try again or choose a different payment method. Eine von Cardcom bestätigte Ablehnung setzt die Bestellung auf Fehlgeschlagen. Der Kunde kann eine unbezahlte Bestellung erneut bezahlen, zum Beispiel über die Seite Pay for order. Eine Zahlung auf einer älteren Zahlungsseite derselben Bestellung wird weiterhin erkannt. Hat der Kunde auf eine andere Zahlungsmethode gewechselt, aber auf der Cardcom-Seite bezahlt, wird die Zahlung verbucht und die Zahlungsmethode wieder auf Cardcom gesetzt.

Kann Cardcom die Zahlungsseite nicht öffnen, sieht der Kunde eine kurze Meldung, zum Beispiel Could not connect to Cardcom. Please try again in a moment. oder dass Cardcom die Zahlungsseite nicht öffnen konnte, mit dem Cardcom-Code, und kann eine andere Zahlungsmethode wählen.

Die Zahlungsmethode funktioniert auf 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 akzeptiert Kartenzahlungen nur auf der Cardcom-Seite. Es bietet keine gespeicherten Karten oder Ein-Klick-Zahlungen, keine Abonnements und belastet keine gespeicherten Token. Es hat 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. Nicht abgeschlossene Zahlungsseiten werden nicht automatisch geprüft.

Bestellungen und Erstattungen

Bestellstatus

Pending payment: Der Kunde wurde zu Cardcom weitergeleitet und hat noch nicht bezahlt, oder Cardcom hat die Zahlung noch nicht bestätigt.

Processing, Completed or On Hold: Die Zahlung wurde bestätigt. Der Status richtet sich nach Success Order Status. Die Bestellnotiz zeigt die Cardcom-Transaktion und, sofern Cardcom sie meldet, die letzten vier Ziffern der Karte, die Rechnungsnummer und die Anzahl der Ratenzahlungen. Testzahlungen sind mit Test mode — no real money was charged. gekennzeichnet. Die Transaktions-ID der Bestellung ist die Cardcom-Deal-Nummer.

On hold after payment: Cardcom hat eine Zahlung bestätigt, die nicht zur Bestellung passt, etwa weil der Bestellbetrag geändert wurde, nachdem die Zahlungsseite geöffnet wurde, oder weil ein anderer Betrag oder eine andere Währung belastet wurde. Die Bestellnotiz erklärt das. Vergleichen Sie die Zahlung im Cardcom-Dashboard mit der Bestellung und erfüllen Sie die Bestellung anschließend oder erstatten Sie die Zahlung.

Failed: Cardcom hat die Zahlung abgelehnt. Die Bestellnotiz zeigt den Antwortcode von Cardcom. Eine Ablehnung auf einer älteren Zahlungsseite setzt einen neueren Versuch nicht auf Fehlgeschlagen, und eine verspätete Ablehnung ändert nie eine bezahlte Bestellung.

Trifft eine zweite erfolgreiche Zahlung für eine bereits bezahlte Bestellung ein (zum Beispiel, wenn der Kunde in zwei Browser-Tabs bezahlt hat), wird die Bestellung nicht erneut verändert. Eine Notiz warnt, dass der Kunde möglicherweise doppelt belastet wurde, und bittet Sie, dies im Cardcom-Dashboard zu erstatten.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Credit Card (Cardcom) (die Schaltfläche zeigt den Titel der Zahlungsmethode an). Vollständige und Teilerstattungen werden unterstützt; für eine Bestellung können mehrere Teilerstattungen erfolgen. 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, Live-Bestellungen immer mit Ihren Live-Zugangsdaten. Live-Erstattungen benötigen API Username und API Password. Akzeptiert Cardcom die Erstattung nicht, zeigt WooCommerce den Fehler an, und es wird keine Erstattung verbucht. Eine erfolgreiche Erstattung wird mit der Cardcom-Erstattungstransaktion und dem Grund den Bestellnotizen hinzugefügt.

Im Cardcom-Dashboard vorgenommene Erstattungen werden nicht an den Shop zurückgemeldet. Falls nötig, legen Sie in WooCommerce eine manuelle Erstattung an, ohne Refund via das Gateway zu verwenden.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Cardcom. 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 deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Cardcom Kunden an der Kasse nicht angezeigt. Versucht trotzdem jemand, eine Zahlung zu starten, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen bleiben unberührt: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, doch Updates und Support erfordern eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

Cardcom erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Bestellwährung ILS, USD, EUR oder GBP ist. Prüfen Sie im Live-Modus, ob Terminal Number und API Username ausgefüllt sind. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt bei Pending payment: Cardcom konnte Ihre Website nicht erreichen, zum Beispiel wegen des Wartungsmodus, einer Firewall, eines Passwortschutzes oder einer lokalen Entwicklungsseite. Die Benachrichtigungsadresse muss über HTTPS aus dem Internet erreichbar sein. Die Bestellung wird auch bestätigt, wenn der Kunde auf die Bestellbestätigungsseite zurückkehrt. Schalten Sie das Debug log ein und prüfen Sie WooCommerce > Status > Logs, Quelle wcp_cardcom_payment_gateway.

Die Benachrichtigung meldet Missing or invalid lowprofilecode oder Unknown lowprofilecode for this order: Der Aufruf enthielt keinen Code einer Zahlungsseite, den Ihr Shop für diese Bestellung ausgestellt hat. Die Bestellung wird nicht verändert.

Die Benachrichtigung meldet 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. Die Bestellung wird nicht verändert und erneut geprüft, wenn der Kunde in den Shop zurückkehrt.

Die Benachrichtigung meldet ReturnValue mismatch oder Terminal mismatch: Cardcom hat eine Zahlung für eine andere Bestellung oder ein anderes Terminal gemeldet. Die Bestellung wird nicht verä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 Bestellwä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 Terminalnummer oder API-Benutzername fehlen.

Der Kunde sieht beim Aufgeben der Bestellung einen Fehler: Öffnen Sie die Bestellnotizen oder schalten Sie das Debug log ein und prüfen Sie das Protokoll. Verbindungsprobleme und Fehlercodes von Cardcom werden dort geschrieben.

Die Bestellung ist nach der Zahlung auf On hold: Lesen Sie die Bestellnotiz. Der bezahlte Betrag oder die Währung wich von der Bestellung ab. Erfüllen Sie die Bestellung oder erstatten Sie die Zahlung.

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

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

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits 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.

Für Entwickler: In der Readme-Datei ist der Filter cardcom_p_supported_currencies aufgeführt, der die Liste der Währungen erweitert (fügen Sie nur Währungen hinzu, die auf Ihrem Cardcom-Terminal aktiviert sind).

Deinstallation

Beim Deaktivieren des Plugins bleiben alle Daten erhalten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen, die an den Bestellungen gespeicherten Cardcom-Daten und die Protokolle werden nur entfernt, wenn Delete on Uninstall eingeschaltet war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Cardcom ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Cardcom verbunden noch von Cardcom empfohlen.