VibeFox Eupago 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: Euro (EUR). Eupago rechnet nur in Euro ab, daher muss der Euro in Ihrem Shop aktiviert sein; wenn der Kunde in einer anderen Währung bezahlt, wird die Zahlungsart 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: wird auf vibefox.net gekauft. 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 OpenCart-3-Paket wcp_eupago_gateway-oc3-(Version).ocmod.zip und das OpenCart-4-Paket wcp_eupago_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_eupago_gateway-oc3-(Version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Modifikationen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Eupago 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 Lizenzschlüssel).

4. 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).

5. Wählen Sie die Payment Method, aktivieren Sie Enable/Disable und klicken Sie auf Save. Legen Sie eine Testbestellung im Sandbox-Modus an und deaktivieren Sie danach Sandbox Mode.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_eupago_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Erweiterungscode dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint in der Liste der installierten Erweiterungen auf derselben Seite. 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 Eupago Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

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

Eine neue Installation startet mit deaktivierter Zahlungsart und aktiviertem Sandbox-Modus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Eupago Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Ist die Zahlungsart aktiviert, warnt Sie die Seite oberhalb der Einstellungen, wenn der API-Schlüssel des aktuellen Modus leer ist (die Zahlungsart wird dann an der Kasse ausgeblendet), oder sie zeigt Sandbox mode: no real payments are taken., solange der Sandbox-Modus aktiv ist. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf der Titel nicht leer sein und nicht länger als 128 Zeichen sein, eine Zahlungsart muss ausgewählt sein, Sort Order muss eine ganze Zahl sein, Total eine Zahl von null oder mehr, und die Geozone sowie die Bestellstatus müssen vorhanden sein. Andernfalls nennt eine Fehlermeldung das Problem, zum Beispiel Enter a title for the payment method (1 to 128 characters)., und nichts wird gespeichert.

Eupago

Enable/Disable: Enable Eupago Gateway 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: Eupago. Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, den der Kunde im Schritt Confirm Order über der Schaltfläche zum Bestätigen sieht. Standard: Pay securely via Eupago.

Payment Method: die einzige Eupago-Zahlungsart, die an der Kasse angeboten wird.

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

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

Total: die Kassensumme in der Standardwährung des Shops, die eine Bestellung erreichen muss, damit Eupago angeboten wird. Lassen Sie das Feld leer, um Eupago bei jeder Summe anzubieten. Unabhängig von diesem Feld wird Eupago nur angeboten, wenn der Kunde in EUR bezahlt, und Multibanco nur für Beträge von 1 € bis 999 999,99 €.

Eupago-Konto

Holen Sie den API-Schlüssel Ihres Kanals und den Webhook-2.0-Schlüssel im Eupago-Backoffice: clientes.eupago.pt (Live) oder sandbox.eupago.pt (Sandbox). Sandbox und Live sind getrennte Konten mit getrennten Schlüsseln.

Sandbox Mode: verwendet sandbox.eupago.pt und die Sandbox-Schlüssel. Es werden keine echten Zahlungen angenommen. Standard: an. Schalten Sie ihn aus, um mit den Live-Schlüsseln echte Zahlungen anzunehmen. Solange er aktiv ist, sehen Kunden im Schritt Confirm Order den Hinweis SANDBOX / TEST MODE.

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.

Gespeicherte Schlüssel werden nicht erneut 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 das Häkchen bei Clear the saved key on save und klicken Sie auf Save.

Webhook-URL

Der Webhook teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist. Legen Sie im Eupago-Backoffice einen Webhook 2.0 mit der in diesem Abschnitt angezeigten URL an, mit Methode POST und aktivierter Verschlüsselung. Unter OpenCart 3 sieht die URL etwa so aus: https://your-store/index.php?route=extension/payment/wcp_eupago_gateway/webhook, unter OpenCart 4 so: https://your-store/index.php?route=extension/wcp_eupago_gateway/payment/wcp_eupago_gateway.webhook. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen. Legen Sie einen Webhook im Sandbox-Backoffice und einen weiteren im Live-Backoffice an.

