DE
EUR
Zurück

VibeFox Eupago for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv.

PHP: 8.0 oder neuer.

Shop-Währung: Euro (EUR). Eupago rechnet nur in Euro ab, daher wird die Zahlungsmethode bei anderen Währungen an der Kasse ausgeblendet.

Eupago-Konto: Sie benötigen den API-Schlüssel Ihres Eupago-Kanals und den Schlüssel eines Webhook 2.0, den Sie im Eupago-Backoffice anlegen (siehe Konfiguration). Das Live-Backoffice ist clientes.eupago.pt, das Sandbox-Backoffice ist sandbox.eupago.pt. Sandbox und Live sind getrennte Konten mit getrennten Schlüsseln.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert auf einer 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. Sie können auch den Ordner wcp_eupago_gateway per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Eupago > 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 API-Schlüssel Ihres Eupago-Kanals ein, legen Sie im Eupago-Backoffice einen Webhook 2.0 an und fügen Sie dessen Schlüssel ein (siehe Konfiguration).

6. Wählen Sie die Payment Method, aktivieren Sie Enable/Disable, legen Sie eine Testbestellung im Sandbox-Modus an und deaktivieren Sie danach Sandbox Mode.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Eupago. Ist das Gateway aktiviert, warnt Sie die Seite, wenn der API-Schlüssel des aktuellen Modus leer ist (das Gateway wird dann an der Kasse ausgeblendet), oder zeigt Sandbox mode: no real payments are taken., solange der Sandbox-Modus aktiv ist. In der Liste der Zahlungsmethoden ist Eupago als „Aktion erforderlich“ markiert, bis der API-Schlüssel des aktuellen Modus gesetzt ist, und im Sandbox-Modus wird ein Testmodus-Badge angezeigt.

Allgemein

Enable/Disable: Enable Eupago Gateway schaltet die Zahlungsmethode ein oder aus. Standard: off.

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

Description: der Text unter der Zahlungsmethode an der Kasse. Standard: Pay securely via Eupago.

Payment Method: die eine Eupago-Methode, die an der Kasse angeboten wird.

Multibanco: der Kunde erhält eine Entität und eine Referenz, um am Geldautomaten oder im Online-Banking zu bezahlen (Standard). Angeboten für Bestellsummen von 1 € bis 999 999,99 €.
MB WAY: der Kunde gibt an der Kasse die MB-WAY-Telefonnummer ein und bestätigt die Zahlung in der MB-WAY-App.
Credit Card: der Kunde wird zur Kartenseite von Eupago weitergeleitet.

Order Status After Payment: der Bestellstatus, der nach Bestätigung der Zahlung gesetzt wird: Processing (Standard) oder Completed. Der Status wird sofort gesetzt, mit einer Statusänderung und einer E-Mail.

Eupago-Konto

Holen Sie sich den API-Schlüssel Ihres Kanals und den Schlüssel des Webhook 2.0 im Eupago-Backoffice: clientes.eupago.pt (Live) oder sandbox.eupago.pt (Sandbox).

Sandbox Mode: Enable sandbox/test mode nutzt sandbox.eupago.pt und die Sandbox-Schlüssel. Es werden keine echten Zahlungen angenommen. Standard: on. Deaktivieren Sie es, um echte Zahlungen mit den Live-Schlüsseln anzunehmen.

Live API Key: der API-Schlüssel Ihres Live-Kanals bei Eupago (clientes.eupago.pt).

Live Webhook Key: der Verschlüsselungsschlüssel Ihres Live-Webhook 2.0. Erforderlich: Benachrichtigungen ohne gültige Signatur werden abgelehnt.

Sandbox API Key: der API-Schlüssel Ihres Sandbox-Kanals (sandbox.eupago.pt).

Sandbox Webhook Key: der Verschlüsselungsschlüssel Ihres Sandbox-Webhook 2.0.

Webhook-URL

