VibeFox Redsys for WooCommerce — Hilfe
Anforderungen
WordPress: 6.2 oder neuer.
WooCommerce: 8.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.
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-Verwaltungsbereich, in dem der geheime SHA-256-Schlüssel jeder Umgebung angezeigt wird. Der Schlüssel der Testumgebung unterscheidet sich vom Schlüssel der echten Umgebung. Die Online-Benachrichtigung (HTTP) muss für Ihr Terminal aktiv sein. Fragen Sie Ihre Bank, wenn Sie unsicher sind.
Shop-Währung: eine der vom Plugin unterstützten Währungen (siehe Konfiguration). Ihre Bank muss das Redsys-Terminal dafür freigeschaltet haben. Die meisten Terminals akzeptieren nur EUR.
Erreichbare Website: Redsys muss Ihre Website aus dem Internet erreichen können, ohne Anmeldung und ohne Firewall-Sperre, um die Zahlungsbenachrichtigungen zuzustellen.
VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert für eine Domain.
Installation
1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_redsys_gateway per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Redsys > Manage, oder klicken Sie auf der Plugins-Seite unter dem Namen des Plugins auf Settings.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.
5. Geben Sie Ihren Händlercode, das Terminal und den geheimen Schlüssel jeder Umgebung ein (siehe Konfiguration).
6. Schalten Sie Enable/Disable ein. Testen Sie eine Zahlung mit aktiviertem Test Mode und entfernen Sie danach bei Test Mode den Haken, um echte Zahlungen anzunehmen.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Redsys. Oberhalb der Felder 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 Zahlungsart wird dann an der Kasse ausgeblendet) und wenn die Shop-Währung nicht unterstützt wird. Solange der Testmodus aktiv ist, zeigt die Seite Test mode is active: payments go to the Redsys test environment (SIS-T), no real money is charged. an. Nach dem Speichern folgen die Warnungen sofort den neuen Einstellungen. In der Liste der Zahlungsarten ist Redsys als einrichtungsbedürftig markiert, bis Händlercode, Terminal und der Schlüssel des aktuellen Modus gültig sind.
Allgemein
Enable/Disable: Enable Redsys Gateway schaltet die Zahlungsart ein oder aus. Standard: aus.
Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Standard: Credit/Debit Card (Redsys).
Description: der Text unter der Zahlungsart an der Kasse. 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 Redsys-Verwaltungsbereich, in dem der geheime SHA-256-Schlüssel jeder Umgebung angezeigt wird. Der Abschnitt verlinkt auf den Redsys-Verwaltungsbereich.
Merchant Code (FUC): Ihr Redsys-Händlercode, bis zu 9 Ziffern. Alle Zeichen, die keine Ziffern sind, werden 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. Er wird verwendet, wenn der Testmodus aus ist.
Testmodus (SIS-T)
Die Testumgebung von Redsys hat einen 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: Enable test mode sendet Zahlungen und Erstattungen an die Testumgebung von Redsys (SIS-T) und signiert sie mit dem Testschlüssel. Standard: an. Entfernen Sie den Haken, um echte Zahlungen anzunehmen. Solange er aktiv ist, zeigt die Kasse unter der Zahlungsart TEST MODE: Redsys test environment, no real money is charged. 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.
Zahlungsseite und Bestellungen
Commerce Name: der Shopname auf der Redsys-Zahlungsseite, höchstens 25 Zeichen. Standard: der Name Ihrer Website, auf 25 Zeichen gekürzt.
Order Status After Payment: der Bestellstatus nach einer erfolgreichen Zahlung. Der Status wird nur einmal gesetzt, sodass der Kunde nur eine E-Mail erhält.
Zahlungsbenachrichtigungen
Redsys meldet jede Zahlung an die Benachrichtigungsadresse Ihres Shops. Sie hat das Format https://your-site/wc-api/rdsg_redsys/ und wird in diesem Abschnitt angezeigt. Das Plugin sendet sie bei jeder Zahlung an Redsys, daher müssen Sie nichts im Redsys-Verwaltungsbereich eintragen. Die Online-Benachrichtigung (HTTP) muss für Ihr Terminal aktiv sein. Fragen Sie Ihre Bank, wenn Bestellungen nach einer erfolgreichen Zahlung bei Zahlung ausstehend bleiben. Benachrichtigungen ohne gültige Signatur werden abgelehnt. Ohne die Benachrichtigung wird eine Bestellung nicht als bezahlt markiert.
Erweitert
Debug log: Enable debug logging schreibt Details zu Zahlungen, Benachrichtigungen und Erstattungen in WooCommerce > Status > Logs, Quelle wcp_redsys_gateway. Fehler werden immer protokolliert, auch wenn diese Option aus ist. Schlüssel, Signaturen und Kartendaten werden nie protokolliert. Standard: aus.
Delete Data: Delete the gateway settings when the plugin is deleted. Wenn aktiv, werden beim Löschen des Plugins die Gateway-Einstellungen und die Plugin-Protokolle entfernt. 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. Die Zahlungsart wird für andere Währungen ausgeblendet. Auf der Seite Pay for order zählt die Währung der Bestellung.
Kasse
Der Kunde wählt die Zahlungsart (standardmäßig Credit/Debit Card (Redsys)) und gibt die Bestellung auf. Die Bestellung wird auf Zahlung ausstehend gesetzt, und der Kunde sieht Redirecting to Redsys for payment. Please wait.... Danach geht es zur Zahlungsseite Ihrer Bank bei Redsys. Wenn der Browser nicht von selbst weiterleitet, klickt der Kunde auf Pay via Redsys. Auf der Redsys-Seite bezahlt 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 Ihres Shops (Spanisch, Englisch, Katalanisch, Französisch, Deutsch, Italienisch, Portugiesisch und weitere), für andere Sprachen Englisch.
Der Betrag wird in den kleinsten Einheiten der Bestellwährung übermittelt, zum Beispiel EUR 43,45 als 4345, bei JPY oder CLP ohne Dezimalstellen. Die Zahlung wird als Order mit der Bestellnummer und dem Namen Ihrer Website beschrieben. Der Lagerbestand wird erst reduziert, wenn die Zahlung bestätigt ist, nicht vorher.
Nach der Zahlung kehrt der Kunde zur Bestellbestätigungsseite Ihres Shops zurück. Die Bestellung wird erst als bezahlt markiert, wenn Redsys dies über die signierte Benachrichtigung bestätigt. Bis sie eintrifft, zeigt die Seite Redsys is confirming your payment. If you completed the payment, your order will be updated in a few moments — please do not pay again.
Bricht der Kunde ab oder wird die Zahlung abgelehnt, leitet Redsys den Kunden zurück in Ihren Shop. Bei einer Bestellung aus dem Checkout wird die Bestellung auf die übliche WooCommerce-Weise storniert, und der Warenkorb bleibt erhalten. Bei einer Bestellung, die Sie im Adminbereich angelegt haben (einem Zahlungslink), kehrt der Kunde zur Seite Pay for order mit der Meldung The Redsys payment was not completed. You can try again or choose another payment method. zurück, und die Bestellung wird nicht storniert. Die Weiterleitungsseite Ihres Shops bietet außerdem Cancel order & restore cart oder bei im Adminbereich angelegten Bestellungen Choose another payment method an.
Ein Kunde kann eine unbezahlte Bestellung auf der Seite Pay for order erneut bezahlen. Jeder Versuch erhält eine neue Redsys-Bestellnummer, und eine Zahlung über einen dieser Versuche, zum Beispiel aus einem zweiten Browser-Tab, wird weiterhin erkannt.
Kann die Bestellung nicht an Redsys gesendet werden, sieht der Kunde eine kurze Meldung und kann eine andere Zahlungsart wählen: Redsys payments are not configured correctly. Please choose another payment method or contact us., eine Meldung, dass die Währung nicht akzeptiert wird, oder The order total must be greater than zero.
Die Zahlungsart funktioniert in der klassischen Kasse, im Checkout-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Das Plugin verarbeitet einmalige Zahlungen, 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 SOAP-Benachrichtigungen.
Bestellungen und Erstattungen
Bestellstatus
Pending payment: Der Kunde wurde zu Redsys weitergeleitet und hat noch nicht bezahlt, oder die Benachrichtigung von Redsys ist noch nicht eingetroffen. Die Bestellnotiz lautet Awaiting Redsys payment.
Processing, Completed or On Hold: Die Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Die Bestellnotiz zeigt die Redsys-Bestellnummer (Ds_Order), den Autorisierungscode und den Antwortcode, bei Testzahlungen mit [TEST] gekennzeichnet. Die Transaktions-ID der Bestellung ist die Redsys-Bestellnummer.
On hold after payment: Redsys hat einen anderen Betrag oder eine andere Währung gemeldet als die Bestellsumme, eine Testzahlung ist eingegangen, während der Shop im Live-Modus lief (es wurde kein echtes Geld belastet), oder die Zahlung kam, nachdem die Bestellung storniert worden war. Die Bestellnotiz erklärt es. Prüfen Sie die Zahlung im Redsys-Verwaltungsbereich und versenden Sie danach die Bestellung oder erstatten Sie die Zahlung.
Failed: Die Zahlung wurde bei Redsys abgelehnt oder abgebrochen. Die Bestellnotiz zeigt den Antwortcode und bei häufigen Codes einen kurzen Grund wie Insufficient funds, Card expired oder Cancelled by the customer. Nur eine Bestellung, die noch auf Zahlung wartet, wird auf Fehlgeschlagen gesetzt. Eine bezahlte oder abgeschlossene Bestellung wird durch einen abgelehnten Versuch nie verändert. Der Versuch wird nur vermerkt.
Cancelled: Der Kunde hat die Zahlung abgebrochen, oder die Bestellung wurde von Ihnen oder durch das Zeitlimit für die Lagerreservierung in WooCommerce storniert.
Geht für eine bereits bezahlte oder erstattete Bestellung eine zweite, andere Zahlung ein, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, die doppelte Zahlung im Redsys-Verwaltungsbereich zu erstatten. Meldet Redsys, dass eine Zahlung noch läuft, wird eine Notiz hinzugefügt, und die Bestellung wartet auf das endgültige Ergebnis.
Erstattungen
Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf die Erstattungsschaltfläche über die Redsys-Zahlungsart (standardmäßig Refund via Credit/Debit Card (Redsys)). Vollständige und teilweise Erstattungen werden unterstützt. 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 WooCommerce den Fehler an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird den Bestellnotizen mit der Redsys-Bestellnummer und dem Grund hinzugefügt.
Im Redsys-Verwaltungsbereich vorgenommene Erstattungen werden nicht als WooCommerce-Erstattungen erfasst. Sendet Redsys dafür eine Benachrichtigung, wird der Bestellung eine Notiz hinzugefügt. Falls nötig, legen Sie eine manuelle Erstattung in WooCommerce an, ohne die Redsys-Erstattungsschaltfläche zu verwenden.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Redsys. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.
Ein Schlüssel funktioniert für eine Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.
Ohne aktiven Schlüssel wird 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. Angemeldete Shop-Manager sehen die Zahlungsart weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Eine Erinnerung erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.
Läuft eine Lizenz ab, funktioniert das Plugin weiter, Updates und Support benötigen aber eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.
Fehlerbehebung
Redsys wird an der Kasse nicht angezeigt: 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, dass die Shop-Währung (auf der Seite Pay for order die Bestellwährung) in der Liste der unterstützten Währungen steht. Die Einstellungsseite zeigt für jedes dieser Probleme eine Warnung an.
Die Zahlung ging durch, aber die Bestellung bleibt bei Pending payment: 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, dass die unter Zahlungsbenachrichtigungen angezeigte Adresse aus dem Internet ohne Anmeldung, ohne Wartungsseite und ohne Firewall-Sperre erreichbar ist. Aktivieren Sie Debug log und sehen Sie unter WooCommerce > Status > Logs nach, Quelle wcp_redsys_gateway.
Benachrichtigung antwortet Forbidden: Die Signatur stimmte 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, dass die geheimen Schlüssel und der Händlercode in den Einstellungen die Ihres Terminals sind.
Benachrichtigung antwortet Order not found: Die Benachrichtigung war korrekt signiert, aber keine Bestellung dieses Shops verwendet diese Redsys-Bestellnummer.
Benachrichtigung antwortet Busy: Die Bestellung wurde im selben Moment von einer anderen Benachrichtigung verarbeitet. Redsys wiederholt die Benachrichtigung.
Benachrichtigung antwortet Bad request: Die Anfrage enthielt keine oder fehlerhafte Redsys-Parameter. Sie kam nicht im erwarteten Format von Redsys.
Bestellung ist On hold after payment: Lesen Sie die Bestellnotiz. Der bezahlte Betrag oder die Währung wich von der Bestellung ab, eine Testzahlung ging im Live-Shop ein, oder die Zahlung kam, nachdem die Bestellung storniert worden war. Versenden Sie die Bestellung oder erstatten Sie die Zahlung.
Testzahlungen bestätigen im Live-Modus keine Bestellungen: Eine Testzahlung bezahlt eine Bestellung nie, solange Test Mode aus ist. Stattdessen wird die Bestellung mit einer Notiz auf „Wartend“ gesetzt. 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. Die 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 keine Erstattung durchgeführt. Versuchen Sie es später erneut.
Ihr Terminal akzeptiert eine Währung, die nicht in der Liste steht: Entwickler können die Liste der Währungen mit dem Filter rdsg_currency_codes ändern. Fügen Sie eine Währung nur hinzu, wenn Ihre Bank sie für das Terminal freigeschaltet hat.
Nach dem Update von Version 1.0: Der Schlüssel, den Sie im Testmodus verwendet haben, steht nun unter Secret Key (SHA-256) — test. Geben Sie den Live-Schlüssel ein, bevor Sie Test Mode deaktivieren. Mit Version 1.0 erstellte Bestellungen erhalten weiterhin Benachrichtigungen und Erstattungen.
Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.
Deinstallation
Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen und die Plugin-Protokolle werden nur entfernt, wenn Delete Data aktiv war; andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Die auf Bestellungen gespeicherten Redsys-Daten bleiben immer erhalten, da sie die Zahlungen dokumentieren und für Erstattungen benötigt werden. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.
Redsys ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Redsys verbunden noch wird es von Redsys unterstützt.