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

Quickpay-Konto: Sie benötigen zwei Werte aus dem Quickpay-Manager: den API-Schlüssel eines API-Benutzers (zum Erstellen von Zahlungen, Erfassen und Erstatten) und den privaten Schlüssel des Kontos (zum Prüfen der Signatur der Quickpay-Callbacks). In Quickpay muss sonst nichts eingerichtet werden. Ihr Shop muss aus dem Internet erreichbar sein, nicht hinter einem Passwortschutz, damit die Quickpay-Callbacks ankommen können.

VibeFox-Lizenzschlüssel: Erwerb auf vibefox.net. Ein Schlüssel gilt für eine Domain.

Installation

Der Download ist eine einzelne 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_quickpay_gateway-oc3-(Version).ocmod.zip und das OpenCart-4-Paket wcp_quickpay_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_quickpay_gateway-oc3-(Version).ocmod.zip. Die Erweiterung hat keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload aus diesem Paket in das Stammverzeichnis Ihres Shops kopieren.

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

3. Klicken Sie auf Edit (die Stift-Schaltfläche), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite in License key ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Fügen Sie den API-Schlüssel und den privaten Schlüssel aus dem Quickpay-Manager ein und klicken Sie auf Test API key (siehe Konfiguration).

5. Wählen Sie den Erfassungsmodus und den Bestellstatus nach der Zahlung, aktivieren Sie Enable/Disable und klicken Sie auf Save. Solange Ihr Quickpay-Konto im Testmodus ist, aktivieren Sie Test payments und führen Sie eine Zahlung mit einer Quickpay-Testkarte durch.

OpenCart 4

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_quickpay_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung 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 Quickpay 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 Quickpay-Schlüssel und die Einstellungen wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Callback-URL ist anders (siehe Konfiguration).

Eine neue Installation startet mit deaktivierter Zahlungsart.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Quickpay Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Solange weder der API-Schlüssel noch der private Schlüssel gespeichert sind, zeigt die Seite Quickpay needs setup: enter the API key and the private key. Until both are saved the payment method is hidden at checkout. Solange Test payments eingeschaltet ist, erinnert Sie die Seite daran, es auszuschalten, sobald Ihr Quickpay-Konto live geht. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title 1 bis 128 Zeichen lang sein, Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total muss eine Zahl von 0 oder größer sein, und die Geo-Zone sowie jeder Bestellstatus müssen vorhanden sein. Andernfalls wird nichts gespeichert, und die Seite nennt das Feld.

Quickpay

Enable/Disable: Enable Quickpay schaltet die Zahlungsart ein oder aus. Standard: off.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Quickpay. Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, der dem Kunden im Schritt Confirm Order über der Schaltfläche zum Bestätigen angezeigt wird. Standard: Pay securely by card or MobilePay on the Quickpay payment page.

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

Geo Zone: Quickpay nur für Zahlungsadressen in der gewählten Geo-Zone anbieten. Standard: All zones. Geo-Zonen richten Sie unter System > Localisation > Geo Zones ein.

Total: der Warenkorbbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor Quickpay angeboten wird: eine Zahl von 0 oder größer. Lassen Sie das Feld leer, um Quickpay bei jedem Betrag anzubieten.

Quickpay-API-Zugangsdaten

Im Quickpay-Manager (manage.quickpay.net, die Seite enthält Links dorthin) öffnen Sie Settings > Integration. Kopieren Sie den API-Schlüssel eines API-Benutzers (Settings > Users) und den privaten Schlüssel des Kontos.

Callback URL: zeigt die Callback-URL Ihres Shops. Auf OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_quickpay_gateway/callback, auf OpenCart 4 so: https://your-store/index.php?route=extension/wcp_quickpay_gateway/payment/wcp_quickpay_gateway.callback. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Quickpay ruft sie nach jeder Zahlungsoperation auf (Autorisierung, Erfassung, Erstattung, Stornierung). Sie wird bei jeder Zahlung, Erfassung und Erstattung automatisch mitgesendet, daher muss in Quickpay nichts konfiguriert werden.

API key: der API-Schlüssel eines Quickpay-API-Benutzers. Er dient dazu, Zahlungen zu erstellen, zu erfassen und zu erstatten.

