VibeFox Barion for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Ohne WooCommerce zeigt das Plugin einen Hinweis im Adminbereich, und die Zahlungsmethode wird nicht geladen.

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 Live, secure.test.barion.com für Tests, unter My stores und Ihrem Shop. Test- und Live-Zugangsdaten sind unterschiedlich.

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

Erreichbarer Shop: Barion ruft Ihren Shop nach jeder Zahlung auf. Die Website muss daher aus dem Internet erreichbar sein, ohne Wartungsmodus, Firewall oder Basisauthentifizierung vor /wc-api/.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel gilt 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_barion_gateway per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Barion > Manage, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Geben Sie den Test-POSKey und die Test-Wallet-E-Mail ein, lassen Sie Test Mode eingeschaltet und schalten Sie Enable/Disable ein. Führen Sie eine Testbestellung durch.

6. Wenn alles funktioniert, geben Sie die Live-Zugangsdaten ein und entfernen Sie das Häkchen bei Test Mode.

Die Callback-URL wird bei jeder Zahlung automatisch an Barion übermittelt. Im Barion-Portal muss nichts eingerichtet werden.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Barion. Ist die Shopwährung nicht unterstützt, zeigt die Seite das in Rot im Abschnitt Barion shop credentials an und listet die unterstützten Währungen auf; die Zahlungsmethode wird dann an der Kasse ausgeblendet.

Allgemein

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

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: Barion.

Description: der Text unter der Zahlungsmethode an der Kasse. Standard: Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay.

Barion-Shop-Zugangsdaten

POSKey und Wallet-E-Mail finden Sie im Barion-Portal: secure.barion.com (Live) oder secure.test.barion.com (Test), My stores, Ihr Shop. Dieser Abschnitt zeigt außerdem die Callback-URL, zum Beispiel https://your-site/wc-api/barion_payment_callback/. Sie wird bei jeder Zahlung an Barion übermittelt; sie muss nur aus dem Internet erreichbar sein.

Test Mode: Enable Barion test/sandbox mode. Der Testmodus verwendet die unten stehenden Testzugangsdaten und die Barion-Sandbox (api.test.barion.com); es werden keine echten Gelder belastet. Standard: ein. Entfernen Sie das Häkchen, um echte Zahlungen anzunehmen.

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.

Bestellungen

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

Erweitert

Logging: Enable debug logging. Protokolle werden in WooCommerce > Status > Logs, Quelle wcp_barion_gateway, gespeichert. Geheime Schlüssel werden nie protokolliert. Standard: aus.

Delete Data on Uninstall: Remove the plugin settings when the plugin is deleted. Bestellungen und ihre Barion-Zahlungsdaten bleiben immer erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig Barion) und gibt die Bestellung auf. Das Plugin startet eine Barion-Zahlung für den Bestellbetrag in der Bestellwährung und leitet den Kunden zur Barion-Zahlungsseite weiter. Die Bestellpositionen, der Versand, Gebühren und Steuern werden auf der Zahlung aufgelistet, die Rechnungs-E-Mail-Adresse des Kunden wird als Hinweis übergeben, und die Sprache der Seite folgt der Shop-Sprache, soweit Barion sie unterstützt.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Barion ruft zusätzlich die Callback-URL auf. Keine dieser Anfragen markiert die Bestellung für sich allein als bezahlt: Das Plugin fragt den Zahlungsstatus mit Ihrem POSKey bei Barion ab, und die Bestellung wird erst als bezahlt markiert, wenn Barion die Zahlung bestätigt und Betrag und Währung zur Bestellung passen. Der Rückkehrlink enthält den Bestellschlüssel (order key), und es werden nur Zahlungen geprüft, die für diese Bestellung gestartet wurden.

Wenn die Zahlung bei Barion erfolgreich war oder noch läuft, landet der Kunde auf der Seite „Bestellung eingegangen“. Andernfalls kehrt er zur Kasse zurück und sieht Payment was not completed. Please try again. Der Kunde kann es erneut versuchen; jeder Versuch wird gespeichert, sodass eine verspätete Zahlung eines früheren Versuchs die Bestellung trotzdem abschließt.

