VibeFox Tap for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 8.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.

PHP: 8.0 oder neuer.

Shop-Währung: AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR oder USD. Bei anderen Währungen wird die Zahlungsart in der Kasse ausgeblendet.

Internetzugang zu Ihrer Website: Tap sendet das Zahlungsergebnis an einen Webhook in Ihrem Shop, daher muss die Website aus dem Internet erreichbar sein. Die Webhook-URL wird bei jeder Zahlung übermittelt; 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 weitere) und die Domainverifizierung für Apple Pay richten Sie in Ihrem Tap-Konto ein.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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. Alternativ können Sie den Ordner wcp_tap_payment_gateway per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Tap Payments > 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 Ihre Tap-Test- und Live-Schlüssel ein, wählen Sie die Zahlungsaktion, den Kassentyp und die Sprache der Tap-Seite (siehe Konfiguration).

6. Aktivieren Sie Enable / Disable und speichern Sie. Testen Sie mit den Tap-Testkarten und deaktivieren Sie danach Test mode.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Tap Payments. Oberhalb der Felder zeigt die Seite Test mode is on: payments use your Tap test keys and no real money is charged., solange der Testmodus aktiv ist. Außerdem wird angezeigt, wenn die Schlüssel des aktuellen Modus fehlen (dann wird das Gateway in der Kasse nicht angezeigt), und wenn die Shop-Währung von Tap nicht unterstützt wird. In der Liste der Zahlungsarten ist Tap Payments als einrichtungsbedürftig markiert, bis der aktuelle Modus einen geheimen Schlüssel hat (und für das Popup zusätzlich einen öffentlichen Schlüssel).

Beim Speichern wird ein Schlüssel mit dem falschen Präfix für sein Feld nicht gespeichert: Es erscheint eine Fehlermeldung und der bisherige Wert bleibt erhalten. Ein Live-Schlüssel in einem Testfeld wird beispielsweise abgelehnt.

Allgemein

Enable / Disable: Enable Tap Payments schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, der in der Kasse angezeigt wird. Standard: Tap Payments.

Description: der Text, der in der Kasse unter der Zahlungsart angezeigt wird. Standard: Pay with Visa, Mastercard, mada, KNET, Benefit, Apple Pay or Google Pay.

Tap-API-Schlüssel

Ihre Schlüssel finden Sie im Tap-Dashboard (goSell, API-Zugangsdaten). Testschlüssel beginnen mit pk_test_ / sk_test_, Live-Schlüssel mit pk_live_ / sk_live_.

Test mode: Use the test keys (no real money is charged). Zahlungen, Statusprüfungen und Erstattungen verwenden immer die Schlüssel des Modus, in dem die Zahlung erfolgte. Eine Testzahlung wird daher auch nach dem Umstellen auf Live weiterhin mit dem Testschlüssel geprüft und erstattet. Standard: ein.

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 über ein bestimmtes Händlerkonto abzuwickeln.

Zahlung

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

Checkout type: wo der Kunde bezahlt.

Tap page language: English (Standard) oder Arabic.

Zahlungsbenachrichtigungen (Webhook)

Tap sendet das Zahlungsergebnis an die URL, die in diesem Abschnitt angezeigt wird. Sie hat die Form https://your-site/wc-api/tap_p_webhook/. Die URL wird bei jeder Zahlung übermittelt, daher muss im Tap-Dashboard nichts eingerichtet werden. Stellen Sie lediglich sicher, dass sie aus dem Internet erreichbar ist (nicht durch eine Firewall, den Wartungsmodus oder eine HTTP-Authentifizierung blockiert). Jede Benachrichtigung wird mit der Hashstring-Signatur geprüft (HMAC-SHA256 mit dem geheimen Schlüssel des Modus der Zahlung). Webhooks ohne gültige Signatur werden abgelehnt. Selbst eine signierte Benachrichtigung wird nicht ungeprüft übernommen: Das Plugin liest die Zahlung erneut über die Tap-API aus, bevor es die Bestellung ändert. Ohne funktionierenden Webhook wird die Bestellung nur dann aktualisiert, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Erweitert

