Zurück

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

Währung: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK oder USD. Bei jeder anderen Währung der Kasse wird die Zahlungsart an der Kasse ausgeblendet. Beträge werden mit 2 Dezimalstellen übermittelt; ein Gesamtbetrag mit mehr Dezimalstellen (zum Beispiel bei einer Währung mit 3 Dezimalstellen wie BHD) wird abgelehnt statt gerundet.

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

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

Installation

Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 wcp_corvuspay_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_corvuspay_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 Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_corvuspay_gateway-oc3-(version).ocmod.zip aus. Die Erweiterung enthält keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch 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 CorvusPay Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer 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 im Lizenzblock oben auf der Seite in License key ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

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

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Legen Sie eine Testbestellung an und deaktivieren Sie danach Test Mode, um in den Live-Betrieb zu gehen.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_corvuspay_gateway.ocmod.zip aus. 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 CorvusPay Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und danach auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die CorvusPay-Shops und die Merchant-Center-URLs wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Success URL und die Cancel URL sind anders (siehe Success- und Cancel-URL).

Eine neue Installation startet mit deaktivierter Zahlungsart und aktiviertem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox CorvusPay Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite Test mode is on. Payments go to the CorvusPay test environment — no real money is taken. an, solange der Testmodus aktiv ist. Sie warnt außerdem, wenn das Gateway aktiviert ist, aber Store ID oder Secret Key des aktuellen Modus leer sind (die Zahlungsart ist dann an der Kasse ausgeblendet, bis beide eingetragen sind), und wenn die Standardwährung Ihres Shops von CorvusPay nicht unterstützt wird. Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht länger als 128 Zeichen sein, Sort Order muss eine ganze Zahl sein, Minimum Total muss eine nicht negative Zahl sein, und die ausgewählte Geozone sowie die Bestellstatus müssen vorhanden sein. Andernfalls wird nichts gespeichert und die Seite listet die Fehler auf.

CorvusPay

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

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Default: Credit/Debit Card (CorvusPay). Bis zu 128 Zeichen; wenn Sie das Feld leer lassen, wird der Standardname angezeigt.

Description: der Text, der dem Kunden im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche angezeigt wird. Default: Pay securely with your credit or debit card via CorvusPay. Im Testmodus wird (Test mode — no real payment is taken.) angehängt.

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

Geo Zone: CorvusPay nur für Rechnungsadressen in der ausgewählten Geozone anbieten. Default: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet.

Minimum Total: der Bestellbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor CorvusPay angeboten wird. Lassen Sie das Feld leer, wenn es kein Mindestbetrag sein soll.

Zugangsdaten des Shops

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

Test Mode: nutzt die Testumgebung von CorvusPay (wallet.test.corvuspay.com) sowie die Test-Store-ID und den Test-Secret-Key. Default: on. Deaktivieren Sie es, um echte Zahlungen über wallet.corvuspay.com anzunehmen.

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. Geben Sie etwas anderes ein, zeigt die Seite … must contain digits only — the previous value was kept. an, die übrigen Felder werden trotzdem gespeichert. Gespeicherte Secret Keys werden nie wieder angezeigt: Das Feld bleibt leer und zeigt Saved — leave empty to keep it. an. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Schlüssel zu entfernen, aktivieren Sie unter dem Feld Clear the saved value on save und klicken Sie auf Save. Eine Zahlung wird immer mit dem Secret Key des Shops geprüft, in dem sie gestartet wurde; halten Sie den Testschlüssel daher ausgefüllt, solange Testzahlungen noch zurückkommen können.

Success- und Cancel-URL

Kopieren Sie die beiden unter Merchant Center URLs angezeigten Adressen in das CorvusPay Merchant Center, sowohl für den Test- als auch für den Produktions-Shop. CorvusPay leitet den Kunden nach der Zahlung dorthin zurück. Sie werden aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet; kopieren Sie sie genau so, wie die Seite sie anzeigt.

