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

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 Warenkorbwährung wird die Zahlungsart an der Kasse ausgeblendet. Beträge werden mit 2 Dezimalstellen übermittelt; ein Gesamtbetrag mit mehr Dezimalstellen (z. B. in einem Shop mit BHD-Preisen mit 3 Dezimalstellen) 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- und den Produktionsshop; sie werden im CorvusPay Merchant Center angezeigt. Die Success URL und die Cancel URL des Moduls müssen dort eingetragen werden (siehe Konfiguration).

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert 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. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie VibeFox CorvusPay Gateway später in der Modulliste und klicken Sie 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. Geben Sie Store ID und Secret Key Ihres CorvusPay-Teststores ein (und die des Produktionsshops für Echtzahlungen). Kopieren Sie die Success URL und die Cancel URL, die auf der Seite Configure angezeigt werden, in das CorvusPay Merchant Center, sowohl für den Test- als auch für den Produktionsshop.

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Legen Sie eine Testbestellung an und deaktivieren Sie dann Test Mode, um live zu gehen.

Bei der Installation legt das Modul den Bestellstatus CorvusPay payment on hold an. PrestaShop verknüpft ein neues Zahlungsmodul mit den zu diesem Zeitpunkt aktiven Währungen, Kundengruppen und Ländern. Sie können dies unter Payment > Preferences ändern; ein Land, das Sie später aktivieren, muss dort für das Modul angekreuzt werden.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox CorvusPay Gateway > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder zeigt die Seite Der Testmodus ist aktiviert. Zahlungen gehen an die CorvusPay-Testumgebung — es wird kein echtes Geld abgebucht. an, solange der Testmodus aktiv ist, und warnt Sie, wenn das Gateway aktiviert ist, aber Store ID oder Secret Key des aktuellen Modus leer sind (die Zahlungsart wird dann an der Kasse ausgeblendet, bis sie ausgefüllt sind), sowie wenn die Standardwährung Ihres Shops von CorvusPay nicht unterstützt wird.

CorvusPay

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

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert. 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 (Testmodus — es wird keine echte Zahlung abgebucht.) hinzugefügt.

Zugangsdaten des Shops

Store ID und Secret Key stellt CorvusPay für jeden Shop aus (Test und Produktion getrennt); sie werden im CorvusPay Merchant Center angezeigt.

Test Mode: verwendet die CorvusPay-Testumgebung (wallet.test.corvuspay.com) sowie die Test-Store-ID und den Test-Secret-Key. Standard: an. Schalten Sie ihn aus, um echte Zahlungen über wallet.corvuspay.com anzunehmen.

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

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

Live Store ID: die numerische Store ID Ihres CorvusPay-Produktionsshops.

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

Clear saved secrets: aktivieren Sie Test Secret Key oder Live Secret Key und klicken Sie auf Save, um ihn zu entfernen.

Eine Store ID darf nur Ziffern enthalten. Wenn Sie etwas anderes eingeben, zeigt die Seite Die Store ID darf nur Ziffern enthalten — der vorherige Wert wurde beibehalten. an, und die übrigen Felder werden trotzdem gespeichert. Gespeicherte Secret Keys werden nie wieder angezeigt: Das Feld bleibt leer und zeigt Gespeichert — leer lassen, um ihn zu behalten. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Eine Zahlung wird immer mit dem Secret Key des Shops geprüft, in dem sie gestartet wurde. Lassen Sie den Testschlüssel daher ausgefüllt, solange noch Testzahlungen zurückkommen können.

Success URL und Cancel URL

Kopieren Sie die beiden Adressen aus diesem Abschnitt in das CorvusPay Merchant Center, sowohl für den Test- als auch für den Produktionsshop. CorvusPay leitet den Kunden nach der Zahlung dorthin zurück. Kopieren Sie sie genau so, wie die Seite sie anzeigt; mit sprechenden URLs sehen sie wie die folgenden Beispiele aus, eventuell mit einem Sprachcode wie /en/.

