VibeFox Redsys for OpenCart — Hilfe

Voraussetzungen

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.

Redsys-Händlerkonto: Ihre Bank (der Acquirer, der Ihnen das virtuelle Redsys-POS bereitgestellt hat) gibt Ihnen den Händlercode (FUC), die Terminalnummer und den Zugang zum Redsys-Administrationsbereich, in dem der SHA-256-Geheimschlüssel jeder Umgebung angezeigt wird. Der Schlüssel der Testumgebung unterscheidet sich vom echten Schlüssel. Die Online-Benachrichtigung (HTTP) muss für Ihr Terminal aktiv sein. Fragen Sie Ihre Bank, wenn Sie unsicher sind.

Währung: eine der Währungen, die die Erweiterung unterstützt (siehe Konfiguration), und Ihr Redsys-Terminal muss von der Bank dafür freigeschaltet sein. Die meisten Terminals akzeptieren nur EUR.

Erreichbarer Shop: Redsys muss Ihren Shop über das Internet erreichen können, ohne Anmeldung oder Firewall-Sperre, um die Zahlungsbenachrichtigungen zuzustellen.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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_redsys_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_redsys_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_redsys_gateway-oc3-(version).ocmod.zip. 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 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 Redsys Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

3. Klicken Sie auf Edit (die Schaltfläche mit dem Stift), 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 Ihren Händlercode, Ihr Terminal und den Geheimschlüssel jeder Umgebung ein (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung mit eingeschaltetem Test Mode und schalten Sie danach Test Mode aus, um echte Zahlungen anzunehmen.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_redsys_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 Redsys Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Schaltfläche mit dem Stift).

4. Fügen Sie den Lizenzschlüssel und die Redsys-Daten ein, wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungs-URL ist anders (siehe Zahlungsbenachrichtigungen).

Eine neue Installation startet mit ausgeschalteter Zahlungsmethode und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Redsys Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Oberhalb der Einstellungen warnt Sie die Seite, wenn der Händlercode fehlt oder nicht nur aus Ziffern besteht, wenn ein Geheimschlüssel kein gültiger Redsys-SHA-256-Schlüssel ist, wenn der Schlüssel des aktuellen Modus leer ist (dann wird die Zahlungsmethode an der Kasse ausgeblendet) und wenn die Standardwährung des Shops nicht unterstützt wird. Solange der Testmodus eingeschaltet ist, zeigt sie Test mode is active: payments go to the Redsys test environment (SIS-T), no real money is charged. an.

Beim Speichern muss Title 1 bis 128 Zeichen lang sein (Enter a title for the payment method (1 to 128 characters).), 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 existieren. Andernfalls wird nichts gespeichert.

Redsys

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

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsmethode in der Bestellung gespeichert. Standard: Credit/Debit Card (Redsys). Erforderlich, bis zu 128 Zeichen.

Description: der Text, den Kunden im Schritt Confirm Order über der Schaltfläche zum Bestätigen sehen. Standard: Pay securely with your credit or debit card via Redsys.

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

Geo Zone: Redsys nur für Zahlungsadressen in der ausgewählten Geo Zone anbieten. Standard: All zones. Geo Zones werden unter System > Localisation > Geo Zones eingerichtet.

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

Redsys-Konto

Ihre Bank gibt Ihnen den Händlercode (FUC), das Terminal und den Zugang zum Redsys-Administrationsbereich, in dem der SHA-256-Geheimschlüssel jeder Umgebung angezeigt wird. Der Abschnitt verlinkt auf den Redsys-Administrationsbereich.

Merchant Code (FUC): Ihr Redsys-Händlercode, bis zu 9 Ziffern. Alles, was keine Ziffer ist, wird beim Speichern entfernt.

Terminal Number: die von Ihrer Bank zugewiesene Terminalnummer, bis zu 3 Ziffern. Standard: 1. Ein leeres Feld wird als 1 gespeichert.

Secret Key (SHA-256) — live: der Base64-SHA-256-Schlüssel der echten (Produktions-)Umgebung, in der Regel 32 Zeichen. Er wird verwendet, wenn der Testmodus ausgeschaltet ist.

Testmodus (SIS-T)