Private key: der private Schlüssel des Kontos. Er dient dazu, die Signatur (HMAC-SHA256) der Quickpay-Callbacks zu prüfen. Ohne ihn kann keine Zahlung bestätigt werden, und Callbacks werden abgelehnt.

Gespeicherte Schlüssel werden 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 einen gespeicherten Wert zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved value on save und klicken Sie auf Save.

Test API key: Diese Schaltfläche prüft den im Feld API key eingegebenen Schlüssel (oder den gespeicherten, wenn das Feld leer ist) mit einer authentifizierten Anfrage an Quickpay, ohne ihn zu speichern. Die Antwort lautet Connection successful — the API key is valid., Quickpay rejected the API key., API key is not configured. oder Connection failed: gefolgt vom Grund.

Test payments: akzeptiert Zahlungen mit Quickpay-Testkarten. Quickpay hat keine eigene Sandbox: Solange Ihr Quickpay-Konto im Testmodus ist, werden Zahlungen mit Testkarten getätigt und als Test gekennzeichnet. Schalten Sie diese Option nur während des Testens ein. Ist sie aus, markiert eine Testzahlung eine Bestellung nie als bezahlt. Ist sie an, sieht der Kunde im Schritt Confirm Order den Hinweis Test mode: Quickpay test cards are accepted. Standard: off.

Zahlung

Capture: wann das Geld von der Karte abgebucht wird.

Order status after payment: welchen Status eine bezahlte Bestellung erhält, nachdem Quickpay die erfasste Zahlung bestätigt hat.

Bestellstatus

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst nach dem signierten Quickpay-Callback einen Status. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

"Payment accepted" status: Die erfasste Zahlung wurde bestätigt, und Betrag und Währung stimmen überein. Standard: Processing.

"Delivered (completed)" status: wird stattdessen verwendet, wenn Order status after payment auf Delivered (completed) steht. Standard: Complete.

"Quickpay payment on hold" status: Die Zahlung ist nur autorisiert und wartet auf die Erfassung, der Betrag oder die Währung stimmen nicht überein, oder die Erfassung ist fehlgeschlagen. Standard: Pending, weil OpenCart keinen Status On hold hat; eine Notiz an der Bestellung erklärt den Grund. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Cancelled status: wird gesetzt, wenn die Zahlung einer Bestellung auf Wartezeit im Quickpay-Manager storniert wird. Setzen Sie eine Bestellung dieser Erweiterung auf diesen Status, wird ihr nicht bezahlter Zahlungslink in Quickpay gelöscht (siehe Bestellungen und Erstattungen). Standard: Canceled.

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

Erweitert

Debug log: schreibt in qpg_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über das Web öffnen; bei 5 MB wird sie nach qpg_debug.old.log.php verschoben. Fehler und Warnungen, etwa abgelehnte Callbacks und Fehler der Quickpay-API, werden immer protokolliert. Schalten Sie diese Option ein, um zusätzlich die Details jeder Anfrage und jedes Callbacks zu protokollieren. API-Schlüssel, Kartendaten und Kundendaten werden nie protokolliert. Standard: off.

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

Delete data: ist die Option aktiviert, entfernt die Deinstallation der Erweiterung die Einstellungen der Zahlungsanbindung und das Protokoll. Bestelldaten (Quickpay-Zahlungen, Erstattungen, Notizen) bleiben immer erhalten. Standard: off.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Der API-Schlüssel und der private Schlüssel werden nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Quickpay). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the Quickpay payment window to complete the payment. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Quickpay-Zahlung in der Bestellwährung und einen Zahlungslink für den Bestellbetrag und leitet den Kunden zum Quickpay-Zahlungsfenster weiter. Dort zahlt der Kunde mit einer der Methoden, die in Ihrem Quickpay-Zahlungsfenster aktiviert sind. Die E-Mail-Adresse des Kunden wird an Quickpay übergeben. Das Zahlungsfenster öffnet sich in der Sprache des Kunden, wenn Quickpay sie anbietet (Dänisch, Deutsch, Englisch, Spanisch, Finnisch, Französisch, Italienisch, Niederländisch, Norwegisch, Polnisch, Schwedisch), andernfalls auf Englisch. Auf OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose des Zahlungsartenblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Rückkehr selbst markiert nichts als bezahlt. Die Bestellung wird erst als bezahlt markiert, wenn Quickpay die Zahlung bestätigt: Der signierte Callback setzt den Bestellstatus, sobald der erfasste Betrag und die Währung mit der Bestellung übereinstimmen. Die Bestellung erhält ihren Status dann auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung. Bei Authorize only erhält die Bestellung stattdessen den Status "Quickpay payment on hold" status, und Sie erfassen die Zahlung später. Ist der Callback beim Zurückkehren des Kunden noch nicht angekommen, zeigt eine Seite Payment confirmation den Hinweis Your payment is being confirmed by Quickpay. You will receive an e-mail as soon as the order is confirmed. mit den Schaltflächen Check again und Back to checkout. Wenn der Quickpay-Callback eine Bestellung später vom Status "Quickpay payment on hold" status in den Bezahlt-Status oder in den Cancelled status überführt, wird der Kunde per E-Mail benachrichtigt.

