VibeFox Comgate for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 7.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 Comgate die Hintergrundbenachrichtigung zustellen kann.

Währung: CZK, EUR, PLN, HUF, USD, GBP, RON, HRK, NOK oder SEK. Bei anderen Währungen und bei Beträgen unter dem Comgate-Mindestbetrag wird die Zahlungsmethode ausgeblendet. HUF-Zahlungen werden, wie Comgate es verlangt, auf ganze Forint gerundet.

Comgate-Konto: Sie benötigen Merchant ID und Secret (Passwort für die Hintergrundkommunikation) Ihrer Shop-Verbindung im Comgate-Kundenportal sowie die dort hinterlegte Benachrichtigungs-URL (siehe Konfiguration). Comgate verwendet dieselbe Merchant ID und dasselbe Secret für Test- und Live-Zahlungen.

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Comgate > 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. Tragen Sie Merchant ID und Secret aus dem Comgate-Kundenportal ein und hinterlegen Sie dort die Benachrichtigungs-URL (siehe Konfiguration).

6. Schalten Sie Enable / Disable ein. Lassen Sie Test Mode für eine Probezahlung eingeschaltet und schalten Sie ihn danach aus.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Comgate. Oberhalb der Felder warnt die Seite, wenn Comgate aktiviert ist, aber Merchant ID oder Secret fehlt (die Zahlungsmethode wird dann an der Kasse ausgeblendet, bis beide eingetragen sind), sowie wenn die Shopwährung nicht unterstützt wird. Solange der Testmodus eingeschaltet ist, zeigt sie Test mode is on: payments are created as Comgate test payments and no money is charged. Turn it off before going live.

Allgemein

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

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: Comgate.

Description: der Text unter der Zahlungsmethode an der Kasse. Standard: Pay securely via Comgate — cards, bank transfers, wallets and more. Im Testmodus wird TEST MODE: no real money is charged. angehängt, oder es wird allein angezeigt, wenn die Beschreibung leer ist.

Comgate-Verbindung

Übernehmen Sie die Shop-Kennung (Merchant ID) und das Passwort (Secret) aus dem Comgate-Kundenportal unter Integration > shop connection settings. Setzen Sie dort außerdem die URL for passing the payment result (Hintergrundbenachrichtigung) auf die in diesem Abschnitt angezeigte URL. Sie sieht so aus: https://your-site/wc-api/comgate_payment_callback/. Comgate ruft sie nach jeder Zahlung auf; das Plugin prüft die Zahlung dann über die Status-API von Comgate erneut, bevor es die Bestellung ändert. Rückkehr-URLs für den Kunden werden bei jeder Zahlung übergeben. Verlangt das Portal außerdem Rückkehr-URLs (bezahlt, storniert, ausstehend), verwenden Sie die zweite in diesem Abschnitt angezeigte URL, die so aussieht: https://your-site/wc-api/comgate_payment_return/?id=${id}&refId=${refId}.

Merchant ID: die Shop-Kennung (Merchant) bei Comgate.

Secret: das Passwort für die Hintergrundkommunikation (Secret) dieser Shop-Verbindung.

Test Mode: Create test payments (no money is charged). Comgate verwendet dieselbe Merchant ID und dasselbe Secret für Test- und Live-Zahlungen; Testzahlungen werden mit test=true gekennzeichnet. Erstattungen werden immer im Modus der ursprünglichen Zahlung gesendet. Standard: ein.

Zahlungsseite

Payment Methods: welche Comgate-Zahlungsmethoden der Kunde wählen kann. Angezeigt werden nur die Methoden, die für Ihren Shop in Comgate aktiviert sind.

Language: die Sprache der Comgate-Zahlungsseite. Automatic (site language, English as fallback) (Standard) oder eine von 26 Sprachen.

Bestellungen

Order Status After Payment: der Status, der gesetzt wird, sobald Comgate die Zahlung bestätigt. Der Status wird sofort gesetzt, ohne zweite Statusänderung.

Erweitert

Debug Log: Log API requests and notifications schreibt in WooCommerce > Status > Logs, Quelle wcp_comgate_gateway. Das Secret und personenbezogene Daten werden nie protokolliert. Fehler werden immer protokolliert. Standard: aus.

