VibeFox Przelewy24 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: Die Bestellung muss in PLN, EUR, GBP oder CZK erfolgen. In anderen Währungen wird die Zahlungsart an der Kasse ausgeblendet. Die Bestellung wird in ihrer eigenen Währung belastet; die Erweiterung rechnet keine Währungen um.

Przelewy24-Konto: Sie benötigen ein Händlerkonto bei Przelewy24 und dessen API-Daten: die Merchant ID, den API-Schlüssel (im Przelewy24-Panel report key genannt), den CRC-Schlüssel und, falls Ihr Shop eine eigene ID hat, die POS ID (Shop ID). Sie finden sie im Händlerpanel von Przelewy24 unter panel.przelewy24.pl, unter My data > API data and configuration. Sandbox-Schlüssel stammen aus einem separaten Sandbox-Konto unter sandbox.przelewy24.pl/panel. Im Przelewy24-Panel muss sonst nichts eingerichtet werden: Die Erweiterung sendet ihre Benachrichtigungs-URL bei jeder Zahlung mit. Ihr Shop muss aus dem Internet erreichbar sein, weil Przelewy24 ihm Zahlungsbenachrichtigungen schickt.

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

Installation

Der Download ist eine einzelne ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das OpenCart-3-Paket wcp_przelewy24_payment-oc3-(Version).ocmod.zip und das OpenCart-4-Paket wcp_przelewy24_payment.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 Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_przelewy24_payment-oc3-(Version).ocmod.zip. Die Erweiterung hat 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 Przelewy24 Payment und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Administratorbenutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

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 Sandbox-Schlüssel ein (Merchant ID, API-Schlüssel, CRC-Schlüssel; die POS ID nur, wenn sie von der Merchant ID abweicht), aktivieren Sie Enable/Disable, klicken Sie auf Save und führen Sie eine Testzahlung im Sandbox-Modus durch.

5. Geben Sie die Live-Schlüssel ein, deaktivieren Sie Test Mode und klicken Sie auf Save, um echte Zahlungen anzunehmen.

OpenCart 4

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_przelewy24_payment.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 Przelewy24 Payment, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

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

Eine neue Installation startet mit deaktivierter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Przelewy24 Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Über den Einstellungen zeigt die Seite Warnungen, wenn etwas fehlt. Solange die Sandbox aktiv ist: Sandbox (test) mode is on: payments go to the Przelewy24 sandbox and no real money is charged. Do not ship orders paid in test mode. Wenn die Schlüssel des aktuellen Modus unvollständig sind: Enter the Sandbox Merchant ID, API key and CRC key - until then Przelewy24 is not shown at checkout. (oder dasselbe für die Live-Schlüssel). Akzeptiert Przelewy24 die Standardwährung Ihres Shops nicht, nennt die Warnung die Währung und die unterstützten Währungen. Nach dem Speichern folgen die Warnungen sofort dem neuen Modus und den neuen Schlüsseln. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern wird nichts gespeichert, wenn ein Feld fehlerhaft ist: Title darf nicht leer sein (Enter a title for the payment method (at most 128 characters).), Sort Order muss eine ganze Zahl sein (negative Werte sind erlaubt), Total muss eine Zahl von 0 oder größer sein, und Geo Zone sowie die Bestellstatus müssen vorhanden sein. Fehlende Schlüssel verhindern das Speichern nicht. Leerzeichen und Zeilenumbrüche, die zusammen mit den Schlüsseln aus dem Przelewy24-Panel kopiert wurden, werden beim Speichern entfernt.

Przelewy24

Enable/Disable: Enable Przelewy24 Payment schaltet die Zahlungsart ein oder aus. Standard: off.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Przelewy24. Pflichtfeld, höchstens 128 Zeichen.

Description: der Text, der dem Kunden im Schritt Confirm Order über der Schaltfläche zum Bestätigen angezeigt wird. Standard: Pay with BLIK, online bank transfer or card via Przelewy24.

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

Geo Zone: Przelewy24 nur für Zahlungsadressen in der gewählten Geo-Zone anbieten. Standard: All zones. Geo-Zonen richten Sie unter System > Localisation > Geo Zones ein.

Total: der Warenkorbbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor Przelewy24 angeboten wird. Lassen Sie das Feld leer, um Przelewy24 bei jedem Betrag anzubieten.

API-Zugangsdaten

Dieser Abschnitt erklärt, wo Sie die Schlüssel finden (My data > API data and configuration im Händlerpanel von Przelewy24), und verlinkt auf das Przelewy24-Panel und das Sandbox-Panel.

