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

Bestellwährung: AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR oder USD. Bei Bestellungen in anderen Währungen wird die Zahlungsart an der Kasse nicht angezeigt.

Internetzugang zu Ihrem Shop: Tap sendet das Zahlungsergebnis an einen Webhook auf Ihrem Shop, daher muss die Website aus dem Internet erreichbar sein. Die Webhook-URL wird mit jeder Zahlung übertragen; im Tap-Dashboard muss nichts eingerichtet werden.

Tap-Konto: Sie benötigen die API-Schlüssel aus Ihrem Tap-Dashboard (goSell, API-Zugangsdaten). Testschlüssel beginnen mit pk_test_ / sk_test_, Live-Schlüssel mit pk_live_ / sk_live_. Der geheime Schlüssel wird immer benötigt; der öffentliche Schlüssel nur für das Checkout-Popup. Welche Zahlungsarten angeboten werden (mada, KNET, Benefit und andere) und die Domain-Verifizierung für Apple Pay richten Sie in Ihrem Tap-Konto ein.

VibeFox-Lizenzschlüssel: Erwerb auf vibefox.net. 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 Paket für OpenCart 3 wcp_tap_payment_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_tap_payment_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_tap_payment_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 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 Tap Payments 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 License key).

4. Geben Sie Ihre Tap-Testschlüssel und Live-Schlüssel ein, wählen Sie die Zahlungsaktion, den Checkout-Typ und die Sprache der Tap-Seite (siehe Configuration).

5. Aktivieren Sie Enable / Disable und klicken Sie auf Save. Testen Sie mit den Tap-Testkarten und schalten Sie danach Test mode aus.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_tap_payment_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 und wählen Sie den Typ Payments. Suchen Sie VibeFox Tap Payments, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die Tap-Schlüssel und die Zahlungsoptionen wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Eine Neuinstallation startet mit deaktivierter Zahlungsart und eingeschaltetem Testmodus.

Configuration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Tap Payments > Edit. Die Abschnitte stehen links; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite Test mode is on: payments use your Tap test keys and no real money is charged. oder Live mode: real payments are accepted. an. Sie warnt außerdem, wenn die Schlüssel des aktuellen Modus fehlen (die Zahlungsart wird dann an der Kasse nicht angezeigt), und wenn die Standardwährung des Shops von Tap nicht unterstützt wird. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein und nicht mehr als 128 Zeichen haben, Sort Order muss eine ganze Zahl sein (negative Werte sind erlaubt), Total muss eine Zahl von 0 oder mehr sein, und die Bestellstatus müssen existieren; andernfalls wird nichts gespeichert. Ein Schlüssel mit dem falschen Präfix für sein Feld wird nicht gespeichert: Der bisherige Wert bleibt erhalten, die übrigen Einstellungen werden gespeichert, und es erscheint eine Meldung wie Test secret key was not saved: a Tap key for this field starts with "sk_test_".. Ein Live-Schlüssel in einem Testfeld wird zum Beispiel abgelehnt.

Tap Payments

Enable / Disable: Enable Tap Payments 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: Tap Payments. Pflichtfeld, höchstens 128 Zeichen.

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay with Visa, Mastercard, mada, KNET, Benefit, Apple Pay or Google Pay.

Sort Order: die Position von Tap unter den Zahlungsarten an der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein (negative Werte sind erlaubt).

Geo Zone: Tap nur für Rechnungsadressen in der gewählten Geo-Zone anbieten. Standard: All zones. Geo-Zonen richten Sie unter System > Localisation > Geo Zones ein.

Total: der Kassenbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor Tap angeboten wird. Lassen Sie das Feld leer, um Tap bei jedem Betrag anzubieten.

Tap-API-Schlüssel

Ihre Schlüssel finden Sie im Tap-Dashboard (goSell, API-Zugangsdaten). Der Abschnitt verweist auf die Entwicklerdokumentation von Tap.

Test mode: verwendet die Testschlüssel, es wird kein echtes Geld belastet. Zahlungen, Statusabfragen, Erfassungen und Erstattungen verwenden immer die Schlüssel des Modus, in dem die Zahlung erfolgt ist. Eine Testzahlung wird daher auch nach dem Umschalten auf Live mit dem Testschlüssel geprüft und erstattet. Standard: an. Solange er eingeschaltet ist, sehen Kunden im Schritt Confirm Order und auf der Popup-Zahlungsseite Test mode: no real payment will be made.

Test publishable key: beginnt mit pk_test_. Wird für das Popup benötigt.

