VibeFox Comgate 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 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 Summen unter dem Mindestbetrag von Comgate 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 die dort hinterlegte Benachrichtigungs-URL (siehe Konfiguration). Comgate verwendet dieselbe Merchant ID und dasselbe Secret für Test- und Live-Zahlungen.

VibeFox-Lizenzschlüssel: Er wird auf vibefox.net gekauft. Ein Schlüssel gilt 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.

2. Klicken Sie nach Abschluss des Uploads auf Configure, oder suchen Sie VibeFox Comgate Gateway später in der Modulliste und klicken Sie dort auf Configure.

3. Geben 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. Tragen 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 es danach aus.

Bei der Installation legt das Modul den Bestellstatus Comgate payment on hold an. PrestaShop bietet eine neue Zahlungsart 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 Comgate Gateway > Configure. Jeder Bereich hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder warnt die Seite, wenn Comgate aktiviert ist, aber Merchant ID oder Secret fehlen (die Zahlungsart wird dann im Checkout 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.

Comgate

Enable / Disable: Enable Comgate Payment Gateway schaltet die Zahlungsart ein oder aus. Default: off.

Title: der Name der Zahlungsart, den Kunden im Checkout sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert. Default: Comgate. Pflichtfeld.

Description: der Text, der im Checkout unter der Zahlungsart angezeigt wird. Default: Pay securely via Comgate — cards, bank transfers, wallets and more. Im Testmodus wird TEST MODE: no real money is charged. angehängt, oder dieser Hinweis allein angezeigt, wenn die Beschreibung leer ist.

Comgate-Verbindung

Die Shop-Kennung (Merchant ID) und das Passwort (Secret) entnehmen Sie dem Comgate-Kundenportal unter Integration > shop connection settings. Setzen Sie dort außerdem die URL for passing the payment result (Hintergrundbenachrichtigung) auf die URL, die in diesem Bereich unter Notification URL angezeigt wird. Mit suchmaschinenfreundlichen URLs sieht sie etwa so aus: https://your-shop/module/wcp_comgate_gateway/webhook, eventuell mit einem Sprachcode wie /en/. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen. Comgate ruft sie nach jeder Zahlung auf; das Modul prüft die Zahlung dann über die Status-API von Comgate, bevor es etwas ändert. Rückkehr-URLs für den Kunden werden mit jeder Zahlung übermittelt. Falls das Portal außerdem Rückkehr-URLs (bezahlt, abgebrochen, ausstehend) verlangt, verwenden Sie die zweite URL aus diesem Bereich, die auf return?id=${id}&refId=${refId} endet.

Merchant ID: die Shop-Kennung (Merchant) bei 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 wollen.

Gespeichertes Secret löschen: Setzen Sie den Haken und klicken Sie auf Save, um das gespeicherte Secret zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Test Mode: erstellt Testzahlungen (es wird kein Geld abgebucht). 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. Default: on.

Zahlungsseite

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

Language: die Sprache der Comgate-Zahlungsseite. Automatic (shop 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.

Zahlungen, die nicht zur Bestellung passen, Testzahlungen im Livemodus und vorautorisierte Zahlungen werden immer auf Comgate payment on hold gesetzt.

Erweitert

Debug Log: schreibt API-Anfragen und Benachrichtigungen in logs/comgate_p_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. Das Secret und personenbezogene Daten werden nie protokolliert. Fehler werden immer protokolliert. Default: off.

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

Delete Data on Uninstall: Ist die Option eingeschaltet, entfernt die Deinstallation des Moduls die Einstellungen des Gateways und das Protokoll. Bestellungen und ihre Comgate-Transaktions-IDs bleiben immer erhalten. Default: off.

Checkout

Im Zahlungsschritt wählt der Kunde die Zahlungsart (standardmäßig Comgate) und bestätigt die Bestellung. Das Modul legt die Zahlung bei Comgate für die Warenkorbsumme in der Warenkorbwährung an und leitet den Kunden zur Zahlungsseite von Comgate weiter. E-Mail-Adresse und Name des Kunden werden an Comgate übergeben, und die Zahlung wird mit Cart und der Warenkorbnummer gekennzeichnet. Eine gültige E-Mail-Adresse ist erforderlich. Auf der Comgate-Seite bezahlt der Kunde mit einer der von Ihnen erlaubten Methoden. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, nachdem Comgate die Zahlung bestätigt hat: Das Modul liest die Zahlung über die Status-API von Comgate aus, sowohl wenn die Hintergrundbenachrichtigung eintrifft als auch wenn der Kunde zurückkehrt. Danach wird die Bestellung angelegt, und der Kunde sieht die übliche Bestellbestätigungsseite. Wurde die Bestellung auf Halt gesetzt, ergänzt die Seite den Hinweis Your payment is being reviewed. We will contact you if anything else is needed. Wurde eine vorautorisierte Bestellung später storniert, zeigt die Seite Your Comgate payment was not completed. Please contact us about this order. an.

Wenn die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt ist, zum Beispiel bei einer Banküberweisung auf dem Weg, zeigt eine Seite Payment confirmation den Hinweis Comgate has not confirmed your payment yet. Your order will be created 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 zum Checkout zurück, mit dem Hinweis The Comgate payment was cancelled or has expired. You can try again or choose another payment method. Der Warenkorb bleibt erhalten. Bei jedem neuen Versuch wird zuerst der vorherige geprüft, sodass eine bereits erfolgte Zahlung nicht doppelt abgebucht wird, und der vorherige Versuch wird bei Comgate storniert, falls er noch offen ist. Eine späte Zahlung eines älteren Versuchs legt die Bestellung trotzdem an.

Kann Comgate die Zahlung nicht starten, bleibt der Kunde im Checkout mit einer kurzen 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 annehmen kann oder dass die gewählte Comgate-Zahlungsart nicht verfügbar ist. Der technische Grund wird ins Protokoll geschrieben.

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

Das Modul verarbeitet Einmalzahlungen nur auf der Comgate-Seite. Es bietet keine wiederkehrenden Zahlungen, Abonnements oder gespeicherten Karten, kein eingebettetes Comgate-Checkout, keine Apple Pay- oder Google Pay-Buttons auf Ihrer Website (sie sind auf der Comgate-Seite verfügbar) und keine Erfassung oder Stornierung von Vorautorisierungen aus PrestaShop. Ohne die Benachrichtigung wird der Zahlungsstatus nicht automatisch abgefragt; er wird nur bei der Rückkehr des Kunden geprüft.

Bestellungen und Erstattungen

Bestellstatus

Noch keine Bestellung: Der Kunde wurde zu Comgate weitergeleitet und hat noch nicht bezahlt, oder Comgate meldet die Zahlung als ausstehend. Es existiert nur der Warenkorb.

Payment accepted or Delivered: Comgate hat die Zahlung als PAID mit demselben Betrag und derselben Währung gemeldet. Der Status richtet sich nach Order Status After Payment. Die Zahlung wird mit der Comgate-Transaktions-ID erfasst. Testzahlungen erhalten die Notiz Comgate test payment — no money was charged.

Comgate payment on hold: Der gezahlte Betrag oder die Währung weicht von der Bestellung ab, eine Testzahlung wurde im Livemodus bestätigt (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 Notiz erklärt den Grund.

Canceled: Eine autorisierte Zahlung wurde bei Comgate storniert oder ist abgelaufen. Bestätigt Comgate die Zahlung danach trotzdem, wird die Bestellung mit einer Notiz wieder als bezahlt geöffnet, die Sie auffordert, vor dem Versand den Lagerbestand zu prüfen.

Refunded: Die Zahlung wurde über das Modul 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. Eine wiederholte Bestätigung öffnet nie eine erstattete Bestellung erneut.

Comgate-Zahlungsblock

Die Bestellseite zeigt einen Block Comgate payment mit der Transaktions-ID, dem Comgate-Status, dem Zahlungsbetrag, der Bestellsumme und dem erstatteten Betrag, einem Abzeichen Test mode für Testzahlungen, dem Grund für eine Prüfung, dem Erstattungsverlauf und den Comgate notes der Bestellung.

Erstattungen

Geben Sie im Block Comgate payment den Betrag ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Grund, und klicken Sie auf Refund via Comgate. Bestätigen Sie die Abfrage Refund this amount through Comgate? This cannot be undone. Vollständige und Teilerstattungen werden unterstützt. Sie benötigen das Recht, Bestellungen zu bearbeiten; der Zugriff auf die Modulseiten ist nicht nötig. 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. Lehnt Comgate die Erstattung ab, zeigt der Block den Fehler, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit Betrag, Comgate-Transaktion und Grund dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded. Eine Teilerstattung ändert den Status nicht.

Erstattungen sind nur für bezahlte Bestellungen möglich. Eine Bestellung, die nach einer Abweichung bei Betrag oder Währung auf Halt steht, kann nicht aus PrestaShop erstattet werden; erstatten Sie sie im Comgate-Portal. Das Modul erstellt keine Gutschriften. Die Standard-Erstattungsschaltflächen von PrestaShop auf der Bestellseite überweisen kein Geld über Comgate zurück. Im Comgate-Portal vorgenommene Erstattungen werden dem Shop nicht gemeldet.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Comgate Gateway ist der erste Block unter Modules > Module Manager > VibeFox Comgate Gateway > Configure, oberhalb der Einstellungen. Geben 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 gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-payment-comgate 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 in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain: die Domain des Hauptshops, auch bei einem Multistore-Setup. 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 Comgate im Checkout nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Die Storefront weiß nicht, dass Sie im Back Office angemeldet sind, daher wird die Zahlungsart auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht im Checkout testen. Ein Hinweis erscheint unter Modules > Module Manager auf der Registerkarte 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, doch Updates und Support erfordern eine Verlängerung. Der Status wird beim Arbeiten im Back Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Die Deinstallation oder das Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Comgate erscheint nicht im Checkout: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist, Merchant ID und Secret ausgefüllt sind, die Warenkorbwä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 unter Payment > Preferences, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe erlaubt ist.

Die Zahlung war erfolgreich, aber es wurde keine Bestellung angelegt: 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 über HTTPS aus dem Internet erreichbar ist und das Protokoll (schalten Sie Debug Log ein). Comgate wiederholt nicht zugestellte Benachrichtigungen; das Modul antwortet mit einem Fehler, wenn es eine Benachrichtigung nicht verarbeitet hat, sodass sie erneut gesendet wird. Die Bestellung wird auch angelegt, wenn der Kunde in den Shop zurückkehrt.

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

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

Die Benachrichtigung antwortet Unknown transaction, Order not found oder Reference mismatch: Die Benachrichtigung gehört zu einer Zahlung, die dieser Shop für diesen Warenkorb nicht angelegt hat. Es wird nichts geändert.

Die Benachrichtigung antwortet Status verification failed, Status verification rejected oder Busy, retry later: Die Status-API von Comgate war nicht erreichbar, hat die Anfrage abgelehnt, oder der Warenkorb wurde im selben Moment von einer anderen Anfrage verarbeitet. Busy wird auch zurückgegeben, wenn die Bestellung nicht angelegt werden konnte; der Grund steht im Protokoll. Comgate wiederholt die Benachrichtigung.

Die Benachrichtigungs-URL zeigt im Browser code=1&message=POST%20required: Das ist normal. Die URL akzeptiert nur Anfragen von Comgate.

Der Kunde sieht We could not verify the Comgate payment: Der Rücklink passte nicht zum Warenkorb. Wurde Geld abgebucht, legt die Benachrichtigung die Bestellung trotzdem an. 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: Der Warenkorb kann so nicht über Comgate bezahlt werden.

Die Bestellung steht nach der Zahlung auf Comgate payment on hold: Lesen Sie die Notizen im Block Comgate payment. Der gezahlte Betrag oder die Währung war abweichend, eine Testzahlung kam im Livemodus an, 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.

Erstattung schlägt fehl: Lesen Sie die Meldung im Block. 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.

Deinstallation

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

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