Success URL: sieht bei OpenCart 3 etwa so aus: https://your-store/index.php?route=extension/payment/wcp_corvuspay_gateway/success, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_corvuspay_gateway/payment/wcp_corvuspay_gateway.success. CorvusPay signiert diese Anfrage; die Bestellung erhält den Status erst, nachdem die Signatur geprüft wurde.
Cancel URL: sieht bei OpenCart 3 etwa so aus: https://your-store/index.php?route=extension/payment/wcp_corvuspay_gateway/cancel, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_corvuspay_gateway/payment/wcp_corvuspay_gateway.cancel. CorvusPay signiert sie nicht, daher kann sie nur einen nicht bezahlten Zahlungsversuch mit einer von diesem Shop vergebenen CorvusPay-Bestellnummer als storniert markieren.

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 erhält den Prüfstatus; Sie erfassen (abschließen) die Zahlung im CorvusPay Merchant Center und ändern danach den Bestellstatus.

Payment Page Language: die Sprache der CorvusPay-Zahlungsseite. Site language (Standard) verwendet die aktuelle Sprache Ihres Shops, wenn CorvusPay sie unterstützt, andernfalls Englisch. Sie können auch Hrvatski, English, Deutsch, Italiano, Srpski oder Slovenščina wählen.

Order Status After Payment: der Bestellstatus nach einer erfolgreichen Sale-Zahlung. Die Optionen verweisen auf die OpenCart-Status, die im Abschnitt Order statuses gewählt wurden.

Processing (default): die Bestellung erhält den Processing status.
Completed: die Bestellung erhält den Completed status.
On hold (review status): jede bezahlte Bestellung wartet im On hold (review) status auf Ihre manuelle Prüfung.

Bestellstatus

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung). Dies sind die OpenCart-Status, die das Gateway setzt; jedes Feld listet Ihre OpenCart-Bestellstatus auf. OpenCart hat keinen Status „On hold“, daher wird der Prüfstatus für Authorize only, Abweichungen bei Betrag oder Währung und Zahlungen nach einer Stornierung verwendet; eine Bestellnotiz erklärt den Grund.

Processing status: wird verwendet, wenn Order Status After Payment Processing ist. Default: Processing.

Completed status: wird verwendet, wenn Order Status After Payment Completed ist. Default: Complete.

On hold (review) status: Authorize only, Abweichung bei Betrag oder Währung, Zahlung nach einer Stornierung oder Order Status After Payment auf On hold gesetzt. Default: Pending. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Erweitert

Logging: schreibt Debug-Informationen in corvuspay_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden. Fehler werden immer protokolliert, auch wenn dies ausgeschaltet ist; Geheimnisse, Signaturen und Kundendaten werden niemals protokolliert. Default: off.

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

Delete Data: wenn aktiviert, entfernt das Deinstallieren der Erweiterung die Gateway-Einstellungen und die Protokolldateien. Bestellungen und CorvusPay-Transaktionsdaten bleiben immer erhalten. Default: off.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Secret Keys werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Secret Keys bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit/Debit Card (CorvusPay)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung; OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, zeigt die Seite Redirecting to CorvusPay for payment. Please wait... an und sendet das signierte Formular an die CorvusPay-Zahlungsseite. Startet die Weiterleitung nicht, klickt der Kunde auf Pay via CorvusPay. Übermittelt werden der Bestellbetrag in der Bestellwährung, eine kurze Beschreibung (Order, die Bestellnummer und der Shopname) sowie die Adress- und E-Mail-Daten des Kunden (zum Vorausfüllen der Zahlungsseite). Dieselbe CorvusPay-Bestellnummer wird wiederverwendet, solange sich Betrag, Währung, Modus und Transaktionstyp nicht ändern, und CorvusPay nimmt keine zweite Zahlung dafür an. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose des Zahlungsartblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Fordert der Shop keine Rechnungsadresse an (Standard bei OpenCart 4), werden die Angaben zum Karteninhaber aus dem Namen des Kunden und der Lieferadresse übernommen.

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 von diesem Shop vergeben worden sein, die Signatur muss zum Secret Key des Shops passen, in dem die Zahlung gestartet wurde, und Betrag und Währung müssen zur Bestellung passen. Die Bestellung erhält dann ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die OpenCart-Erfolgsseite mit Your CorvusPay payment has been received. Bei Authorize only zeigt die Seite Your CorvusPay payment has been authorized. The amount will be charged when the shop processes your order., und bei einer Bestellung im Prüfstatus Your payment was received and is being reviewed by the shop.