Die Redsys-Testumgebung hat ihren eigenen Geheimschlüssel. Der Abschnitt zeigt die öffentlichen Redsys-Testdaten: Händlercode 999008881, Terminal 1, Schlüssel sq7HjrUOBfKmC576ILgskD5srU870gJ7, Karte 4548 8100 0000 0003, Ablauf 12/49, CVV 123. Im Testmodus wird kein echtes Geld belastet.

Test Mode: Zahlungen und Erstattungen gehen an die Redsys-Testumgebung (SIS-T) und werden mit dem Testschlüssel signiert. Standard: ein. Schalten Sie es aus, um echte Zahlungen anzunehmen. Solange es eingeschaltet ist, sehen Kunden im Schritt Confirm Order den Hinweis TEST MODE: Redsys test environment, no real money is charged.

Secret Key (SHA-256) — test: der Base64-SHA-256-Schlüssel der Testumgebung. Verwenden Sie Ihren eigenen Testschlüssel oder den oben genannten öffentlichen Testschlüssel.

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 Schlüssel zu entfernen, setzen Sie unter dem Feld den Haken bei Clear saved secret on save und klicken Sie auf Save.

Zahlungsseite und Bestellungen

Commerce Name: der Shopname, der auf der Redsys-Zahlungsseite angezeigt wird, maximal 25 Zeichen. Standard: der Name Ihres Shops, auf 25 Zeichen gekürzt.

Order Status After Payment: welchen Status eine bezahlte Bestellung erhält.

Abweichungen bei Betrag oder Währung, Testzahlungen, während die Gateway im Live-Modus ist, und Zahlungen abgebrochener Versuche erhalten immer den On hold (review) status.

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Sie erhält einen Status erst nach der signierten Benachrichtigung von Redsys. Eine abgelehnte oder abgebrochene Zahlung lässt die Bestellung ohne Status; der Kunde kehrt mit erhaltenem Warenkorb zur Kasse zurück. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Processing status: wird verwendet, wenn Order Status After Payment auf Processing steht. Standard: In Bearbeitung.

Completed status: wird verwendet, wenn Order Status After Payment auf Completed steht. Standard: Abgeschlossen.

On hold (review) status: für Zahlungen, die Ihre Prüfung benötigen (siehe oben), oder für jede bezahlte Bestellung, wenn Order Status After Payment auf On hold (review) steht. Standard: Ausstehend, weil OpenCart keinen Status „On hold“ hat; eine Notiz zur Bestellung erklärt den Grund. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Refunded status: wird gesetzt, wenn die Redsys-Zahlung über die Bestellseite vollständig erstattet wird. Standard: Erstattet.

Zahlungsbenachrichtigungen

Notification URL: Redsys meldet jede Zahlung an diese Adresse Ihres Shops. Sie wird in diesem Abschnitt angezeigt. Bei OpenCart 3 sieht sie so aus: https://your-store/index.php?route=extension/payment/wcp_redsys_gateway/notify, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_redsys_gateway/payment/wcp_redsys_gateway.notify. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Die Erweiterung sendet sie bei jeder Zahlung an Redsys, daher müssen Sie im Redsys-Panel nichts kopieren. Die Online-Benachrichtigung (HTTP) muss für Ihr Terminal aktiv sein. Fragen Sie Ihre Bank, wenn nach einer erfolgreichen Zahlung keine Bestellung bestätigt wird. Benachrichtigungen ohne gültige Signatur werden abgelehnt. Ohne die Benachrichtigung erhält die Bestellung nie einen Status.

Erweitert

Debug log: schreibt die Details von Zahlungen, Benachrichtigungen und Erstattungen in rdsg_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden, und bei 5 MB wird sie in eine alte Kopie verschoben. Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Schlüssel, Signaturen und Kartendaten werden nie protokolliert. 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: wenn eingeschaltet, entfernt das Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll. Die Redsys-Zahlungsdatensätze der Bestellungen (für Erstattungen nötig) bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Die geheimen Schlüssel werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten geheimen Schlüssel bleiben erhalten.

Unterstützte Währungen