Test Mode: nutzt die Przelewy24-Sandbox und die Sandbox-Schlüssel. Es wird kein echtes Geld belastet. Deaktivieren Sie die Option, um mit den Live-Schlüsseln echte Zahlungen anzunehmen. Standard: on. Solange sie aktiviert ist, sieht der Kunde im Schritt Confirm Order den Hinweis Sandbox mode - no real money is charged.

Live-Schlüssel

Live Merchant ID: Ihre Przelewy24-Händler-ID, nur Ziffern.

Live POS ID (optional): die Shop ID (posId). Lassen Sie das Feld leer, wenn sie gleich der Merchant ID ist.

Live API key (report key): der API-Schlüssel aus dem Przelewy24-Panel. Er dient der API-Authentifizierung.

Live CRC key: dient dazu, Anfragen an Przelewy24 zu signieren, und die Signatur der Benachrichtigungen von Przelewy24 zu prüfen.

Sandbox-Schlüssel

Sandbox Merchant ID: die Merchant ID Ihres Przelewy24-Sandbox-Kontos.

Sandbox POS ID (optional): die Shop ID (posId) des Sandbox-Kontos. Lassen Sie das Feld leer, wenn sie gleich der Merchant ID ist.

Sandbox API key (report key): der API-Schlüssel des Sandbox-Kontos.

Sandbox CRC key: der CRC-Schlüssel des Sandbox-Kontos; er dient dazu, Anfragen zu signieren und Sandbox-Benachrichtigungen zu prüfen.

Gespeicherte API-Schlüssel und CRC-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 the saved value und klicken Sie auf Save.

Live- und Sandbox-Schlüssel sind verschieden. Merchant ID und POS ID dürfen nur Ziffern enthalten; solange die Merchant ID, der API-Schlüssel und der CRC-Schlüssel des aktuellen Modus nicht eingegeben sind, wird die Zahlungsart an der Kasse nicht angezeigt. Eine in einem Modus gestartete Zahlung wird immer mit den Schlüsseln dieses Modus geprüft und erstattet, auch nach dem Umschalten. Bewahren Sie daher die Schlüssel des alten Modus auf, solange dessen Zahlungen noch offen sind oder erstattet werden könnten.

Zahlungsbenachrichtigungen

Notification URL: die Adresse, die Zahlungsbenachrichtigungen von Przelewy24 empfängt. Auf OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_przelewy24_payment/notify, auf OpenCart 4 so: https://your-store/index.php?route=extension/wcp_przelewy24_payment/payment/wcp_przelewy_24payment.notify. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Die Erweiterung sendet diese URL bei jeder Zahlung und jeder Erstattung an Przelewy24, daher muss im Przelewy24-Panel nichts konfiguriert werden. Die URL muss aus dem Internet erreichbar sein: keine Firewall und keine HTTP-Authentifizierung davor. Sie funktioniert auch im Wartungsmodus des Shops: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und auf OpenCart 4 fügt die Erweiterung dafür eine Startaktion für die Benachrichtigungs-URL und die Rückkehr des Kunden hinzu. Ohne Benachrichtigungen wird eine Zahlung trotzdem bestätigt, wenn der Kunde in den Shop zurückkehrt (siehe Kasse); kehrt der Kunde nicht zurück, bleibt die Bestellung ohne Status.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst einen Status, nachdem Przelewy24 die Zahlung bestätigt und die Erweiterung sie geprüft hat. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Paid Order Status: der Status nach einer geprüften Zahlung. Standard: Processing.

On Hold (Review) Status: Zahlungen, deren Betrag oder Währung nicht zur Bestellung passt (nicht geprüft), oder die nach der Stornierung der Bestellung eingehen, erhalten diesen Status und eine Notiz mit der Begründung. Standard: Pending, weil OpenCart keinen Status On hold hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Cancelled Order Status: die Erweiterung setzt ihn nie. Eine für eine Bestellung in diesem Status geprüfte Zahlung setzt die Bestellung auf Wartezeit, statt sie stillschweigend wieder zu öffnen. Standard: Canceled.

Refunded Status: wird gesetzt, nachdem die Zahlung auf der Bestellseite vollständig erstattet wurde. Standard: Refunded.

Erweitert

Debug Log: schreibt technische Ereignisse (Bestellnummern, P24-Transaktions-IDs, Fehler) in wc_p24_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über das Web öffnen; bei 5 MB wird sie nach wc_p24_debug.old.log.php verschoben. Fehler und Warnungen, etwa abgelehnte Benachrichtigungen oder eine fehlgeschlagene Prüfung oder Erstattung, werden immer protokolliert; schalten Sie den Schalter ein, um zusätzlich jeden Schritt zu protokollieren. Schlüssel und personenbezogene Daten werden nie protokolliert. Standard: off.

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

