VibeFox Quickpay for WooCommerce — Hilfe

Anforderungen

WordPress: 6.2 oder neuer.

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

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 (zur Prüfung der Signatur von Quickpay-Callbacks). In Quickpay muss sonst nichts eingerichtet werden. Ihre Website muss aus dem Internet erreichbar sein, nicht hinter einem Passwortschutz oder im Wartungsmodus, damit Quickpay-Callbacks ankommen können.

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. Sie können den Ordner wcp_quickpay_gateway auch per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Quickpay > Manage, oder klicken Sie auf der Seite Plugins unter dem Namen des Plugins auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. 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).

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

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Quickpay. Solange API-Schlüssel und privater Schlüssel nicht eingegeben sind, wird Quickpay in der Liste der Zahlungsmethoden als einrichtungsbedürftig markiert und an der Kasse ausgeblendet, da eine Zahlung weder erstellt noch bestätigt werden könnte.

Allgemein

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

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

Description: der Text unter der Zahlungsmethode an der Kasse. Standard: Pay securely by card or MobilePay on the Quickpay payment page.

Quickpay-API-Zugangsdaten

Öffnen Sie im Quickpay-Manager (manage.quickpay.net) Settings > Integration. Kopieren Sie den API-Schlüssel eines API-Benutzers (Settings > Users) und den privaten Schlüssel des Kontos. Der Bereich zeigt außerdem die Callback-URL Ihres Shops, die etwa so aussieht: https://your-site/wc-api/qpg_quickpay/. Sie wird bei jeder Zahlung automatisch übermittelt, daher muss in Quickpay nichts konfiguriert werden.

API key: der API-Schlüssel eines Quickpay-API-Benutzers. Er wird zum Erstellen von Zahlungen, Erfassen und Erstatten verwendet.

Unter dem Feld prüft die Schaltfläche Test API key den eingegebenen Schlüssel (oder den gespeicherten, wenn das Feld leer ist) mit einer authentifizierten Anfrage an Quickpay. Sie antwortet mit Connection successful — the API key is valid., Quickpay rejected the API key., API key is not configured. oder Connection failed: gefolgt vom Grund.

Private key: der private Schlüssel des Kontos. Er wird zur Prüfung der Signatur (HMAC-SHA256) von Quickpay-Callbacks verwendet. Ohne ihn kann keine Zahlung bestätigt werden, und Callbacks werden abgelehnt.

Test payments: Accept payments made with Quickpay test cards. Quickpay hat keine separate Sandbox: Solange Ihr Quickpay-Konto im Testmodus ist, werden Zahlungen mit Testkarten durchgeführt und als Test gekennzeichnet. Aktivieren Sie dies nur während des Testens. Ist es ausgeschaltet, markiert eine Testzahlung eine Bestellung nie als bezahlt, sondern die Bestellung erhält stattdessen eine Notiz. Ist es eingeschaltet, zeigt die Kasse Test mode: Quickpay test cards are accepted. an. Standard: aus.

Zahlung

Capture: wann das Geld von der Karte abgebucht wird.

Order status after payment: der Bestellstatus, sobald Quickpay die erfasste Zahlung bestätigt hat. Der Status wird sofort gesetzt, mit einer Statusänderung und einem einzigen Satz E-Mails.

Erweitert

Debug log: Enable logging. Das Protokoll finden Sie unter WooCommerce > Status > Logs, Quelle wcp_quickpay_gateway. Fehler und Warnungen, etwa abgelehnte Callbacks und Quickpay-API-Fehler, werden immer protokolliert. Aktivieren Sie dies, um auch jede Anfrage und jeden Callback zu protokollieren. API-Schlüssel, Kartendaten und Kundendaten werden nie protokolliert. Standard: aus.

Delete data: Delete the gateway settings and logs when the plugin is deleted. Das Deaktivieren des Plugins löscht nie etwas. Bestelldaten (Quickpay-Zahlungs-IDs, Notizen) bleiben immer erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig Quickpay, angezeigt mit den Visa- und Mastercard-Symbolen) und gibt die Bestellung auf. Das Plugin erstellt für die Bestellung eine Quickpay-Zahlung in der Bestellwährung sowie 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 Rechnungs-E-Mail wird an Quickpay übergeben. Das Zahlungsfenster öffnet sich in der Sprache Ihrer Website, sofern Quickpay diese anbietet (Dänisch, Deutsch, Englisch, Spanisch, Finnisch, Französisch, Italienisch, Niederländisch, Norwegisch, Polnisch, Schwedisch), andernfalls auf Englisch.

