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

Redsys-Händlerkonto: Ihre Bank (der Acquirer, der Ihnen den virtuellen POS von Redsys gegeben hat) stellt Ihnen den Händlercode (FUC), die Terminalnummer und den Zugang zum Verwaltungspanel von Redsys bereit, wo der geheime SHA-256-Schlüssel jeder Umgebung angezeigt wird. Der Schlüssel der Testumgebung unterscheidet sich vom echten. Die Online-Benachrichtigung (HTTP) muss für Ihr Terminal aktiv sein. Fragen Sie Ihre Bank, wenn Sie unsicher sind.

Shop-Währung: eine der Währungen, die das Modul 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 aus dem Internet erreichen können, ohne Anmeldung oder Firewall-Sperre, um die Zahlungsbenachrichtigungen zuzustellen.

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

Installation

1. Im Back-Office gehen Sie zu Modules > Module Manager und klicken auf Upload a module. Wählen Sie die ZIP-Datei des Moduls.

2. Nach dem Hochladen klicken Sie auf Configure, oder Sie suchen später VibeFox Redsys Gateway in der Modulliste und klicken 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 Ihren Händlercode, das Terminal und den geheimen Schlü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 dann Test Mode aus, um echte Zahlungen anzunehmen.

Bei der Installation legt das Modul den Bestellstatus Redsys payment on hold an. PrestaShop bietet das neue Zahlungsmodul für die Länder an, die zu diesem Zeitpunkt aktiv sind, sowie für alle Währungen und Kundengruppen. Sie können das unter Payment > Preferences ändern; Länder, die Sie später aktivieren, müssen dort für das Modul angehakt werden.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Redsys Gateway > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Über den Feldern warnt die Seite, wenn der Händlercode fehlt oder nicht nur aus Ziffern besteht, wenn ein geheimer Schlüssel kein gültiger Redsys-SHA-256-Schlüssel ist, wenn der Schlüssel des aktuellen Modus leer ist (die Zahlungsmethode wird dann an der Kasse ausgeblendet) und wenn die Shop-Währung nicht unterstützt wird. Solange der Testmodus eingeschaltet ist, zeigt die Seite Test mode is active: payments go to the Redsys test environment (SIS-T), no real money is charged. an. Ist Title leer, zeigt die Seite Enter a title for the payment method. und es 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). Pflichtfeld.

Description: der Text, der an der Kasse unter der Zahlungsmethode angezeigt wird. Standard: Pay securely with your credit or debit card via Redsys.

Redsys-Konto

Ihre Bank gibt Ihnen den Händlercode, das Terminal und den Zugang zum Verwaltungspanel von Redsys, wo der geheime SHA-256-Schlüssel jeder Umgebung angezeigt wird. Der Abschnitt verlinkt auf das Verwaltungspanel von Redsys.

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 vergebene 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 (Produktiv-)Umgebung, in der Regel 32 Zeichen. Er wird verwendet, wenn der Testmodus ausgeschaltet ist.

Testmodus (SIS-T)

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

Test Mode: Zahlungen und Erstattungen gehen an die Testumgebung von Redsys (SIS-T) und werden mit dem Testschlüssel signiert. Standard: ein. Schalten Sie ihn aus, um echte Zahlungen anzunehmen. Ist er eingeschaltet, zeigt die Kasse TEST MODE: Redsys test environment, no real money is charged. unter der Zahlungsmethode an.

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.

Clear saved secrets: Haken Sie einen Schlüssel an und klicken Sie auf Save, um ihn zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Zahlungsseite und Bestellungen

Commerce Name: der Shop-Name, der auf der Redsys-Zahlungsseite angezeigt wird, höchstens 25 Zeichen. Standard: der Name Ihres Shops, auf 25 Zeichen gekürzt.

Order Status After Payment: der Bestellstatus, der nach einer erfolgreichen Zahlung gesetzt wird.

Abweichungen bei Betrag oder Währung, Testzahlungen, während der Shop im Live-Modus ist, und Zahlungen aus abgebrochenen Versuchen gehen immer auf Redsys payment on hold.

Zahlungsbenachrichtigungen

Notification URL: Redsys meldet jede Zahlung an diese Adresse Ihres Shops. Sie wird in diesem Abschnitt angezeigt und sieht mit URLs im Freundlich-Format so aus: https://your-shop/module/wcp_redsys_gateway/notify. Das Modul sendet sie bei jeder Zahlung an Redsys, daher müssen Sie nichts in das Verwaltungspanel von Redsys eintragen. Die Online-Benachrichtigung (HTTP) muss für Ihr Terminal aktiv sein. Fragen Sie Ihre Bank, wenn nach einer erfolgreichen Zahlung keine Bestellung entsteht. Benachrichtigungen ohne gültige Signatur werden abgewiesen. Ohne die Benachrichtigung wird keine Bestellung angelegt.

Erweitert

