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

finby-(TrustPay-)Konto: Sie brauchen ein Projekt im finby Merchant Portal mit Project ID und Secret key. Für Testzahlungen brauchen Sie ein separates Test-Projekt (Playground) mit eigener Project ID und eigenem Secret key. Weitere Schlüssel sind nicht nötig: Der Secret key wird sowohl für den API-Zugriff als auch zur Prüfung der Signatur von Zahlungsbenachrichtigungen verwendet.

Erreichbare Benachrichtigungs-URL: finby muss Ihren Shop aus dem Internet erreichen können. Eine Firewall, eine Wartungsanmeldung oder HTTP-Authentifizierung vor dem Shop blockiert die Zahlungsbenachrichtigungen.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel gilt für eine Domain.

Installation

Das Download-Paket ist eine einzige 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_trustpay_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_trustpay_gateway.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen derselbe.

OpenCart 3

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_trustpay_gateway-oc3-(version).ocmod.zip. Die Erweiterung hat 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 und wählen Sie den Typ Payments. Suchen Sie VibeFox TrustPay 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 in License key im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Geben Sie Project ID und Secret key Ihres Test-Projekts sowie für echte Zahlungen die Ihres Live-Projekts ein (siehe Konfiguration). Die Benachrichtigungs-URL wird bei jeder Zahlung übermittelt, daher muss im Merchant Portal nichts eingerichtet werden.

5. Aktivieren Sie Enable / Disable und klicken Sie auf Save. Führen Sie eine Testzahlung mit aktiviertem Test mode durch und deaktivieren Sie danach Test mode, um echte Zahlungen anzunehmen.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_trustpay_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, wählen Sie den Typ Payments, suchen Sie VibeFox TrustPay 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 finby-Projekte wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungs-URL ist anders (siehe Konfiguration).

Bei einer Neuinstallation ist die Zahlungsart deaktiviert und der Testmodus aktiviert.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox TrustPay Gateway > Edit. Die Abschnitte sind links aufgeführt; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Über den Einstellungen warnt die Seite, wenn die Zahlungsart aktiviert ist, aber Project ID oder Secret key des aktuellen Modus leer sind, und wenn die Standardwährung des Shops nicht unterstützt wird. In beiden Fällen wird die Zahlungsart im Checkout ausgeblendet. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer und nicht länger als 128 Zeichen sein, Sort order muss eine ganze Zahl sein (negative Werte sind erlaubt), Minimum total muss eine Zahl von 0 oder mehr sein, und die gewählte Geozone und die Bestellstatus müssen existieren. Andernfalls wird nichts gespeichert und die Seite zeigt die Meldung an. Eine Project ID darf nur Ziffern enthalten: Speichern Sie einen anderen Wert, zeigt die Seite must contain digits only — the previous value was kept. und die übrigen Felder werden gespeichert.

TrustPay / finby

Enable / Disable: Enable TrustPay / finby card payments. schaltet die Zahlungsart ein oder aus. Standard: ausgeschaltet.

Title: der Name der Zahlungsart, den Kunden in der Kasse sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: Card payment (TrustPay). Pflichtfeld, höchstens 128 Zeichen.

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay securely by card on the TrustPay / finby payment page.

Sort order: die Position der Zahlungsart in der Kasse. Leer lassen oder eine ganze Zahl eingeben (negative Werte sind erlaubt).

Geo zone: Die Zahlungsart wird nur für Rechnungsadressen in der gewählten Geozone angeboten. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet.

Minimum total: die Kassensumme in der Standardwährung des Shops, die eine Bestellung erreichen muss, damit die Zahlungsart angeboten wird. Leer lassen für keinen Mindestbetrag.

API-Zugangsdaten

Kopieren Sie Project ID und Secret key Ihres Projekts aus dem finby (TrustPay) Merchant Portal. Der Abschnitt enthält einen Link zum Merchant Portal. Testzahlungen verwenden ein separates Test-Projekt (Playground) mit eigener Project ID und eigenem Secret key. Dort wird kein echtes Geld abgebucht.

Test mode: nutzt das Test-Projekt (keine echten Zahlungen). Neue Zahlungen und Erstattungen verwenden die Testzugangsdaten. Erstattungen einer Bestellung gehen immer an das Projekt, über das die Bestellung bezahlt wurde. Standard: eingeschaltet. Solange er aktiv ist, sehen Kunden im Schritt Confirm Order den Hinweis Test mode: no real payment will be taken.

Live Project ID: die numerische Project ID Ihres Live-Projekts.

Live Secret key: der Secret key des Live-Projekts. Er wird benötigt, um API-Zugriffstokens zu erhalten und Zahlungsbenachrichtigungen zu prüfen.

