VibeFox Barion 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.
Barion-Shop: Sie benötigen den POSKey (geheimen 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 Live, secure.test.barion.com für Test, unter My stores und Ihrem Shop. Test- und Live-Zugangsdaten sind unterschiedlich.
Währung: Die Warenkorbwährung muss HUF, EUR, USD oder CZK sein. Bei anderen Währungen wird die Zahlungsart an der Kasse ausgeblendet.
Erreichbarer Shop: Barion ruft Ihren Shop nach jeder Zahlung auf. Die Website muss daher aus dem Internet erreichbar sein, ohne Firewall oder Basisauthentifizierung davor.
VibeFox-Lizenzschlüssel: Erwerb über vibefox.net. Ein Schlüssel gilt 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. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox Barion Gateway in der Modulliste und klicken Sie 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 den Test-POSKey und die Test-Wallet-E-Mail ein, lassen Sie Test Mode aktiviert, schalten Sie Enable/Disable ein 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.
Die Callback-URL wird bei jeder Zahlung automatisch an Barion übermittelt. Im Barion-Portal muss nichts eingerichtet werden.
Bei der Installation legt das Modul zwei Bestellstatus an: Awaiting Barion payment und Barion payment on hold. PrestaShop bietet ein neues Zahlungsmodul für alle Währungen, Länder und Kundengruppen an. Sie können dies unter Payment > Preferences einschränken.
Konfiguration
Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Barion Gateway > Configure. Jeder Bereich hat einen eigenen Button Save, der die gesamte Seite speichert. Oberhalb der Felder 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; dabei wird die Liste der unterstützten Währungen angezeigt. Solange der Testmodus aktiv ist, zeigt sie Der Testmodus ist aktiv: Zahlungen gehen an die Barion-Sandbox (api.test.barion.com), es wird kein echtes Geld abgebucht. an.
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 Zahlungsart in der Bestellung gespeichert. Standard: Barion. Pflichtfeld.
Description: der Text, der unter der Zahlungsart an der Kasse angezeigt wird. Standard: Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay.
Zugangsdaten des Barion-Shops
Holen Sie POSKey und Wallet-E-Mail im Barion-Portal: secure.barion.com (Live) oder secure.test.barion.com (Test), My stores, Ihr Shop. Der Testmodus verwendet nur die Testzugangsdaten, der Livemodus nur die Live-Zugangsdaten.
Test Mode: verwendet die unten eingetragenen Testzugangsdaten und die Barion-Sandbox (api.test.barion.com). Es wird kein echtes Geld abgebucht. Standard: an. Schalten Sie ihn aus, um echte Zahlungen anzunehmen. Solange er aktiv ist, sehen Kunden unter der Zahlungsart Testmodus: Es wird keine echte Zahlung abgebucht.
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 wieder angezeigt. Das Feld bleibt leer und zeigt Gespeichert — leer lassen, um ihn zu behalten. Geben Sie einen neuen Wert nur ein, wenn Sie ihn ändern möchten.
Clear saved POSKeys: aktivieren Sie einen Schlüssel und klicken Sie auf Save, um ihn zu entfernen. Ein leeres Feld behält den gespeicherten Wert.
Callback URL: die Adresse, die Barion nach jeder Zahlung aufruft, zum Beispiel https://your-shop/module/wcp_barion_gateway/callback bei suchmaschinenfreundlichen URLs, gegebenenfalls mit einem Sprachcode wie /en/. Sie wird bei jeder Zahlung an Barion übermittelt, es gibt also nichts zu konfigurieren. Sie muss nur aus dem Internet erreichbar sein.
Bestellungen
Order Status After Payment: der Bestellstatus, der nach einer erfolgreichen, geprüften Zahlung gesetzt wird.
Zahlungen, die bei Barion noch verarbeitet werden, warten im Status Awaiting Barion payment. Abweichungen bei Betrag oder Währung gehen immer auf Barion payment on hold.
Erweitert
Logging: schreibt Barion-Anfragen und Callbacks in logs/barion_p_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. Geheime Schlüssel und Wallet-E-Mails werden nicht protokolliert. Standard: aus. Bei deaktiviertem Protokoll wird nichts geschrieben, auch keine Fehler.
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 aktiv, entfernt das Deinstallieren des Moduls die Moduleinstellungen und das Protokoll. Bestellungen, deren Barion-Zahlungsdaten und die Bestellstatus bleiben immer erhalten. Standard: aus.
Kasse
Im Zahlungsschritt wählt der Kunde die Zahlungsart (standardmäßig Barion) und sieht den Hinweis Sie werden zur sicheren Barion-Zahlungsseite weitergeleitet. Nach der Bestätigung startet das Modul eine Barion-Zahlung für den Warenkorbbetrag in der Warenkorbwährung und leitet den Kunden zur Barion-Zahlungsseite weiter. Produkte, Versand, Geschenkverpackung und Steuern erscheinen auf der Zahlung, die Zahlung wird als Cart mit der Warenkorbnummer angezeigt, die E-Mail-Adresse des Kunden wird als Hinweis übergeben, und die Sprache der Seite richtet sich nach der Sprache des Warenkorbs, sofern Barion sie unterstützt. Zu diesem Zeitpunkt existiert noch keine Bestellung.
Nach der Zahlung kehrt der Kunde in Ihren Shop zurück, und Barion ruft außerdem die Callback-URL auf. Keine der beiden Anfragen markiert etwas von sich aus als bezahlt: Das Modul 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 die Zahlung bestätigt, und nur wenn Betrag und Währung mit dem Warenkorb übereinstimmen. Der Rücklink enthält den sicheren Schlüssel des Warenkorbs, und es werden nur Zahlungen geprüft, die für diesen Warenkorb gestartet wurden.
War die Zahlung erfolgreich, wird die Bestellung angelegt, und der Kunde sieht die übliche Bestellbestätigungsseite mit Ihre Zahlung mit Barion ist eingegangen. Ist die Zahlung bei Barion noch in Bearbeitung, wird die Bestellung im Status Awaiting Barion payment angelegt, und die Seite zeigt Ihre Zahlung wird von Barion bestätigt. Sie erhalten eine E-Mail, sobald sie bestätigt ist. Wird eine solche Zahlung später bei Barion abgebrochen, läuft sie ab oder schlägt sie fehl, zeigt die Seite Ihre Barion-Zahlung wurde nicht abgeschlossen. Bitte kontaktieren Sie uns zu dieser Bestellung. Kann Barion beim Zurückkehren des Kunden nicht erreicht werden, zeigt eine Seite Zahlungsbestätigung denselben Text „wird bestätigt“ und einen Button Check again; der Callback legt die Bestellung an, sobald Barion die Zahlung bestätigt.
Wurde die Zahlung nicht abgeschlossen (abgebrochen, abgelaufen oder fehlgeschlagen), wird keine Bestellung angelegt, der Warenkorb bleibt erhalten, und der Kunde kehrt zur Kasse zurück mit Die Zahlung wurde nicht abgeschlossen. Bitte versuchen Sie es erneut. Der Kunde kann es erneut versuchen. Jeder Versuch wird gespeichert, daher erzeugt eine verspätete Zahlung eines früheren Versuchs trotzdem die Bestellung, und ein früherer Versuch, der abläuft, storniert keine Bestellung eines neueren Versuchs.
Kann die Zahlung nicht gestartet werden, bleibt der Kunde an der Kasse mit einer kurzen Meldung: Die Barion-Zahlung konnte nicht gestartet werden. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsart., Barion unterstützt keine Zahlungen in der Warenkorbwährung oder Barion kann eine Bestellung mit einer Summe von null nicht verarbeiten. Die Details werden bei aktivem Logging ins Protokoll geschrieben.
Der Callback funktioniert, während der Shop im Wartungsmodus ist, und wird nicht durch die Länderbeschränkung Ihres Shops blockiert.
Das Modul nimmt nur Sofortzahlungen an. Es bietet keine Zahlungen mit Reservierung oder verzögerter Erfassung, 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 seiner Zahlungsseite.
Bestellungen und Erstattungen
Bestellstatus
No order yet: der Kunde wurde zu Barion weitergeleitet und hat noch nicht bezahlt, oder Barion hat die Zahlung noch nicht bestätigt. Es existiert nur der Warenkorb.
Awaiting Barion payment: 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 Status „Zahlung akzeptiert“, sobald Barion die Zahlung bestätigt.
Payment accepted or Delivered: Barion hat die Zahlung bestätigt. Der Status folgt Order Status After Payment. Die Zahlung wird mit der Barion-Transaktions-ID erfasst, und eine Notiz zeigt den Betrag, die PaymentId und die Transaktion.
Barion payment on hold: Barion hat einen anderen Betrag oder eine andere Währung gemeldet als den Bestellbetrag, zum Beispiel weil der Warenkorb geändert wurde, nachdem die Zahlung gestartet wurde. Die Notiz zeigt beide Beträge. Prüfen Sie die Zahlung im Barion-Portal und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung im Barion-Portal.
Canceled: der letzte Zahlungsversuch einer wartenden Bestellung wurde bei Barion abgebrochen oder ist abgelaufen.
Payment error: der letzte Zahlungsversuch einer wartenden Bestellung ist fehlgeschlagen.
Refunded: die Zahlung wurde über das Modul vollständig erstattet.
Gelingt eine Zahlung zur Bestellung noch, 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. Gelingt eine weitere Zahlung zu einer bezahlten Bestellung, weist eine Notiz Sie an, dies im Barion-Portal zu prüfen und bei einem Duplikat zu erstatten. Notizen sind private Nachrichten auf der Bestellseite.
Barion-Zahlungsblock
Die Bestellseite zeigt einen Block Barion payment mit der PaymentId, der Barion-Transaktion, dem Zahlungsstatus, dem bezahlten und erstatteten Betrag, einem Abzeichen Test mode für Testzahlungen und dem Erstattungsverlauf.
Erstattungen
Geben Sie im Block Barion payment den Betrag ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Grund, und klicken Sie auf Refund via Barion. Bestätigen Sie die Frage Diesen Betrag über Barion erstatten? Dies kann nicht rückgängig gemacht werden. Vollständige und Teilerstattungen werden unterstützt. Sie benötigen das Recht, Bestellungen zu bearbeiten. Der Grund wird als Kommentar an Barion übermittelt. HUF-Erstattungen müssen ganze Beträge sein. Die Erstattung wird im Modus (Test oder Live) gesendet, in dem die Zahlung erfolgte, daher muss der POSKey dieses Modus eingetragen sein. Akzeptiert oder bestätigt Barion die Erstattung nicht, zeigt der Block den Fehler, 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. Eine Teilerstattung ändert den Status nicht.
Erstattungen sind verfügbar, sobald Barion die Zahlung bestätigt hat und die Bestellung durch sie bezahlt ist. Eine Zahlung mit Abweichung bei Betrag oder Währung kann nicht aus PrestaShop erstattet werden; erstatten Sie sie im Barion-Portal. Das Modul erstellt keine Gutschriften, und die Standard-Erstattungsbuttons von PrestaShop auf der Bestellseite senden kein Geld über Barion zurück.
Lizenzschlüssel
Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Barion Gateway ist der erste Block auf Modules > Module Manager > VibeFox Barion 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 Schlüssel maskiert, 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-barion 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 einen Domain-Platz in Ihrem Konto 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-Einrichtung. 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 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 wird die Zahlungsart auch für Sie ausgeblendet: Sie können das Modul einrichten, bevor Sie einen Schlüssel kaufen, aber an der Kasse nicht testen. Eine Erinnerung erscheint unter Modules > Module Manager auf dem Tab Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.
Läuft eine Lizenz ab, arbeitet das Modul weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird während der Arbeit im Back-Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.
Fehlerbehebung
Barion erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der aktuelle Modus einen POSKey und eine Empfänger-E-Mail hat (die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt) und die Warenkorbwährung HUF, EUR, USD oder CZK ist. Unter Payment > Preferences prüfen Sie, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe erlaubt ist.
Die Zahlung war erfolgreich, aber es wurde keine Bestellung angelegt: die Bestellung wird angelegt, wenn Barion die Callback-URL aufruft oder wenn der Kunde zu Ihrem 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, ob der POSKey des Modus, in dem die Zahlung erfolgte, korrekt ist, da das Modul damit den Zahlungsstatus bei Barion abfragt. Aktivieren Sie Logging, um den Callback zu sehen.
Der Callback antwortet Busy, retry: die Bestellung wurde im selben Moment von der Rückkehr des Kunden verarbeitet, oder die Bestellung konnte nicht angelegt werden (zum Beispiel, weil das Modul deaktiviert ist). Barion ruft erneut auf. Aktivieren Sie Logging, um den Grund zu sehen.
Der Callback antwortet API error: der Shop konnte den Zahlungsstatus nicht bei Barion lesen, 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 „Zahlungsprüfung fehlgeschlagen“: der Rücklink passt nicht zum Warenkorb, zum Beispiel weil er in einer anderen Browsersitzung geöffnet oder bearbeitet wurde. Der Zahlungsstatus wird trotzdem durch den Callback bestätigt.
Der Kunde sieht einen Fehler bei der Auswahl von Barion: aktivieren Sie Logging und sehen Sie sich das Feld Log auf der Modulseite an. Ein falscher POSKey oder eine falsche Empfänger-E-Mail führt zu Die Barion-Zahlung konnte nicht gestartet werden.
Bestellung ist Barion payment on hold: lesen Sie die Abweichungsnotiz an der Bestellung, prüfen Sie die Zahlung im Barion-Portal und bearbeiten Sie dann die Bestellung oder erstatten Sie sie im Barion-Portal.
Warum kann ich 10,50 HUF nicht erstatten?: Barion verarbeitet HUF ohne Dezimalstellen. Geben Sie einen ganzen Betrag ein.
Die Erstattung meldet, dass der Barion-POSKey für den Modus dieser Bestellung nicht konfiguriert ist: die Zahlung erfolgte im Test- oder Livemodus, und der POSKey dieses Modus ist leer. Tragen Sie ihn ein und versuchen Sie es erneut.
Deinstallation
Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Barion Gateway und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete Data on Uninstall aktiv, werden die Moduleinstellungen und das Protokoll entfernt. Ist die Option deaktiviert, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die Barion-Zahlungsdaten der Bestellungen sowie die Bestellstatus Awaiting Barion payment und Barion payment on hold bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation noch erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.
Barion ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist weder mit Barion verbunden noch wird es von Barion unterstützt.