Test secret key: beginnt mit sk_test_.

Live publishable key: beginnt mit pk_live_. Wird für das Popup benötigt.

Live secret key: beginnt mit sk_live_.

Merchant ID: optional. Ihre Tap-Merchant-ID; nur nötig, wenn Tap Sie gebeten hat, Zahlungen an ein bestimmtes Händlerkonto weiterzuleiten.

Gespeicherte geheime Schlüssel werden nie 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, aktivieren Sie unter dem Feld Clear the saved value und klicken Sie auf Save. Die öffentlichen Schlüssel sind nicht geheim und bleiben sichtbar.

Zahlung

Payment action: was mit dem Geld geschieht, wenn der Kunde bezahlt.

Checkout type: wo der Kunde bezahlt.

Tap page language: Sprache der Tap-Zahlungsseite und des Popups: English (Standard) oder Arabic.

Zahlungsbenachrichtigungen (Webhook)

Tap sendet das Zahlungsergebnis an die URL, die in diesem Abschnitt unter Webhook URL angezeigt wird. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_tap_payment_gateway/webhook, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_tap_payment_gateway/payment/wcp_tap_payment_gateway.webhook. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Die URL wird mit jeder Zahlung übertragen, daher muss im Tap-Dashboard nichts eingerichtet werden. Stellen Sie nur sicher, dass sie aus dem Internet erreichbar ist (nicht durch eine Firewall oder HTTP-Authentifizierung blockiert); der Wartungsmodus blockiert sie nicht (bei OpenCart 4 lässt eine Startaktion der Erweiterung den Webhook und die Rückkehr des Kunden durch). Jede Benachrichtigung wird mit der hashstring-Signatur geprüft (HMAC-SHA256 mit dem geheimen Schlüssel des Modus, in dem die Zahlung erfolgte). Webhooks ohne gültige Signatur werden abgelehnt. Selbst eine signierte Benachrichtigung gilt nicht ohne Weiteres als vertrauenswürdig: Die Erweiterung liest die Zahlung vor jeder Änderung der Bestellung erneut über die Tap-API ein. Ohne funktionierenden Webhook erhält die Bestellung ihren Status erst, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Tap die Zahlung über die API bestätigt hat. Die folgenden Felder enthalten Ihre Bestellstatus aus OpenCart.

Paid Order Status: der Status nach einer erfassten Zahlung. Standard: In Bearbeitung.

Authorized Status: Authorize only: Die Mittel sind reserviert, aber noch nicht erfasst. Standard: Ausstehend.

On Hold (Review) Status: die Zahlung muss von Ihnen geprüft werden (siehe Bestellstatus). Standard: Ausstehend, da OpenCart keinen Status „In Prüfung“ hat. Sie können einen eigenen Status unter System > Localisation > Order Statuses anlegen und hier auswählen.

Voided Status: wird gesetzt, nachdem Void Tap authorization die reservierten Mittel freigegeben hat. Standard: Storniert.

Refunded Status: wird gesetzt, nachdem die Zahlung von der Bestellseite aus vollständig erstattet wurde. Standard: Erstattet.

Erweitert

Debug log: schreibt Zahlungsereignisse in tap_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs; bei OpenCart 4 system/storage/logs). Die Datei kann nicht über das Web gelesen werden, und bei 5 MB wird sie nach tap_p_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert; aktivieren Sie diese Option, um außerdem jedes Zahlungsereignis zu protokollieren. Das Protokoll enthält nie Schlüssel oder Karten- und Kundendaten. 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 die Deinstallation der Erweiterung die Gateway-Einstellungen und das Protokoll. Zahlungsdaten zu Bestellungen bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Die geheimen Schlüssel werden nicht exportiert.

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Tap Payments). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Dann klickt der Kunde auf Confirm Order. Bei 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.

Tap payment page: Die Erweiterung erstellt eine Tap-Belastung (oder eine Autorisierung im Modus Authorize only) für den Bestellbetrag in der Bestellwährung mit der Beschreibung Order # und der Bestellnummer und leitet den Kunden zur Tap-Zahlungsseite weiter. Name, E-Mail-Adresse und Telefonnummer des Kunden werden an Tap übergeben. Dort wählt der Kunde eine Karte, mada, KNET, Benefit, Apple Pay oder Google Pay (je nachdem, was in Ihrem Tap-Konto aktiviert ist) und zahlt. Kann Tap die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit The Tap payment could not be started. Please try again or choose another payment method., und der Grund wird im Protokoll festgehalten.

