VibeFox CorvusPay for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

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

PHP: 8.0 oder neuer.

Währung: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK oder USD. In jeder anderen Währung wird die Zahlungsart an der Kasse ausgeblendet. Beträge werden mit 2 Dezimalstellen gesendet; eine Summe mit mehr Dezimalstellen (zum Beispiel in einem BHD-Shop mit 3 Dezimalstellen) wird abgelehnt, statt gerundet zu werden.

CorvusPay-Konto: Sie benötigen ein CorvusPay-Händlerkonto. CorvusPay vergibt für jeden Shop eine Store ID und einen Secret Key, getrennt für den Test- und den Produktions-Shop; beide werden im CorvusPay Merchant Center angezeigt. Die Success URL und die Cancel URL des Plugins müssen dort eingetragen werden (siehe Konfiguration).

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > CorvusPay > Manage, oder klicken Sie auf der Plugin-Seite unter dem Plugin-Namen auf Settings.

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

5. Geben Sie die Store ID und den Secret Key Ihres CorvusPay-Test-Shops ein (und des Produktions-Shops für Live-Zahlungen). Kopieren Sie die auf der Einstellungsseite angezeigten Success URL und Cancel URL in das CorvusPay Merchant Center, für den Test- und den Produktions-Shop.

6. Schalten Sie Enable/Disable ein, geben Sie eine Testbestellung auf und entfernen Sie dann das Häkchen bei Test Mode, um live zu gehen.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > CorvusPay. Über den Feldern zeigt die Seite Test mode is on., solange der Testmodus aktiv ist, und warnt Sie, wenn das Gateway aktiviert ist, aber die Store ID oder der Secret Key des aktuellen Modus leer ist (es wird dann an der Kasse ausgeblendet, bis sie ausgefüllt sind), und wenn die Shop-Währung von CorvusPay nicht unterstützt wird.

Allgemein

Enable/Disable: Enable CorvusPay Gateway schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Standard: Credit/Debit Card (CorvusPay).

Description: der Text, der an der Kasse unter der Zahlungsart angezeigt wird. Standard: Pay securely with your credit or debit card via CorvusPay. Im Testmodus wird (Test mode — no real payment is taken.) angehängt.

Shop-Zugangsdaten

Die Store ID und der Secret Key werden von CorvusPay für jeden Shop (Test und Produktion getrennt) vergeben und im CorvusPay Merchant Center angezeigt.

Test Mode: Enable test mode verwendet die CorvusPay-Testumgebung (wallet.test.corvuspay.com) sowie die Test-Store-ID und den Test-Secret-Key. Standard: ein.

Test Store ID: die numerische Store ID Ihres CorvusPay-Test-Shops.

Test Secret Key: der Secret Key Ihres CorvusPay-Test-Shops, der für die HMAC-SHA256-Signaturen verwendet wird.

Live Store ID: die numerische Store ID Ihres CorvusPay-Produktions-Shops.

Live Secret Key: der Secret Key Ihres CorvusPay-Produktions-Shops, der für die HMAC-SHA256-Signaturen verwendet wird.

Eine Store ID darf nur Ziffern enthalten. Bei jeder anderen Eingabe wird ein Fehler angezeigt und der vorherige Wert beibehalten. Eine Zahlung wird immer mit dem Secret Key des Shops geprüft, in dem sie erfolgt ist. Lassen Sie den Test-Key daher ausgefüllt, solange noch Testbestellungen offen sind.

Success URL und Cancel URL

Kopieren Sie die beiden in diesem Abschnitt angezeigten Adressen in das CorvusPay Merchant Center, für den Test- und den Produktions-Shop. CorvusPay leitet den Kunden nach der Zahlung dorthin zurück.

Success URL: sieht aus wie https://your-site/wc-api/corvuspay_payment_success/. CorvusPay signiert diese Anfrage; die Bestellung wird erst als bezahlt markiert, nachdem die Signatur geprüft wurde.

Cancel URL: sieht aus wie https://your-site/wc-api/corvuspay_payment_cancel/. CorvusPay signiert sie nicht, daher kann sie nur eine unbezahlte Bestellung mit einer von diesem Shop vergebenen CorvusPay-Bestellnummer stornieren.

Zahlung

Transaction Type: wie die Karte belastet wird.

Sale (capture immediately): die Karte wird sofort belastet (Standard).

Authorize only (capture in Merchant Center): der Betrag wird nur reserviert. Die Bestellung wird in Wartestellung gesetzt; Sie erfassen die Zahlung (schließen sie ab) im CorvusPay Merchant Center und setzen die Bestellung dann auf In Bearbeitung.