Bricht der Kunde im Zahlungsfenster ab, wird der Zahlungslink in Quickpay gelöscht, und der Kunde landet zurück an der Kasse mit The payment was cancelled. You can try again or choose another payment method. Wurde die Karte abgelehnt, lautet die Meldung The payment was not completed. You can try again or choose another payment method. Der Warenkorb bleibt erhalten. Ein erneuter Versuch derselben Bestellung erhält einen neuen Link derselben Quickpay-Zahlung. OpenCart 3 legt jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung an; die Zahlungslinks früherer Bestellungen desselben Warenkorbs werden dann gelöscht, damit ein alter Link nie parallel bezahlt werden kann. Solange eine Zahlung des Warenkorbs autorisiert ist und auf ihre Erfassung wartet, wird keine zweite Zahlung gestartet; der Kunde sieht die Seite Payment confirmation.

Auf OpenCart 4 werden die Meldungen zu Abbruch und Ablehnung über der Kassenseite angezeigt. OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie jedes Mal, wenn der Schritt Confirm Order angezeigt wird; nach einem Abbruch oder einer Ablehnung wird daher dieselbe Bestellung mit einem neuen Link derselben Quickpay-Zahlung bezahlt. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen, wird der Kunde mit Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. zur Kasse zurückgeschickt, und das nächste Confirm Order bezahlt eine neue Bestellung. Hat die Bestellung der Kasse bereits einen Status, der Warenkorb hat sich seitdem aber geändert, auch durch eine neue Menge, wird der Kunde zur Kasse zurückgeschickt, und der neue Warenkorb wird mit einer neuen Bestellung bezahlt.

Kann die Zahlung nicht gestartet werden, bleibt der Kunde im Schritt Confirm Order und sieht über der Schaltfläche The Quickpay payment could not be started. Please try again or choose another payment method. Der technische Grund wird ins Protokoll geschrieben. Fehlen die Schlüssel, lautet die Meldung Quickpay is not available at the moment. Please choose another payment method.

Der Callback und die Rückkehr des Kunden funktionieren auch im Wartungsmodus des Shops. OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und auf OpenCart 4 fügt die Erweiterung dafür eine Startaktion hinzu.

Die Erweiterung unterstützt nur Einmalzahlungen. Sie bietet keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten und keine Teilerfassung, sendet keine Warenkorb- oder Rechnungspositionen an Quickpay und hat keine eigenen Methoden für MobilePay, Apple Pay oder Klarna: Der Kunde wählt unter den Methoden Ihres Quickpay-Zahlungsfensters.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu Quickpay geschickt und hat nicht bezahlt, die Karte wurde abgelehnt, oder die Zahlung ist autorisiert und wartet auf die automatische Erfassung. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

„Payment accepted“ oder „Delivered (completed)“ status: Quickpay hat die erfasste Zahlung mit dem richtigen Betrag und der richtigen Währung bestätigt. Der Status richtet sich nach Order status after payment. Eine Notiz zeigt die Quickpay-Zahlungs-ID (bei Testzahlungen mit TEST gekennzeichnet).