Success URL: sieht etwa so aus: https://your-shop/module/wcp_corvuspay_gateway/success. CorvusPay signiert diese Anfrage; die Bestellung wird erst angelegt, nachdem die Signatur geprüft wurde.

Cancel URL: sieht etwa so aus: https://your-shop/module/wcp_corvuspay_gateway/cancel. CorvusPay signiert sie nicht. Sie kann daher nur einen unbezahlten Zahlungsversuch, der mit einer von diesem Shop ausgestellten CorvusPay-Bestellnummer verknüpft ist, 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 wird in CorvusPay payment on hold gesetzt; Sie erfassen (abschließen) die Zahlung im CorvusPay Merchant Center und setzen die Bestellung danach auf Payment accepted.

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 Bestellung wird direkt in diesem Status angelegt.

Payment accepted (default): der Standard-Bestellstatus von PrestaShop für bezahlte Bestellungen.

Delivered (completed): jede bezahlte Bestellung wird auf Zugestellt gesetzt.

CorvusPay payment on hold: jede bezahlte Bestellung wartet auf Ihre manuelle Prüfung. Die Zahlung wird trotzdem in der Bestellung erfasst.

Erweitert

Logging: schreibt Debug-Informationen in logs/corvuspay_p_debug.log.php im Modulordner. Die Datei kann nicht über das Web aufgerufen werden. Fehler werden immer protokolliert, auch wenn dies deaktiviert ist; Geheimnisse, Signaturen und Kundendaten dagegen nie. Standard: aus.

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

Delete Data: ist diese Option aktiviert, werden beim Deinstallieren des Moduls die Moduleinstellungen und die Protokolldateien entfernt. Bestellungen, die CorvusPay-Transaktionsdaten und der Bestellstatus bleiben immer erhalten. Standard: aus.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsart (standardmäßig Credit/Debit Card (CorvusPay)) und bestätigt. Die nächste Seite zeigt Weiterleitung zu CorvusPay für die Zahlung. Bitte warten... und sendet das signierte Formular an die CorvusPay-Zahlungsseite. Startet die Weiterleitung nicht, klickt der Kunde auf Pay via CorvusPay; Back to checkout führt zurück zur Kasse. Gesendet werden der Warenkorbbetrag, die Währung, eine kurze Beschreibung (Warenkorbnummer und Shopname) sowie die Rechnungsadresse und die E-Mail-Adresse (um die Zahlungsseite vorauszufüllen). Zu diesem Zeitpunkt existiert noch keine Bestellung. Dieselbe CorvusPay-Bestellnummer wird wiederverwendet, solange sich Betrag, Währung, Modus und Transaktionsart nicht ändern; CorvusPay nimmt für sie keine zweite Zahlung an.

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 ausgestellt worden sein, die Signatur muss zum Secret Key des Shops passen, in dem die Zahlung gestartet wurde, und Betrag und Währung müssen mit dem Warenkorb übereinstimmen. Anschließend wird die Bestellung angelegt, und der Kunde sieht die übliche Bestellbestätigungsseite mit Ihre CorvusPay-Zahlung ist eingegangen. Bei Authorize only zeigt die Seite Ihre CorvusPay-Zahlung wurde autorisiert. Der Betrag wird belastet, wenn der Shop Ihre Bestellung bearbeitet., und bei einer Bestellung in Wartestellung Ihre Zahlung ist eingegangen und wird vom Shop geprüft.

Kann die Bestellung in diesem Moment nicht angelegt werden (etwa weil eine andere Anfrage denselben Warenkorb bestätigt), sieht der Kunde Ihre Zahlung wird bestätigt mit einer Schaltfläche Check again, die zur Bestellbestätigung führt, sobald die Bestellung existiert. Kann die Anfrage an die Success URL nicht verifiziert werden, sieht der Kunde Zahlung nicht bestätigt und Wir konnten diese CorvusPay-Zahlung nicht bestätigen. Falls Ihre Karte belastet wurde, wenden Sie sich bitte an den Shop — zahlen Sie nicht erneut. Es wird nichts verändert. Die Success URL funktioniert auch, wenn der Shop im Wartungsmodus ist.