Der Webhook teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist. Legen Sie im Eupago-Backoffice einen Webhook 2.0 mit der URL an, die in diesem Abschnitt der Einstellungen angezeigt wird, mit Methode POST und aktivierter Verschlüsselung. Die URL sieht so aus: https://your-site/wc-api/eupago_payment_callback/. Legen Sie je einen Webhook im Sandbox-Backoffice und im Live-Backoffice an.

Kopieren Sie den Schlüssel jedes Webhooks in Sandbox Webhook Key oder Live Webhook Key. Webhooks ohne gültige Signatur werden abgelehnt. Ein unverschlüsselter Webhook wird nur akzeptiert, wenn Eupago ihn signiert; lassen Sie die Verschlüsselung daher aktiviert. Das Plugin reagiert auf folgende Benachrichtigungsstatus:

PAID: die Zahlung wurde geleistet. Die Bestellung wird nach allen Prüfungen als bezahlt markiert.
CANCELED: die Zahlung wurde storniert. Eine unbezahlte Bestellung wird auf Storniert gesetzt.
EXPIRED: die Zahlung ist abgelaufen. Eine unbezahlte Bestellung wird auf Storniert gesetzt.
ERROR: die Zahlung ist fehlgeschlagen. Eine unbezahlte Bestellung wird auf Fehlgeschlagen gesetzt.

Andere Status erfordern keine Aktion. Der alte GET-Callback von Eupago an dieselbe URL wird ebenfalls akzeptiert; er wird über den API-Schlüssel authentifiziert und meldet immer eine Zahlung. Ohne Benachrichtigungen werden Bestellungen nie als bezahlt markiert: Das Plugin fragt Eupago nicht ab, und die Rückkehr des Kunden bezahlt keine Bestellung.

Erweitert

Debug Log: Enable logging schreibt API-Aufrufe und Benachrichtigungen nach WooCommerce > Status > Logs, Quelle wcp_eupago_gateway. Schlüssel, E-Mails und vollständige Telefonnummern werden nicht protokolliert. Fehler werden immer protokolliert. Standard: off.

Delete Data on Uninstall: Delete all plugin data when uninstalling. Ist das Feld aktiviert, werden die Gateway-Einstellungen und Protokolle beim Löschen des Plugins entfernt. Bestellungen und ihre Zahlungsdaten bleiben erhalten. Standard: off.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig Eupago) und gibt die Bestellung auf. Im Sandbox-Modus zeigt die Kasse SANDBOX / TEST MODE. Was danach passiert, hängt von Payment Method ab.

Multibanco: an der Kasse sieht der Kunde You will receive Multibanco payment details after placing the order. Das Plugin erstellt eine Multibanco-Referenz für die Bestellsumme. Die Bestellung wird auf Wartend gesetzt, der Lagerbestand wird reduziert und der Warenkorb geleert. Die Bestellbestätigungsseite zeigt Multibanco Payment Details mit Entität, Referenz und Betrag. Dieselben Angaben werden in die Bestell-E-Mail des Kunden aufgenommen, solange die Bestellung auf die Zahlung wartet. Der Kunde bezahlt am Geldautomaten oder im Online-Banking.

MB WAY: an der Kasse gibt der Kunde MB WAY Phone Number ein, das mit der Rechnungstelefonnummer vorausgefüllt ist. Portugiesische Nummern können ohne +351 eingegeben werden. Eine falsche Nummer ergibt Please enter a valid MB WAY phone number (e.g. 912 345 678 or +351 912 345 678). Das Plugin sendet die Zahlungsanfrage an die MB-WAY-App. Die Bestellung wird auf Wartend gesetzt, der Lagerbestand wird reduziert und der Warenkorb geleert. Die Bestellbestätigungsseite fordert den Kunden auf, die MB-WAY-App zu öffnen und die Anfrage innerhalb von 5 Minuten zu bestätigen.