Tap checkout popup: Der Kunde gelangt zur Seite Tap payment der Erweiterung, auf der das Tap-Zahlungsformular geöffnet wird. Die Seite zeigt außerdem den Link Pay on the Tap payment page instead. Wurde das Fenster geschlossen, öffnet die Schaltfläche Pay now es erneut. Lässt sich das Formular nicht laden, wird der Kunde gebeten, die Tap-Zahlungsseite zu verwenden. Ein Neuladen der Seite verwendet denselben Zahlungsversuch.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Tap die Zahlung bestätigt: Die Erweiterung liest die Zahlung über die Tap-API mit dem Schlüssel des Zahlungsmodus erneut ein, prüft, ob sie sich auf diese Bestellung bezieht und von ihrem Checkout gestartet wurde, und vergleicht Betrag und Währung mit der Bestellung. Die Tap-ID in der Rücksprung-Adresse allein ändert die Bestellung nie. Der Webhook führt dieselbe Prüfung im Hintergrund durch. Die Bestellung erhält ihren Status dann auf die übliche OpenCart-Weise mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung. Bei OpenCart 4 öffnet sich, wenn der Kunde von der Tap-Zahlungsseite zurückkommt, kurz eine Zwischenseite, die die Rücksprung-Adresse Ihres Shops erneut aufruft, damit Warenkorb und Kundenanmeldung erhalten bleiben. Bei einer autorisierten Zahlung zeigt die Seite außerdem Your payment has been authorized. We will process the order as soon as the payment is captured. Bei einer Zahlung in Prüfung zeigt sie Your payment is being reviewed. We will contact you if anything else is needed.

Hat Tap die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt, zeigt eine Seite Payment confirmation den Text We have not received the payment confirmation from Tap yet. If you completed the payment, the order will be updated automatically in a few minutes — there is no need to pay again. mit den Schaltflächen Check again und Back to checkout. Der Webhook setzt den Bestellstatus, sobald er eintrifft.

Wurde die Zahlung abgelehnt, abgebrochen oder storniert, bleibt die Bestellung ohne Status. Der Kunde kehrt zur Kasse zurück und sieht Your payment was not completed. Please try again or choose another payment method. (mit dem Grund von Tap, wenn Tap einen angibt). Eine unvollendete Zahlung zeigt The payment was not completed. You can try again or choose another payment method. Der Warenkorb bleibt erhalten und kann erneut bezahlt werden. Bei OpenCart 4 werden diese Meldungen oberhalb 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. Wurde eine andere Bestellung desselben Warenkorbs bereits bezahlt, gelangt der Kunde direkt zur Erfolgsseite, statt erneut zu zahlen. Bevor eine neue Zahlung gestartet wird, werden die offenen Tap-Zahlungsseiten der Bestellung und des Warenkorbs der letzten 24 Stunden bei Tap geprüft, sodass eine in einem anderen Tab getätigte Zahlung bestätigt wird, statt doppelt belastet zu werden. Jede Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung benötigt.

Bei OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Nach einer abgelehnten oder abgebrochenen Zahlung startet der nächste Klick auf Confirm Order eine neue Tap-Zahlung für dieselbe Bestellung. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel weil Sie sie abgebrochen haben oder ihre Autorisierung storniert wurde), wird der Kunde mit der Meldung Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. zur Kasse zurückgeschickt, und der nächste Klick auf Confirm Order bezahlt eine neue Bestellung.

Weitere Meldungen an der Kasse: Tap does not accept payments in, gefolgt von der Währung, wenn die Bestellwährung nicht unterstützt wird, und The order total must be greater than zero to pay with Tap.

Die Erweiterung bietet keine gespeicherten Karten oder Tokenisierung, keine Abonnements und keine Kartenfelder, die in Ihre Kassenseite eingebettet sind. Capture Tap payment erfasst immer den vollen Bestellbetrag; Teilerfassungen werden nicht unterstützt.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu Tap weitergeleitet und hat nicht bezahlt, oder Tap hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt. Bei 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.

Paid Order Status (default Processing): Tap hat eine erfasste Zahlung bestätigt. Eine Notiz zeigt den Betrag, die Tap-Belastungs-ID (chg_...), die Zahlungsart und (im Testmodus) bei Testzahlungen.

Authorized Status (default Pending): Die Zahlung wurde nur autorisiert und wartet auf Erfassung oder Stornierung.

