VibeFox Comgate for OpenCart — Hilfe

Anforderungen

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

PHP: 8.0 oder neuer.

Internetzugang: Ihr Shop muss aus dem Internet erreichbar sein, ohne Wartungsseite, Firewall oder Passwortschutz vor der Benachrichtigungs-URL, damit Comgate die Hintergrundbenachrichtigung zustellen kann.

Währung: CZK, EUR, PLN, HUF, USD, GBP, RON, HRK, NOK oder SEK. Für andere Währungen und für Beträge unterhalb des Mindestbetrags von Comgate (zum Beispiel 1 CZK, 0.10 EUR oder 100 HUF) wird die Zahlungsart ausgeblendet. HUF-Zahlungen werden, wie von Comgate verlangt, auf ganze Forint gerundet.

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

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

Installation

Das Download-Paket 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 OpenCart-3-Paket wcp_comgate_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_comgate_gateway.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.

OpenCart 3

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_comgate_gateway-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Modifikationen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie den Inhalt des Ordners upload dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Comgate Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Administratorbenutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu bearbeiten.

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. Geben Sie die Merchant ID und das Secret aus dem Comgate-Kundenportal ein und hinterlegen Sie dort die Benachrichtigungs-URL (siehe Konfiguration).

5. Aktivieren Sie Enable / Disable und klicken Sie auf Save. Lassen Sie Test Mode für eine Testzahlung eingeschaltet und schalten Sie ihn danach aus.

OpenCart 4

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_comgate_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 Comgate Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die Comgate-Zugangsdaten und die Benachrichtigungs-URL wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungs- und Rücksprung-URLs unterscheiden sich (siehe Konfiguration).

Eine neue Installation startet mit deaktivierter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Comgate Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn Comgate aktiviert ist, aber Merchant ID oder Secret fehlt (die Zahlungsart wird an der Kasse dann ausgeblendet, bis beide ausgefüllt sind), und wenn die Standardwährung des Shops von Comgate 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. an. Ohne das Recht, die Erweiterung zu bearbeiten, 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 darf nicht negativ sein, und die gewählte Geozone sowie die Bestellstatus müssen vorhanden sein. Schlägt eine Prüfung fehl, wird nichts gespeichert und die Seite listet die Fehler auf.

Comgate

Enable / Disable: Enable Comgate 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: Comgate. Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, den der Kunde im Schritt Confirm Order über dem Bestätigungsbutton sieht. Standard: Pay securely via Comgate — cards, bank transfers, wallets and more. Im Testmodus wird TEST MODE: no real money is charged. ergänzt oder allein angezeigt, wenn die Beschreibung leer ist.

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

Geo Zone: bietet Comgate nur für Rechnungsadressen in der ausgewählten Geozone an. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet.

Total: der Warenkorbbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor Comgate angeboten wird. Lassen Sie das Feld leer, um Comgate bei jedem Betrag anzubieten. Der Mindestbetrag von Comgate für die Währung gilt immer.

Comgate-Verbindung

Übernehmen Sie die Shop-Kennung (Merchant ID) und das Passwort (Secret) aus dem Comgate-Kundenportal unter Integration > shop connection settings (die Seite verlinkt auf das Portal). Tragen Sie dort außerdem die URL for passing the payment result (Hintergrundbenachrichtigung) ein, und zwar die URL aus dem Feld Notification URL in diesem Abschnitt. Unter OpenCart 3 hat sie die Form https://your-store/index.php?route=extension/payment/wcp_comgate_gateway/notify, unter OpenCart 4 die Form https://your-store/index.php?route=extension/wcp_comgate_gateway/payment/wcp_comgate_gateway.notify. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen. Comgate ruft sie nach jeder Zahlung auf; die Erweiterung prüft die Zahlung daraufhin über die Status-API von Comgate erneut, bevor sie die Bestellung ändert. Rücksprung-URLs für den Kunden werden bei jeder Zahlung mitgesendet. Verlangt das Portal zusätzlich Rücksprung-URLs (bezahlt, abgebrochen, ausstehend), verwenden Sie die zweite URL in diesem Abschnitt, die mit back&id=${id}&refId=${refId} endet (unter OpenCart 4 mit wcp_comgate_gateway.back&id=${id}&refId=${refId}).

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

Secret: das Passwort für die Hintergrundkommunikation (Secret) dieser Shop-Verbindung. Ein gespeichertes Secret wird nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um das gespeicherte Secret zu entfernen, aktivieren Sie unter dem Feld Clear the saved secret und klicken Sie auf Save.

Test Mode: erstellt Testzahlungen (es wird kein Geld belastet). Comgate verwendet dieselbe Merchant ID und dasselbe Secret für Test- und Live-Zahlungen; Testzahlungen werden mit test=true markiert. Erstattungen werden immer im Modus der ursprünglichen Zahlung gesendet. Standard: an.