Credit Card: an der Kasse sieht der Kunde You will be redirected to a secure payment page to enter your card details. Der Kunde wird zur Kartenseite von Eupago geschickt, auf Portugiesisch, Spanisch oder Englisch je nach Sprache der Website. Die Bestellung bleibt auf Zahlung ausstehend und der Warenkorb bleibt erhalten. Nach der Zahlung kehrt der Kunde zur Bestellbestätigungsseite zurück, die Your card payment is being confirmed by Eupago. You will receive an e-mail as soon as it is confirmed. anzeigt, bis die Benachrichtigung eintrifft. Schlägt die Kartenzahlung fehl oder wird sie abgebrochen, landet der Kunde auf der Seite Pay for order mit The card payment was not completed. You can try again or choose another payment method. oder The card payment was cancelled. You can try again or choose another payment method.

Bei jeder Methode wird die Bestellung erst als bezahlt markiert, wenn Eupago die Zahlung mit einer verifizierten Benachrichtigung bestätigt. Ein Kunde kann eine unbezahlte Bestellung über die Seite Pay for order erneut bezahlen; jede für die Bestellung erstellte Zahlungsreferenz bleibt für die Prüfung gültig.

Kann Eupago die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, zum Beispiel The payment could not be started because Eupago is temporarily unavailable. Please try again in a few minutes or choose another payment method. Die Bestellung ändert sich nicht, und die Details stehen im Protokoll.

Die Zahlungsmethode funktioniert in der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist kompatibel mit WooCommerce High-Performance Order Storage (HPOS). Die Texte für Kunden sind ins Portugiesische übersetzt.

Das Plugin bietet pro Installation genau eine Eupago-Methode. Es gibt keine Erstattungen aus WooCommerce, keine gespeicherten Karten, Abonnements oder Vorautorisierungen, keine PayShop-, Cofidis-Pay-, Bizum- oder anderen Eupago-Methoden, keine SMS-Erinnerungen, kein Ablaufdatum für Multibanco und keine Statusabfrage.

Bestellungen

Bestellstatus

Pending payment: eine Kartenzahlung wurde gestartet und Eupago hat sie noch nicht bestätigt.

On hold, awaiting payment: eine Multibanco-Referenz oder eine MB-WAY-Anfrage wurde erstellt. Die Bestellnotiz zeigt Entität und Referenz bzw. die maskierte Telefonnummer.

Processing or Completed: die Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Die Bestellnotiz zeigt die Methode, die Eupago-Transaktions-ID und die Referenz. Die Transaktions-ID der Bestellung ist die Eupago-Transaktions-ID.

On hold, manual review: Eupago meldete eine Zahlung mit abweichendem Betrag oder abweichender Währung, mit einer Referenz, die nicht für diese Bestellung erstellt wurde, oder für eine Bestellung, die inzwischen storniert worden oder fehlgeschlagen war (zum Beispiel eine verspätet bezahlte Multibanco-Referenz). Die Notiz erklärt es. Prüfen Sie die Zahlung und den Lagerbestand und schließen Sie die Bestellung dann manuell ab oder erstatten Sie dem Kunden den Betrag. Spätere Benachrichtigungen zu dieser Zahlung schließen die Bestellung nicht hinter Ihrem Rücken ab.

Cancelled: Eupago meldete die Zahlung als storniert oder abgelaufen, für den aktuellen Zahlungsversuch einer unbezahlten Bestellung.

Failed: Eupago meldete einen Fehler für den aktuellen Zahlungsversuch einer unbezahlten Bestellung.

Meldet Eupago eine weitere Zahlung für eine bereits bezahlte Bestellung (zum Beispiel wurde auch eine ältere Multibanco-Referenz bezahlt), bleibt die Bestellung unverändert. Eine Notiz bittet Sie, auf eine doppelte Zahlung zu prüfen und sie im Eupago-Backoffice zu erstatten. Eine Zahlungsbenachrichtigung öffnet nie eine Bestellung wieder, die bezahlt und danach storniert oder erstattet wurde.