Kann die Zahlung in diesem Moment nicht übernommen werden (zum Beispiel, weil eine andere Anfrage dieselbe Bestellung bestätigt), sieht der Kunde Your payment is being confirmed mit einer Schaltfläche Check again, die zur Erfolgsseite führt, sobald die Bestellung einen Status hat. Kann die Anfrage an die Success URL nicht geprüft werden, sieht der Kunde Payment not confirmed und We could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again. Es wird nichts verändert. Die Success URL funktioniert auch, während der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und bei OpenCart 4 fügt die Erweiterung eine Startaktion für die Success- und die Cancel-URL hinzu. Bei OpenCart 4 sendet der Browser die Shop-Sitzung nicht mit, wenn CorvusPay den Kunden zurückschickt; die Erweiterung zeigt daher zuerst eine kurze Seite, die dieselbe Adresse erneut von Ihrem Shop aus öffnet: Der Kunde behält Warenkorb und Anmeldung.

Bricht der Kunde auf der CorvusPay-Seite ab, bleibt die Bestellung ohne Status, und der Kunde kehrt mit unverändertem Warenkorb und 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. Bei OpenCart 4 wird diese Meldung oberhalb der Kassenseite angezeigt. OpenCart 3 erstellt jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung; OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie, und ein neuer Versuch erhält eine neue CorvusPay-Bestellnummer; ist eine andere Bestellung desselben Warenkorbs bereits bezahlt, wird der Kunde zur Erfolgsseite geleitet, statt erneut zu zahlen.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel weil Sie sie storniert haben), schickt Confirm Order oder die Rückkehr von CorvusPay den Kunden mit Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. zurück zur Kasse. Hat die Bestellung bereits einen Status und hat sich der Warenkorb seitdem geändert (andere Produkte oder Mengen), lautet die Meldung Your previous order is already placed. The cart has changed since then: please confirm the new order to pay for it. In beiden Fällen bezahlt der nächste Klick auf Confirm Order eine neue Bestellung des Warenkorbs.

Kann die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche: CorvusPay is not configured. Please choose another payment method., CorvusPay does not accept payments in … oder This order total cannot be paid via CorvusPay (it must be greater than zero with at most 2 decimals). Please choose another payment method.

Die Bestellung wird nur bestätigt, wenn CorvusPay den Kunden zur Success URL zurückleitet; es gibt keine Benachrichtigungen von Server zu Server. Schließt der Kunde den Browser direkt nach der Zahlung, bleibt die Bestellung ohne Status. Die Erweiterung unterstützt keine Erstattungen, Erfassungen oder Stornierungen aus OpenCart heraus (die Server-API von CorvusPay erfordert ein Client-Zertifikat), keine gespeicherten Karten, Abonnements, Ratenzahlungen oder ein Kartenformular im Shop selbst.

Bestellungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu CorvusPay geschickt und ist nicht mit einer bestätigten Zahlung zurückgekehrt oder hat die Zahlung abgebrochen. Unter Sales > Orders werden solche Bestellungen nur angezeigt, wenn der Filter Order Status auf Missing Orders gesetzt ist. Hat der Kunde gezahlt, ist aber nicht zurückgekehrt, prüfen Sie die Zahlung im CorvusPay Merchant Center und setzen Sie den Bestellstatus manuell.

Processing, Completed oder Prüfstatus: Die Sale-Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Eine Notiz zeigt die CorvusPay-Bestellnummer, den Genehmigungscode und den Kartentyp.

Prüfstatus, autorisiert: Authorize only ist ausgewählt. Erfassen Sie die Zahlung im CorvusPay Merchant Center und ändern Sie danach den Bestellstatus.

Prüfstatus, Abweichung bei Betrag oder Währung: 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.

Prüfstatus, Zahlung nach Abbruch: Eine erfolgreiche Zahlung ist für einen Zahlungsversuch eingegangen, den der Kunde abgebrochen hatte. Bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung im CorvusPay Merchant Center.

Trifft eine weitere erfolgreiche Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, das CorvusPay Merchant Center zu prüfen und die doppelte Zahlung bei Bedarf zu erstatten. Trifft eine Zahlung für eine andere Bestellung desselben Warenkorbs ein, während eine Bestellung bereits bezahlt ist, bleibt diese Bestellung ohne Status, und die Notiz wird der bezahlten Bestellung hinzugefügt.

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

Registerkarte VibeFox CorvusPay Gateway