Kopieren Sie den Schlüssel jedes Webhooks in Sandbox Webhook Key bzw. 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 deshalb aktiviert. Eine Benachrichtigung muss mit dem Schlüssel des Modus signiert sein, in dem die Zahlung gestartet wurde, daher kann eine Sandbox-Benachrichtigung niemals eine Live-Zahlung bezahlen. Die Erweiterung reagiert auf diese Benachrichtigungsstatus:

Andere Status erfordern keine Aktion. Der veraltete 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 niemals als bezahlt markiert: Die Erweiterung fragt Eupago nicht ab, und die Rückkehr des Kunden bezahlt keine Bestellung. Der Webhook funktioniert auch, wenn der Shop im Wartungsmodus ist, weil OpenCart 3 Anfragen von Zahlungserweiterungen durchlässt und die Erweiterung auf OpenCart 4 dafür eine Startup-Aktion ergänzt (auch für die Rückkehr des Kunden von der Kartenseite).

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Bei Multibanco und MB WAY erhält die Bestellung den Status „wartend“, sobald Eupago die Referenz oder die MB-WAY-Anfrage ausgestellt hat. Bei einer Karte erhält die Bestellung nur über die Benachrichtigung von Eupago einen Status. Die Bestellung wird nur als bezahlt markiert, wenn eine geprüfte Benachrichtigung eintrifft und deren Modus, Referenz, Betrag und Währung mit der Bestellung übereinstimmen. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: der Bestellstatus, der gesetzt wird, wenn die Zahlung bestätigt ist. Standard: Processing.

Awaiting payment status: die Multibanco-Referenz bzw. die MB-WAY-Anfrage wurde ausgestellt, und der Kunde muss noch bezahlen. Die Multibanco-Daten werden mit diesem Status gesendet (in der Bestell-E-Mail und im Bestellverlauf des Kunden). Standard: Pending.

Manual review status: Eupago hat eine Zahlung gemeldet, die nicht zur Bestellung passt (Betrag, Währung, Referenz), eine Zahlung nach der Stornierung der Bestellung oder eine Zahlung für eine Bestellung, deren Warenkorb bereits bezahlt war. Eine Notiz erklärt den Grund. 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 status: Eupago hat die aktuelle Zahlung einer wartenden Bestellung als storniert oder abgelaufen gemeldet. Standard: Canceled.

Failed status: Eupago hat die aktuelle Zahlung einer wartenden Bestellung als fehlgeschlagen (ERROR) gemeldet. Standard: Failed.

Erweitert

Debug Log: schreibt API-Aufrufe und Benachrichtigungen in eupago_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht im Web öffnen; bei 5 MB wird sie nach eupago_p_debug.old.log.php verschoben. Schlüssel, E-Mail-Adressen und vollständige Telefonnummern werden nicht protokolliert. Fehler werden immer protokolliert. Standard: aus.

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: wenn aktiviert, entfernt das Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll. Bestellungen und ihre Eupago-Zahlungsdatensätze bleiben erhalten. Standard: aus.

Import / Export

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

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Eupago). OpenCart legt die Bestellung im Schritt Confirm Order an, weiterhin ohne Status. Auf OpenCart 4 wählt der Kunde die Zahlungsart über die Schaltfläche Choose des Zahlungsartblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Was passiert, wenn der Kunde auf Confirm Order klickt, hängt von der Payment Method ab.

Multibanco: der Kunde sieht You will receive Multibanco payment details after placing the order. Die Erweiterung erstellt eine Multibanco-Referenz für den Bestellbetrag in Euro, und die Bestellung erhält den Status Awaiting payment status. Die Bestell-E-Mail und der Bestellverlauf des Kunden erhalten den Kommentar Multibanco Payment Details mit Entität, Referenz und Betrag. Die Erfolgsseite der Bestellung zeigt dieselben Angaben. Der Kunde bezahlt am Geldautomaten oder im Online-Banking.