Test Project ID: die numerische Project ID Ihres Test- (Playground-) Projekts.

Test Secret key: der Secret key des Test-Projekts.

Secret keys werden genau so gespeichert, wie sie eingegeben wurden; nur Leerzeichen am Anfang und Ende werden entfernt. Gespeicherte Secret keys werden nie wieder 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. Beim Speichern der Einstellungen werden außerdem die zwischengespeicherten API-Zugriffstokens verworfen, sodass neue Zugangsdaten sofort verwendet werden.

Clear saved secrets: Markieren Sie einen Secret key und klicken Sie auf Save, um ihn zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Bestellstatus

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine Bestellung ohne Status). Die Bestellung erhält erst dann einen Status, wenn finby sie mit einer signierten Benachrichtigung bestätigt. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf. OpenCart hat keine eigenen Status für eine ausstehende oder zurückgehaltene TrustPay-Zahlung, daher verwenden beide standardmäßig Ausstehend; die Bestellnotizen und der Tab der Bestellung unterscheiden sie. Eigene Status können Sie unter System > Localisation > Order Statuses anlegen und hier auswählen.

Order status after payment: der Status einer bezahlten Bestellung. Standard: In Bearbeitung. Wählen Sie Abgeschlossen, wenn bezahlte Bestellungen sofort abgeschlossen werden sollen. Der Status wird in einem Schritt gesetzt, sodass der Kunde nur eine E-Mail erhält.

Awaiting TrustPay payment: finby hat die letzte Zahlung als ausstehend gemeldet; die Bestellung wechselt in den bezahlten Status, sobald finby sie bestätigt. Standard: Ausstehend.

TrustPay payment on hold: Die Zahlung wurde nur autorisiert (erfassen Sie sie im Merchant Portal), oder der bezahlte Betrag bzw. die Währung weicht von der Zahlungsanfrage oder der Bestellsumme ab. Standard: Ausstehend.

Payment error: finby hat die letzte Zahlung einer wartenden Bestellung abgelehnt. Eine später bestätigte Zahlung setzt die Bestellung trotzdem in den bezahlten Status. Standard: Fehlgeschlagen.

Cancelled order status: Die Erweiterung setzt ihn nicht. Eine Bestellung in diesem Status wird durch eine späte Zahlung nie wieder geöffnet; es wird eine Notiz hinzugefügt. Standard: Storniert.

Refunded order status: wird nach einer vollen Erstattung über die Bestellseite gesetzt. Standard: Erstattet.

Zahlungsbenachrichtigungen

Die Bestellung wird nur dann als bezahlt markiert, wenn finby sie mit einer signierten Benachrichtigung bestätigt. Die Erweiterung sendet die Benachrichtigungs-URL bei jeder Zahlung automatisch, Sie müssen sie also nicht einrichten. Der Abschnitt zeigt die URL unter Notification URL. In OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_trustpay_gateway/callback, in OpenCart 4 so: https://your-store/index.php?route=extension/wcp_trustpay_gateway/payment/wcp_trustpay_gateway.callback. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Sie können sie auch als Benachrichtigungs-URL Ihrer Projekte im Merchant Portal eintragen. Benachrichtigungen ohne gültige Signatur werden abgelehnt. Die URL funktioniert auch, wenn der Shop im Wartungsmodus ist (in OpenCart 4 lässt eine Startaktion der Erweiterung die Benachrichtigung und die Rückkehr des Kunden durch).

Die Erweiterung fragt finby nicht selbst nach dem Zahlungsstatus ab. Wenn eine Benachrichtigung Ihren Shop nicht erreicht, bleibt die Bestellung ohne Status, bis finby sie zustellt. finby wiederholt Benachrichtigungen.

Erweitert

Debug logging: schreibt API-Anfragen und Benachrichtigungen in trustpay_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs; in OpenCart 4 system/storage/logs). Die Datei kann nicht über das Web geöffnet werden. Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Das Protokoll enthält keine Schlüssel, Tokens, Kartendaten oder Kundendaten. Standard: ausgeschaltet.

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

Delete data on uninstall: Wenn eingeschaltet, entfernt die Deinstallation der Erweiterung ihre Einstellungen und das Protokoll. Bestelldaten bleiben erhalten: Bestellungen, TrustPay-Zahlungsdatensätze und Erstattungen. Standard: ausgeschaltet.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Die Secret keys werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten Secret keys bleiben erhalten.