Nach der Zahlung kehrt der Kunde zur Bestellbestätigungsseite Ihres Shops zurück. Die Rückkehr selbst markiert nichts als bezahlt. Die Bestellung wird erst als bezahlt markiert, wenn Quickpay sie mit dem signierten Callback bestätigt und Betrag und Währung mit der Bestellung übereinstimmen. Bei Authorize only wird die Bestellung stattdessen auf Wartend gesetzt, und Sie erfassen die Zahlung später.

Bricht der Kunde im Zahlungsfenster während des Bestellvorgangs ab, wird die unbezahlte Bestellung auf die übliche WooCommerce-Weise storniert und der Warenkorb wiederhergestellt. Auf der Seite Pay for order führt der Abbruch den Kunden zurück zu dieser Seite, sodass die Bestellung weiterhin bezahlbar bleibt. Ein fehlgeschlagener oder abgebrochener Versuch kann erneut gestartet werden: Der neue Versuch verwendet die Quickpay-Zahlung der Bestellung mit einem neuen Link, sodass ein alter Link nie parallel bezahlt werden kann. Wird eine unbezahlte Bestellung storniert, wird ihr Zahlungslink in Quickpay gelöscht.

Kann die Zahlung nicht gestartet werden, sieht der Kunde The Quickpay payment could not be started. Please try again or choose another payment method. Der technische Grund wird den Bestellnotizen und dem Protokoll hinzugefügt. Fehlen die Schlüssel, sieht der Kunde Quickpay is not available at the moment. Please choose another payment method.

Die Zahlungsmethode funktioniert in 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 unterstützt nur Einmalzahlungen. Es gibt keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten und keine Zahlungsgebühren, es werden keine Warenkorb- oder Rechnungspositionen an Quickpay übermittelt, und es gibt keine eigenen Methoden MobilePay, Apple Pay oder Klarna: Der Kunde wählt unter den Methoden Ihres Quickpay-Zahlungsfensters.

Bestellungen und Erstattungen

Bestellstatus

Pending payment: der Kunde wurde an Quickpay weitergeleitet und hat noch nicht bezahlt. Bei automatischer Erfassung wird eine autorisierte Zahlung, die auf die Erfassung wartet, in der Bestellung vermerkt.

Processing or Completed: Quickpay hat die erfasste Zahlung mit dem richtigen Betrag und der richtigen Währung bestätigt. Der Status folgt Order status after payment. Die Bestellnotiz zeigt die Quickpay-Zahlungs-ID (bei Testzahlungen mit TEST gekennzeichnet), und sie wird als Transaktions-ID der Bestellung gespeichert.

On hold: 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 (etwa weil die Bestellung nach Beginn der Zahlung geändert wurde oder im Quickpay-Manager ein anderer Betrag erfasst wurde); oder die Erfassung ist fehlgeschlagen und der Betrag ist weiterhin nur reserviert. Die Bestellnotiz erklärt dies, auch wenn die Bestellung bereits Wartend war.

Failed: der Zahlungsversuch wurde abgelehnt. Der Kunde kann erneut bezahlen.

Cancelled: der Kunde hat im Zahlungsfenster abgebrochen, die Bestellung wurde von Ihnen oder durch das WooCommerce-Zeitlimit für die Lagerreservierung storniert, oder die Zahlung wurde im Quickpay-Manager storniert.

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, etwa um eine doppelte Zahlung zu erstatten.

Erfassung

Bei Authorize only öffnen Sie die Bestellung, wählen in den Bestellaktionen Capture Quickpay payment und klicken auf die Aktualisieren-Schaltfläche. Der Bestellbetrag wird erfasst; Teilerfassung ist nicht verfügbar. Bestätigt Quickpay sofort, wird die Bestellung als bezahlt markiert. Andernfalls zeigt eine Notiz, dass die Erfassung angefordert wurde, und die Bestellung wird als bezahlt markiert, sobald der Quickpay-Callback dies bestätigt. Eine abgelehnte Erfassung wird auf der Bestellseite angezeigt und in der Bestellung vermerkt.