On Hold (Review) Status (default Pending): Der bezahlte Betrag oder die Währung wich von der Bestellung ab (Tap: amount/currency mismatch — manual review required.), oder eine Zahlung traf ein, nachdem die Bestellung storniert worden war. Die Notiz erklärt dies. Prüfen Sie die Bestellung und erfüllen Sie sie oder erstatten Sie die Zahlung.

Voided Status (default Canceled): Die Autorisierung wurde mit Void Tap authorization storniert, sodass die reservierten Mittel freigegeben wurden.

Refunded Status (default Refunded): Die Zahlung wurde über die Erweiterung vollständig erstattet.

Ein fehlgeschlagener Versuch ändert nie eine Bestellung, die bereits einen Status hat. Trifft eine zweite erfolgreiche Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz weist auf eine doppelte Zahlung hin und bittet Sie, sie im Tap-Dashboard zu erstatten. Eine Zahlung für eine andere Bestellung eines bereits bezahlten Warenkorbs lässt diese Bestellung ohne Status und wird auf der bezahlten Bestellung vermerkt. Eine Zahlung, die sich auf die Bestellung bezieht, aber nicht von ihrer Kasse gestartet wurde, wird nur vermerkt.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht. Sie beginnen mit „Tap“.

Tab VibeFox Tap Payments

Öffnen Sie unter Sales > Orders eine mit Tap bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Tab VibeFox Tap Payments die Tap ID, die Authorization und die Charge, den Mode (eine Kennzeichnung Test bei Testzahlungen), den Status der Zahlung und die Zahlungsart, Charged / refunded, das Erstattungsformular, den Erstattungsverlauf, die Payment attempts der Bestellung und die Tap notes. Der Tab wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben; Erfassung, Stornierung und Erstattungen erfordern das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups).

Erfassung und Stornierung

Öffnen Sie im Modus Authorize only die autorisierte Bestellung. Capture Tap payment (mit dem Bestellbetrag auf der Schaltfläche) erfasst den Bestellbetrag nach der Abfrage Capture the reserved funds of this order through Tap?; die Bestellung erhält danach den Paid Order Status. Void Tap authorization fragt Release the reserved funds? The order will be canceled., gibt die Mittel frei und setzt den Voided Status. Ein zweiter Klick auf Erfassen innerhalb von 2 Minuten wird blockiert. Lehnt Tap die Aktion ab, wird im Tab ein Fehler angezeigt und in den Notizen vermerkt. Diese Statusänderungen erfolgen ohne Benachrichtigung des Kunden und ohne Änderung des Bestands, wie eine manuelle Statusänderung. Wird eine Autorisierung direkt im Tap-Dashboard erfasst, markiert der Webhook die Bestellung als bezahlt; Erstattungen für eine solche Zahlung müssen im Tap-Dashboard erfolgen.

Erstattungen

Geben Sie im Tab den Amount ein (der noch nicht erstattete Betrag ist bereits eingetragen), optional einen Reason (optional), und klicken Sie auf Refund via Tap. Bestätigen Sie die Abfrage Refund this amount through Tap? This cannot be undone. Vollständige und teilweise Erstattungen werden für erfasste Tap-Belastungen unterstützt. Sie können bis zum Betrag und zur Währung erstatten, die Tap tatsächlich belastet hat, auch wenn die Bestellung später bearbeitet wurde. Die Erstattung wird mit dem geheimen Schlüssel des Modus gesendet, in dem die Zahlung erfolgte; dieser Schlüssel muss daher eingerichtet sein. Eine von Tap akzeptierte Erstattung wird mit der Tap-Erstattungs-ID und dem Status in den Erstattungsverlauf und die Notizen eingetragen. Lehnt Tap sie ab, zeigt der Tab den Fehler, und es wird keine Erstattung erfasst. Eine vollständige Erstattung setzt den Refunded Status ohne Benachrichtigung des Kunden und ohne Rückgabe der Produkte in den Bestand; eine teilweise Erstattung ändert den Status nicht. Bei einer autorisierten Bestellung sind Erstattungen erst möglich, sobald die Autorisierung erfasst wurde. Eine Bestellung in Prüfung nach einer Abweichung von Betrag oder Währung wird im Tap-Dashboard erstattet.

Produktrücksendungen unter Sales > Returns zahlen über Tap kein Geld zurück. Im Tap-Dashboard vorgenommene Erstattungen erscheinen nicht in OpenCart.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Tap Payments ist der erste Block unter Extensions > Extensions > Payments > VibeFox Tap Payments > 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 zur erneuten Statusprüfung, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-payment-tap 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. Nachdem sich die Shop-Adresse 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 seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Tap Payments 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 selben Browser im Admin 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. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin 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 Dashboard des Admins. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen, Erfassung und Stornierung funktionieren.

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