Bricht der Kunde auf der CorvusPay-Seite ab, kehrt er mit unverändertem Warenkorb zur Kasse zurück, mit Die CorvusPay-Zahlung wurde abgebrochen und die Bestellung wurde nicht bezahlt. Ihr Warenkorb ist noch da — Sie können es erneut versuchen oder eine andere Zahlungsart wählen.

Kann die Zahlung nicht starten, bleibt der Kunde an der Kasse mit einer kurzen Meldung: CorvusPay ist nicht konfiguriert. Bitte wählen Sie eine andere Zahlungsart., CorvusPay akzeptiert keine Zahlungen in … oder Dieser Bestellbetrag kann nicht über CorvusPay bezahlt werden (er muss größer als null sein und höchstens 2 Dezimalstellen haben). Bitte wählen Sie eine andere Zahlungsart.

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, wird keine Bestellung angelegt. Das Modul bietet in PrestaShop keine Erstattungen, Erfassungen oder Stornierungen (die CorvusPay-Server-API erfordert ein Client-Zertifikat), keine gespeicherten Karten, Abonnements, Ratenzahlungen und kein Kartenformular im Shop.

Bestellungen

Bestellstatus

Noch keine Bestellung: der Kunde wurde zu CorvusPay geschickt und ist nicht mit einer bestätigten Zahlung zurückgekehrt. Es existiert nur der Warenkorb. Hat der Kunde bezahlt, ist aber nicht zurückgekehrt, prüfen Sie die Zahlung im CorvusPay Merchant Center und legen Sie die Bestellung manuell an.

Payment accepted, Delivered or CorvusPay payment on hold: die Sale-Zahlung wurde bestätigt. Der Status folgt Order Status After Payment. Die Zahlung wird mit der CorvusPay-Transaktions-ID erfasst oder, wenn CorvusPay keine sendet, mit der CorvusPay-Bestellnummer, über die sie im Merchant Center gefunden werden kann. Eine private Bestellnotiz zeigt die CorvusPay-Bestellnummer, den Genehmigungscode und den Kartentyp.

CorvusPay payment on hold, authorized: Authorize only ist ausgewählt. Erfassen Sie die Zahlung im CorvusPay Merchant Center und setzen Sie die Bestellung danach auf Payment accepted.

CorvusPay payment on hold, amount/currency mismatch: der gezahlte Betrag oder die Währung stimmt nicht mit dem Warenkorb überein, etwa weil der Warenkorb in einem anderen Tab geändert wurde. Die Zahlung wird mit dem tatsächlich gezahlten Betrag erfasst, wenn er in der Bestellwährung vorliegt. Versenden Sie nicht, bevor Sie die Zahlung im CorvusPay Merchant Center geprüft haben.

CorvusPay payment on hold, payment after cancel: 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.

Geht für einen Warenkorb, der bereits eine Bestellung hat, eine andere, abweichende erfolgreiche Zahlung ein, wird die Bestellung nicht verändert. Ein Hinweis bittet Sie, das CorvusPay Merchant Center zu prüfen und die doppelte Zahlung bei Bedarf zu erstatten.

CorvusPay-Zahlungsblock

Die Bestellseite zeigt einen Block CorvusPay payment mit der CorvusPay-Bestellnummer, dem Status des Zahlungsversuchs, der Transaktionsart (Sale oder Authorize only), dem Betrag (und dem eingegangenen Betrag, falls CorvusPay ihn gemeldet hat), dem Genehmigungscode, der Transaktion und dem Kartentyp. Testzahlungen sind mit Test gekennzeichnet.