Delete Data on Uninstall: Remove the gateway settings and log files when the plugin is deleted. Bestellungen und ihre Comgate-Transaktions-IDs bleiben immer erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig Comgate) und gibt die Bestellung auf. Das Plugin legt die Zahlung bei Comgate für den Bestellbetrag in der Bestellwährung an und leitet den Kunden zur Comgate-Zahlungsseite weiter. Die Rechnungs-E-Mail-Adresse und der Name werden an Comgate übergeben, und die Zahlung wird mit der Bestellnummer bezeichnet. Eine gültige Rechnungs-E-Mail-Adresse ist erforderlich. Auf der Comgate-Seite bezahlt der Kunde mit einer der von Ihnen erlaubten Methoden.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Comgate die Zahlung bestätigt: Das Plugin liest die Zahlung über die Status-API von Comgate, sowohl wenn die Hintergrundbenachrichtigung eintrifft als auch wenn der Kunde zurückkehrt. Ist die Zahlung noch nicht bestätigt, etwa eine Banküberweisung, die unterwegs ist, zeigt die Bestellbestätigungsseite Comgate has not confirmed your payment yet. The order will be updated automatically as soon as the payment is confirmed — please do not pay again. Wurde die Bestellung auf Wartend gesetzt, zeigt die Seite Your payment is being reviewed. We will contact you if anything else is needed.

Wird die Zahlung storniert oder läuft sie ab, kehrt der Kunde zur Kasse (oder zum Warenkorb) zurück und sieht The Comgate payment was cancelled or has expired. You can try again or choose another payment method. Ein Kunde kann eine unbezahlte Bestellung erneut bezahlen, zum Beispiel über die Seite Pay for order. Der vorherige Versuch wird zuerst geprüft, sodass eine bereits erfolgte Zahlung nicht doppelt belastet wird, und er wird bei Comgate storniert, falls er noch offen ist. Eine späte Zahlung eines älteren Versuchs bezahlt weiterhin eine unbezahlte Bestellung.

Kann Comgate die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, zum Beispiel The Comgate payment could not be started. Please try again or choose another payment method., dass Comgate diesen Betrag oder diese Währung nicht annimmt oder dass die gewählte Comgate-Zahlungsmethode nicht verfügbar ist. Der technische Grund wird im Protokoll gespeichert.

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 einmalige Zahlungen nur auf der Comgate-Seite. Es bietet keine wiederkehrenden Zahlungen, Abonnements oder gespeicherten Karten, kein eingebettetes Comgate-Checkout, keine Apple-Pay- oder Google-Pay-Schaltflächen auf Ihrer Website (sie sind auf der Comgate-Seite verfügbar) und keine Erfassung oder Stornierung von Vorautorisierungen aus WooCommerce. Ohne die Benachrichtigung wird der Zahlungsstatus nicht automatisch abgefragt; er wird nur geprüft, wenn der Kunde zurückkehrt.

Bestellungen und Erstattungen

Bestellstatus

Pending payment: Der Kunde wurde zu Comgate weitergeleitet und hat noch nicht bezahlt, oder Comgate meldet die Zahlung als ausstehend. Die Bestellnotiz zeigt die angelegte Comgate-Zahlung.

Processing or Completed: Comgate hat die Zahlung als PAID mit demselben Betrag und derselben Währung gemeldet. Der Status richtet sich nach Order Status After Payment. Die Transaktions-ID der Bestellung ist die Comgate-Transaktions-ID; alle Versuche bleiben bei der Bestellung gespeichert. Testzahlungen erhalten die Notiz Comgate test payment — no money was charged.

On hold: Der bezahlte Betrag oder die Währung weicht von der Bestellung ab, eine Testzahlung wurde bestätigt, während der Shop im Live-Modus ist (es ist kein Geld eingegangen), oder die Zahlung ist nur autorisiert (Vorautorisierung auf Ihrem Comgate-Konto). Eine autorisierte Zahlung wird automatisch bezahlt, sobald Sie sie im Comgate-Portal erfassen. Die Bestellnotiz erklärt den Grund.

Cancelled: Die aktuelle Comgate-Zahlung wurde storniert oder ist abgelaufen. Bestätigt Comgate die Zahlung, nachdem WooCommerce die unbezahlte Bestellung storniert hat (zum Beispiel bei einer langsamen Banküberweisung), wird die Bestellung als bezahlt wieder geöffnet, mit einer Notiz, den Bestand vor dem Versand zu prüfen.