Checkout

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Card payment (TrustPay)). Sie wird nur angeboten, wenn die Währung des Kunden zu den unterstützten Währungen gehört: EUR, CZK, HUF, GBP, PLN, NOK, SEK, DKK, BGN, RON, CHF und USD. Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the secure TrustPay / finby payment page to pay by card. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. In OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order.

Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung bei finby eine Kartenzahlungsanfrage über die Bestellsumme in der Bestellwährung. Beträge in HUF werden ohne Dezimalstellen übermittelt. Name, Adresse und E-Mail-Adresse des Kunden werden für 3-D Secure übermittelt, die OpenCart-Bestellnummer als Referenz. Kartenzahlungen benötigen eine Adresse: Fehlt Straße, Ort, Postleitzahl oder Land, sieht der Kunde Please enter your billing address (street, city, postcode and country) — it is required for card payments. In OpenCart 4, das standardmäßig keine Rechnungsadresse abfragt, werden fehlende Felder aus der Lieferadresse übernommen. Der Kunde wird zur finby-Zahlungsseite weitergeleitet und zahlt dort mit Karte. Die Seite öffnet sich in der Sprache des Shops, wenn finby diese unterstützt, sonst auf Englisch.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn finby sie mit der signierten Benachrichtigung bestätigt. Die Rückkehr selbst ändert den Zahlungsstatus nie. Ist die Benachrichtigung bereits eingetroffen, sieht der Kunde die Erfolgsseite der OpenCart-Bestellung. Wenn nicht, zeigt eine Seite Payment confirmation an: TrustPay / finby is confirming your card payment. Your order is confirmed as soon as the payment is confirmed, and you will receive an e-mail — there is no need to pay again. Sie hat eine Schaltfläche Check again und eine Schaltfläche Back to checkout. Solange die Bestellung im Status Ausstehend oder zurückgehalten ist, zeigt die Erfolgsseite Your card payment is being confirmed by TrustPay / finby. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Wird eine ausstehende oder zurückgehaltene Bestellung danach bezahlt oder lehnt finby die Zahlung ab, erhält der Kunde die E-Mail über den neuen Bestellstatus. Hat finby die Zahlung abgelehnt oder wurde die unbezahlte Bestellung storniert, zeigt die Erfolgsseite Your card payment was not completed. Please contact us about this order. In OpenCart 4, wenn der Kunde von der finby-Zahlungsseite zurückkehrt, öffnet eine kurze Zwischenseite die Rücksprungadresse erneut in Ihrem Shop, sodass Warenkorb und Kundenanmeldung erhalten bleiben.

Bricht der Kunde auf der Zahlungsseite ab, kehrt er zur Kasse zurück und sieht The card payment was cancelled. You can try again or choose another payment method. Gibt die Zahlungsseite einen Fehler zurück oder hat finby die Zahlung bereits abgelehnt, lautet die Meldung The card payment was not completed. Please try again or choose another payment method. Der Warenkorb bleibt erhalten und der Kunde kann erneut zahlen. In OpenCart 4 werden diese Meldungen über der Kassenseite angezeigt.

OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 aktualisiert die Bestellung der Kasse. Ein Warenkorb wird nur durch eine Bestellung bezahlt: Sobald eine Bestellung des Warenkorbs einen TrustPay-Status hat, führt eine erneute Bestätigung des Warenkorbs zur Erfolgsseite statt zu einer zweiten Zahlung. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung braucht.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Nach einer abgebrochenen oder fehlgeschlagenen Zahlung bezahlt der Kunde dieselbe Bestellung mit einer neuen Zahlungsanfrage bei finby. Wurde diese Bestellung inzwischen geschlossen, kehrt der Kunde zur Kasse zurück, und das nächste Confirm Order bezahlt eine neue Bestellung: nach einer abgelehnten Zahlung oder einer abgebrochenen unbezahlten Bestellung mit The card payment was not completed. Please try again or choose another payment method., sonst (zum Beispiel wenn Sie die Bestellung storniert oder erstattet haben) mit Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order.

Kann finby die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order und sieht über der Schaltfläche We could not start the card payment. Please try again in a moment or choose another payment method. Der technische Grund wird im Protokoll festgehalten.

Die Erweiterung nimmt nur Kartenzahlungen als Einmalzahlung auf der finby-Seite an. Es gibt keine Banküberweisungen oder anderen finby-Zahlungsarten, keine Apple Pay- oder Google Pay-Schaltflächen auf Ihrer Website, keine gespeicherten Karten, keine Abonnements oder wiederkehrenden Zahlungen, keine getrennte Autorisierung und Erfassung und keine Statusabfrage.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (Bestellung ohne Status): Der Kunde wurde zu finby weitergeleitet und hat nicht bezahlt, oder die Benachrichtigung ist noch nicht eingetroffen. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt. In OpenCart 4.1 kann eine solche Bestellung auch den Status Voided haben, den OpenCart setzt, wenn der Bestätigungsschritt erneut angezeigt wird; die Erweiterung zählt sie als Bestellung ohne Status.