Debug log: Log payment events (WooCommerce → Status → Logs, source "wcp_tap_payment_gateway"). Fehler werden immer protokolliert. Das Protokoll enthält nie Schlüssel, Karten- oder Kundendaten. Standard: aus.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted (order payment records are kept). Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Tap Payments) und gibt die Bestellung auf. Im Testmodus zeigt die Kasse Test mode: no real payment will be made. an.

Tap payment page: Das Plugin erstellt für den Bestellbetrag in der Bestellwährung eine Tap-Belastung (bzw. im Modus Authorize only eine Autorisierung) mit der Beschreibung Order # und der Bestellnummer und leitet den Kunden auf die Tap-Zahlungsseite weiter. Dort wählt der Kunde eine Karte, mada, KNET, Benefit, Apple Pay oder Google Pay (je nach Aktivierung in Ihrem Tap-Konto) und bezahlt. Kann Tap die Zahlung nicht starten, sieht der Kunde The Tap payment could not be started. Please try again or choose another payment method., und der Grund wird in den Bestellnotizen vermerkt.

Tap checkout popup: Der Kunde gelangt auf die Zahlungsseite der Bestellung, wo sich das Tap-Zahlungsformular öffnet. Die Seite zeigt außerdem den Link Pay on the Tap payment page instead. Wird das Fenster geschlossen, öffnet der Button Pay now es erneut. Lässt sich das Formular nicht laden, wird der Kunde gebeten, die Tap-Zahlungsseite zu verwenden.

Nach der Zahlung kehrt der Kunde zur Seite „Bestellung eingegangen“ zurück. Die Bestellung wird erst als bezahlt markiert, wenn Tap die Zahlung bestätigt: Das Plugin liest die Zahlung mit dem Schlüssel des Zahlungsmodus über die Tap-API aus, prüft, dass sie sich auf diese Bestellung bezieht und von ihrer Kasse gestartet wurde, und vergleicht Betrag und Währung mit der Bestellung. Die Tap-ID in der Rücksprung-Adresse allein markiert eine Bestellung nie als bezahlt. Der Webhook führt dieselbe Prüfung im Hintergrund durch. Wiederholte Webhooks und Rücksprünge ändern eine Bestellung nie zweimal (jeweils nur eine Änderung gleichzeitig pro Bestellung).

Ist die Zahlung noch nicht bestätigt, zeigt die Seite „Bestellung eingegangen“ 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. an. Bei einer autorisierten Zahlung erscheint Your payment has been authorized. We will process the order as soon as the payment is captured.

Wurde die Zahlung abgelehnt oder abgebrochen, wird die Bestellung als Fehlgeschlagen markiert, und der Kunde gelangt zurück zur Seite Pay for order mit der Meldung Your payment was not completed. Please try again or choose another payment method. (mit dem Grund von Tap, sofern Tap einen angibt). Eine nicht abgeschlossene Zahlung zeigt The payment was not completed. You can try again below. Der Kunde kann die Bestellung über diese Seite erneut bezahlen.

Die Zahlungsart funktioniert in der klassischen Kasse, im Checkout-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin unterstützt keine gespeicherten Karten oder Tokenisierung, keine Abonnements und keine Kartenfelder, die in Ihre Kasse eingebettet sind. Capture Tap payment erfasst immer den vollen Bestellbetrag; eine Teilerfassung wird nicht unterstützt.

Bestellungen und Erstattungen

Bestellstatus

Pending payment: Der Kunde wurde zu Tap weitergeleitet und hat noch nicht bezahlt, oder Tap hat die Zahlung noch nicht bestätigt.

Processing: Tap hat eine erfasste Zahlung bestätigt. Das ist der übliche WooCommerce-Status nach der Zahlung (Bestellungen, die nur virtuelle herunterladbare Produkte enthalten, werden direkt auf Abgeschlossen gesetzt). Die Bestellnotiz zeigt den Betrag, die Tap-Charge-ID (chg_...), die Zahlungsart und (im Testmodus) den Hinweis, dass es sich um eine Testzahlung handelt. Die Transaktions-ID ist die Tap-Charge-ID.

On hold: Die Zahlung wurde nur autorisiert und wartet auf die Erfassung; oder der bezahlte Betrag bzw. die Währung wich von der Bestellung ab (Tap: amount/currency mismatch — manual review required.); oder eine Zahlung ging ein, nachdem die Bestellung storniert worden war. Die Bestellnotiz erklärt es.