Payment Page Language: die Sprache der CorvusPay-Zahlungsseite. Site language (Standard) verwendet die aktuelle Sprache Ihrer Website, wenn CorvusPay sie unterstützt, andernfalls Englisch. Sie können auch Kroatisch, Englisch, Deutsch, Italienisch, Serbisch oder Slowenisch wählen.

Order Status After Payment: der Status der Bestellung nach einer erfolgreichen Sale-Zahlung. Der Status wird sofort gesetzt, ohne zweite Statusänderung.

Processing (WooCommerce default): Standard.

Completed: jede bezahlte Bestellung wird auf Abgeschlossen gesetzt.

On Hold: jede bezahlte Bestellung wartet auf Ihre manuelle Prüfung.

Erweitert

Logging: Enable debug logging schreibt in WooCommerce > Status > Logs, Quelle wcp_corvuspay_gateway. Fehler werden immer protokolliert; Geheimnisse und Kundendaten nie. Standard: aus.

Delete Data: Delete the plugin settings and log files when the plugin is deleted (uninstalled). Beim Deaktivieren wird nie etwas gelöscht. In Bestellungen gespeicherte Zahlungsdaten bleiben immer erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Credit/Debit Card (CorvusPay)) und gibt die Bestellung auf. Die Bestellung bleibt auf Zahlung ausstehend, und die Seite Pay for order zeigt Redirecting to CorvusPay for payment. Please wait... und sendet das signierte Formular an die CorvusPay-Zahlungsseite. Startet die Weiterleitung nicht, klickt der Kunde auf Pay via CorvusPay. Übermittelt werden die Bestellsumme, die Währung, eine kurze Warenkorbbeschreibung und die Rechnungsdaten (zum Vorausfüllen der Zahlungsseite). Dieselbe CorvusPay-Bestellnummer wird wiederverwendet, solange sich der Betrag nicht ändert, und CorvusPay akzeptiert dafür keine zweite Zahlung.

Nach der Zahlung leitet CorvusPay den Kunden zur Success URL zurück. Die Bestellung wird erst als bezahlt markiert, wenn CorvusPay dies bestätigt: Die CorvusPay-Bestellnummer muss für diese Bestellung vergeben worden sein, die Signatur muss zum Secret Key des Shops passen, in dem die Zahlung erfolgt ist, und Betrag und Währung müssen mit der Bestellung übereinstimmen. Dann gelangt der Kunde auf die Bestellbestätigungsseite. Der Lagerbestand wird reduziert, sobald die Zahlung bestätigt ist, und der Warenkorb wird auf der Bestellbestätigungsseite geleert.

Bricht der Kunde auf der CorvusPay-Seite ab, wird die unbezahlte Bestellung storniert, und der Kunde kehrt mit unverändertem Warenkorb und der Meldung The CorvusPay payment was cancelled and the order was not paid. Your cart is still here — you can try again or choose another payment method. zur Kasse zurück. Wurde die Zahlung von der Seite Pay for order aus gestartet und der Warenkorb ist leer, zeigt WooCommerce The CorvusPay payment was cancelled and the order was not paid. auf der Warenkorbseite an. Kann die Anfrage an die Success URL nicht geprüft werden, sieht der Kunde We could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again. und die Bestellung bleibt unverändert.

Die Zahlungsart funktioniert in der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist mit dem High-Performance Order Storage (HPOS) von WooCommerce kompatibel. Die Texte sind ins Kroatische übersetzt.

Die Bestellung wird nur bestätigt, wenn CorvusPay den Kunden zur Success URL zurückleitet; es gibt keine Server-zu-Server-Benachrichtigungen. Schließt der Kunde den Browser direkt nach der Zahlung, bleibt die Bestellung auf Zahlung ausstehend. Das Plugin bietet keine Erstattungen, Erfassungen oder Stornierungen aus WooCommerce (die CorvusPay-Server-API erfordert ein Client-Zertifikat) und keine gespeicherten Karten, Abonnements, Ratenzahlungen, IBAN / PIS oder CorvusWallet.

Bestellungen

Bestellstatus

Pending payment: der Kunde wurde zu CorvusPay weitergeleitet und ist noch nicht zurückgekehrt. Hat der Kunde bezahlt, ist aber nicht zurückgekehrt, prüfen Sie die Zahlung im CorvusPay Merchant Center und schließen Sie die Bestellung manuell ab.