Zahlungsseite

Payment Methods: die Zahlungsarten von Comgate, unter denen der Kunde wählen kann. Angezeigt werden nur die Zahlungsarten, die für Ihren Shop in Comgate aktiviert sind.

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

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Comgate die Zahlung bestätigt hat, entweder über die Hintergrundbenachrichtigung oder wenn der Kunde zurückkehrt; der Status wird immer über die Status-API von Comgate abgefragt. Jedes der folgenden Felder bietet Ihre Bestellstatus aus OpenCart zur Auswahl.

Order Status After Payment: der Status, der gesetzt wird, wenn Comgate die Zahlung bestätigt. Standard: In Bearbeitung.

Comgate Payment On Hold Status: Zahlungen, die nicht zur Bestellung passen, Testzahlungen im Live-Modus und vorautorisierte Zahlungen. Eine Notiz erklärt den Grund. Standard: Zahlung ausstehend, da OpenCart keinen Status Wartend hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Payment Canceled Status: eine vorautorisierte Bestellung, deren Comgate-Zahlung storniert wurde oder abgelaufen ist. Standard: Storniert.

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

Erweitert

Debug Log: schreibt API-Anfragen und Benachrichtigungen in comgate_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden. Das Secret und personenbezogene Daten werden nie protokolliert. Fehler werden immer protokolliert, auch wenn die Option ausgeschaltet ist. Standard: aus.

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

Delete Data on Uninstall: Ist die Option eingeschaltet, entfernt die Deinstallation der Erweiterung die Einstellungen des Gateways und das Protokoll. Bestellungen und ihre Comgate-Transaktionsnummern bleiben immer erhalten. Standard: aus.

Import / Export

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

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Comgate). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the secure Comgate payment page. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung bei Comgate die Zahlung über die Bestellsumme in der Bestellwährung und leitet den Kunden zur Zahlungsseite von Comgate weiter. E-Mail-Adresse und Name des Kunden werden an Comgate übergeben; die Zahlung wird mit Order und der Bestellnummer bezeichnet. Eine gültige E-Mail-Adresse ist erforderlich. Auf der Seite von Comgate bezahlt der Kunde mit einer der von Ihnen erlaubten Zahlungsarten. Unter 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. Fragt der Shop nicht nach einer Rechnungsadresse (Standard bei OpenCart 4), wird das Land der Lieferadresse an Comgate übergeben.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Comgate die Zahlung bestätigt: Die Erweiterung liest die Zahlung über die Status-API von Comgate, sowohl wenn die Hintergrundbenachrichtigung eintrifft als auch wenn der Kunde zurückkehrt. Danach erhält die Bestellung ihren Status auf die übliche Weise von OpenCart, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung. Wurde die Bestellung in die Wartestellung gesetzt, ergänzt die Seite Your payment is being reviewed. We will contact you if anything else is needed. Unter OpenCart 4 sendet der Browser die Sitzung des Shops nicht, wenn Comgate den Kunden zurückschickt. Die Erweiterung zeigt daher zuerst eine kurze Seite, die dieselbe Rücksprung-Adresse erneut aus Ihrem Shop öffnet: Der Kunde behält Warenkorb und Anmeldung.

Ist die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt, etwa bei einer unterwegs befindlichen Banküberweisung, zeigt eine Seite Payment confirmation den Hinweis Comgate has not confirmed your payment yet. Your order will be confirmed automatically as soon as the payment is confirmed — please do not pay again. mit einer Schaltfläche Check again und einer Schaltfläche Back to checkout.

Wird die Zahlung abgebrochen oder läuft sie ab, kehrt der Kunde mit The Comgate payment was cancelled or has expired. You can try again or choose another payment method. zur Kasse zurück. Unter OpenCart 4 werden die Meldungen der Kasse über der Kassenseite angezeigt. Der Warenkorb bleibt erhalten. Bei jedem neuen Versuch (OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird, OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie) prüft die Erweiterung zuerst bei Comgate die früheren Versuche dieses Warenkorbs. Ist einer davon bereits bezahlt, wird seine Bestellung bestätigt und der Kunde gelangt ohne zweite Belastung zur Erfolgsseite; offene Versuche werden bei Comgate storniert. Eine verspätete Zahlung eines älteren Versuchs wird weiterhin erkannt und bestätigt dessen Bestellung. Ein Warenkorb, der bereits durch eine andere Bestellung bezahlt ist, wird nicht erneut belastet: Der Kunde gelangt zur Erfolgsseite.

