VibeFox PayPal for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

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

PHP: 8.0 oder neuer.

HTTPS: Ihre Website sollte für Live-Zahlungen HTTPS verwenden.

PayPal-Konto: ein PayPal-Business-Konto mit einer REST-API-App im PayPal Developer Dashboard. Sie benötigen die Client ID und das Secret der App. Sandbox- und Live-Apps haben unterschiedliche Zugangsdaten. Ein Webhook ist nicht erforderlich: Das Plugin bestätigt jede Zahlung auf Ihrem Server, während der Kunde auf der Kasse ist.

Währung: eine der von PayPal unterstützten Währungen: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, ILS, JPY, MXN, MYR, NOK, NZD, PHP, PLN, SEK, SGD, THB, TWD oder USD.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert auf einer Domain.

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_paypal_gateway per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Erstellen Sie im PayPal Developer Dashboard eine REST-API-App (Sandbox und/oder Live) und kopieren Sie deren Client ID und Secret.

4. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > PayPal (Smart Buttons) > Manage oder klicken Sie auf der Seite Plugins unter dem Plugin-Namen auf Settings.

5. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzbereich oben auf der Seite ein und klicken Sie auf Activate.

6. Tragen Sie die Zugangsdaten des verwendeten Modus ein, wählen Sie Capture oder Authorize, aktivieren Sie Enable/Disable und speichern Sie.

7. Testen Sie mit einem PayPal-Sandbox-Käuferkonto und deaktivieren Sie danach Sandbox mode, um die Live-Zugangsdaten einzutragen.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > PayPal (Smart Buttons). Oberhalb der Felder warnt die Seite, wenn die Zahlungsart aktiviert ist, die Client ID oder das Secret des gewählten Modus aber leer ist, und wenn PayPal die Shop-Währung nicht unterstützt. In beiden Fällen wird die Zahlungsart auf der Kasse ausgeblendet. In der Liste der Zahlungsarten zeigt PayPal im Sandbox-Modus ein Abzeichen Test mode und ist als einzurichten markiert, bis die Zugangsdaten des gewählten Modus eingetragen sind.

Allgemein

Enable/Disable: Enable PayPal Gateway schaltet die Zahlungsart ein oder aus. Standard: off.

Title: der Name der Zahlungsart, den Kunden auf der Kasse sehen. Standard: PayPal.

Description: der Text unter der Zahlungsart auf der Kasse. Standard: Pay with your PayPal account or a card via PayPal.

API-Zugangsdaten

Erstellen Sie im PayPal Developer Dashboard eine REST-API-App und kopieren Sie deren Client ID und Secret. Der Bereich enthält Links zu den Sandbox- und den Live-Apps. Es werden nur die Felder des gewählten Modus angezeigt.

Sandbox mode: Enable sandbox (test) mode. Zahlungen gehen mit den Sandbox-Zugangsdaten an die PayPal-Sandbox; es wird kein echtes Geld bewegt. Standard: on. Deaktivieren Sie die Option, um echte Zahlungen anzunehmen.

Sandbox Client ID: die Client ID Ihrer REST-API-App für die Sandbox.

Sandbox Secret: das Secret Ihrer REST-API-App für die Sandbox.

Live Client ID: die Client ID Ihrer Live-REST-API-App.

Live Secret: das Secret Ihrer Live-REST-API-App.

Zahlung

Payment action: was geschieht, wenn der Kunde die Zahlung bestätigt. Standard: Capture.

Capture: Der Kunde wird sofort belastet und die Bestellung wird auf In Bearbeitung gesetzt.

Authorize: Die Mittel werden nur reserviert und die Bestellung wird auf Wartend gesetzt. Erfassen oder stornieren Sie die Zahlung über das Menü Order actions auf der Bestellseite. PayPal-Autorisierungen können innerhalb von 29 Tagen erfasst werden.

Erweitert

Debug log: Log API requests (errors are always logged). Einträge werden unter WooCommerce > Status > Logs mit der Quelle wcp_paypal_gateway gespeichert. Zugangsdaten und Käuferdaten werden nie protokolliert. Standard: off.

Delete data on uninstall: Delete the gateway settings when the plugin is deleted. Zahlungsdaten der Bestellungen (PayPal-IDs in den Bestellungen) bleiben immer erhalten. Standard: off.

Kasse

Wählt der Kunde PayPal (standardmäßig PayPal), ersetzt die PayPal-Schaltfläche Place order. Im Sandbox-Modus zeigt die Kasse Sandbox-Modus: Mit einem PayPal-Sandbox-Käuferkonto bezahlen – es wird kein echtes Geld abgebucht. Ein Klick auf die Schaltfläche erstellt auf Ihrem Server eine PayPal-Bestellung über die Warenkorbsumme (bzw. die Bestellsumme auf der Seite Pay for order). Der Betrag wird immer auf dem Server berechnet, nie im Browser.

