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

Barion-Shop: Sie benötigen den POSKey (geheimer Schlüssel) Ihres Shops und die E-Mail-Adresse der Barion-Wallet, die die Zahlungen erhält. Beides finden Sie im Barion-Portal: secure.barion.com für den Livebetrieb, secure.test.barion.com für Tests, unter My stores und Ihrem Shop. Test- und Livebetrieb haben unterschiedliche Zugangsdaten.

Währung: Die Bestellwährung muss HUF, EUR, USD oder CZK sein. Bei anderen Währungen wird die Zahlungsart an der Kasse ausgeblendet.

Erreichbarer Shop: Barion ruft nach jeder Zahlung Ihren Shop auf. Die Website muss deshalb aus dem Internet erreichbar sein, ohne Firewall oder Basisauthentifizierung davor. Der Wartungsmodus blockiert den Callback nicht: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und unter OpenCart 4 fügt die Erweiterung dafür eine Startaktion hinzu.

VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. 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_barion_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_barion_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_barion_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, wählen Sie den Typ Payments, suchen Sie VibeFox Barion 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 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 Abschnitt Lizenzschlüssel).

4. Geben Sie den Test-POSKey und die Test-Wallet-E-Mail ein, lassen Sie Test Mode eingeschaltet, aktivieren Sie Enable/Disable und klicken Sie auf Save. Führen Sie eine Testbestellung durch.

5. Wenn alles funktioniert, geben Sie die Live-Zugangsdaten ein und schalten Sie Test Mode aus.

OpenCart 4

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

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

Die Callback-URL wird bei jeder Zahlung automatisch an Barion übermittelt. Im Barion-Portal muss nichts konfiguriert werden. Eine Neuinstallation startet mit deaktivierter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Barion Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn für den aktuellen Modus kein POSKey oder keine Empfänger-E-Mail hinterlegt ist (die Zahlungsart wird dann an der Kasse ausgeblendet), und wenn die Standardwährung Ihres Shops von Barion nicht unterstützt wird; die unterstützten Währungen werden aufgelistet. Solange der Testmodus eingeschaltet ist, zeigt sie Test mode is on: payments go to the Barion sandbox (api.test.barion.com), no real money is charged. an. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title 1 bis 128 Zeichen lang sein, Sort Order muss eine ganze Zahl sein und Total eine Zahl von 0 oder mehr. Enthält ein Feld einen Fehler, wird nichts gespeichert und die Seite nennt das betreffende Feld.

Barion

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

Title: Der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Barion. Pflichtfeld, bis zu 128 Zeichen.

Description: Der Text, den der Kunde im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche sieht. Standard: Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay.

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

Geo Zone: Bieten Sie Barion nur für Rechnungsadressen in der gewählten Geozone an. Standard: All zones. Geozonen richten Sie unter System > Localisation > Geo Zones ein.

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

Barion-Zugangsdaten des Shops

Ihren POSKey und Ihre Wallet-E-Mail erhalten Sie im Barion-Portal: secure.barion.com (Live) oder secure.test.barion.com (Test), My stores, Ihr Shop (die Portale sind in diesem Abschnitt verlinkt). Im Testmodus werden nur die Testzugangsdaten verwendet, im Livemodus nur die Livezugangsdaten.

Test Mode: Verwendet die unten eingetragenen Testzugangsdaten und die Barion-Sandbox (api.test.barion.com). Es wird kein echtes Geld abgebucht. Standard: eingeschaltet. Schalten Sie den Modus aus, um echte Zahlungen anzunehmen. Ist er eingeschaltet, sehen Kunden im Schritt Confirm Order den Hinweis Test mode: no real payment is taken.

Test POSKey: Der geheime Schlüssel (POSKey) Ihres Shops im Barion-Testsystem (secure.test.barion.com, My stores).

Test Payee Email: Die E-Mail-Adresse Ihrer Barion-Testwallet, die die Testzahlungen erhält.

Live POSKey: Der geheime Schlüssel (POSKey) Ihres Shops im Barion-Livesystem (secure.barion.com, My stores).