Delete data on uninstall: ist die Option aktiviert, entfernt die Deinstallation der Erweiterung die Einstellungen der Zahlungsanbindung und das Protokoll. Bestellungen und ihre Przelewy24-Zahlungsdaten werden nie gelöscht. Standard: off.

Import / Export

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

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte API- und CRC-Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Przelewy24). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the secure Przelewy24 page to complete the payment. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, registriert die Erweiterung bei Przelewy24 eine Transaktion über den Bestellbetrag in der Bestellwährung, mit der E-Mail-Adresse, dem Namen und dem Rechnungsland des Kunden sowie der Beschreibung Order # mit der Bestellnummer und dem Namen Ihres Shops. Jeder Zahlungsversuch erhält eine eigene Sitzungs-ID. Der Kunde wird zur Zahlungsseite von Przelewy24 geleitet und zahlt mit BLIK, einer Online-Banküberweisung, einer Karte oder einer anderen Methode, die für Ihr Przelewy24-Konto aktiviert ist. Die Zahlungsseite wird in der Sprache der Bestellung angezeigt, wenn Przelewy24 sie unterstützt, andernfalls auf Englisch. Auf OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose des Zahlungsartenblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order.

Die Bestellung wird erst als bezahlt markiert, nachdem Przelewy24 die Zahlung bestätigt hat. Przelewy24 sendet eine signierte Benachrichtigung an Ihren Shop. Die Erweiterung prüft die Signatur mit dem CRC-Schlüssel, der Merchant ID und der POS ID, ob die Sitzung für diese Bestellung und im selben Modus registriert wurde und ob Betrag und Währung mit dem Zahlungsversuch und dem Bestellbetrag übereinstimmen. Erst dann prüft sie die Transaktion bei Przelewy24 (Przelewy24 schreibt nur geprüfte Zahlungen gut) und setzt Paid Order Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Webhooks ohne gültige Signatur werden abgelehnt.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Ist die Benachrichtigung noch nicht eingetroffen, fragt die Erweiterung den Transaktionsstatus bei Przelewy24 mit einer authentifizierten Server-zu-Server-Anfrage ab (höchstens einmal alle 10 Sekunden je Versuch) und wendet dieselben Prüfungen an. Die Rückkehrseite allein markiert eine Bestellung nie als bezahlt. Ist die Zahlung bestätigt, sieht der Kunde die Erfolgsseite der OpenCart-Bestellung. Solange sie nicht bestätigt ist, zeigt eine Seite Payment confirmation den Hinweis We have not received the payment confirmation from Przelewy24 yet. If you have paid, it will be confirmed in a few minutes. If the payment was interrupted, you can try again: mit einer Schaltfläche Check again und einer Schaltfläche Pay again, die die Kasse öffnet. Der Warenkorb bleibt erhalten, und eine später auf einer älteren Przelewy24-Seite getätigte Zahlung wird weiterhin akzeptiert. Ist die Bestellung auf Wartezeit, zeigt die Erfolgsseite Your payment is being verified. We will send you an e-mail as soon as it is confirmed. Bringt eine spätere Zahlung die Bestellung vom Wartestatus auf Paid Order Status, wird der Kunde per E-Mail benachrichtigt. Haben Sie die Bestellung vor der Zahlung storniert und liegt bei Przelewy24 keine Zahlung dafür vor, sieht der zurückkehrende Kunde: Order #… was cancelled by the store before the payment was completed. No Przelewy24 payment was received for it. Please place a new order or contact us.

Kann die Zahlung nicht gestartet werden, bleibt der Kunde im Schritt Confirm Order und sieht über der Schaltfläche eine kurze Meldung: Payment error: Przelewy24 could not start the payment. Please try again or choose another payment method. (der Grund wird ins Protokoll geschrieben), Payment gateway is not configured properly. Please contact the administrator. (Schlüssel des aktuellen Modus fehlen), eine Meldung, dass Przelewy24 keine Zahlungen in der Bestellwährung annehmen kann, oder The order total must be greater than zero. OpenCart 3 legt jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung an. Eine bereits bezahlte Bestellung oder ein bereits bezahlter Warenkorb wird nicht erneut an Przelewy24 gesendet; der Kunde gelangt zur Erfolgsseite.

OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie jedes Mal, wenn der Schritt Confirm Order angezeigt wird; Pay again startet daher eine neue Przelewy24-Transaktion für dieselbe Bestellung. Hat der Shop diese Bestellung inzwischen geschlossen (zum Beispiel storniert oder erstattet), wird der Kunde mit Your previous order was closed by the store. Please confirm the order again to place and pay a new order. zur Kasse zurückgeschickt (bei einer vor jeder Zahlung stornierten Bestellung mit der Meldung zur stornierten Bestellung oben), und 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, sieht der Kunde Your previous order #… has already been placed. Your cart has changed: please confirm the new order to pay for it., und der neue Warenkorb wird mit einer neuen Bestellung bezahlt. Auf OpenCart 4 werden diese Meldungen sowie We could not match this payment to an order. If you were charged, please contact us. über der Kassenseite angezeigt.

Die Erweiterung unterstützt keine gespeicherten Karten oder Ein-Klick-Zahlungen, keine Abonnements oder wiederkehrenden Zahlungen, keine Auswahl der P24-Zahlungsmethode (zum Beispiel ein BLIK-Codefeld) auf Ihrer Kassenseite, keine Ratenzahlungs-Widgets und sendet keinen Warenkorbinhalt an Przelewy24.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu Przelewy24 geschickt und hat nicht bezahlt, oder die Zahlung ist noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Paid Order Status (Standard Processing): Die Zahlung wurde geprüft. Eine Notiz zeigt die P24-Bestell-ID, den Betrag und den Modus. Jede Zahlung wird nur einmal verarbeitet.

On Hold (Review) Status (Standard Pending): Der von Przelewy24 gemeldete Betrag oder die Währung weicht von der Bestellung ab; die Zahlung wurde nicht bestätigt, und die Notiz sagt das. Oder die Zahlung ist eingegangen und für eine Bestellung im Status „storniert“ geprüft worden; die Bestellung wird nicht stillschweigend wieder geöffnet, die Notiz fordert Sie auf, sie zu versenden oder die Zahlung zu erstatten. Prüfen Sie die Zahlung im Przelewy24-Panel. Geht später für eine Bestellung im Wartestatus nach einer Abweichung eine korrekte Zahlung eines anderen Versuchs ein, wechselt die Bestellung zu Paid Order Status.

Refunded Status (Standard Refunded): Die Zahlung wurde über die Erweiterung vollständig erstattet.

Geht eine zweite Zahlung für eine Bestellung oder einen Warenkorb ein, der bereits bezahlt oder erstattet ist (ein älterer Zahlungslink, zwei Browser-Tabs, eine andere Bestellung desselben Warenkorbs), wird sie nicht bestätigt, und Przelewy24 bucht sie nicht gut. Eine Notiz an der bezahlten Bestellung bittet Sie, die Zahlung im Przelewy24-Panel zu prüfen und bei Bedarf an den Käufer zurückzuzahlen.

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

Reiter VibeFox Przelewy24 Payment

Öffnen Sie unter Sales > Orders eine mit Przelewy24 bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Przelewy24 Payment die P24-Bestell-ID, die Session, die Environment (Sandbox oder Live), den Status der Zahlung und wie sie geprüft wurde (Benachrichtigung oder Rückkehr), die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die Payment notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Reiter VibeFox Przelewy24 Payment den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Przelewy24. Bestätigen Sie die Abfrage Refund this amount through Przelewy24? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt, bis zum noch nicht erstatteten Betrag. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Die Erstattung wird in dem Modus gesendet, in dem die Zahlung getätigt wurde (Sandbox oder Live), daher müssen die Schlüssel dieses Modus eingerichtet sein. Erstattungen sind verfügbar, sobald Przelewy24 die Zahlung geprüft hat.

Przelewy24 verarbeitet Erstattungen asynchron. Der Reiter zeigt Refund of … requested at Przelewy24. The result will be added as an order note., der Erstattungsverlauf zeigt den Status requested, und eine Notiz wird hinzugefügt. Das Ergebnis trifft später an der Benachrichtigungs-URL ein: Der Status wird completed mit der Notiz Przelewy24: refund of … completed., oder rejected mit einer Notiz, dass das Geld nicht an den Käufer zurückgegeben wurde. Eine vollständige Erstattung setzt die Bestellung bei der Anfrage auf Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie eine manuelle Statusänderung. Eine teilweise Erstattung ändert den Status nicht. Wird eine Erstattung abgelehnt, prüfen Sie sie im Przelewy24-Panel; der Bestellstatus wird nicht automatisch zurückgesetzt.

Lehnt Przelewy24 die Erstattungsanfrage ab, zeigt der Reiter Przelewy24 refund failed: mit dem Grund, und es wird keine Erstattung erfasst. Produktrücksendungen unter Sales > Returns erstatten kein Geld über Przelewy24, und direkt im Przelewy24-Panel vorgenommene Erstattungen werden nicht zur Bestellung hinzugefügt.