Erstattungen: Erstattungen aus WooCommerce werden nicht unterstützt. Erstatten Sie dem Kunden den Betrag im Eupago-Backoffice und erfassen Sie die Erstattung in WooCommerce mit Refund manually.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock steht oben unter WooCommerce > Settings > Payments > Eupago. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, etwa 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 auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt ihren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne einen aktiven Schlüssel wird Eupago 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 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 sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt.

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

Fehlerbehebung

Eupago erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der API-Schlüssel des aktuellen Modus gesetzt ist (Sandbox API Key im Sandbox-Modus, Live API Key im Live-Modus) und die Shop-Währung EUR ist. Bei Multibanco muss die Bestellsumme zwischen 1 € und 999 999,99 € liegen.

Die Zahlung ging durch, aber die Bestellung bleibt auf Pending payment oder On hold: die Eupago-Benachrichtigung kommt nicht an oder wird abgelehnt. Prüfen Sie im Eupago-Backoffice des verwendeten Modus, ob der Webhook 2.0 existiert, ob seine URL genau der in den Einstellungen angezeigten entspricht, ob die Methode POST ist und die Verschlüsselung aktiv ist. Prüfen Sie, ob sein Schlüssel im passenden Feld steht (Sandbox Webhook Key oder Live Webhook Key). Aktivieren Sie Debug Log und sehen Sie unter WooCommerce > Status > Logs, Quelle wcp_eupago_gateway, nach. Kommt eine Benachrichtigung nie an, prüfen Sie die Zahlung im Eupago-Backoffice.

Der Webhook antwortet Invalid signature oder Missing signature: der Webhook-Schlüssel im Plugin passt nicht zum Schlüssel des Webhooks, oder der Webhook ist unverschlüsselt und unsigniert. Kopieren Sie den Schlüssel erneut und lassen Sie die Verschlüsselung aktiviert.

Der Webhook antwortet Webhook key not configured: keiner der beiden Webhook-Schlüssel ist gesetzt. Eupago wiederholt die Benachrichtigung, nachdem Sie den Schlüssel eingefügt haben.

Der Webhook antwortet Decryption failed: die Signatur ist gültig, aber der Inhalt konnte nicht entschlüsselt werden. Prüfen Sie die Webhook-2.0-Einstellungen im Eupago-Backoffice.

Der Webhook antwortet Environment mismatch: die Benachrichtigung ist mit dem Schlüssel des anderen Modus signiert als dem, in dem die Bestellung aufgegeben wurde. Eine Sandbox-Benachrichtigung bezahlt nie eine Live-Bestellung und umgekehrt.

Der alte Callback antwortet Invalid API key: der von Eupago gesendete API-Schlüssel stimmt nicht mit Live API Key oder Sandbox API Key überein.

Der Kunde sieht The MB WAY payment could not be started: prüfen Sie, ob die Telefonnummer mit MB WAY verknüpft ist, und versuchen Sie es erneut.

Die Bestellung ist nach der Zahlung On hold: lesen Sie die Bestellnotiz. Betrag oder Währung wichen ab, die Referenz war unbekannt oder die Zahlung kam, nachdem die Bestellung storniert wurde. Prüfen Sie die Zahlung im Eupago-Backoffice und schließen Sie dann die Bestellung ab oder erstatten Sie dem Kunden den Betrag.

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.

Für Entwickler listet die Plugin-Dokumentation die Filter eupago_p_icon (Icon an der Kasse) und eupago_p_card_language (Sprache der Eupago-Kartenseite: PT, EN oder ES) auf.

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 Protokolle werden nur entfernt, wenn Delete Data on Uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestellungen und ihre Eupago-Referenzen bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Eupago ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin steht in keiner Verbindung zu Eupago und wird von Eupago weder unterstützt noch empfohlen.