Unter OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung storniert, schickt Confirm Order den Kunden mit der Meldung über die stornierte Zahlung zurück zur Kasse. Wurde sie auf andere Weise geschlossen (zum Beispiel erstattet oder nach der Zahlung storniert), lautet die Meldung Your previous order is closed (cancelled or refunded). Please confirm the order again: the cart will be paid with a new order. In beiden Fällen bezahlt das nächste Confirm Order eine neue Bestellung des Warenkorbs. Ist die Bestellung bereits bezahlt und der Warenkorb seitdem geändert (andere Produkte oder Mengen), wird der Kunde zur Kasse zurückgeschickt, und der geänderte Warenkorb erhält eine neue Bestellung mit eigener Zahlung.

Kann Comgate die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung über dem Button, 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 akzeptiert oder dass die gewählte Zahlungsart von Comgate nicht verfügbar ist. Der technische Grund wird im Protokoll festgehalten.

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

Die Erweiterung unterstützt nur einmalige Zahlungen auf der Seite von Comgate. Es gibt keine wiederkehrenden Zahlungen, Abonnements oder gespeicherten Karten, keinen eingebetteten Comgate-Checkout, keine Apple-Pay- oder Google-Pay-Schaltflächen in Ihrem Shop (verfügbar sind sie auf der Seite von Comgate) und keine Erfassung oder Stornierung von Vorautorisierungen aus OpenCart. Ohne die Benachrichtigung wird der Zahlungsstatus nicht automatisch abgefragt; er wird nur bei der Rückkehr des Kunden geprüft.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu Comgate weitergeleitet und hat nicht bezahlt, die Zahlung wurde storniert, oder Comgate meldet sie als ausstehend. In Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (default Processing): Comgate hat die Zahlung mit demselben Betrag und derselben Währung als PAID gemeldet. Eine Notiz zeigt die Comgate-Transaktion und den Betrag. Testzahlungen erhalten die Notiz Comgate test payment — no money was charged.

Comgate Payment On Hold Status (default Pending): Der bezahlte Betrag oder die Währung weicht von der Bestellung ab, eine Testzahlung wurde im Live-Modus des Shops bestätigt (es ist kein Geld eingegangen), oder die Zahlung ist nur autorisiert (Vorautorisierung auf Ihrem Comgate-Konto). Eine autorisierte Zahlung wird automatisch als bezahlt markiert, sobald Sie sie im Comgate-Portal erfassen. Die Notiz erklärt den Grund.

Payment Canceled Status (default Canceled): Eine autorisierte Zahlung wurde bei Comgate storniert oder ist abgelaufen. Bestätigt Comgate die Zahlung danach doch, wird die Bestellung als bezahlt wieder geöffnet, mit einer Notiz, den Bestand vor dem Versand zu prüfen.

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

Meldet Comgate eine weitere PAID-Zahlung für eine bereits bezahlte Bestellung, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, dies im Comgate-Portal zu prüfen und das Duplikat zu erstatten. Dasselbe gilt, wenn derselbe Warenkorb mit einer weiteren Bestellung erneut bezahlt wird (zum Beispiel in zwei Browser-Tabs gleichzeitig): Diese Bestellung behält keinen Status, und die bezahlte Bestellung erhält die Notiz. Trifft eine Zahlung für eine Bestellung ein, deren Status Sie inzwischen geändert haben, bleibt der Status unverändert, und eine Notiz bittet Sie, die Bestellung zu prüfen. Eine wiederholte Bestätigung öffnet nie eine erstattete Bestellung erneut.

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

VibeFox Comgate Gateway tab

Öffnen Sie in Sales > Orders eine mit Comgate bezahlte Bestellung. Am unteren Rand der Bestellseite zeigt der Reiter VibeFox Comgate Gateway, neben History und Additional, die Comgate transaction (transId) mit der Kennzeichnung Test mode bei Testzahlungen, den Status, den Payment amount, die Order total / refunded, den Grund für eine Prüfung, das Erstattungsformular, den Erstattungsverlauf und die Comgate notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Reiter VibeFox Comgate Gateway den Amount ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Comgate. Bestätigen Sie die Abfrage Refund this amount through Comgate? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu bearbeiten (festgelegt unter System > Users > User Groups), und Merchant ID und Secret müssen gesetzt sein. Die Erstattung geht an die bezahlte Comgate-Transaktion und wird im Modus (Test oder Live) der ursprünglichen Zahlung gesendet. Comgate erstattet nur PAID-Zahlungen und höchstens den bezahlten Betrag; HUF-Erstattungen müssen ganze Forint sein. Akzeptiert Comgate die Erstattung nicht, zeigt der Reiter den Fehler an und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit Betrag, Comgate-Transaktion und Grund in den Erstattungsverlauf und in die Notizen aufgenommen. 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 teilweise Erstattung ändert den Status nicht.