Live Payee Email: Die E-Mail-Adresse Ihrer Barion-Wallet, die die Zahlungen erhält.

Gespeicherte POSKeys werden nie erneut angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. an. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten POSKey zu entfernen, aktivieren Sie unter dem Feld Clear the saved POSKey on save und klicken Sie auf Save.

Callback URL: Die Adresse, die Barion nach jeder Zahlung aufruft. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_barion_gateway/callback, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_barion_gateway/payment/wcp_barion_gateway.callback. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Sie wird bei jeder Zahlung an Barion übermittelt, daher ist nichts zu konfigurieren. Sie muss lediglich aus dem Internet erreichbar sein.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Sie erhält erst einen Status, nachdem Barion die Zahlung gemeldet hat (per Callback oder bei der Rückkehr des Kunden; der Status wird immer bei Barion abgefragt). Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: Der Status, der nach einer erfolgreichen, geprüften Zahlung gesetzt wird. Standard: In Bearbeitung.

Awaiting Barion Payment Status: Der Kunde hat auf der Barion-Seite abgeschlossen, Barion verarbeitet die Zahlung aber noch. Standard: Zahlung ausstehend.

Barion Payment On Hold Status: Die Zahlung ist eingegangen, der Betrag oder die Währung weicht aber von der Bestellung ab. Eine Notiz erklärt den Grund; prüfen Sie die Zahlung manuell. Standard: Zahlung ausstehend, da OpenCart keinen Status Wartend kennt. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Payment Failed Status: Eine Bestellung, die auf Zahlung wartet, deren Barion-Zahlung fehlgeschlagen ist. Standard: Fehlgeschlagen.

Payment Canceled Status: Eine Bestellung, die auf Zahlung wartet, deren Barion-Zahlung abgebrochen wurde oder abgelaufen ist. Standard: Storniert.

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

Erweitert

Logging: Schreibt Barion-Anfragen und Callbacks in die Datei barion_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über das Web öffnen. Geheime Schlüssel und Wallet-E-Mails werden nicht protokolliert. Standard: aus. Bei ausgeschaltetem Logging wird nichts geschrieben, auch keine Fehler.

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

Delete Data on Uninstall: Ist die Option eingeschaltet, entfernt das Deinstallieren der Erweiterung die Einstellungen des Gateways und das Protokoll. Bestellungen und ihre Barion-Zahlungsdaten bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. POSKeys werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte POSKeys bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Barion). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the secure Barion payment page. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, startet die Erweiterung eine Barion-Zahlung über den Bestellbetrag in der Bestellwährung und leitet den Kunden zur Barion-Zahlungsseite weiter. Die Produkte, der Versand, weitere Bestellgebühren und die Steuer werden in der Zahlung aufgeführt. Die OpenCart-Bestellnummer wird als Bestellnummer übergeben, die E-Mail-Adresse des Kunden als Hinweis. Die Sprache der Zahlungsseite richtet sich nach der Sprache des Kunden, sofern Barion sie unterstützt (Ungarisch, Deutsch, Französisch, Spanisch, Tschechisch, Slowakisch, Slowenisch, Griechisch, sonst Englisch). Auf OpenCart 4 wählt der Kunde die Zahlungsart über die Schaltfläche Choose im Zahlungsartenblock im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück, und Barion ruft außerdem die Callback-URL auf. Keine dieser Anfragen markiert allein etwas als bezahlt: Die Erweiterung fragt bei Barion den Zahlungsstatus mit dem POSKey des Modus ab, in dem die Zahlung gestartet wurde. Die Bestellung wird erst als bezahlt markiert, wenn Barion dies bestätigt, und nur dann, wenn Betrag und Währung mit der Bestellung übereinstimmen. Der Rücksprunglink enthält ein zufälliges Token des Zahlungsversuchs; geprüft werden nur Zahlungen, die für diese Bestellung gestartet wurden. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Auf OpenCart 4 sendet der Browser die Sitzung des Shops nicht mit, wenn Barion den Kunden zurückschickt. Daher zeigt die Erweiterung zuerst eine kurze Seite, die denselben Rücksprunglink erneut aus Ihrem Shop öffnet: Der Kunde behält Warenkorb und Anmeldung.