„Quickpay payment on hold“ status (Standard Pending): Die Zahlung ist nur autorisiert und wartet auf Capture Quickpay payment; oder Quickpay meldete einen anderen Betrag oder eine andere Währung als den Bestellbetrag (zum Beispiel wurde im Quickpay-Manager ein anderer Betrag erfasst); oder die Erfassung ist fehlgeschlagen, und der Betrag ist nur noch reserviert. Die Notiz erklärt es. Wurde Geld mit einem abweichenden Betrag erfasst, speichert die Erweiterung den von Quickpay erfassten Betrag, und Erstattungen sind bis zu diesem Betrag möglich.

Cancelled status: Die Zahlung einer Bestellung auf Wartezeit wurde im Quickpay-Manager storniert.

Refunded status: Die Zahlung wurde über die Erweiterung vollständig erstattet.

Eine Zahlung, die für eine bereits bezahlte, stornierte oder erstattete Bestellung eingeht, ändert die Bestellung nicht. Eine Notiz bittet Sie, die Zahlung im Quickpay-Manager zu prüfen, zum Beispiel um eine doppelte Zahlung zu erstatten. Wurde eine andere Bestellung desselben Warenkorbs bereits bezahlt, bleibt die neue Bestellung ohne Status, und die bezahlte Bestellung erhält die Notiz.

Setzen Sie im History einer unbezahlten Bestellung dieser Erweiterung den Cancelled status, wird ihr Zahlungslink in Quickpay gelöscht. Das Stornieren einer autorisierten Bestellung gibt den reservierten Betrag nicht automatisch frei: Eine Notiz erinnert Sie, die Zahlung im Quickpay-Manager zu stornieren; andernfalls endet die Reservierung mit dem Ablauf der Autorisierung.

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

Reiter VibeFox Quickpay Gateway

Öffnen Sie unter Sales > Orders eine mit Quickpay bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Quickpay Gateway die Payment ID mit der Kennzeichnung Test payment bei Testzahlungen, den Status der Zahlung, Amount / refunded, die Liste aller Quickpay-Zahlungen der Bestellung (wenn es mehr als eine gibt), die Schaltfläche zur Erfassung, das Erstattungsformular, den Erstattungsverlauf und die Quickpay notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben. Erfassung und Erstattungen erfordern das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups).

Erfassung

Bei Authorize only klicken Sie im Reiter auf Capture Quickpay payment und bestätigen Sie Capture the order total through Quickpay? Der Bestellbetrag wird erfasst; eine Teilerfassung ist nicht verfügbar. Bestätigt Quickpay sofort, wird die Bestellung auf den Bezahlt-Status von Order status after payment gesetzt, ohne den Kunden zu benachrichtigen und ohne den Bestand zu ändern, wie bei einer manuellen Statusänderung. Andernfalls zeigt eine Notiz, dass die Erfassung angefordert wurde, und die Bestellung wird als bezahlt markiert, sobald der Quickpay-Callback sie bestätigt. Eine abgelehnte Erfassung wird im Reiter angezeigt und an der Bestellung vermerkt.

Erstattungen

Geben Sie im Reiter den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Quickpay. Bestätigen Sie die Abfrage Refund this amount through Quickpay? This cannot be undone. Vollständige und teilweise Erstattungen sind für erfasste Zahlungen möglich. Erstattungen erfolgen in dem Betrag und in der Währung, die Quickpay erfasst hat, nicht im Bestellbetrag. Quickpay verarbeitet Erstattungen asynchron: Der Erstattungsverlauf zeigt requested, und der Callback setzt den Status auf confirmed oder failed und fügt das Ergebnis den Notizen hinzu. Eine fehlgeschlagene Erstattung gilt nicht als erstattet. Lehnt Quickpay die Erstattung sofort ab, zeigt der Reiter den Fehler, und es wird keine Erstattung erfasst. Eine vollständige Erstattung setzt die Bestellung auf den Refunded status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen; eine teilweise Erstattung ändert den Status nicht. Eine autorisierte, nie erfasste Zahlung kann nicht erstattet werden; stornieren Sie sie im Quickpay-Manager.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über Quickpay.