Erstattungen: Erstattungen, Erfassungen und Stornierungen aus PrestaShop werden nicht unterstützt. Führen Sie diese im CorvusPay Merchant Center durch und erfassen Sie das Ergebnis manuell in PrestaShop.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox CorvusPay Gateway ist der erste Block auf Modules > Module Manager > VibeFox CorvusPay Gateway > Configure, oberhalb der Einstellungen. Fügen 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, 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: presta-payment-corvuspay und der Link Lizenzen und Domains in Ihrem Konto verwalten, 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. Nachdem sich die Shopadresse geändert hat oder Sie in Ihrem Konto einen Domainplatz freigegeben haben, klicken Sie auf Check now. Kann der Lizenzserver nicht erreicht werden, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Domain des Hauptshops, auch in einer Multistore-Installation. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domainplatz 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 Diese Zahlungsart ist nicht verfügbar. Bitte wählen Sie eine andere. Das PrestaShop-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 an der Kasse testen. Eine Erinnerung erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind nicht betroffen: bereits begonnene Zahlungen werden weiterhin bestätigt, wenn der Kunde von CorvusPay zurückkehrt.

Läuft eine Lizenz ab, arbeitet das Modul weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird während der Arbeit 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. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

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 ausgefüllt sind (Test Store ID und Test Secret Key im Testmodus, Live Store ID und Live Secret Key im Produktionsmodus) und die Warenkorbwährung von CorvusPay unterstützt wird. Prüfen Sie unter Payment > Preferences, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe zugelassen ist.

Die Zahlung ist durchgegangen, aber es wurde keine Bestellung angelegt: wahrscheinlich ist die Success URL nicht im CorvusPay Merchant Center eingetragen oder der Secret Key in PrestaShop passt nicht zum Shop. Suchen Sie im Feld Log auf der Modulseite nach INVALID signature (Fehler werden immer protokolliert). Es wird auch keine Bestellung angelegt, wenn der Kunde den Browser vor der Rückkehr geschlossen hat; prüfen Sie dann die Zahlung im Merchant Center und legen Sie die Bestellung manuell an.

Der Kunde sieht Zahlung nicht bestätigt: die Anfrage an die Success URL wurde abgelehnt: Pflichtfelder fehlten, die CorvusPay-Bestellnummer wurde nicht von diesem Shop ausgestellt, der Secret Key dieses Shops ist leer oder die Signatur stimmte nicht überein. Nichts wird verändert. Das Protokoll zeigt den Grund.

Der Kunde sieht Ihre Zahlung wird bestätigt über längere Zeit: die Bestellung konnte nicht angelegt werden, etwa weil das Modul deaktiviert war oder der Warenkorb nicht mehr gültig ist. Das Protokoll zeigt den Grund; prüfen Sie die Zahlung im Merchant Center.

Der Kunde sieht Dieser Bestellbetrag kann nicht über CorvusPay bezahlt werden: der Betrag ist null oder hat mehr als 2 Dezimalstellen.

Der Kunde sieht CorvusPay ist nicht konfiguriert oder CorvusPay akzeptiert keine Zahlungen in …: Store ID oder Secret Key des aktuellen Modus fehlen, oder die Warenkorbwährung wird nicht unterstützt.

Bestellung ist CorvusPay payment on hold: lesen Sie die privaten Notizen der Bestellung. Authorize only ist ausgewählt, der gezahlte Betrag oder die Währung stimmte nicht mit dem Warenkorb überein, die Zahlung ging ein, nachdem der Kunde abgebrochen hatte, oder Order Status After Payment ist auf Wartestellung gesetzt.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox CorvusPay Gateway und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete Data aktiviert, werden die Moduleinstellungen und die Protokolldateien entfernt. Ist die Option deaktiviert, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die CorvusPay-Transaktionsdaten und der Bestellstatus CorvusPay payment on hold bleiben immer erhalten, sodass der CorvusPay-Block alter Bestellungen nach einer Neuinstallation wieder erscheint. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

CorvusPay ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist weder mit CorvusPay verbunden noch wird es von CorvusPay unterstützt.