Wurde die Zahlung erfolgreich abgeschlossen, sieht der Kunde die Erfolgsseite der OpenCart-Bestellung. Ist die Zahlung bei Barion noch in Bearbeitung, erhält die Bestellung den Status Awaiting Barion Payment Status, und die Erfolgsseite zeigt Your payment is being confirmed by Barion. You will receive an e-mail as soon as it is confirmed. Kann Barion bei der Rückkehr des Kunden nicht erreicht werden oder ist die Zahlung erfolgt, aber noch nicht übernommen, zeigt eine Seite Payment confirmation denselben Text und eine Schaltfläche Check again. Der Callback setzt den Bestellstatus, sobald Barion die Zahlung bestätigt.

Wurde die Zahlung nicht abgeschlossen (abgebrochen, abgelaufen oder fehlgeschlagen), bleibt die Bestellung ohne Status, der Warenkorb bleibt erhalten und der Kunde gelangt mit der Meldung Payment was not completed. Please try again. zurück zur Kasse. Passt der Rücksprunglink nicht zur Bestellung, lautet die Meldung Payment verification failed. Auf OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt. Auf OpenCart 3 legt jeder neue Versuch eine neue OpenCart-Bestellung an. OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie, daher ist der neue Versuch eine neue Barion-Zahlung für dieselbe Bestellung. Barion kann eine gestartete Zahlung nicht abbrechen, daher prüft die Erweiterung vor einer neuen Zahlung die früheren offenen Zahlungen des Warenkorbs bei Barion: Ist eine davon bezahlt oder noch in Bearbeitung, wird ihre Bestellung bestätigt und der Kunde gelangt zur Erfolgsseite, ohne erneut zu zahlen. Ist eine andere Bestellung desselben Warenkorbs (dieselben Produkte im selben Besuch) bereits bezahlt, gelangt der Kunde ebenfalls zur Erfolgsseite, ohne eine neue Zahlung zu leisten; ein neuer Einkauf nach einem abgeschlossenen ist ein neuer Warenkorb. Eine verspätete Zahlung eines früheren Versuchs derselben Bestellung bestätigt sie weiterhin, und ein früherer Versuch, der abläuft, storniert die Bestellung nicht. Bezahlt der Kunde zwei Bestellungen aus einem Warenkorb (zwei Tabs), bestätigt die zweite Zahlung ihre Bestellung nicht: Die bezahlte Bestellung erhält eine Notiz, dass eine zweite Zahlung für denselben Warenkorb eingegangen ist, damit Sie sie im Barion-Portal erstatten können.

Auf OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel weil ihre ausstehende Zahlung bei Barion abgebrochen wurde oder Sie die Bestellung abgebrochen haben), schickt das nächste Confirm Order den Kunden mit Payment was not completed. Please try again. zurück zur Kasse, und die Kasse legt dann eine neue Bestellung des Warenkorbs an. Hat die Bestellung bereits einen Status und hat sich der Warenkorb seitdem geändert (andere Produkte oder Mengen), verlässt die Bestellung die Kasse, und der geänderte Warenkorb erhält eine neue Bestellung und eine eigene Zahlung.

Kann die Zahlung nicht gestartet werden, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche: The Barion payment could not be started. Please try again or choose another payment method., Barion does not support payments in der Bestellwährung, Barion payment is not available at the moment. Please choose another payment method. oder Barion cannot process an order with a zero total. Die Details werden bei eingeschaltetem Logging im Protokoll gespeichert.

Die Erweiterung unterstützt nur sofortige Zahlungen. Sie kennt keine Reservierungen oder verzögerten Einzugszahlungen, keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten, kein Barion Pixel und keine zusätzlichen 3-D-Secure-Daten; 3-D Secure übernimmt Barion auf der eigenen Zahlungsseite.