Lizenzschlüssel

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

Ohne aktiven Schlüssel wird Przelewy24 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 Administrator, der im Administrationsbereich im selben Browser 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. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher wird die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Administrationsbereichs eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin geprüft und bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, 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 des Administrationsbereichs öffnen: täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach wöchentlich. Ein Cron-Job ist nicht nötig. Die Deinstallation der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Przelewy24 erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die Merchant ID, der API-Schlüssel und der CRC-Schlüssel des aktuellen Modus eingetragen sind (die Sandbox-Schlüssel, solange Test Mode eingeschaltet ist, sonst die Live-Schlüssel; Merchant ID und POS ID nur Ziffern) und die Bestellwährung PLN, EUR, GBP oder CZK ist. Die Warnungen oben in den Einstellungen benennen das Problem. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: Die Benachrichtigung von Przelewy24 hat Ihren Shop nicht erreicht, und der Kunde ist nicht in den Shop zurückgekehrt. Prüfen Sie, ob die Notification URL aus dem Internet erreichbar ist (keine Firewall und keine HTTP-Authentifizierung davor) und ob Merchant ID, POS ID und CRC-Schlüssel des Modus der Zahlung korrekt sind. Abgelehnte Benachrichtigungen werden auch bei ausgeschaltetem Debug Log protokolliert; sehen Sie im Feld Log auf der Seite der Erweiterung nach.

So beantwortet der Shop Benachrichtigungen: Eine verarbeitete, wiederholte oder unbekannte Benachrichtigung wird mit HTTP 200 beantwortet. Andernfalls sendet Przelewy24 sie später erneut: 400 (fehlende oder fehlerhafte Daten), 401 Invalid signature (falscher CRC-Schlüssel, andere Merchant ID oder POS ID), 401 Invalid signature for this payment (eine mit den Schlüsseln des anderen Modus signierte Benachrichtigung, anders als die Zahlung), 405 (keine POST-Anfrage), 500 Verification failed (die Prüfung bei Przelewy24 ist fehlgeschlagen; einmalig wird eine Notiz zur Bestellung hinzugefügt), 500 Order could not be updated (der Bestellstatus konnte nicht gesetzt werden; die nächste Benachrichtigung setzt ihn ohne neue Prüfung) und 503 Busy, retry later (die Bestellung wurde im selben Moment von einer anderen Anfrage bestätigt).

Der Kunde sieht Payment error: Przelewy24 could not start the payment: Przelewy24 hat die Transaktion abgelehnt, meist wegen falscher Schlüssel des aktuellen Modus (Sandbox-Schlüssel funktionieren nur im Sandbox-Modus, Live-Schlüssel nur im Live-Modus). Der Fehler von Przelewy24 steht im Protokoll.

Der Kunde sieht We could not match this payment to an order: Der Rücksprunglink von Przelewy24 passte zu keiner Bestellung des Shops. Wurde der Kunde belastet, suchen Sie die Zahlung im Przelewy24-Panel.

Die Bestellung ist nach der Zahlung im Prüfstatus: Lesen Sie die Notizen im Reiter VibeFox Przelewy24 Payment. Betrag oder Währung wichen von der Bestellung ab, oder die Zahlung ging für eine Bestellung ein, die storniert worden war. Prüfen Sie die Zahlung im Przelewy24-Panel und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Eine Erstattung schlägt fehl: This order has no verified Przelewy24 payment. Cannot process refund. bedeutet, dass die Bestellung nicht über eine geprüfte Przelewy24-Zahlung bezahlt wurde. The payment was made in the Przelewy24 sandbox, but the Sandbox keys are missing. (oder dasselbe für Live) bedeutet, dass die Schlüssel des Modus der Zahlung entfernt wurden; geben Sie sie erneut ein. Invalid refund amount bedeutet, dass der Betrag leer ist, keine Zahl ist oder den noch nicht erstatteten Betrag übersteigt.

Für Entwickler: Die Liste der Währungen lässt sich mit dem OpenCart-Ereignis wc_p24_supported_currencies ändern (nur Währungen mit zwei Dezimalstellen).

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Przelewy24 Payment 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 Bestellstatus im Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (auf OpenCart 4 außerdem seine Ereignisse und seine Startaktion, die Benachrichtigungen und die Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiviert, werden die übrigen Einstellungen der Zahlungsanbindung (Titel, Beschreibung, Testmodus, Schlüssel, Schalter des Debug-Logs) und das Protokoll entfernt. Ist sie deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die Przelewy24-Zahlungsdaten der Bestellungen (Sitzungen, P24-Bestell-IDs, Erstattungen) bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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