Das Stornieren einer autorisierten Bestellung gibt den reservierten Betrag nicht automatisch frei. Die Bestellnotiz erinnert Sie daran, die Zahlung im Quickpay-Manager zu stornieren; andernfalls endet die Reservierung, wenn die Autorisierung abläuft.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Quickpay. Vollständige und teilweise Erstattungen sind für erfasste Zahlungen möglich. Quickpay verarbeitet Erstattungen asynchron: Eine Notiz zeigt, dass die Erstattung angefordert wurde, und der Callback ergänzt das endgültige Ergebnis, confirmed oder FAILED mit dem Grund. Lehnt Quickpay die Erstattung sofort ab, zeigt WooCommerce den Fehler an, und es wird keine Erstattung verbucht. Eine autorisierte Zahlung, die nie erfasst wurde, kann nicht erstattet werden; stornieren Sie sie im Quickpay-Manager.

Im Quickpay-Manager direkt vorgenommene Zahlungen und Erstattungen werden nur in der Bestellung vermerkt. Sie werden nicht automatisch als WooCommerce-Erstattungen erfasst. Erstellen Sie bei Bedarf eine manuelle Erstattung in WooCommerce ohne Refund via Quickpay.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Quickpay. 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 gültig 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 Quickpay Kunden an der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, 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 vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Seite Plugins und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erfassung und Erstattungen funktionieren.

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

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 eingegeben sind. Ohne beide Schlüssel wird die Methode ausgeblendet.

Die Zahlung ging durch, aber die Bestellung bleibt Pending payment: der Quickpay-Callback hat Ihren Shop nicht erreicht oder wurde abgelehnt. Prüfen Sie, ob Ihre Website aus dem Internet erreichbar ist (kein Passwortschutz und kein Wartungsmodus) und ob Private key der private Schlüssel desselben Quickpay-Kontos ist. Abgelehnte Callbacks werden immer in WooCommerce > Status > Logs, Quelle wcp_quickpay_gateway, geschrieben. Aktivieren Sie Debug log, 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 aus 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 akzeptiert.

Das Protokoll zeigt Callback: no order found for payment …: der Callback gehört zu einer Quickpay-Zahlung, die keine Bestellung dieses Shops kennt, zum Beispiel eine Zahlung, die außerhalb von WooCommerce oder für eine gelöschte Bestellung erstellt wurde.

Das Protokoll zeigt Callback: order #… is locked by another request.: ein anderer Callback derselben Bestellung wurde in diesem Moment verarbeitet. Der Callback erhält eine Fehlerantwort und gilt daher nicht als verarbeitet. Bleibt die Bestellung unverändert, prüfen Sie die Zahlung im Quickpay-Manager.

Eine Testzahlung hat die Bestellung nicht als bezahlt markiert: Test payments ist ausgeschaltet. Die Bestellnotiz besagt, dass die Testzahlung nicht akzeptiert wurde. Schalten Sie die Einstellung während des Testens ein und nach der Livegang Ihres Kontos wieder aus.

Bestellung ist nach der Zahlung On hold: lesen Sie die Bestellnotiz. Die Zahlung ist möglicherweise nur autorisiert und wartet auf Capture Quickpay payment, der bezahlte Betrag oder die Währung kann vom Bestellbetrag abweichen, oder die Erfassung ist fehlgeschlagen. Erfassen, versenden Sie die Bestellung oder erstatten Sie die Zahlung im Quickpay-Manager.

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.: öffnen Sie die Bestellnotizen oder das Protokoll. Die Notiz zeigt den Quickpay-Fehler, etwa eine Währung, die Ihr Quickpay-Konto nicht akzeptiert.

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; stornieren Sie sie stattdessen im Quickpay-Manager.

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. Wurde 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

Das Deaktivieren des Plugins behält alle Daten. 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 Protokolle des Plugins (Protokolldateien, einschließlich rotierter, und Datenbank-Protokolleinträge) werden nur entfernt, wenn Delete data aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Quickpay ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Quickpay verbunden noch von Quickpay gebilligt.