Direkt im Quickpay-Manager vorgenommene Erstattungen werden nur den Notizen hinzugefügt. Der Bestellstatus ändert sich nicht automatisch. Aktualisieren Sie ihn bei Bedarf manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Quickpay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Quickpay Gateway > Edit, über den 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 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: opencart-payment-quickpay und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Administratorbenutzer mit dem Recht Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Administrationsbereichs (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 die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt für eine Domain: die 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 Quickpay Kunden an der Kasse nicht angezeigt. Wird trotzdem 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, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher wird die Zahlungsart ohne aktiven Schlüssel 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 Erfassung und Erstattungen funktionieren.

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

Fehlerbehebung

Quickpay erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und sowohl API key als auch Private key gespeichert sind. Ohne beide Schlüssel wird die Zahlungsart ausgeblendet, und die Einstellungsseite zeigt eine Warnung. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: Der Quickpay-Callback hat Ihren Shop nicht erreicht oder wurde abgelehnt. Prüfen Sie, ob Ihr Shop aus dem Internet erreichbar ist (kein Passwortschutz), und ob der Private key der private Schlüssel desselben Quickpay-Kontos ist. Abgelehnte Callbacks werden immer im Protokoll der Erweiterungsseite vermerkt. Schalten Sie Debug log ein, um jeden Callback zu sehen.

Das Protokoll zeigt Callback rejected: invalid checksum.: Der private Schlüssel in den Einstellungen gehört nicht zu dem Konto, das den Callback gesendet hat. Kopieren Sie ihn erneut unter Settings > Integration im Quickpay-Manager.

Das Protokoll zeigt Callback rejected: the private key is not configured.: Geben Sie den privaten Schlüssel ein. Callbacks werden ohne ihn nie angenommen.

Das Protokoll zeigt Callback: no order found for payment …: Der Callback gehört zu einer Quickpay-Zahlung, die dieser Shop nicht erstellt hat, zum Beispiel zu einer Zahlung außerhalb von OpenCart.

Das Protokoll zeigt, dass der Warenkorb von einer anderen Anfrage gesperrt ist: Ein anderer Callback desselben Warenkorbs wurde in diesem Moment verarbeitet. Der Callback wird mit einem Fehler beantwortet, sodass Quickpay ihn erneut sendet.

Eine Testzahlung hat die Bestellung nicht als bezahlt markiert: Test payments ist ausgeschaltet. Das Protokoll und eine Notiz an der Bestellung zeigen, dass die Testzahlung nicht akzeptiert wurde. Schalten Sie die Option während des Testens ein und aus, sobald Ihr Konto live geht.

Die Bestellung ist nach der Zahlung im Wartestatus: Lesen Sie die Notizen im Reiter VibeFox Quickpay Gateway. Die Zahlung ist möglicherweise nur autorisiert und wartet auf Capture Quickpay payment, der erfasste Betrag oder die Währung weicht vom Bestellbetrag ab, oder die Erfassung ist fehlgeschlagen. Erfassen Sie die Zahlung, bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.

Test API key meldet Quickpay rejected the API key.: Der Schlüssel ist falsch oder gehört einem Benutzer ohne API-Zugriff. Kopieren Sie den API-Schlüssel eines API-Benutzers aus dem Quickpay-Manager.

Der Kunde sieht The Quickpay payment could not be started.: Sehen Sie im Feld Log auf der Seite der Erweiterung nach. Dort steht der Fehler von Quickpay, zum Beispiel eine Währung, die Ihr Quickpay-Konto nicht akzeptiert.

Eine Erstattung schlägt fehl: Die Bestellung muss eine erfasste Quickpay-Zahlung haben. Die Meldung The Quickpay payment of this order has not been captured — there is nothing to refund. bedeutet, dass die Zahlung nur autorisiert ist; erfassen oder stornieren Sie sie im Quickpay-Manager. Invalid refund amount: at most … bedeutet, dass der Betrag höher ist als der Rest der erfassten Zahlung.

Für Entwickler: Vor der Erstellung des Zahlungslinks löst die Erweiterung das OpenCart-Ereignis qpg_quickpay_link_data mit den Parametern des Links und der Bestellung aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Quickpay 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 Status im Abschnitt Order statuses, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (auf OpenCart 4 außerdem seine Ereignisse und seine Startaktion, die Callback und Rückkehr des Kunden im Wartungsmodus durchlassen). Ist Delete data aktiviert, werden die übrigen Einstellungen der Zahlungsanbindung (Titel, Beschreibung, Schlüssel, Testzahlungen, Erfassung, Protokollierung) und das Protokoll entfernt. Ist sie deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die Quickpay-Zahlungen und Erstattungen bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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