MB WAY: der Kunde gibt MB WAY Phone Number ein, vorausgefüllt mit der Telefonnummer der Bestellung. Portugiesische Nummern können ohne +351 eingegeben werden. Auf OpenCart 4 wird standardmäßig keine Telefonnummer abgefragt, daher ist das Feld dort meist leer, und der Kunde gibt die Nummer ein. Eine falsche Nummer ergibt Please enter a valid MB WAY phone number (e.g. 912 345 678 or +351 912 345 678). Die Erweiterung sendet die Zahlungsanfrage an die MB-WAY-App, und die Bestellung erhält Awaiting payment status. Die Erfolgsseite fordert den Kunden auf, die MB-WAY-App auf der maskierten Telefonnummer zu öffnen und die Anfrage innerhalb von 5 Minuten zu bestätigen. Lehnt Eupago die Anfrage ab, bleibt der Kunde im Schritt Confirm Order mit The MB WAY payment could not be started. Check that the phone number is associated with MB WAY and try again.

Credit Card: der Kunde sieht You will be redirected to a secure payment page to enter your card details. Der Kunde wird zur Kartenseite von Eupago weitergeleitet, je nach Shop-Sprache auf Portugiesisch, Spanisch oder Englisch. Die Bestellung bleibt ohne Status, und der Warenkorb wird gespeichert. Ist die Benachrichtigung bei der Rückkehr des Kunden bereits eingetroffen, sieht er die Bestellerfolgsseite von OpenCart. Andernfalls zeigt eine Seite Payment confirmation den Text Your card payment is being confirmed by Eupago. You will receive an e-mail as soon as it is confirmed. mit den Schaltflächen Check again und Back to checkout. Schlägt die Kartenzahlung fehl oder wird sie abgebrochen, kehrt der Kunde zur Kasse zurück mit The card payment was not completed. You can try again or choose another payment method. bzw. The card payment was cancelled. You can try again or choose another payment method. Auf OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt.

Bei allen Zahlungsarten wird die Bestellung erst dann als bezahlt markiert, wenn Eupago die Zahlung mit einer geprüften Benachrichtigung bestätigt. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, einschließlich der Bestandsaktualisierung. Die Zahlungsdetails werden auf der Erfolgsseite nur angezeigt, solange die Bestellung auf die Zahlung wartet. Hat Eupago die Zahlung bereits als storniert, abgelaufen oder fehlgeschlagen gemeldet, zeigt die Erfolgsseite Your Eupago payment was not completed. Please contact us about this order.

OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird. OpenCart 4 aktualisiert die Bestellung der Kasse, sodass der Kunde nach einer abgebrochenen oder fehlgeschlagenen Kartenzahlung dieselbe Bestellung mit einer neuen Eupago-Zahlung bezahlt. Ist eine frühere Bestellung desselben Warenkorbs bereits über Eupago bezahlt, gelangt der Kunde zur Erfolgsseite, und es wird keine neue Zahlung erstellt.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (etwa weil die Multibanco-Referenz abgelaufen ist, die MB-WAY-Anfrage abgelehnt wurde oder Sie die Bestellung storniert haben), wird der Kunde mit Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. zurück zur Kasse geschickt, und der nächste Klick auf Confirm Order bezahlt eine neue Bestellung des Warenkorbs. Ist diese Bestellung bereits bezahlt oder wartet auf ihre Zahlung, der Warenkorb seitdem aber geändert, auch durch eine neue Menge, lautet die Meldung Your previous order is already paid or awaiting its payment. Please confirm the order again: the cart will be paid with a new order. Eine bezahlte Bestellung wird niemals als bezahlt für einen anderen Warenkorb angezeigt.

