PayPal Reader (Zettle) Gateway

Das PayPal Reader Gateway ermöglicht die Annahme von Vor-Ort-Kartenzahlungen über ein PayPal Reader (Zettle) Kartenterminal direkt aus WCPOS. Der Browser überträgt den aktuellen Zahlungsstatus vom Lesegerät über eine sichere Verbindung zur Reader Connect API von Zettle, sodass der Kassierer jeden Schritt der Zahlung in Echtzeit verfolgen kann.

Funktionen

Vor-Ort-Kartenzahlungen

Chip-, kontaktlose und Mobile-Wallet-Zahlungen an einem PayPal Reader (Zettle) Terminal akzeptieren

Live-Zahlungsstatus

Das POS zeigt den Echtzeit-Fortschritt — Verbindung wird hergestellt, Zahlung läuft, abgeschlossen oder storniert

Betrag serverseitig verifiziert

Der gemeldete Betrag wird immer mit der Bestellsumme abgeglichen, bevor die Bestellung aufgegeben wird

Einfache Kopplung

Ein Lesegerät über die Gateway-Einstellungen mit einem auf dem Gerät angezeigten Kopplungscode verbinden

Voraussetzungen

WCPOS: Pro-Version für den POS-Checkout erforderlich

WordPress: WordPress 5.2+ mit aktiviertem WooCommerce

PHP: PHP 7.4 oder höher

Zettle-Konto: Ein Zettle-Entwickler-Händlerkonto sowie eine Zettle Client-ID und Assertion (JWT) aus dem Zettle Developer Portal

Kompatible Hardware: Ein PayPal Reader (Zettle) Kartenterminal

Stabile Verbindung: Live-Zahlungen übertragen den Status über das Netzwerk an das Lesegerät und erfordern eine Internetverbindung

Unterstützte Hardware und Regionen

Die Verfügbarkeit von PayPal Reader / Zettle, unterstützte Lesegerätmodelle und unterstützte Länder werden durch Ihr Zettle-Händlerkonto bestimmt, nicht durch WCPOS. Vergewissern Sie sich vor dem Kauf bei PayPal/Zettle, dass Ihr Lesegerät und Ihre Region unterstützt werden.

Installation

1

PayPal Reader für WooCommerce installieren

Installieren Sie über WP Admin > POS > Einstellungen > Erweiterungen, oder laden Sie das neueste Plugin-ZIP-Asset (nicht das GitHub-Quellcode-ZIP oder -Tarball) von der GitHub-Releases-Seite herunter und laden Sie es über Plugins > Neu hinzufügen > Plugin hochladen hoch. WooCommerce muss installiert und aktiviert sein.

2

Zahlungsgateway konfigurieren

1. Navigieren Sie zu WP Admin > WooCommerce > Einstellungen > Zahlungen
2. Suchen Sie PayPal Reader in der Liste der Zahlungsmethoden und öffnen Sie die zugehörigen Einstellungen
3. Lassen Sie Testmodus aktivieren eingeschaltet, während Sie die Einrichtung überprüfen. Verwenden Sie im Testmodus die Zugangsdaten Ihres Zettle-Entwickler-Händlerkontos; deaktivieren Sie den Testmodus später, um Live-Zahlungen entgegenzunehmen
4. Geben Sie Ihre Zettle Client ID ein — Ihre Zettle-OAuth-Client-ID aus dem Zettle Developer Portal
5. Geben Sie Ihre Zettle Assertion ein — Ihre Zettle-OAuth-Assertion (JWT). Diese wird als Geheimnis behandelt
6. Optional können Titel und Beschreibung festgelegt werden, die den Kunden angezeigt werden
7. Speichern Sie die Einstellungen

Hinweis

Das Kontrollkästchen "PayPal Reader für Web-Checkout aktivieren" gilt nur für den Checkout Ihres Onlineshops — es ist nicht für das POS erforderlich. Das Zahlungsgateway für das POS wird in einem späteren Schritt aktiviert.

3

Kartenleser koppeln

1. Scrollen Sie nach dem Speichern zum Abschnitt Gekoppelte Kartenleser am Ende des Einstellungsbildschirms (dieser wird angezeigt, sobald Ihre Client ID und Assertion gespeichert sind)
2. Öffnen Sie auf dem PayPal-Reader-Gerät Einstellungen → Mit Entwickler verknüpfen, um den Kopplungscode anzuzeigen
3. Geben Sie unter Neuen Kartenleser koppeln den Kopplungscode und optional einen Kartenleser-Namen ein (z. B. "Hauptkasse")
4. Klicken Sie auf Kartenleser koppeln. Der Kartenleser erscheint in der Liste der gekoppelten Geräte und ist bereit, Zahlungen entgegenzunehmen

Wichtig