Kann die Zahlung nicht gestartet werden, sieht der Kunde The Barion payment could not be started. Please try again or choose another payment method. Angemeldete Shop-Manager sehen zusätzlich den technischen Grund. Die Details gehen ins Protokoll.

Die Zahlungsmethode funktioniert an der klassischen Kasse und am Kassen-Block. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin nimmt nur Sofortzahlungen an. Es bietet keine Reservierungen oder Zahlungen mit verzögerter Erfassung, keine WooCommerce Subscriptions 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

Pending payment: die Barion-Zahlung wurde gestartet, und Barion hat sie noch nicht bestätigt. Die Bestellnotiz zeigt die Barion-PaymentId, den Betrag und im Testmodus (test mode).

Processing or Completed: Barion hat die Zahlung bestätigt. Der Status richtet sich nach Order Status After Payment. Die Bestellnotiz zeigt Betrag, PaymentId und Transaktion. Die Transaktions-ID ist die Barion-Transaktions-ID.

On hold: Barion hat einen anderen Betrag oder eine andere Währung gemeldet als den Bestellbetrag, zum Beispiel weil die Bestellung nach dem Start der Zahlung geändert wurde. Prüfen Sie die Zahlung im Barion-Portal und schließen Sie die Bestellung manuell ab oder erstatten Sie sie.

Cancelled: der letzte Zahlungsversuch wurde bei Barion storniert oder ist abgelaufen.

Failed: der letzte Zahlungsversuch ist fehlgeschlagen.

Eine bezahlte oder erstattete Bestellung wird durch einen späteren Callback nie verändert. Gelingt für eine bezahlte Bestellung eine weitere Zahlung, bittet eine Notiz, sie im Barion-Portal zu prüfen und bei einer Doppelzahlung zu erstatten.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Barion. Vollständige und Teilerstattungen werden unterstützt. Der Erstattungsgrund 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 Bestellung bezahlt wurde; deshalb muss dessen POSKey eingetragen sein. Akzeptiert oder bestätigt Barion die Erstattung nicht, zeigt WooCommerce den Fehler an, und es wird keine Erstattung verbucht. Eine erfolgreiche Erstattung wird mit der Barion-Transaktion und dem Status den Bestellnotizen hinzugefügt.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Barion. 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 gilt 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 Barion Kunden an der Kasse nicht angezeigt. Versucht trotzdem jemand, eine Zahlung zu starten, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen bleiben unberührt: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, doch Updates und Support erfordern eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.

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 Payee-E-Mail hat und die Shopwährung HUF, EUR, USD oder CZK ist.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt bei Pending payment: die Bestellung wird abgeschlossen, 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 (kein Wartungsmodus, keine Firewall oder Basisauthentifizierung vor /wc-api/). Prüfen Sie, ob der POSKey des Modus, in dem die Bestellung bezahlt wurde, korrekt ist, denn das Plugin fragt den Zahlungsstatus damit bei Barion ab. Schalten Sie Logging ein, um den Callback zu sehen.

Der Callback antwortet mit „Busy, retry“: die Bestellung wurde im selben Moment durch die Rückkehr des Kunden verarbeitet. Barion ruft erneut auf.

Der Callback antwortet mit „API error“: der Shop konnte den Zahlungsstatus nicht von Barion abrufen. Prüfen Sie den POSKey des Modus, in dem die Bestellung bezahlt wurde.

Eine Bestellung ist auf „Wartend“ mit einer Abweichungsnotiz: der von Barion gemeldete Betrag oder die Währung weicht vom Bestellbetrag ab. Prüfen Sie die Zahlung im Barion-Portal und schließen Sie sie manuell ab oder erstatten Sie sie.

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

Die Erstattung meldet, dass der POSKey für den Modus dieser Bestellung nicht konfiguriert ist: die Bestellung wurde im Test- oder Live-Modus bezahlt, und der POSKey dieses Modus ist leer. Tragen Sie ihn ein und versuchen Sie es erneut.

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

Beim Deaktivieren des Plugins bleiben alle Daten erhalten. 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 werden nur entfernt, wenn Delete Data on Uninstall eingeschaltet war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestellungen und ihre Barion-Zahlungsdaten bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Barion ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Barion verbunden noch von Barion empfohlen.