Bestellungen und Erstattungen

Bestellstatus

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

Awaiting Barion Payment Status (Standard Pending): Barion meldet die Zahlung als noch in Bearbeitung. Eine Notiz zeigt die Barion-PaymentId, den Betrag und im Testmodus (test mode). Die Bestellung wechselt in den Bezahlt-Status, sobald Barion die Zahlung bestätigt.

Order Status After Payment (Standard Processing): Barion hat die Zahlung bestätigt. Eine Notiz zeigt den Betrag, die PaymentId und die Barion-Transaktion.

Barion Payment On Hold Status (Standard Pending): Barion hat einen anderen Betrag oder eine andere Währung gemeldet als den Bestellbetrag. Die Notiz zeigt beide Beträge. Prüfen Sie die Zahlung im Barion-Portal und schließen Sie dann die Bestellung ab oder erstatten Sie die Zahlung im Barion-Portal.

Payment Canceled Status (Standard Canceled): Der letzte Zahlungsversuch einer wartenden Bestellung wurde bei Barion abgebrochen oder ist abgelaufen.

Payment Failed Status (Standard Failed): Der letzte Zahlungsversuch einer wartenden Bestellung ist fehlgeschlagen.

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

Ist eine Zahlung der Bestellung noch erfolgreich, nachdem die Bestellung storniert oder fehlgeschlagen ist, wird die Bestellung bezahlt. Eine bezahlte oder erstattete Bestellung wird durch einen späteren Callback nie verändert. Wenn eine weitere Zahlung für eine bezahlte Bestellung erfolgreich ist, weist eine Notiz darauf hin, dies im Barion-Portal zu prüfen und die Zahlung zu erstatten, falls es sich um ein Duplikat handelt. Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht.

Tab VibeFox Barion Gateway

Öffnen Sie unter Sales > Orders eine mit Barion bezahlte Bestellung. Am unteren Rand der Bestellseite, neben History und Additional, zeigt der Tab VibeFox Barion Gateway die PaymentId mit der Kennzeichnung Test mode bei Testzahlungen, die Barion-Transaction, den Zahlungs-Status, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die Barion notes der Bestellung. Der Tab wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Tab VibeFox Barion Gateway den Betrag ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Barion. Bestätigen Sie die Abfrage Diesen Betrag über Barion erstatten? Dies kann nicht rückgängig gemacht werden. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Der Grund wird als Kommentar an Barion übermittelt. Erstattungen in HUF müssen ganze Beträge sein. Die Erstattung wird im Modus (Test oder Live) gesendet, in dem die Zahlung erfolgt ist, daher muss der POSKey dieses Modus hinterlegt sein. Akzeptiert oder bestätigt Barion die Erstattung nicht, zeigt der Tab den Fehler an und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen mit der Barion-Transaktion und dem Status hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte zurück in den Bestand zu buchen, wie bei einer manuellen Statusänderung. Eine teilweise Erstattung ändert den Status nicht.

Erstattungen sind verfügbar, sobald Barion die Zahlung bestätigt hat und die Bestellung dadurch bezahlt ist. Eine Zahlung mit Abweichung von Betrag oder Währung kann nicht aus OpenCart erstattet werden; erstatten Sie sie im Barion-Portal. Produktrücksendungen unter Sales > Returns erstatten kein Geld über Barion.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Barion Gateway ist der erste Block auf Extensions > Extensions > Payments > VibeFox Barion 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 Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-payment-barion und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht 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 Schlüssel nicht gefunden, Dieser Schlüssel gehört zu einem anderen Produkt, Domainlimit erreicht oder Lizenz abgelaufen am mit einem Datum. Nachdem sich die Shop-Adresse geändert hat oder 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 funktioniert 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 Barion 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 Zahlungsart im Shop weiterhin, gekennzeichnet mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Auf OpenCart 4 gibt es diese Vorschau nicht: Der Shop sieht die Anmeldung im Admin nicht, daher ist die Zahlungsart ohne aktive Lizenz für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint eine Erinnerung auf dem Dashboard im Admin. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen bleiben unberührt: Bereits gestartete Zahlungen werden weiterhin 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 beim Öffnen des Dashboard im Admin oder der Seite Edit automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Beim Deinstallieren der Erweiterung werden immer der Lizenzschlüssel und der Lizenzstatus entfernt.