Debug log: schreibt die Details von Zahlungen, Benachrichtigungen und Erstattungen in logs/rdsg_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. 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 die Deinstallation des Moduls die Gateway-Einstellungen und das Protokoll. Die Redsys-Zahlungsdaten der Bestellungen (für Erstattungen nötig) und der Bestellstatus Redsys payment on hold bleiben immer erhalten. Standard: aus.

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. Für Warenkörbe in anderen Währungen wird die Zahlungsmethode ausgeblendet.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsmethode (standardmäßig Credit/Debit Card (Redsys)) und bestätigt die Bestellung. Der Kunde sieht Redirecting to Redsys for payment. Please wait... und gelangt zur Redsys-Zahlungsseite Ihrer Bank. Geht der Browser nicht von selbst weiter, klickt der Kunde auf Pay via Redsys oder auf Choose another payment method, um zurückzugehen. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Auf der Redsys-Seite zahlt der Kunde mit Karte und 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 Warenkorbs (Spanisch, Englisch, Katalanisch, Französisch, Deutsch, Italienisch, Portugiesisch und weitere) oder Englisch für andere Sprachen. Der Betrag ist der Warenkorbbetrag in der kleinsten Einheit der Warenkorbwährung, zum Beispiel EUR 43,45 als 4345, und JPY oder CLP ohne Dezimalstellen. Die Zahlung wird als Cart mit der Warenkorbnummer und dem Namen Ihres Shops beschrieben.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung gilt erst dann als bezahlt, wenn Redsys dies durch die signierte Benachrichtigung bestätigt: Die Benachrichtigung legt die Bestellung an, und der Kunde sieht die übliche Bestellbestätigungsseite mit Your payment with Redsys has been received. Ist die Bestellung auf Redsys payment on hold gesetzt worden, 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 die Meldung Redsys is confirming your payment. If you completed the payment, your order will be created 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 zurück zur Kasse mit The Redsys payment was not completed. You can try again or choose another payment method. Der Warenkorb bleibt erhalten, und der Kunde kann erneut zahlen. Jeder neue Versuch erhält eine neue Redsys-Bestellnummer, und eine Zahlung aus einem dieser Versuche, zum Beispiel aus einem zweiten Browser-Tab, wird trotzdem erkannt.

Lässt sich die Zahlung nicht an Redsys senden, bleibt der Kunde an der Kasse mit einer kurzen Meldung: Redsys payments are not configured correctly. Please choose another payment method or contact us., einem Hinweis, dass die Währung nicht akzeptiert wird, oder The order total must be greater than zero.

Die Benachrichtigung funktioniert auch, während der Shop im Wartungsmodus ist, und wird nicht von der Länderbeschränkung Ihres Shops blockiert.

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

Bestellungen und Erstattungen

Bestellstatus

No order yet: der Kunde wurde zu Redsys geschickt und hat nicht bezahlt, die Zahlung wurde abgelehnt oder abgebrochen, oder die Benachrichtigung von Redsys ist noch nicht eingetroffen. Es existiert nur der Warenkorb.

Payment accepted, Delivered or Redsys payment on hold: die Zahlung wurde bestätigt. Der Status folgt Order Status After Payment. Die Zahlung wird mit der Redsys-Bestellnummer (Ds_Order) als Transaktions-ID erfasst, und eine Notiz zeigt die Redsys-Bestellnummer, den Autorisierungscode und den Antwortcode, bei Testzahlungen mit der Kennzeichnung [TEST].

Redsys payment on hold after payment: Redsys hat einen anderen Betrag oder eine andere Währung als den Warenkorbbetrag gemeldet (zum Beispiel wurde der Warenkorb nach Beginn der Zahlung in einem anderen Tab geändert), eine Testzahlung ist eingegangen, während der Shop im Live-Modus ist (es wurde kein echtes Geld belastet und keine Zahlung erfasst), oder der Kunde hat nach dem Abbrechen dieser Zahlung auf der Redsys-Seite trotzdem bezahlt. Die Notiz erklärt es. Prüfen Sie die Zahlung im Verwaltungspanel von Redsys und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Refunded: die Zahlung wurde über das Modul vollständig erstattet.

Eine abgelehnte Zahlung verändert nie eine bestehende Bestellung. Bei häufigen Antwortcodes geben das Protokoll und die Notizen einen kurzen Grund an, zum Beispiel Insufficient funds, Card expired oder Cancelled by the customer. Kommt eine zweite, andere Zahlung für einen Warenkorb, der bereits eine Bestellung hat, wird die Bestellung nicht verändert. Eine Notiz fordert Sie auf, die doppelte Zahlung im Verwaltungspanel von Redsys zu erstatten. Meldet Redsys, dass eine Zahlung noch läuft, wird eine Notiz hinzugefügt und die Bestellung wartet auf das Endergebnis.

Redsys-Zahlungsblock