Kann Eupago die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen 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 bleibt ohne Status, und die Details stehen im Protokoll.

Die Erweiterung bietet pro Installation eine Eupago-Zahlungsart an. Sie unterstützt keine Erstattungen aus dem Shop, keine gespeicherten Karten, Abonnements oder Vorautorisierungen, kein PayShop, Cofidis Pay, Bizum oder andere Eupago-Zahlungsarten, keine SMS-Erinnerungen, kein Ablaufdatum für Multibanco und keine Statusabfragen.

Bestellungen

Bestellstatus

No status (missing order): eine Kartenzahlung wurde gestartet, und Eupago hat sie noch nicht bestätigt oder sie ist fehlgeschlagen. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Awaiting payment status (default Pending): eine Multibanco-Referenz oder eine MB-WAY-Anfrage wurde erstellt. Die Notiz zeigt Entität und Referenz bzw. die maskierte Telefonnummer.

Order Status After Payment (default Processing): die Zahlung wurde bestätigt. Eine Notiz zeigt die Zahlungsart, die Eupago-Transaktions-ID und die Referenz.

Manual review status (default Pending): Eupago hat eine Zahlung mit abweichendem Betrag oder abweichender Währung gemeldet, mit einer Referenz, die nicht für diese Bestellung erstellt wurde, für eine Bestellung, die inzwischen storniert oder fehlgeschlagen ist (zum Beispiel eine verspätet bezahlte Multibanco-Referenz), oder für eine Bestellung, deren Warenkorb bereits durch eine andere Bestellung bezahlt wurde. Die Notiz erklärt es. Prüfen Sie die Zahlung und den Bestand und vervollständigen Sie die Bestellung dann manuell oder erstatten Sie dem Kunden den Betrag. Spätere Benachrichtigungen zu dieser Zahlung schließen die Bestellung nicht ohne Ihr Zutun ab.

Cancelled status (default Canceled): Eupago hat die Zahlung als storniert oder abgelaufen gemeldet, für den aktuellen Zahlungsversuch einer wartenden Bestellung.

Failed status (default Failed): Eupago hat einen Fehler für den aktuellen Zahlungsversuch einer wartenden Bestellung gemeldet.

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 Doppelzahlung zu prüfen und sie im Eupago-Backoffice zu erstatten. Eine Zahlungsbenachrichtigung öffnet eine Bestellung nie wieder, die bezahlt und anschließend storniert oder erstattet wurde. Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht.

Registerkarte VibeFox Eupago Gateway

Öffnen Sie unter Sales > Orders eine mit Eupago bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, listet die Registerkarte VibeFox Eupago Gateway jeden Zahlungsversuch der Bestellung auf: Date, Method (mit der Bezeichnung Sandbox bei Sandbox-Zahlungen), Amount, Entity / reference / phone, Eupago transaction ID und Status. Bei einer Bestellung in der manuellen Prüfung zeigt die Registerkarte eine Warnung. Darunter listet Eupago notes die Notizen der Erweiterung zur Bestellung auf. Die Registerkarte ist nur lesbar und wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen sind in dieser Erweiterung nicht verfügbar. Erstatten Sie dem Kunden den Betrag im Eupago-Backoffice und aktualisieren Sie die Bestellung in OpenCart manuell. Produktrücksendungen unter Sales > Returns überweisen kein Geld über Eupago zurück.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Eupago Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Eupago 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 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, 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: opencart-payment-eupago und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung 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 Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Adresse des Shops 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 den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne 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. Ein Admin-Benutzer, der im Admin-Bereich 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 ohne aktiven Schlüssel die Zahlungsart für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Admin-Dashboard. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, aber Updates und Support benötigen eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Admin-Dashboard oder die Seite Edit öffnen: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Eupago does not appear at checkout: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der API-Schlüssel des aktuellen Modus gesetzt ist (Sandbox API Key im Sandbox-Modus, Live API Key im Live-Modus). Der Kunde muss in EUR bezahlen, und bei Multibanco muss der Bestellbetrag zwischen 1 € und 999 999,99 € liegen. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung die in den Einstellungen festgelegte Total erreicht.