Processing, Completed oder On Hold: die Sale-Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Die Bestellnotiz enthält die CorvusPay-Bestellnummer, den Autorisierungscode und den Kartentyp. Die Transaktions-ID der Bestellung ist die CorvusPay-Transaktions-ID oder, falls CorvusPay keine sendet, die CorvusPay-Bestellnummer, mit der sich die Zahlung im Merchant Center finden lässt.

On hold, autorisiert: Authorize only ist ausgewählt. Erfassen Sie die Zahlung im CorvusPay Merchant Center und setzen Sie die Bestellung dann auf In Bearbeitung.

On hold, Betrag/Währung weicht ab: der gezahlte Betrag oder die Währung stimmt nicht mit der Bestellung überein. Versenden Sie nicht, bevor Sie die Zahlung im CorvusPay Merchant Center geprüft haben.

On hold, Zahlung für eine stornierte Bestellung: eine erfolgreiche Zahlung ging ein, nachdem die Bestellung storniert worden war, zum Beispiel durch das Zeitlimit für unbezahlte Bestellungen. Wickeln Sie die Bestellung ab oder erstatten Sie die Zahlung im CorvusPay Merchant Center.

Cancelled: der Kunde hat die Zahlung auf der CorvusPay-Seite abgebrochen.

Geht für eine bereits bezahlte oder abgeschlossene Bestellung eine weitere, andere erfolgreiche Zahlung ein, wird die Bestellung nicht geändert. Eine Notiz weist Sie an, das CorvusPay Merchant Center zu prüfen und die doppelte Zahlung bei Bedarf zu erstatten.

Refunds: Erstattungen, Erfassungen und Stornierungen aus WooCommerce werden nicht unterstützt. Führen Sie sie im CorvusPay Merchant Center durch und erfassen Sie die Erstattung in WooCommerce manuell.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben auf WooCommerce > Settings > Payments > CorvusPay. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status an, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr Konto auf vibefox.net.

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 CorvusPay den 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 Zahlungsart weiterhin, gekennzeichnet mit (unlicensed — visible to admins only), sodass Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Plugin-Seite und auf WooCommerce-Seiten erscheint eine Erinnerung. Bestehende Bestellungen sind nicht betroffen: Kunden, die von bereits gestarteten Zahlungen zurückkehren, werden weiterhin verarbeitet.

Läuft eine Lizenz ab, funktioniert das Plugin weiter, aber für Updates und Support ist eine Verlängerung nötig. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

CorvusPay erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die Store ID und der Secret Key des aktuellen Modus ausgefüllt sind (Test Store ID und Test Secret Key im Testmodus, Live Store ID und Live Secret Key im Live-Modus) und die Shop-Währung von CorvusPay unterstützt wird. Die Einstellungsseite zeigt in jedem Fall eine Warnung an.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt auf Zahlung ausstehend: wahrscheinlich ist die Success URL nicht im CorvusPay Merchant Center eingetragen, oder der Secret Key in WooCommerce passt nicht zum Shop. Schalten Sie Logging ein und suchen Sie in WooCommerce > Status > Logs, Quelle wcp_corvuspay_gateway, nach INVALID signature. Die Bestellung bleibt auch dann ausstehend, wenn der Kunde den Browser geschlossen hat, bevor er zurückkehrte; prüfen Sie dann die Zahlung im Merchant Center und schließen Sie die Bestellung manuell ab.

Der Kunde sieht We could not confirm this CorvusPay payment: die Anfrage an die Success URL wurde abgelehnt: Pflichtfelder fehlten, die CorvusPay-Bestellnummer wurde nicht für die Bestellung vergeben, der Secret Key dieses Shops ist leer oder die Signatur stimmte nicht überein. Die Bestellung bleibt unverändert. Das Protokoll zeigt den Grund.

Der Kunde sieht This order total cannot be paid via CorvusPay: die Summe ist null oder hat mehr als 2 Dezimalstellen.

Der Kunde sieht CorvusPay is not configured oder CorvusPay does not accept payments in …: die Store ID oder der Secret Key des aktuellen Modus fehlt, oder die Bestellwährung wird nicht unterstützt.

Bestellung ist On hold: lesen Sie die Bestellnotiz. Authorize only ist ausgewählt, der gezahlte Betrag oder die Währung stimmte nicht mit der Bestellung überein, oder die Zahlung ging ein, nachdem die Bestellung storniert worden war.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Wird der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Website-Adresse geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, funktioniert 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 Protokolldateien werden nur entfernt, wenn Delete Data eingeschaltet war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. In Bestellungen gespeicherte Zahlungsdaten bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

CorvusPay ist eine Marke des jeweiligen Inhabers. Dieses Plugin steht in keiner Verbindung zu CorvusPay und wird von CorvusPay nicht unterstützt.