Fehlerbehebung

Tap Payments erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist und für den aktuellen Modus ein geheimer Schlüssel (und bei Checkout type als Popup ein öffentlicher Schlüssel) hinterlegt ist. Prüfen Sie, ob die Bestellwährung eine von AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR, USD ist, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht. Die Einstellungsseite zeigt eine Warnung bei fehlenden Schlüsseln und bei einer nicht unterstützten Shop-Währung.

Die Zahlung ging durch, aber die Bestellung bleibt ohne Status: Der Webhook kann Ihren Shop nicht erreichen. Prüfen Sie, ob die unter Webhook URL angezeigte URL aus dem Internet erreichbar ist (keine Firewall oder HTTP-Authentifizierung), und aktivieren Sie Debug log, um die Antworten im Feld Log zu sehen. Die Bestellung erhält ihren Status auch, wenn der Kunde von Tap zurückkehrt.

Webhook answers invalid signature: Die Benachrichtigung wurde nicht mit dem geheimen Schlüssel des Zahlungsmodus signiert. Prüfen Sie die geheimen Schlüssel in den Einstellungen.

Webhook answers gateway not configured: Der geheime Schlüssel des Zahlungsmodus (Test oder Live) ist leer. Geben Sie ihn ein.

Webhook answers verification failed: Die Tap-API konnte zur Prüfung der Zahlung nicht erreicht werden. Tap wiederholt den Webhook später.

Webhook answers order not found: Die Benachrichtigung nennt eine Bestellung, zu der es in diesem Shop keinen Tap-Zahlungsversuch gibt.

Webhook answers busy, retry later or order could not be updated, retry later: Die Bestellung wurde im selben Moment von einer anderen Anfrage bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. Tap wiederholt den Webhook. Sehen Sie im Feld Log nach dem Grund.

Ein Schlüssel wird nicht gespeichert: Der Schlüssel muss mit dem Präfix seines Feldes beginnen: pk_test_, sk_test_, pk_live_ oder sk_live_.

Der Kunde sieht The Tap payment could not be started: Sehen Sie im Feld Log auf der Erweiterungsseite nach. Ein falscher Schlüssel oder eine abgelehnte Anfrage wird dort protokolliert.

Der Kunde sieht This payment method is not available: Die Checkout-Sitzung passt nicht mehr zur Bestellung, oder die Zahlungsart wurde in der Zwischenzeit deaktiviert oder hat ihre Schlüssel verloren. Der Kunde lädt die Kasse neu.

Der Kunde sieht We could not match this payment to an order: Die Zahlung gehört nicht zu dieser Bestellung oder wurde nicht von deren Kasse gestartet. Wenn Geld abgebucht wurde, prüfen Sie die Zahlung im Tap-Dashboard.

Die Bestellung ist im Prüfstatus: Lesen Sie die Notizen im Tab VibeFox Tap Payments. Der bezahlte Betrag oder die Währung stimmte nicht mit der Bestellung überein, oder die Zahlung traf ein, nachdem die Bestellung storniert worden war.

Erstattung schlägt mit einer Meldung zum Modus fehl: Die Zahlung erfolgte im Test- oder Live-Modus, und für diesen Modus ist kein geheimer Schlüssel hinterlegt. Geben Sie ihn ein und versuchen Sie es erneut. Meldet der Tab, dass keine erfasste Tap-Belastung gefunden wurde, erstatten Sie die Zahlung im Tap-Dashboard.

Für Entwickler: Die OpenCart-Ereignisse tap_p_charge_payload, tap_p_supported_currencies und tap_p_currency_decimals ermöglichen es, die Zahlungsanfrage, die unterstützten Währungen und die Währungsdezimalstellen zu ändern.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Tap Payments 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 des Abschnitts Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 seine Ereignisse und seine Startaktion, die den Webhook und die Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Schlüssel, Zahlungsoptionen, Schalter des Debug-Protokolls) und das Protokoll entfernt. Ist es deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die Tap-Zahlungsversuche und Erstattungen bleiben immer erhalten, sodass früher bezahlte Bestellungen auch nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Bei OpenCart 4 entfernen Sie außerdem die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer, klicken Sie in der Liste der installierten Erweiterungen neben VibeFox Tap Payments auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

Tap Payments ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit Tap Payments verbunden und wird von Tap Payments nicht unterstützt.