The payment went through, but the order stays in the awaiting status or without a status: die Eupago-Benachrichtigung kommt nicht an oder wird abgelehnt. Prüfen Sie im Eupago-Backoffice des von Ihnen verwendeten Modus, ob der Webhook 2.0 existiert, ob seine URL genau der in Webhook URL angezeigten entspricht, ob die Methode POST ist und die Verschlüsselung aktiviert 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 sich das Feld Log auf der Erweiterungsseite an. Kommt eine Benachrichtigung nie an, prüfen Sie die Zahlung im Eupago-Backoffice.

Webhook answers Invalid signature or Missing signature: der Webhook-Schlüssel in der Erweiterung stimmt nicht mit dem Schlüssel des Webhooks überein, oder der Webhook ist unverschlüsselt und unsigniert. Kopieren Sie den Schlüssel erneut und lassen Sie die Verschlüsselung aktiviert.

Webhook answers Webhook key not configured: es ist kein Webhook-Schlüssel gesetzt. Eupago wiederholt die Benachrichtigung, nachdem Sie den Schlüssel eingefügt haben.

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

Webhook answers Environment mismatch: die Benachrichtigung ist mit dem Schlüssel des anderen Modus signiert als dem, in dem die Zahlung gestartet wurde. Eine Sandbox-Benachrichtigung bezahlt nie eine Live-Zahlung und umgekehrt. Prüfen Sie, ob die Sandbox- und Live-Schlüssel nicht vertauscht sind.

Webhook answers Order not found: die Benachrichtigung betrifft eine Bestellung ohne Eupago-Zahlung dieses Shops, zum Beispiel eine Zahlung aus einem anderen Shop mit demselben Eupago-Kanal.

Webhook answers Busy or Retry: die Bestellung wurde im selben Moment von einer anderen Anfrage verarbeitet, oder die Verarbeitung ist fehlgeschlagen. Eupago wiederholt die Benachrichtigung. Der Grund steht im Protokoll.

Legacy callback answers Invalid API key: der von Eupago gesendete API-Schlüssel stimmt nicht mit Live API Key oder Sandbox API Key überein. Dieselbe Antwort erscheint, wenn Sie die Webhook-URL im Browser öffnen; das ist normal.

The customer sees This payment method is temporarily unavailable: der API-Schlüssel des aktuellen Modus fehlt. Tragen Sie ihn in den Einstellungen ein.

The customer sees 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.

Order is in the manual review status after payment: lesen Sie die Eupago notes auf der Registerkarte VibeFox Eupago Gateway. Betrag oder Währung waren abweichend, die Referenz war unbekannt, die Zahlung kam nach der Stornierung der Bestellung, oder der Warenkorb war bereits durch eine andere Bestellung bezahlt. Prüfen Sie die Zahlung im Eupago-Backoffice und vervollständigen Sie die Bestellung oder erstatten Sie dem Kunden den Betrag.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Eupago Gateway 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 erneuten Installation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Event der Erweiterung wird entfernt (auf OpenCart 4 zusätzlich seine Events und seine Startup-Aktion, die Webhook und Rückkehr des Kunden im Wartungsmodus durchlassen). Ist Delete Data on Uninstall aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Zahlungsart, Sandbox-Modus, Schlüssel, Debug-Log) und das Protokoll entfernt. Ist die Option deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die Eupago-Zahlungsdatensätze der Bestellungen bleiben immer erhalten, sodass späte Benachrichtigungen zu alten Bestellungen nach einer Neuinstallation weiterhin funktionieren. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

Eupago ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit Eupago verbunden und wird von Eupago nicht empfohlen.