Fehlerbehebung

Barion erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, im aktuellen Modus ein POSKey und eine Empfänger-E-Mail hinterlegt sind (die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt) und ob die Bestellwährung HUF, EUR, USD oder CZK ist. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist eingegangen, aber die Bestellung bleibt ohne Status: Die Bestellung erhält ihren Status, wenn Barion die Callback-URL aufruft oder wenn der Kunde in Ihren Shop zurückkehrt. Stellen Sie sicher, dass die Website aus dem Internet erreichbar ist (keine Firewall oder Basisauthentifizierung vor der Callback-URL). Prüfen Sie, dass der POSKey des Modus, in dem die Zahlung erfolgte, korrekt ist, da die Erweiterung damit den Zahlungsstatus bei Barion abfragt. Schalten Sie Logging ein, um den Callback zu sehen.

Der Callback antwortet Busy, retry: Die Bestellung wurde im selben Moment durch die Rückkehr des Kunden verarbeitet, oder der Bestellstatus konnte nicht gesetzt werden. Barion ruft erneut auf. Schalten Sie Logging ein, um den Grund zu sehen.

Der Callback antwortet API error: Der Shop konnte den Zahlungsstatus nicht bei Barion abrufen, oder der POSKey des Modus, in dem die Zahlung erfolgte, ist nicht gesetzt. Prüfen Sie diesen POSKey.

Der Callback antwortet Order not found: Die PaymentId wurde nicht von diesem Shop gestartet. Barion-Aufrufe für andere Shops oder Testsysteme werden ignoriert.

Der Kunde sieht Payment verification failed.: Der Rücksprunglink passt nicht zur Bestellung, zum Beispiel weil er verändert wurde. Der Zahlungsstatus wird trotzdem durch den Callback bestätigt.

Der Kunde sieht nach Confirm Order einen Fehler: Schalten Sie Logging ein und sehen Sie im Feld Log auf der Erweiterungsseite nach. Ein falscher POSKey oder eine falsche Empfänger-E-Mail führt zu The Barion payment could not be started. This payment method is not available. Please reload the checkout page. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt oder die Zahlungsart inzwischen deaktiviert wurde: Der Kunde lädt die Kasse neu.

Die Bestellung ist im Status „On hold“: Lesen Sie die Abweichungsnotiz im Tab VibeFox Barion Gateway, prüfen Sie die Zahlung im Barion-Portal und schließen Sie dann die Bestellung ab oder erstatten Sie sie im Barion-Portal.

Warum kann ich 10.50 HUF nicht erstatten: Barion verarbeitet HUF ohne Nachkommastellen. Geben Sie einen ganzen Betrag ein.

Kein Erstattungsformular im Tab: Der Tab nennt den Grund: Die Zahlung ist noch nicht bestätigt, sie ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern, oder der POSKey des Zahlungsmodus ist nicht konfiguriert.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse wcp_barion_supported_currencies (die Liste der Währungen) und wcp_barion_payment_request (die Zahlungsanfrage und die Bestellung, bevor sie an Barion gesendet werden) aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Barion Gateway auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt außerdem immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus des Abschnitts Orders, die bei einer erneuten Installation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 seine Ereignisse und seine Startaktion, die den Callback im Wartungsmodus durchlässt). Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, POSKeys, Empfänger-E-Mails, Logging) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Zahlungs- und Erstattungsdaten von Barion bleiben immer erhalten, sodass vorher 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 Barion Gateway auf Uninstall (der orangefarbene −-Button) und danach auf Delete (der rote Papierkorb-Button), um das hochgeladene Paket zu entfernen.

Barion ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung steht in keiner Verbindung zu Barion und wird von Barion weder unterstützt noch empfohlen.