Der Kunde bestätigt die Zahlung im PayPal-Fenster mit einem PayPal-Konto oder einer anderen von PayPal angebotenen Zahlungsquelle. Die Kasse zeigt dann PayPal-Zahlung bestätigt. Ihre Bestellung wird abgeschlossen… und sendet die Bestellung ab. Ihr Server liest die PayPal-Bestellung und prüft, ob sie freigegeben ist, auf dieser Kasse erstellt wurde, nicht von einer anderen Bestellung verwendet wird und Betrag und Währung mit der Bestellung übereinstimmen. Erst dann wird die Zahlung erfasst (oder autorisiert), und der Kunde gelangt zur Bestellbestätigung.

Hat sich die Warenkorbsumme nach der Freigabe geändert, wird nichts erfasst. Der Kunde sieht Die Bestellsumme hat sich geändert, nachdem Sie die Zahlung bei PayPal bestätigt haben. Bitte klicken Sie erneut auf die PayPal-Schaltfläche, um die neue Summe zu bestätigen. Fehlt ein Feld der Kasse, bleibt die Freigabe erhalten: Nach der Korrektur klickt der Kunde auf Place order, um die Zahlung abzuschließen. Lehnt PayPal die Zahlung ab, wird der Kunde gebeten, auf die PayPal-Schaltfläche zu klicken und eine andere Zahlungsart zu wählen. Schließt der Kunde das PayPal-Fenster, zeigt die Kasse Sie haben die PayPal-Zahlung abgebrochen.

Antwortet PayPal während der Erfassung nicht, sieht der Kunde Wir konnten Ihre PayPal-Zahlung noch nicht bestätigen. Bitte versuchen Sie es in einem Moment erneut – Sie werden nicht doppelt belastet. Ein erneuter Versuch verwendet dieselbe Freigabe; hat PayPal den früheren Versuch abgeschlossen, wird diese Zahlung verwendet und die neue Freigabe nicht erfasst.

Die Zahlungsart funktioniert auf der klassischen Kasse, im Checkout-Block und auf der Seite Pay for order. Das PayPal-Skript wird in einem eigenen Namespace geladen, sodass es nicht mit einem anderen PayPal-Plugin auf der Seite kollidiert. Das Plugin ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin hat keine PayPal-Webhooks, keine Pay-Later-Hinweise, keine Kartenfelder, keine Venmo-Einstellungen, kein Apple Pay, Google Pay oder Fastlane, keine gespeicherten Zahlungsarten oder Abonnements und keine Schaltflächen auf Produkt- oder Warenkorbseiten. Verwendet wird die Versandadresse aus der WooCommerce-Kasse, nicht eine Adresse aus PayPal.

Bestellungen und Erstattungen

Order statuses

Pending payment: Die Bestellung wurde angelegt, die Zahlung ist aber noch nicht erfasst, zum Beispiel nach einer unbekannten Antwort von PayPal.

Processing: Die Erfassung ist abgeschlossen. Bestellungen mit nur virtuellen, herunterladbaren Produkten werden auf Abgeschlossen gesetzt, dem WooCommerce-Standard. Die Bestellnotiz zeigt den Betrag, die PayPal-Bestellung und die Erfassung. Die Transaktions-ID ist die PayPal-Erfassungs-ID; auf der Bestellseite verlinkt sie zur Zahlung in Ihrem PayPal-Konto (Sandbox oder Live).

On hold: Die Zahlung wurde autorisiert und wartet auf die Erfassung (Zahlungsaktion Authorize); oder die Erfassung ist bei PayPal PENDING, zum Beispiel bei einer Zahlungsprüfung; oder der gezahlte Betrag oder die Währung weicht von der Bestellung ab; oder die Zahlung konnte der Antwort von PayPal nicht entnommen werden. Die Bestellnotiz erklärt es.

Failed: PayPal hat die Erfassung oder die Autorisierung abgelehnt.

Cancelled: Die Autorisierung wurde mit Void PayPal authorization storniert.

Bestellaktionen

Öffnen Sie die Bestellung, wählen Sie eine Aktion unter Order actions und klicken Sie auf den Pfeil.

Capture PayPal payment: erfasst eine autorisierte Zahlung über die Bestellsumme. Eine abgeschlossene Erfassung setzt die Bestellung auf In Bearbeitung. Wird angezeigt, solange die Autorisierung nicht erfasst ist.