Bestellstatus nach Zahlung (Standard In Bearbeitung): finby hat die Zahlung bestätigt, und Betrag und Währung stimmen mit der Zahlungsanfrage und der Bestellsumme überein. Eine Notiz zeigt Betrag, Zahlungsanfrage und Projekt (Test oder Live).

Ausstehende TrustPay-Zahlung (Standard Ausstehend): finby hat die letzte Zahlung als ausstehend gemeldet. Die Bestellung wechselt in den bezahlten Status, sobald finby die Zahlung bestätigt.

Zurückgehaltene TrustPay-Zahlung (Standard Ausstehend): Dieser Status wird in zwei Fällen gesetzt. Die Zahlung wurde nur autorisiert, nicht erfasst: Erfassen oder stornieren Sie sie im finby Merchant Portal und aktualisieren Sie dann die Bestellung. Oder der bezahlte Betrag bzw. die Währung weicht von der Zahlungsanfrage oder der Bestellsumme ab: Prüfen Sie die Zahlung vor dem Versand. Die Notiz erklärt den Fall. Das Geld ist eingegangen, daher ist eine Erstattung möglich.

Zahlungsfehler (Standard Fehlgeschlagen): finby hat die letzte Zahlung einer wartenden Bestellung abgelehnt. Die Notiz zeigt den Grund, wenn finby ihn übermittelt. Eine später bestätigte Zahlung setzt die Bestellung trotzdem in den bezahlten Status.

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

Stornierte oder erstattete Bestellungen werden durch eine späte Zahlung nie wieder geöffnet. Eine Notiz fordert Sie auf, die Bestellung wiederherzustellen oder die Zahlung im Merchant Portal zu erstatten. Trifft eine zweite Zahlung für eine bereits bezahlte Bestellung ein oder für eine andere Bestellung eines Warenkorbs, der bereits eine bezahlte Bestellung hat, wird die Bestellung nicht verändert, und eine Notiz bittet Sie, das Duplikat im Merchant Portal zu erstatten. Von finby gemeldete Rückbuchungen und Streitfälle werden als Notizen hinzugefügt.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht. Sie werden in der Standardsprache des Shops geschrieben.

VibeFox TrustPay Gateway tab

Öffnen Sie unter Sales > Orders eine mit TrustPay bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Tab VibeFox TrustPay Gateway die Payment request ID, die Payment ID, das Project mit dem Kennzeichen Test project bei Testzahlungen, den Status, die Beträge Requested / paid und Paid / refunded, das Erstattungsformular, den Erstattungsverlauf, die Payment requests of this order und die TrustPay notes. Der Tab wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Tab VibeFox TrustPay Gateway den Amount ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via TrustPay. Bestätigen Sie die Frage Refund this amount through TrustPay? This cannot be undone. Volle und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Erstattungen erfolgen in dem Betrag und in der Währung, die finby für die Zahlung gemeldet hat. Nach einer Abweichung beim Betrag können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht die Bestellsumme. HUF-Erstattungen müssen ganze Beträge sein.