Erstattungen sind nur für bezahlte Bestellungen verfügbar. Eine Bestellung, die nach einer Abweichung von Betrag oder Währung in der Wartestellung ist, kann nicht aus OpenCart erstattet werden; erstatten Sie sie im Comgate-Portal. Produktrücksendungen unter Sales > Returns schicken kein Geld über Comgate zurück. Im Comgate-Portal vorgenommene Erstattungen werden nicht an den Shop zurückgemeldet.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Comgate Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Comgate 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 gültig 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-comgate und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Administratoren mit der Berechtigung Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Administrationssprache (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 die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der 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 aktiven Schlüssel wird Comgate Kunden an der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Administrator, der im Administrationsbereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, gekennzeichnet als (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Unter OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Administrationsbereich nicht, daher wird ohne aktiven Schlüssel die Zahlungsart für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Administrationsbereichs 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.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard des Administrationsbereichs oder die Seite Edit öffnen: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Beim Deinstallieren der Erweiterung werden Lizenzschlüssel und Lizenzstatus immer entfernt.

Fehlerbehebung

Comgate does not appear at checkout: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist, Merchant ID und Secret ausgefüllt sind, die Kassenwährung unterstützt wird und die Bestellsumme nicht unter dem Mindestbetrag von Comgate liegt (zum Beispiel 1 CZK, 0.10 EUR oder 100 HUF). Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

The payment went through, but the order stays without a status: Comgate hat die Hintergrundbenachrichtigung nicht zugestellt. Prüfen Sie die URL for passing the payment result im Comgate-Portal (genau die Notification URL aus den Einstellungen), ob Ihr Shop aus dem Internet erreichbar ist und das Protokoll (schalten Sie Debug Log ein). Comgate wiederholt nicht zugestellte Benachrichtigungen; die Erweiterung antwortet mit einem Fehler, wenn sie eine Benachrichtigung nicht verarbeitet hat, daher wird sie erneut gesendet. Die Bestellung erhält ihren Status auch, wenn der Kunde in den Shop zurückkehrt.

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

Notification answers Gateway not configured: Merchant ID oder Secret sind in den Einstellungen leer. Comgate versucht es erneut, sobald sie ausgefüllt sind.

Notification answers Unknown transaction, Order not found or Reference mismatch: Die Benachrichtigung gehört zu einer Zahlung, die dieser Shop für diese Bestellung nicht erstellt hat. Es wird nichts verändert.

Notification answers Status verification failed, Status verification rejected or 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. Busy ist auch die Antwort, wenn der Bestellstatus nicht gesetzt werden konnte; der Grund steht im Protokoll. Comgate wiederholt die Benachrichtigung.

The notification URL shows code=1&message=POST%20required in the browser: Das ist normal. Die URL akzeptiert nur Anfragen von Comgate.

The customer sees 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 zahlt.

The customer sees This payment method is not available. Please reload the checkout page.: Die Sitzung der Kasse passt nicht mehr zur Bestellung, oder die Zahlungsart wurde in der Zwischenzeit ausgeschaltet. Der Kunde lädt die Kasse neu.

The customer sees The order total is below the minimum amount accepted by Comgate or A valid billing e-mail address is required for Comgate payments: Die Bestellung kann so nicht mit Comgate bezahlt werden.

Order is in the on-hold status after payment: Lesen Sie die Notizen im Reiter VibeFox Comgate Gateway. Der bezahlte Betrag oder die Währung wich ab, eine Testzahlung kam im Live-Modus an, oder die Zahlung ist nur autorisiert. Prüfen Sie die Zahlung im Comgate-Portal und schließen Sie die Bestellung ab oder erstatten Sie sie manuell.

No refund form in the tab: Der Reiter nennt den Grund: Die Bestellung hat keine bestätigte Comgate-Zahlung, sie ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu bearbeiten, oder Merchant ID und Secret sind nicht gesetzt.

Refund fails: Lesen Sie die Meldung im Reiter. 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.

Für Entwickler: Die OpenCart-Ereignisse comgate_p_currencies (unterstützte Währungen und ihre Mindestbeträge) und comgate_p_create_params (Parameter der Comgate-Zahlung und der Bestellung) ermöglichen es anderen Erweiterungen, diese zu ändern.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Comgate 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 Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (unter OpenCart 4 seine Ereignisse und seine Startaktion, die Comgate im Wartungsmodus durchlässt). Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Merchant ID, Secret, Testmodus, Zahlungsseite, Protokollierung) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Comgate-Transaktionen und Erstattungen bleiben immer erhalten, sodass früher bezahlte Bestellungen auch nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Um unter OpenCart 4 auch die Dateien der Erweiterung zu entfernen, gehen Sie nach der Deinstallation zu Extensions > Installer und klicken neben VibeFox Comgate Gateway in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene −-Schaltfläche), danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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