Void PayPal authorization: gibt die reservierten Mittel frei und storniert die Bestellung.

Check PayPal payment status: liest eine PENDING-Erfassung erneut. COMPLETED setzt die Bestellung auf In Bearbeitung, DECLINED oder FAILED auf Fehlgeschlagen. Eine Erfassung über einen anderen Betrag oder eine andere Währung lässt die Bestellung auf Wartend mit einem Hinweis zur Abweichung.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via PayPal (die Schaltfläche zeigt den Titel Ihrer Zahlungsart). Vollständige und teilweise Erstattungen werden unterstützt. Die Erstattung wird an die PayPal-Umgebung gesendet, in der die Zahlung erfolgte (Sandbox oder Live); deren Zugangsdaten müssen daher hinterlegt sein. Der Grund wird als Hinweis an den Käufer an PayPal übergeben. Akzeptiert PayPal die Erstattung nicht, zeigt WooCommerce den Fehler an und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der PayPal-Erstattungs-ID und dem Status in den Bestellnotizen vermerkt; eine PENDING-Erstattung schließt PayPal später ab.

Eine nur autorisierte Zahlung kann nicht erstattet werden: Verwenden Sie stattdessen Void PayPal authorization. Erstattungen, Streitfälle und Rückbuchungen, die in Ihrem PayPal-Konto vorgenommen werden, werden nicht mit WooCommerce synchronisiert.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich befindet sich oben unter WooCommerce > Settings > Payments > PayPal (Smart Buttons). Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Bereich zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz gültig 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. Wenn Sie den Schlüssel von einer Website entfernen, wird der Domain-Platz nicht frei. Geben Sie ihn in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird PayPal Kunden auf der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shopbetreiber 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 Seite Plugins und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Erstattungen und Bestellaktionen funktionieren weiter.

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

Fehlerbehebung

PayPal erscheint nicht auf der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die Client ID und das Secret des gewählten Modus eingetragen sind, die Shop-Währung von PayPal unterstützt wird und die Warenkorbsumme über null liegt. Die Einstellungsseite zeigt eine Warnung, wenn Zugangsdaten oder Währung das Problem sind. Eine Browser-Erweiterung, die www.paypal.com blockiert, blendet die Schaltfläche ebenfalls aus.

Die Zahlung ist eingegangen, die Bestellung bleibt aber auf Zahlung ausstehend: Das Plugin hat keinen Webhook, daher wird die Zahlung nur während der Kasse bestätigt. Das passiert, wenn PayPal während der Erfassung nicht geantwortet hat. Lesen Sie die Bestellnotiz, prüfen Sie die Zahlung in Ihrem PayPal-Konto und schließen Sie die Bestellung manuell ab, oder lassen Sie den Kunden es erneut versuchen: Ein erneuter Versuch belastet nie doppelt.

PayPal ist derzeit nicht verfügbar: Die Zugangsdaten sind falsch oder gehören zum anderen Modus. Kopieren Sie Client ID und Secret der richtigen App erneut.

Ihre PayPal-Freigabe konnte dieser Kasse nicht zugeordnet werden: Die PayPal-Bestellung wurde nicht in dieser Kassensitzung erstellt, zum Beispiel weil die Sitzung abgelaufen ist. Der Kunde klickt erneut auf die PayPal-Schaltfläche.

Die Bestellung ist nach der Zahlung auf Wartend: Lesen Sie die Bestellnotiz. Die Zahlung wurde autorisiert (erfassen Sie sie mit Capture PayPal payment), die Erfassung ist bei PayPal PENDING (nutzen Sie später Check PayPal payment status), oder der gezahlte Betrag oder die Währung stimmte nicht mit der Bestellung überein.

Die Erfassung einer Autorisierung schlägt fehl: Die Autorisierung ist möglicherweise älter als 29 Tage oder bereits storniert. Die Bestellnotiz zeigt den Fehler von PayPal.

Erstattung schlägt fehl: Die Bestellung hat keine PayPal-Erfassung (nur eine Autorisierung), oder die Zugangsdaten der Umgebung, in der die Zahlung erfolgte, fehlen. Entwickler können die Währungsliste mit dem Filter wc_plg_supported_currencies ändern.

Der Lizenzbereich zeigt einen Fehler: Folgen Sie der Meldung im Bereich. Ist der Schlüssel etwa bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem letzten bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Die Einstellungen des Gateways und die zwischengespeicherten PayPal-Zugriffstoken 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, Transaktions-IDs und PayPal-IDs.

PayPal ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit PayPal verbunden und wird nicht von PayPal unterstützt.