Öffnen Sie unter Sales > Orders eine mit CorvusPay bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox CorvusPay Gateway die CorvusPay order number, den Status des Zahlungsversuchs, den Transaction type, den Amount (und den erhaltenen Betrag, falls CorvusPay ihn gemeldet hat), den Approval code, die Transaction, den Kartentyp Card und die CorvusPay notes. Testzahlungen sind mit Test gekennzeichnet. Die Registerkarte ist schreibgeschützt und wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen: Erstattungen, Erfassungen und Stornierungen aus OpenCart heraus werden nicht unterstützt. Führen Sie sie im CorvusPay Merchant Center aus und tragen Sie das Ergebnis manuell in OpenCart ein. Produktrücksendungen unter Sales > Returns zahlen über CorvusPay kein Geld zurück.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox CorvusPay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox CorvusPay 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 aktiv 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-corvuspay und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (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 funktioniert für eine Domain: die Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird CorvusPay 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 Admin-Benutzer, der im selben Browser im Admin-Bereich 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. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin-Bereich nicht, daher ist die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint eine Erinnerung auf dem Dashboard des Admin-Bereichs. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden bestätigt, wenn der Kunde aus CorvusPay zurückkehrt.

Wenn eine Lizenz abläuft, 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 im Admin-Bereich ö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 der Lizenzschlüssel und der Lizenzstatus immer entfernt.

Fehlerbehebung

CorvusPay erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Store ID und Secret Key des aktuellen Modus eingetragen sind (Test Store ID und Test Secret Key im Testmodus, Live Store ID und Live Secret Key im Live-Modus) und die Kassenwährung von CorvusPay unterstützt wird. Prüfen Sie außerdem, ob die Zahlungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den Minimum Total erreicht.

Die Zahlung war erfolgreich, aber die Bestellung bleibt ohne Status: Wahrscheinlich ist die Success URL nicht im CorvusPay Merchant Center eingetragen, oder der Secret Key in OpenCart stimmt nicht mit dem Shop überein. Suchen Sie im Feld Log auf der Seite der Erweiterung nach INVALID signature (Fehler werden immer protokolliert). Die Bestellung bleibt auch ohne Status, wenn der Kunde den Browser geschlossen hat, bevor er zurückkehrte; prüfen Sie dann die Zahlung im Merchant Center und setzen Sie den Bestellstatus manuell.

Der Kunde sieht Payment not confirmed: Die Anfrage an die Success URL wurde abgelehnt: Pflichtfelder fehlten, die CorvusPay-Bestellnummer wurde nicht von diesem Shop vergeben, der Secret Key dieses Shops ist leer oder die Signatur stimmte nicht überein. Es wird nichts verändert. Das Protokoll zeigt den Grund.

Der Kunde sieht lange Your payment is being confirmed: Der Bestellstatus konnte nicht gesetzt werden. Das Protokoll zeigt den Grund; prüfen Sie die Zahlung im Merchant Center.

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

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

Der Kunde sieht This payment method is not available. Please reload the checkout page.: Die Kassensitzung passt nicht mehr zur Bestellung, oder die Zahlungsart wurde inzwischen deaktiviert. Der Kunde lädt die Kasse neu.

Die Bestellung ist im Prüfstatus: Lesen Sie die Notizen auf der Registerkarte VibeFox CorvusPay Gateway. Authorize only ist ausgewählt, der gezahlte Betrag oder die Währung stimmte nicht mit der Bestellung überein, die Zahlung kam an, nachdem der Kunde abgebrochen hatte, oder Order Status After Payment ist auf On hold gesetzt.

Für Entwickler: Bevor das Formular signiert wird, löst die Erweiterung das OpenCart-Ereignis corvuspay_p_form_params mit den Formularfeldern und der Bestellung aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox CorvusPay 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, Minimum 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 (bei OpenCart 4 zusätzlich dessen Ereignisse und die Startaktion, die CorvusPay im Wartungsmodus durchlässt). Ist Delete Data aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Store IDs, Secret Keys, Testmodus, Zahlungseinstellungen, Protokollierung) und die Protokolldateien entfernt. Ist es deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die CorvusPay-Transaktionsdaten werden immer beibehalten, sodass die CorvusPay-Registerkarte älterer Bestellungen nach einer Neuinstallation wieder erscheint. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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