Failed: Die Zahlung wurde abgelehnt, abgebrochen, storniert oder ist abgelaufen. Nur eine Bestellung, die noch auf Zahlung wartet, wird als Fehlgeschlagen markiert; ein fehlgeschlagener Versuch ändert nie eine bezahlte, autorisierte oder stornierte Bestellung. Der Kunde kann erneut zahlen.

Cancelled: Die Autorisierung wurde mit Void Tap authorization aufgehoben, daher wurden die reservierten Mittel freigegeben.

Geht für eine bereits bezahlte Bestellung eine zweite erfolgreiche Zahlung ein, wird die Bestellung nicht erneut geändert. Eine Notiz weist auf eine doppelte Zahlung hin und bittet Sie, sie im Tap-Dashboard zu erstatten. Eine Zahlung, die sich auf die Bestellung bezieht, aber nicht von ihrer Kasse gestartet wurde, wird nur vermerkt.

Erfassung und Aufhebung

Öffnen Sie im Modus Authorize only die Bestellung auf Halten und wählen Sie unter Order actions: Capture Tap payment erfasst den Bestellbetrag; die Bestellung wird danach als bezahlt markiert. Void Tap authorization gibt die Mittel frei und storniert die Bestellung. Lehnt Tap die Aktion ab, wird ein Fehler angezeigt und in den Bestellnotizen vermerkt. 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 vorgenommen werden.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Tap Payments (die Schaltfläche zeigt Ihren Title). Vollständige und teilweise Erstattungen werden für erfasste Tap-Belastungen unterstützt. 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 Tap-Erstattungs-ID und Status in den Bestellnotizen vermerkt. Lehnt Tap sie ab, zeigt WooCommerce den Fehler an und es wird keine Erstattung erfasst. Erstattungen, die im Tap-Dashboard vorgenommen werden, erscheinen nicht in WooCommerce.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Tap Payments. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status an, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Tap Payments Kunden in der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsart weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Ein Hinweis erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen, Erfassung und Aufhebung funktionieren.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, für Updates und Support ist jedoch eine Verlängerung nötig. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Tap Payments erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist und der aktuelle Modus einen geheimen Schlüssel hat (und einen öffentlichen Schlüssel, wenn Checkout type das Popup ist). Prüfen Sie, dass die Shop-Währung (oder die Bestellwährung auf der Seite Pay for order) eine von AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR, USD ist. Die Einstellungsseite zeigt für jedes dieser Probleme einen Hinweis an.

Die Zahlung ist erfolgt, aber die Bestellung bleibt bei Pending payment: Der Webhook kann Ihre Website nicht erreichen. Prüfen Sie, ob die in den Einstellungen angezeigte URL (/wc-api/tap_p_webhook/) aus dem Internet erreichbar ist (keine Firewall, kein Wartungsmodus, keine HTTP-Authentifizierung), und sehen Sie unter WooCommerce > Status > Logs nach, Quelle wcp_tap_payment_gateway. Die Bestellung wird auch aktualisiert, 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. Tragen 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.

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_.

Die Bestellung ist On hold: Lesen Sie die Bestellnotiz. Die Zahlung wurde nur autorisiert (erfassen Sie sie über die Bestellaktionen), der bezahlte Betrag oder die Währung stimmte nicht mit der Bestellung überein, oder die Zahlung ging 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. Tragen Sie ihn ein und versuchen Sie es erneut. Meldet die Notiz, dass keine erfasste Tap-Belastung gefunden wurde, erstatten Sie die Zahlung im Tap-Dashboard.

Hooks für Entwickler: Die Filter tap_p_supported_currencies, tap_p_currency_decimals, tap_p_charge_payload, tap_p_icon, tap_p_checkout_sdk_url und tap_p_payment_page_hosts sind verfügbar.

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 einen Platz in Ihrem vibefox.net-Konto frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

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 Einstellungen des Gateways, die übrigen Optionen des Plugins und die Protokolle werden nur entfernt, wenn Delete data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen, Tap-IDs und Transaktions-IDs.

Tap Payments ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Tap Payments verbunden noch wird es von Tap Payments unterstützt.