Meldet Comgate eine weitere PAID-Zahlung für eine bereits bezahlte Bestellung, wird die Bestellung nicht erneut verändert. Eine Notiz bittet Sie, dies im Comgate-Portal zu prüfen und das Duplikat zu erstatten. Eine wiederholte Bestätigung öffnet nie eine erstattete Bestellung oder eine nach der Zahlung stornierte Bestellung wieder.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Comgate (die Schaltfläche zeigt den Titel der Zahlungsmethode an). Vollständige und Teilerstattungen werden unterstützt. Die Erstattung geht an die bezahlte Comgate-Transaktion und wird im Modus (Test oder Live) der ursprünglichen Zahlung gesendet. Comgate erstattet nur bezahlte Zahlungen und höchstens den bezahlten Betrag; HUF-Erstattungen müssen ganze Forint sein. Akzeptiert Comgate die Erstattung nicht, zeigt WooCommerce den Fehler an, und es wird keine Erstattung verbucht. Eine erfolgreiche Erstattung wird mit Betrag, Comgate-Transaktion und Grund den Bestellnotizen hinzugefügt.

Im Comgate-Portal 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 > Comgate. 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 Comgate 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

Comgate erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist, Merchant ID und Secret ausgefüllt sind, die Bestellwährung unterstützt wird und der Bestellbetrag nicht unter dem Comgate-Mindestbetrag liegt (zum Beispiel 1 CZK, 0,10 EUR oder 100 HUF). Die Einstellungsseite zeigt eine Warnung, wenn Zugangsdaten fehlen oder die Währung nicht unterstützt wird.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt bei Pending payment: Comgate hat die Hintergrundbenachrichtigung nicht zugestellt. Prüfen Sie im Comgate-Portal die URL for passing the payment result, ob Ihre Website über HTTPS aus dem Internet erreichbar ist (kein Wartungsmodus und kein Passwortschutz) und das Protokoll (schalten Sie das Debug Log ein). Comgate wiederholt nicht zugestellte Benachrichtigungen; das Plugin antwortet mit einem Fehler, wenn es eine Benachrichtigung nicht verarbeitet hat, daher wird sie erneut gesendet. Die Bestellung wird auch bestätigt, wenn der Kunde in den Shop zurückkehrt.

Die Benachrichtigung antwortet mit Invalid merchant or secret: Merchant ID oder Secret in den Einstellungen stimmen nicht mit der Shop-Verbindung im Comgate-Portal überein.

Die Benachrichtigung antwortet mit Gateway not configured: Merchant ID oder Secret sind in den Einstellungen leer. Comgate versucht es erneut, sobald beide eingetragen sind.

Die Benachrichtigung antwortet mit Order not found, Unknown transaction oder Reference mismatch: Die Benachrichtigung gehört zu einer Zahlung, die dieser Shop nicht für diese Bestellung angelegt hat. Die Bestellung wird nicht verändert.

Die Benachrichtigung antwortet mit Status verification failed, Status verification rejected oder Busy, retry later: Die Status-API von Comgate war nicht erreichbar, hat die Anfrage abgelehnt, oder die Bestellung wurde im selben Moment von einer anderen Anfrage verarbeitet. Comgate wiederholt die Benachrichtigung.

Der Kunde sieht We could not verify the Comgate payment: Der Rücksprung-Link passte nicht zur Bestellung. Wurde Geld belastet, bestätigt die Benachrichtigung die Bestellung trotzdem. Prüfen Sie die Zahlung im Comgate-Portal, bevor der Kunde erneut bezahlt.

Der Kunde sieht The order total is below the minimum amount accepted by Comgate oder A valid billing e-mail address is required for Comgate payments: Die Bestellung kann so nicht über Comgate bezahlt werden.

Die Bestellung ist nach der Zahlung auf On hold: Lesen Sie die Bestellnotiz. Der bezahlte Betrag oder die Währung wich ab, eine Testzahlung ist im Live-Modus eingegangen, oder die Zahlung ist nur autorisiert. Prüfen Sie die Zahlung im Comgate-Portal und schließen Sie die Bestellung manuell ab oder erstatten Sie sie.

Die Erstattung schlägt fehl: Lesen Sie die Meldung. Comgate rejected the refund: the amount exceeds the refundable amount. bedeutet, dass der Betrag höher ist als der noch erstattbare Betrag; eine Zahlung in einem anderen Status als PAID kann nicht erstattet werden. Comgate could not be reached. The refund was not made — please try again later. bedeutet ein Verbindungsproblem.

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.

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 und die Protokolldateien werden nur entfernt, wenn Delete Data on Uninstall eingeschaltet war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestellungen und ihre Comgate-Daten bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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