Die Erstattung geht an das Projekt, über das die Bestellung bezahlt wurde (Test oder Live), auch wenn Sie seitdem den Modus gewechselt haben. Project ID und Secret key dieses Projekts müssen eingerichtet sein, und seine Project ID darf sich nicht geändert haben. Eine Erstattung wird nur erfasst, wenn finby sie annimmt. Andernfalls zeigt der Tab TrustPay refused the refund: mit dem Grund an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen hinzugefügt. Eine volle Erstattung setzt die Bestellung auf Refunded order status, ohne den Kunden zu benachrichtigen und ohne Produkte wieder ins Lager zu buchen, wie bei einer manuellen Statusänderung. Eine teilweise Erstattung ändert den Status nicht.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über finby. Im finby Merchant Portal vorgenommene Erstattungen werden nicht als Erstattungen erfasst. Sendet finby dazu eine Benachrichtigung, wird sie als Notiz hinzugefügt und der Bestellstatus bleibt unverändert.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox TrustPay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox TrustPay 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 gilt, 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-trustpay 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 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 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 gilt 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 die Kartenzahlung im Checkout nicht angezeigt. Startet trotzdem eine Zahlung, sieht der Kunde This payment method is not available. Please choose another one. Ein im Admin angemeldeter Admin-Benutzer im selben Browser 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. In OpenCart 4 gibt es diese Vorschau nicht: Der Shop sieht die Admin-Anmeldung nicht, daher wird die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie einmal die Seite Edit geöffnet haben, erscheint ein Hinweis auf dem Dashboard des Admins. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin durch die TrustPay-Benachrichtigung und die Rückkehr in den Shop 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 automatisch erneut geprüft, wenn Sie das Dashboard oder die Seite Edit im Admin öffnen: 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. Die Deinstallation der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Card payment (TrustPay) erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist und der aktuelle Modus seine Project ID und seinen Secret key hat: Test Project ID und Test Secret key im Testmodus, Live Project ID und Live Secret key im Livemodus. Die Währung des Kunden muss zu den unterstützten Währungen gehören. Die Einstellungsseite zeigt eine Warnung, wenn Zugangsdaten fehlen oder die Standardwährung nicht unterstützt wird. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo zone liegt und die Bestellung den Minimum total erreicht.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: Die Benachrichtigung hat Ihren Shop nicht erreicht. Prüfen Sie, ob die URL unter Notification URL aus dem Internet erreichbar ist (keine Firewall, Wartungsanmeldung oder HTTP-Authentifizierung). finby wiederholt die Benachrichtigung, und die Bestellung erhält ihren Status, sobald sie eintrifft. Fehler werden immer im Protokoll festgehalten; sehen Sie im Feld Log auf der Seite der Erweiterung nach.

Das Protokoll zeigt Notification rejected: invalid signature or unknown project: Die Benachrichtigung stammt von einem Projekt, dessen Project ID nicht in den Einstellungen steht, oder der Secret key dieses Projekts ist falsch. Der Shop antwortet mit Invalid signature, und nichts wird geändert. Prüfen Sie Project ID und Secret key des Modus, in dem die Zahlung erfolgte.

Das Protokoll zeigt Notification ignored: Die Benachrichtigung gehört zu einer Zahlungsanfrage, die dieser Shop für diese Bestellung nicht erstellt hat, oder zu einem anderen Projekt oder Modus als dem, mit dem die Zahlung gestartet wurde. Es wird nichts geändert.

Die Benachrichtigung wird mit Busy, retry later oder Temporary error beantwortet: Der Warenkorb wurde im selben Moment durch eine andere Benachrichtigung aktualisiert, oder der Bestellstatus konnte nicht gesetzt werden. finby wiederholt sie. Das Protokoll zeigt den Grund.

Der Kunde sieht We could not start the card payment: Öffnen Sie das Protokoll. Eine falsche Project ID oder ein falscher Secret key führt zu einer Meldung, dass finby die Zugangsdaten des Projekts abgelehnt hat. Prüfen Sie, ob die Testdaten in den Testfeldern und die Livedaten in den Livefeldern stehen.

Card payment is temporarily unavailable: Der Kunde sieht dies, wenn der aktuelle Modus keine Project ID oder keinen Secret key hat. Geben Sie sie ein und speichern Sie.

Bestellung ist im zurückgehaltenen Status: Lesen Sie die Notizen im Tab VibeFox TrustPay Gateway (siehe Bestellstatus). Prüfen Sie die Zahlung vor dem Versand im Merchant Portal und erfüllen Sie dann die Bestellung oder erstatten Sie die Zahlung.

Erstattung schlägt mit einer Meldung zum Projekt fehl: Die Bestellung wurde über das Test- oder Live-Projekt bezahlt, und Project ID oder Secret key dieses Modus sind nicht gesetzt, oder dort ist jetzt eine andere Project ID gespeichert. Geben Sie die Zugangsdaten dieses Projekts ein oder erstatten Sie die Zahlung im finby Merchant Portal.

Invalid refund amount: at most … can be refunded: Der Betrag ist höher als der bezahlte Betrag abzüglich der bereits über die Erweiterung erfolgten Erstattungen.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox TrustPay 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, Minimum total und die Bestellstatus, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Außerdem werden das OpenCart-Event der Erweiterung und die zwischengespeicherten API-Zugriffstokens entfernt (in OpenCart 4 zusätzlich dessen Events und Startaktion, die Benachrichtigung und Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiviert, werden die übrigen Einstellungen (Titel, Beschreibung, Testmodus, Project IDs, Secret keys, Protokollierung) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die TrustPay-Zahlungsdatensätze und Erstattungen bleiben immer erhalten, sodass früher bezahlte Bestellungen auch nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

TrustPay und finby sind Marken ihrer jeweiligen Inhaber. Diese Erweiterung ist nicht mit TrustPay oder finby verbunden und wird von ihnen nicht unterstützt.