EUR, USD, GBP, JPY, CHF, CAD, AUD, NZD, NOK, SEK, DKK, PLN, CZK, HUF, BGN, RON, ILS, INR, MYR, SGD, THB, SAR, ZAR, RUB, BRL, MXN, ARS, CLP, COP, PEN, CNY, TWD. Die Zahlungsmethode wird ausgeblendet, wenn die Währung des Kunden nicht in dieser Liste steht.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsmethode (standardmäßig Credit/Debit Card (Redsys)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, bereitet die Erweiterung ein signiertes Zahlungsformular vor, der Kunde sieht Redirecting to Redsys for payment. Please wait... und gelangt zur Zahlungsseite von Redsys bei Ihrer Bank. Geht der Browser nicht von selbst weiter, klickt der Kunde auf Pay via Redsys. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart, im Fenster Payment method options, und klickt unten auf der Kassenseite auf Confirm Order.

Auf der Redsys-Seite bezahlt der Kunde mit Karte per 3-D Secure oder mit Bizum bzw. einer anderen Methode, die Ihre Bank für das Terminal freigeschaltet hat. Die Seite verwendet die Sprache des Kunden (Spanisch, Englisch, Katalanisch, Französisch, Deutsch, Italienisch, Portugiesisch und weitere), für andere Sprachen Englisch. Der Betrag ist der Bestellbetrag in den kleinsten Einheiten der Bestellwährung, zum Beispiel EUR 43,45 als 4345; JPY und CLP haben keine Dezimalstellen. Die Zahlung wird als Order mit der Bestellnummer und dem Namen Ihres Shops beschrieben.

Nach der Zahlung kehrt der Kunde zu Ihrem Shop zurück. Die Rückkehr allein markiert nichts als bezahlt. Die Bestellung wird erst dann als bezahlt markiert, wenn Redsys dies mit der signierten Benachrichtigung bestätigt. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung mit Your payment with Redsys has been received. Hat die Bestellung den On hold (review) status erhalten, zeigt die Seite Your payment with Redsys has been received and is being reviewed by the store. Ist die Benachrichtigung noch nicht eingetroffen, zeigt eine Seite Payment confirmation den Text Redsys is confirming your payment. If you completed the payment, your order will be confirmed in a few moments — please do not pay again. mit den Schaltflächen Check again und Back to checkout.

Bricht der Kunde ab oder wird die Zahlung abgelehnt, schickt Redsys den Kunden mit The Redsys payment was not completed. You can try again or choose another payment method. zurück zur Kasse. Der Warenkorb bleibt erhalten, und der Kunde kann erneut bezahlen. Jeder neue Versuch erhält eine neue Redsys-Bestellnummer, und eine Zahlung über einen dieser Versuche, etwa aus einem zweiten Browser-Tab, wird weiterhin erkannt. OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird; ist eine andere Bestellung desselben Warenkorbs bereits bezahlt, gelangt der Kunde direkt zur Erfolgsseite, und eine verspätete Zahlung der anderen Bestellung wird nicht übernommen.

Bei OpenCart 4 wird die Meldung über die nicht abgeschlossene Zahlung oberhalb der Kassenseite angezeigt. OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie. Nach einem Abbruch oder einer abgelehnten Zahlung bezahlt der Kunde daher dieselbe Bestellung mit einer neuen Redsys-Bestellnummer. Ist diese Bestellung inzwischen geschlossen, wird der Kunde mit Your previous order was closed without a payment. Please confirm the order again to pay with a new order. zur Kasse zurückgeschickt oder, wenn sie eine Redsys-Zahlung hatte, mit Your order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. Das nächste Confirm Order bezahlt eine neue Bestellung. Ist die Bestellung der Kasse bereits bezahlt, der Warenkorb 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 an Redsys gesendet werden, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung: Redsys payments are not configured correctly. Please choose another payment method or contact us., einer Meldung, dass Zahlungen in dieser Währung nicht akzeptiert werden, oder The order total must be greater than zero.

Die Benachrichtigung und die Rückkehr des Kunden funktionieren auch, während der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und bei OpenCart 4 fügt die Erweiterung dafür eine Startaktion hinzu.

Die Erweiterung nimmt nur einmalige Zahlungen an, die auf der Redsys-Seite sofort autorisiert und erfasst werden. Sie hat kein Kartenformular auf Ihrer eigenen Website (InSite oder iframe), keine gespeicherten Karten, keine Ein-Klick-Zahlungen oder Tokenisierung, keine Abonnements oder wiederkehrenden Zahlungen, keine Vorautorisierung mit späterer Erfassung und keine Zahlungslinks für im Admin angelegte Bestellungen.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu Redsys weitergeleitet und hat nicht bezahlt, die Zahlung wurde abgelehnt oder abgebrochen, oder die Redsys-Benachrichtigung ist noch nicht eingetroffen. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Processing, Completed oder On hold (review): Die Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Eine Notiz zeigt die Redsys-Bestellnummer (Ds_Order), den Autorisierungscode und den Antwortcode, bei Testzahlungen mit [TEST] markiert.

On hold (review) nach der Zahlung: Redsys hat einen anderen Betrag oder eine andere Währung als die Bestellsumme gemeldet, eine Testzahlung ist eingegangen, während die Gateway im Live-Modus war (es wurde kein echtes Geld belastet), oder der Kunde hat nach dem Abbruch dieser Zahlung auf der Redsys-Seite erneut bezahlt. Die Notiz erklärt es. Prüfen Sie die Zahlung im Redsys-Administrationsbereich und bearbeiten Sie danach die Bestellung oder erstatten Sie die Zahlung.

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

Eine abgelehnte Zahlung ändert nie eine Bestellung, die bereits einen Status hat. Bei häufigen Antwortcodes geben Protokoll und Notizen einen kurzen Grund an, etwa Insufficient funds, Card expired oder Cancelled by the customer. Trifft eine zweite, andere Zahlung für eine Bestellung oder einen Warenkorb ein, der bereits bezahlt ist, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, die doppelte Zahlung im Redsys-Administrationsbereich zu erstatten. Meldet Redsys, dass eine Zahlung noch läuft, wird eine Notiz hinzugefügt und die Bestellung wartet auf das endgültige Ergebnis.

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

Reiter VibeFox Redsys Gateway

Öffnen Sie unter Sales > Orders eine mit Redsys bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Redsys Gateway die Redsys order number (Ds_Order), den Authorisation code / response, die Environment (Live oder Test) mit einem Hinweis Test mode, den Status der Zahlung, Paid / refunded, einen Prüfhinweis für Bestellungen im Status „On hold“, das Erstattungsformular, den Erstattungsverlauf, die Redsys notes der Bestellung und die Redsys order numbers issued for this cart. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

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 Redsys. Bestätigen Sie die Abfrage Refund this amount through Redsys? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, Bestellungen zu ändern (Sales > Orders, festgelegt unter System > Users > User Groups). Erstattungen erfolgen in dem Betrag und in der Währung, die Redsys belastet hat. Nach einer Abweichung von Betrag oder Währung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht bis zur Bestellsumme. Die Erstattung wird über die Redsys-REST-API an die Umgebung gesendet, in der die Zahlung erfolgte (Test oder Live), mit dem Schlüssel dieser Umgebung signiert, und die Antwortsignatur wird geprüft. Akzeptiert Redsys die Erstattung nicht, zeigt der Reiter den Fehler, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Redsys-Bestellnummer und dem Grund dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht.

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

Im Redsys-Administrationsbereich vorgenommene Erstattungen werden nicht als Erstattungen der Erweiterung erfasst. Sendet Redsys dazu eine Benachrichtigung, wird der Bestellung eine Notiz hinzugefügt. Der Bestellstatus wird nicht automatisch geändert.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Redsys Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Redsys 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 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-redsys und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung 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 einen Domainplatz in Ihrem Konto 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 seinen Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Redsys Kunden an der Kasse nicht angezeigt. Wird dennoch 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 angemeldet ist, sieht die Zahlungsmethode im Shop weiterhin, markiert mit (unlicensed — visible to admins only), sodass 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 nicht, daher wird ohne aktiven Schlüssel die Zahlungsart für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admins eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen bleiben unberührt: Bereits begonnene Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

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

Fehlerbehebung

Redsys erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Händlercode und Terminal ausgefüllt sind und der aktuelle Modus einen gültigen Schlüssel hat: Secret Key (SHA-256) — test im Testmodus, Secret Key (SHA-256) — live im Live-Modus. Prüfen Sie, ob die Währung des Kunden in der Liste der unterstützten Währungen steht. Die Einstellungsseite zeigt für jedes dieser Probleme eine Warnung an. Prüfen Sie außerdem, ob die Zahlungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: Die Redsys-Benachrichtigung hat Ihren Shop nicht erreicht. Bitten Sie Ihre Bank zu prüfen, ob die Online-Benachrichtigung (HTTP) für Ihr Terminal aktiv ist. Prüfen Sie, ob die unter Notification URL angezeigte Adresse ohne Anmeldung und ohne Firewall-Sperre aus dem Internet erreichbar ist. Schalten Sie Debug log ein und sehen Sie sich das Feld Log auf der Seite der Erweiterung an.

Die Benachrichtigung antwortet Forbidden: Die Signatur stimmt nicht mit dem Geheimschlüssel der Umgebung überein, in der die Zahlung gestartet wurde, oder der Händlercode in der Benachrichtigung ist nicht Ihrer. Prüfen Sie, ob die Geheimschlüssel und der Händlercode in den Einstellungen die Ihres Terminals sind.

Die Benachrichtigung antwortet Order not found: Die Benachrichtigung war korrekt signiert, aber keine Bestellung dieses Shops verwendet diese Redsys-Bestellnummer.

Die Benachrichtigung antwortet Busy: Der Warenkorb wurde im selben Moment von einer anderen Benachrichtigung verarbeitet, oder der Bestellstatus konnte nicht gesetzt werden. Redsys wiederholt die Benachrichtigung. Das Protokoll zeigt den Grund.

Die Benachrichtigung antwortet Bad request: Die Anfrage enthielt keine oder fehlerhafte Redsys-Parameter. Sie kam nicht im erwarteten Format von Redsys.

Bestellung ist nach der Zahlung im Status „On hold“: Lesen Sie die Notizen im Reiter VibeFox Redsys Gateway (siehe Bestellstatus) und bearbeiten Sie danach die Bestellung oder erstatten Sie die Zahlung.

Testzahlungen bestätigen keine Bestellungen im Live-Modus: Eine Testzahlung bezahlt eine Bestellung niemals, solange Test Mode ausgeschaltet ist. Stattdessen wird die Bestellung mit einer Notiz auf Eis gelegt. Verwenden Sie für Testzahlungen den Testmodus mit dem Testschlüssel.

Erstattung schlägt fehl: Lesen Sie die Fehlermeldung. Redsys refund: the merchant code or the TEST secret key is not configured. (oder LIVE) bedeutet, dass der Schlüssel der Umgebung der Zahlung fehlt. Redsys-Fehlercodes werden in der Meldung erklärt, zum Beispiel SIS0057 (der Betrag übersteigt den Restbetrag der Zahlung), SIS0056 (die ursprüngliche Zahlung wurde nicht gefunden, andere Umgebung oder anderes Terminal), SIS0042 (Signaturfehler, prüfen Sie den Schlüssel dieser Umgebung), SIS0026 (unbekannter Händlercode oder unbekanntes Terminal) und SIS0027 (Währung für das Terminal nicht konfiguriert). Ist Redsys nicht erreichbar, wird die Erstattung nicht durchgeführt. Versuchen Sie es später erneut.

Kein Erstattungsformular im Reiter: Der Reiter nennt den Grund, zum Beispiel dass die Bestellung keine bestätigte Redsys-Zahlung hat, dass sie vollständig erstattet ist oder dass Ihre Benutzergruppe kein Recht hat, Bestellungen zu ändern.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse wcp_redsys_gateway/merchant_parameters (die Zahlungsparameter und die Bestellung) und wcp_redsys_gateway/currency_codes (die Liste der unterstützten Währungen) aus. Fügen Sie eine Währung nur hinzu, wenn Ihre Bank sie für das Terminal freigeschaltet hat.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Redsys 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 vier Bestellstatus, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 seine Events und seine Startaktion, die die Benachrichtigung und die Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete Data eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Händlercode, Terminal, Schlüssel, Testmodus, Shopname im Zahlungsformular, Bestellstatus nach der Zahlung, Protokollierung) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die Redsys-Zahlungsdatensätze und Erstattungen bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Bei OpenCart 4 entfernen Sie außerdem die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer, klicken Sie in der Liste der installierten Erweiterungen neben VibeFox Redsys Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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