Die Bestellseite zeigt einen Block Redsys payment mit der Redsys-Bestellnummer (Ds_Order), dem Autorisierungscode und der Antwort, der Umgebung (live oder Test), dem bezahlten und erstatteten Betrag, einem Abzeichen Test mode für Testzahlungen, einem Prüfhinweis für wartende Bestellungen, dem Erstattungsverlauf, den Redsys notes der Bestellung und allen Redsys-Bestellnummern, die für den Warenkorb vergeben wurden.

Erstattungen

Geben Sie im Block Redsys payment den Betrag ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Grund, 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 bearbeiten; der Zugriff auf die Modul-Seiten ist nicht nötig. 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 zur Höhe dessen erstatten, was der Kunde tatsächlich bezahlt hat, nicht bis zum Bestellbetrag. Die Erstattung wird über die Redsys REST API an die Umgebung gesendet, in der die Zahlung erfolgt ist (Test oder live), mit dem Schlüssel dieser Umgebung signiert, und die Antwortsignatur wird geprüft. Akzeptiert Redsys die Erstattung nicht, zeigt der Block den Fehler an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen mit der Redsys-Bestellnummer und dem Grund hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded. Eine teilweise Erstattung ändert den Status nicht.

Das Modul erstellt keine Gutschriften. Die standardmäßigen PrestaShop-Erstattungsschaltflächen auf der Bestellseite senden kein Geld über Redsys zurück.

Erstattungen, die im Verwaltungspanel von Redsys vorgenommen werden, gelten nicht als Erstattungen des Moduls. Wenn Redsys dafür eine Benachrichtigung sendet, wird der Bestellung eine Notiz hinzugefügt. Der Bestellstatus ändert sich nicht automatisch.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Redsys Gateway steht als erster Block auf Modules > Module Manager > VibeFox Redsys 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 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: presta-payment-redsys und der Link Manage licenses and domains in your account, 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. 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 das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Konfiguration. Wird der Schlüssel aus dem Shop entfernt, wird sein Domain-Platz 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 trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Die PrestaShop-Storefront weiß nicht, dass Sie im Back Office angemeldet sind, daher ist 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 in Modules > Module Manager auf dem Tab Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits begonnene Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Modul weiter, Updates und Support benötigen jedoch eine Verlängerung. Der Status wird automatisch erneut geprüft, während Sie im Back Office arbeiten: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal pro Woche. Ein Cronjob ist nicht nötig. Das Deinstallieren oder Zurücksetzen des Moduls 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 Warenkorbwährung in der Liste der unterstützten Währungen steht. Die Einstellungsseite zeigt für jedes dieser Probleme eine Warnung. 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: 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 Adresse unter Notification URL aus dem Internet erreichbar ist, ohne Anmeldung oder Firewall-Sperre. Schalten Sie Debug log ein und schauen Sie im Feld Log auf der Modulseite nach.

Die Benachrichtigung antwortet Forbidden: Die Signatur stimmt nicht mit dem geheimen Schlü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 geheimen Schlüssel und der Händlercode in den Einstellungen die Ihres Terminals sind.

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

Die Benachrichtigung antwortet Busy: Der Warenkorb wurde gerade von einer anderen Benachrichtigung verarbeitet, oder die Bestellung konnte nicht angelegt werden (zum Beispiel, weil das Modul deaktiviert ist). Redsys wiederholt die Benachrichtigung. Das Protokoll zeigt den Grund.

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

Bestellung ist nach der Zahlung Redsys payment on hold: Lesen Sie die Notizen im Block Redsys payment (siehe Bestellstatus) und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Testzahlungen bestätigen im Live-Modus keine Bestellungen: Eine Testzahlung bezahlt nie eine Bestellung, solange Test Mode ausgeschaltet ist. Die Bestellung wird stattdessen mit einer Notiz auf Wartestellung gesetzt. Verwenden Sie für Testzahlungen den Testmodus mit dem Testschlüssel.

Erstattung schlägt fehl: Lesen Sie den Fehler. Redsys refund: the merchant code or the TEST secret key is not configured. (bzw. LIVE) bedeutet, dass der Schlüssel der Umgebung der Zahlung fehlt. Redsys-Fehlercodes werden in der Meldung erklärt, zum Beispiel SIS0057 (der Betrag überschreitet den Rest 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.

Ihr Terminal akzeptiert eine Währung, die nicht in der Liste steht: Entwickler können die Währungsliste über den Hook actionRdsgCurrencyCodes ändern. Fügen Sie eine Währung nur hinzu, wenn Ihre Bank sie für das Terminal freigeschaltet hat.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Redsys Gateway und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete Data eingeschaltet, werden die Gateway-Einstellungen und das Protokoll entfernt. Ist es aus, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die Redsys-Zahlungsdaten und Erstattungen sowie der Bestellstatus Redsys payment on hold bleiben immer erhalten, sodass früher bezahlte Bestellungen auch nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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