Ein Lesegerät muss erfolgreich gekoppelt sein, bevor Zahlungen entgegengenommen werden können. Verwenden Sie Entkoppeln in der Liste der gekoppelten Geräte, um ein Lesegerät zu entfernen.

4

In WCPOS aktivieren

1. Navigieren Sie zu WP Admin > POS > Einstellungen > Checkout
2. Suchen Sie das PayPal Reader-Zahlungsgateway in der Liste
3. Aktivieren Sie es zur Verwendung im POS
4. Speichern Sie Ihre Einstellungen

Zahlung durchführen

1. Artikel hinzufügen zum Warenkorb im POS und zur Kasse gehen
2. PayPal Reader auswählen als Zahlungsmethode
3. Ein gekoppeltes Lesegerät auswählen und die Zahlung starten. (Falls keines gekoppelt ist, werden Sie aufgefordert, den Filialadministrator zu bitten, eines unter WooCommerce → Settings → Payments → PayPal Reader zu koppeln.)
4. Das POS zeigt den Live-Status während der Verbindung an: "Verbindung zum Lesegerät wird hergestellt…", "Lesegerät bereit. Zahlung wird angefordert…", "Zahlung wird durchgeführt…"
5. Der Kunde tippt seine Karte an das Lesegerät oder steckt sie ein
6. Bei Erfolg wird der Betrag mit der Bestellsumme abgeglichen, die Transaktionsreferenz gespeichert und die Bestellung automatisch aufgegeben
7. Verwenden Sie Zahlung abbrechen, um die Anfrage am Lesegerät jederzeit abzubrechen

Livebetrieb starten

Wenn Sie alles im Testmodus überprüft haben:

1. Deaktivieren Sie Testmodus aktivieren
2. Ersetzen Sie Ihre Zettle-Testanmeldedaten durch Ihre Produktions-Client-ID und Assertion
3. Speichern – die Endpunkte und der Ablauf sind identisch; nur das Händlerkonto unterscheidet sich

Voraussetzungen und Einschränkungen

• Die Bestellung wird erst nach einem bestätigten Ergebnis des Lesegeräts abgeschlossen. WCPOS gibt die Bestellung nur auf, wenn die Zahlung als abgeschlossen gemeldet wird.
• Schutz bei Betragsabweichung. Wenn der vom Lesegerät gemeldete Betrag nicht mit der Bestellsumme übereinstimmt, wird die Zahlung abgelehnt – vermeiden Sie daher Änderungen an der Warenkorbsumme während der Zahlung.
• Konnektivität. Live-Zahlungen erfordern, dass der Browser eine Sitzung zur Reader Connect API von Zettle aufrechterhält; eine stabile Internetverbindung ist erforderlich.

Fehlerbehebung

Der Abschnitt „Gekoppelte Lesegeräte" wird nicht angezeigt

Speichern Sie zuerst Ihre Zettle Client ID und Assertion. Das Kopplungsfeld wird erst angezeigt, wenn beide Anmeldedaten gespeichert sind. Andernfalls wird die Meldung „Speichern Sie oben Ihre Zettle Client ID und Assertion, bevor Sie einen Reader koppeln." angezeigt.

Lesegerät lässt sich nicht koppeln

• Stellen Sie auf dem Lesegerät sicher, dass Sie Einstellungen → Mit einem Entwickler verknüpfen geöffnet haben, um einen neuen Kopplungscode zu erhalten
• Geben Sie den Code genau wie angezeigt ein, bevor er abläuft
• Bestätigen Sie, dass Ihre Zettle Client-ID und Assertion korrekt sind und gespeichert wurden
• Stellen Sie sicher, dass das Lesegerät und Ihr Netzwerk über eine stabile Internetverbindung verfügen

Zahlung wird mit einer Betragsabweichung abgelehnt

Das Plugin gleicht den vom Lesegerät gemeldeten Betrag mit der Bestellsumme ab und lehnt jede Abweichung ab. Der Warenkorb oder die Bestellsumme sollte nicht geändert werden, während eine Zahlung läuft — stattdessen die Zahlung abbrechen, den Warenkorb anpassen und dann eine neue Zahlung starten.

Es werden keine echten Zahlungen verarbeitet / eine Admin-Warnung über einen ‚Mock Reader' erscheint

Eine Entwicklungs-/CI-Konstante (PRWC_USE_MOCK_READER) wird in wp-config.php definiert. Diese Konstante muss vor der Annahme von Live-Zahlungen entfernt werden — solange sie gesetzt ist, werden keine echten Zahlungen verarbeitet.

Hilfe erhalten

• Gateway-Probleme können im GitHub-Repository gemeldet werden.
• Bei Fragen zu Konto, Kartenleser-Hardware und regionaler Verfügbarkeit wenden Sie sich an den PayPal-/Zettle-Support.