PayPal Reader (Zettle)-Zahlungsgateway
Die Kasse sendet den Gesamtbetrag der Bestellung an einen PayPal Reader. Der Kunde hält seine Karte an das Lesegerät oder steckt sie ein. Sobald das Lesegerät die Zahlung als abgeschlossen meldet, wird der Verkauf automatisch abgeschlossen. Diese Seite besteht aus zwei Teilen: Zahlungen annehmen an der Kasse und Einrichtung in WP Admin.
Die PayPal Reader-Erweiterung benötigt WCPOS Pro, sowohl für die Installation über das Erweiterungsverzeichnis als auch für die Nutzung an der Kasse.
Eine Zahlung annehmen
- Die Kasse und Ihr Shop sind online. Die Zahlung erfolgt auf der eigenen Zahlungsseite Ihres Shops innerhalb des POS.
- Eine Person mit Zugriff auf WP Admin hat das Zahlungsgateway eingerichtet und ein Lesegerät gekoppelt.
- Die Kasse ist geöffnet, falls Ihre Filiale Kasse öffnen und schließen verwendet. Solange sie geschlossen ist, erfasst die Kasse keine Zahlungen. Siehe Kassen.
-
Stellen Sie den Warenkorb zusammen und drücken Sie Kasse.
-
Öffnen Sie den Tab Legacy. Die Zahlungsseite Ihres Shops öffnet sich innerhalb des POS. Siehe Der Legacy-Tab.
-
Wählen Sie PayPal Reader. Ihr Shop verwendet möglicherweise einen anderen Namen dafür. Im Zahlungsbereich steht zunächst Lesegeräte werden geladen…, dann Modus: Test. Bereit zum Starten der Zahlung. (oder Modus: Live., sobald der Shop in den Livebetrieb gewechselt ist).
-
Wählen Sie das Lesegerät. Für jedes gekoppelte Lesegerät gibt es eine Schaltfläche mit seinem Namen, zum Beispiel Vordere Theke (bereit). Das erste ist bereits ausgewählt. Tippen Sie auf ein anderes, um stattdessen dieses zu verwenden.
WarnungTESTMODUS oben im Zahlungsbereich ist lediglich eine Kennzeichnung. Das Lesegerät kann trotzdem echtes Geld abbuchen. Siehe Testmodus und Wechsel in den Livebetrieb.
-
Drücken Sie Zahlung am Lesegerät starten. Im Zahlungsbereich steht zunächst Verbindung zum Lesegerät wird hergestellt…, dann Lesegerät bereit. Zahlung wird angefordert…. Der gesamte Bestellbetrag wird an dieses Lesegerät gesendet.
-
Der Kunde hält seine Karte an das Lesegerät oder steckt sie ein. Während das Lesegerät arbeitet, zeigt der Zahlungsbereich Zahlung läuft… an, gefolgt vom aktuellen Schritt des Lesegeräts in Klammern.
-
Sobald das Lesegerät die Zahlung als abgeschlossen meldet, steht im Zahlungsbereich Zahlung abgeschlossen. Bestellung wird übermittelt… und der POS wechselt zum Beleg.
Sie müssen Zahlung verarbeiten am unteren Ende des Legacy-Tabs nicht drücken: Der Verkauf wird automatisch abgeschlossen. Wenn Sie die Schaltfläche drücken, bevor das Lesegerät fertig ist, zeigt der POS Schließen Sie die PayPal Reader-Zahlung ab, bevor Sie die Bestellung aufgeben. an.
Das dunkle Feld unter den Schaltflächen protokolliert jeden Schritt in einer Zeile mit Zeitstempel. Lesen Sie es, wenn eine Zahlung unterbrochen wird.
Über das Lesegerät wird immer die gesamte Bestellung bezahlt. Daher lässt sich der Verkauf nicht auf mehrere Zahlungsarten aufteilen. Sobald eine Zahlung für die Bestellung angenommen wurde, zeigt der Tab Legacy den Hinweis Nur Gesamtbetrag an und kann nicht verwendet werden. Stornieren Sie zuerst diese Zahlung.
Eine Zahlung abbrechen
Drücken Sie während der laufenden Zahlung Zahlung abbrechen. Dadurch wird das Lesegerät zum Abbruch aufgefordert und die Kasse empfängt keine weiteren Meldungen davon. Im Zahlungsbereich steht Zahlung abgebrochen.
Nach Zahlung abbrechen oder wenn die Zahlungsseite geschlossen oder neu geladen wird, während das Lesegerät arbeitet, empfängt die Kasse keine Meldungen mehr vom Lesegerät. Zeigt das Lesegerät die Zahlung dennoch als genehmigt an, hat der Kunde bezahlt: Buchen Sie nicht erneut ab. Erfassen Sie die Zahlung mit der Kachel Karte auf dem Tab Zahlungen und prüfen Sie die Zahlung in Ihrem Zettle-Konto.
Erst wenn Sie sicher sind, dass dem Kunden nichts abgebucht wurde, drücken Sie Zahlung am Lesegerät starten, um es erneut zu versuchen. Alternativ schließen Sie den Tab und verwenden eine andere Zahlungsart.
Nach dem Verkauf
Die Bestellung wird als bezahlt markiert. Ihre Transaktions-ID ist die Zettle-ID der Kartenzahlung, sodass Sie dieselbe Zahlung in Ihrem Zettle-Konto finden können. Die Bestellnotizen halten fest, wann die Zahlung gestartet wurde und auf welchem Lesegerät (anhand seiner Verknüpfungs-ID). Außerdem vermerken sie, wann die Zahlung abgeschlossen, wegen eines abweichenden Betrags abgelehnt oder mit Zahlung abbrechen abgebrochen wurde.
Rückerstattungen
Die Erweiterung kann keine Rückerstattungen über Zettle ausführen. Deshalb ist Rückerstattung an PayPal Reader nicht verfügbar.
Händigen Sie dem Kunden kein Bargeld aus. Die Rückerstattung auf die Karte erfolgt in Zettle. Rückerstattung in bar erfasst sie lediglich in WCPOS. Ist die Kasse geöffnet, wird dadurch auch der erwartete Bargeldbestand in der Kassenlade um denselben Betrag reduziert. Siehe Bargeldrückerstattungen und die Kassenlade.
- Erstatten Sie die Kartenzahlung in Ihrem Zettle-Konto zurück.
- Erfassen Sie die Rückerstattung in der Bestellung mit Rückerstattung in bar. Siehe Rückerstattungsziel.
Wenn etwas schiefgeht
Noch keine Lesegeräte gekoppelt. Bitten Sie den Filialadministrator, eines zu koppeln… Mit dem Zettle-Konto ist kein Lesegerät gekoppelt, daher bleibt Zahlung am Lesegerät starten ausgegraut. Eine Person mit Zugriff auf WP Admin muss eines koppeln: siehe Ein Lesegerät koppeln unter Einrichtung.
Der Zahlungsbereich bleibt mit der Meldung Verbindung zum Lesegerät wird hergestellt… stehen. Das Lesegerät ist nicht zahlungsbereit: Es befindet sich möglicherweise im Ruhemodus, ist ausgeschaltet, offline oder anderweitig beschäftigt. Aktivieren Sie es und prüfen Sie, ob es den Startbildschirm anzeigt und online ist. Drücken Sie Zahlung abbrechen und vergewissern Sie sich am Lesegerät, dass keine Zahlung angenommen wurde, wie unter Eine Zahlung abbrechen beschrieben. Drücken Sie anschließend erneut Zahlung am Lesegerät starten.
Zahlung abgebrochen. Die Zahlung wurde am Lesegerät oder mit Zahlung abbrechen abgebrochen. Falls Sie Zahlung abbrechen gedrückt haben, prüfen Sie zuerst das Lesegerät, wie unter Eine Zahlung abbrechen beschrieben. Starten Sie die Zahlung dann erneut oder verwenden Sie eine andere Zahlungsart.
Zahlung fehlgeschlagen. Wurde die Karte belastet?
Der Text nach Zahlung fehlgeschlagen. gibt an, ob der Kunde bezahlt hat und ob Sie erneut abbuchen dürfen. Suchen Sie die angezeigte Meldung und folgen Sie der jeweiligen Anleitung:
- Zahlungsbetrag stimmt nicht überein.: Karte belastet, zuerst zurückerstatten.
- Ein Grund in Klammern: Karte nicht belastet, erneut versuchen.
- Anfrage fehlgeschlagen., Ungültige Serverantwort., Ungültige Anfrage. oder Ungültiger Bestellzugriff.: Karte belastet, Zahlung erfassen.
- Kein weiterer Text oder eine hier nicht aufgeführte Meldung: vor einem erneuten Versuch prüfen.
Zahlungsbetrag stimmt nicht überein: Karte belastet, zuerst zurückerstatten
Karte belastet: ja. Im Zahlungsbereich steht Zahlung fehlgeschlagen. Zahlungsbetrag stimmt nicht überein. Das Lesegerät hat das Geld abgebucht, aber der Gesamtbetrag der Bestellung hat sich nach Beginn der Zahlung geändert. Deshalb wird die Bestellung abgelehnt und bleibt unbezahlt. Erstatten Sie diese Zahlung in Ihrem Zettle-Konto zurück und starten Sie dann eine neue Zahlung über den richtigen Gesamtbetrag. Um dies zu vermeiden, ändern Sie den Warenkorb nicht während einer laufenden Zahlung am Lesegerät: Drücken Sie Zahlung abbrechen, ändern Sie den Warenkorb und starten Sie dann eine neue Zahlung.
Ein Grund in Klammern: Karte nicht belastet, erneut versuchen
Karte belastet: nein. Im Zahlungsbereich steht Zahlung fehlgeschlagen., gefolgt von einem Grund in Klammern. Das Lesegerät oder Zettle hat die Zahlung nicht angenommen, beispielsweise weil die Karte abgelehnt wurde. Drücken Sie Zahlung am Lesegerät starten oder verwenden Sie eine andere Zahlungsart.
Nur Zahlung fehlgeschlagen. oder eine nicht aufgeführte Meldung: vor einem erneuten Versuch prüfen
Karte belastet: unklar. Im Zahlungsbereich steht nur Zahlung fehlgeschlagen. Die Kasse hat die Verbindung zu Zettle verloren und kann nicht feststellen, ob die Karte belastet wurde. Gehen Sie bei einer Meldung, die auf dieser Seite nicht aufgeführt ist, genauso vor. Prüfen Sie das Lesegerät und die Zahlungsliste in Ihrem Zettle-Konto. Ist die Zahlung dort vorhanden, erfassen Sie sie wie unter Eine Zahlung abbrechen beschrieben. Starten Sie erst dann erneut, wenn Sie sicher sind, dass keine Zahlung angenommen wurde. Wenn Sie das nicht feststellen können, fragen Sie die für Ihr Zettle-Konto zuständige Person, bevor Sie erneut abbuchen.
Anfrage fehlgeschlagen. oder eine andere hier aufgeführte Meldung: Karte belastet, Zahlung erfassen
Dieser Fall gilt nur für folgende Meldungen nach Zahlung fehlgeschlagen.: Anfrage fehlgeschlagen., Ungültige Serverantwort., Ungültige Anfrage. und Ungültiger Bestellzugriff. Bei allen anderen Meldungen folgen Sie stattdessen der Anleitung unter Nur Zahlung fehlgeschlagen..
Karte belastet: ja. Der Zahlungsbereich zeigt diese Meldungen erst an, nachdem das Lesegerät die Zahlung als abgeschlossen gemeldet hat: Das Lesegerät hat die Zahlung angenommen, aber der Shop konnte sie nicht erfassen. Daher bleibt die Bestellung unbezahlt. Suchen Sie die Zahlung in Ihrem Zettle-Konto und erfassen Sie sie wie unter Eine Zahlung abbrechen beschrieben. Ist sie nicht in Ihrem Zettle-Konto vorhanden, folgen Sie der Anleitung unter Nur Zahlung fehlgeschlagen. und buchen Sie erst erneut ab, wenn Sie Gewissheit haben.
Weitere Meldungen
Zettle-Zugangsdaten sind nicht konfiguriert. Das Feld Zettle-Client-ID oder Zettle-Assertion ist leer. Bitten Sie die Person, die das Zahlungsgateway eingerichtet hat, die Daten einzutragen: siehe Gateway-Einstellungen ausfüllen unter Einrichtung.
Eine Meldung beginnt mit Zettle-OAuth-Austausch gab HTTP … zurück. Zettle hat die Zugangsdaten abgelehnt. Bitten Sie die Person, die das Zahlungsgateway eingerichtet hat, die Zettle-Client-ID und die Zettle-Assertion zu prüfen.
Der Zahlungsbereich zeigt seine Schaltflächen an, aber nie die Meldung Lesegeräte werden geladen… an. Die Skripte der Zahlungsseite werden nicht geladen. Siehe Die Zahlungsseite eines Zahlungsgateways wird falsch dargestellt.
Meldungen während der Einrichtung
Speichern Sie oben Ihre Zettle-Client-ID und Assertion, bevor Sie ein Lesegerät koppeln. Der Abschnitt Gekoppelte Lesegeräte wartet auf beide Zugangsdaten. Geben Sie diese ein und speichern Sie.
Geben Sie zuerst den Kopplungscode ein. Das Feld Kopplungscode ist leer. Lesen Sie den Code vom Lesegerät ab und geben Sie ihn ein.
Gekoppelte Lesegeräte konnten nicht geladen werden: gefolgt von der Antwort von Zettle. Die Einstellungsseite konnte Zettle nicht erreichen oder Zettle hat die Zugangsdaten abgelehnt. Prüfen Sie diese und speichern Sie erneut.
Beim Koppeln eines Lesegeräts erscheint eine Meldung, die mit Zettle-API gab HTTP … zurück beginnt. Zettle hat den Kopplungscode abgelehnt. Öffnen Sie am Lesegerät Einstellungen → Mit einem Entwickler verknüpfen, um einen neuen Code zu erhalten. Geben Sie ihn genau wie angezeigt ein und prüfen Sie, ob das Lesegerät online ist. Schlägt die Kopplung weiterhin fehl, prüfen Sie, ob die Zettle-Client-ID und die Zettle-Assertion gespeichert sind.
PayPal Reader: Simuliertes Lesegerät ist aktiv. In wp-config.php ist die Entwicklereinstellung PRWC_USE_MOCK_READER definiert. Solange sie gesetzt ist, werden keine echten Zahlungen angenommen. Bitten Sie Ihren Entwickler oder Hostinganbieter, sie zu entfernen.
Einrichtung
Dieser Teil richtet sich an die Person, die WP Admin für den Shop verwaltet: fünf Schritte von der Installation der Erweiterung bis zur Aktivierung für den POS.
Installieren, Zugangsdaten eingeben, ein Lesegerät koppeln und für den POS aktivieren
Die Erweiterung installieren
Öffnen Sie WP Admin > POS > Einstellungen > Erweiterungen, suchen Sie PayPal Reader for WooCommerce und klicken Sie auf Installieren, dann auf Aktivieren. Siehe Eine Erweiterung installieren.
Ohne das Verzeichnis laden Sie die Plugin-ZIP-Datei (nicht die Quellcode-ZIP-Datei) von der GitHub-Releaseseite herunter und laden sie über Plugins > Add Plugin und dann Plugin hochladen hoch. WooCommerce muss aktiv sein.
Ihre Zettle-Zugangsdaten abrufen
Rufen Sie im Zettle Developer Portal eine Client-ID und eine Assertion (ein JWT) für Ihr Zettle-Konto ab. Um das Zahlungsgateway ohne echte Abbuchungen auszuprobieren, verwenden Sie zunächst ein Zettle-Händlerkonto für Entwickler (Testkonto).
Welche PayPal Reader-Modelle und Länder Sie nutzen können, hängt von Ihrem Zettle-Konto ab, nicht von WCPOS. Erkundigen Sie sich vor dem Kauf eines Lesegeräts bei PayPal.
Gateway-Einstellungen ausfüllen
- Gehen Sie zu
WP Admin > WooCommerce > Einstellungen > Zahlungenund öffnen Sie PayPal Reader. - Lassen Sie Testmodus aktivieren aktiviert (dies ist die Standardeinstellung), während Sie das Zahlungsgateway mit Ihrem Testkonto ausprobieren.
- Geben Sie die Zettle-Client-ID und die Zettle-Assertion ein.
- Optional: Ändern Sie den Titel, den Kassierer auf der Zahlungsseite auswählen, und die zugehörige Beschreibung.
- Speichern Sie.
Ein Lesegerät koppeln
- Scrollen Sie zum Abschnitt Gekoppelte Lesegeräte am unteren Ende derselben Einstellungsseite. Er erscheint, sobald beide Zugangsdaten gespeichert sind.
- Öffnen Sie am PayPal Reader Einstellungen → Mit einem Entwickler verknüpfen. Das Lesegerät zeigt einen Kopplungscode an.
- Geben Sie unter Neues Lesegerät koppeln den Kopplungscode und einen Lesegerätenamen wie
Front counterein. Ohne Namensangabe heißt esWCPOS PayPal Reader. - Klicken Sie auf Lesegerät koppeln. Die Seite zeigt Lesegerät gekoppelt. an und das Lesegerät wird in die Liste aufgenommen.
Jede Kasse sieht alle mit dem Zettle-Konto gekoppelten Lesegeräte. Der Kassierer wählt beim Bezahlvorgang eines aus. Um ein Lesegerät zu entfernen, klicken Sie daneben auf Kopplung aufheben und bestätigen Sie.
Für den POS aktivieren
Gehen Sie zu WP Admin > POS > Einstellungen > Kasse, suchen Sie PayPal Reader und schalten Sie Aktiviert ein. Siehe Ein Zahlungsgateway aktivieren.
Lassen Sie PayPal Reader für den Web-Checkout aktivieren (für WCPOS nicht erforderlich) deaktiviert. Diese Option zeigt das Zahlungsgateway nur im Onlineshop an. Der POS verwendet es, sobald es hier aktiviert ist.
Testmodus und Wechsel in den Livebetrieb
Der Testmodus versetzt das Lesegerät nicht in eine Sandbox. Zettle verwendet dieselben Adressen für Testzahlungen und echte Zahlungen. Ob echtes Geld fließt, entscheidet das Konto, zu dem Ihre Zugangsdaten gehören. Der Testmodus ändert lediglich die Beschriftungen im Zahlungsbereich: die Kennzeichnung TESTMODUS und Modus: Test. in der Statuszeile.
So wechseln Sie in den Livebetrieb:
- Ersetzen Sie die Zettle-Client-ID und die Zettle-Assertion durch die Daten Ihres echten Zettle-Kontos.
- Entfernen Sie das Häkchen bei Testmodus aktivieren und speichern Sie.
- Prüfen Sie Gekoppelte Lesegeräte. Die Liste stammt aus dem Zettle-Konto. Daher sind Lesegeräte, die mit dem Testkonto gekoppelt sind, dort nicht vorhanden. Koppeln Sie sie erneut, wie unter Ein Lesegerät koppeln im Abschnitt Einrichtung beschrieben.
- Nehmen Sie eine echte Zahlung über einen kleinen Betrag an und erstatten Sie diese in Zettle zurück.
Einstellungsreferenz
Unter WP Admin > WooCommerce > Einstellungen > Zahlungen > PayPal Reader. Die obigen Schritte behandeln die benötigten Einstellungen. Öffnen Sie die Liste, um alle Einstellungen und ihre Standardwerte zu sehen.
Alle 6 Einstellungen und der Kopplungsbereich
| Einstellung | Funktion |
|---|---|
| Aktivieren/Deaktivieren | PayPal Reader für den Web-Checkout aktivieren (für WCPOS nicht erforderlich). Zeigt das Zahlungsgateway im Onlineshop an. Lassen Sie es deaktiviert: Online funktioniert es nur auf der Zahlungsseite einer bestehenden Bestellung. Standardmäßig deaktiviert. Der POS hat einen eigenen Schalter unter POS > Einstellungen > Kasse |
| Titel | Der Name, den Kassierer auf der Zahlungsseite auswählen. Standardwert: PayPal Reader |
| Beschreibung | Die Zeile unter dem Titel. Standardwert: Pay in person using PayPal Reader. |
| Testmodus | Testmodus aktivieren. Zeigt die Kennzeichnung TESTMODUS im Zahlungsbereich an. Standardmäßig aktiviert. Ändert nicht, wohin Zahlungen gehen |
| Zettle-Client-ID | Ihre Zettle-OAuth-Client-ID aus dem Zettle Developer Portal |
| Zettle-Assertion | Ihre Zettle-OAuth-Assertion (ein JWT). Wird wie ein Passwort verborgen |
Unterhalb der Einstellungen listet Gekoppelte Lesegeräte jedes Lesegerät mit Namen, Verknüpfungs-ID und Kopplung aufheben auf. Unter Neues Lesegerät koppeln geben Sie einen Kopplungscode und einen Lesegerätenamen ein.
Protokolle
Sehen Sie zuerst in den Bestellnotizen nach: Der Beginn einer Zahlung, ihr Abschluss oder ihre Ablehnung wegen eines abweichenden Betrags sowie das Drücken von Zahlung abbrechen an der Kasse werden in der Bestellung vermerkt. Eine abgelehnte Zahlung, ein Abbruch am Lesegerät oder ein Verbindungsabbruch werden dort nicht vermerkt. Lesen Sie dafür das Protokollfeld auf der Zahlungsseite.
Wenn der Lesegerätedienst von Zettle eine Anfrage ablehnt oder nicht erreichbar ist, protokolliert die Erweiterung dies zusätzlich unter WP Admin > WooCommerce > Status > Protokolle mit der Quelle paypal-reader-for-woocommerce. Senden Sie dieses Protokoll und die Bestellnummer mit, wenn Sie um Hilfe bitten.
Voraussetzungen
Nicht unterstützte Funktionen
- Rückerstattungen über Zettle aus WooCommerce oder dem POS heraus.
- Trinkgeld am Lesegerät.
- Teilzahlungen: Über das Lesegerät wird immer die gesamte Bestellung bezahlt.
- Fortsetzen einer Zahlung, nachdem die Zahlungsseite geschlossen oder neu geladen wurde.
- Der normale Bezahlvorgang des Onlineshops. Online funktioniert das Zahlungsgateway nur auf der Zahlungsseite einer bestehenden Bestellung.
Funktionsweise für Entwickler
Der Shop meldet sich über den JWT-Bearer-OAuth-Grant bei Zettle an (oauth.zettle.com) und speichert das Zugriffstoken bis 30 Sekunden vor dessen Ablauf im Cache. Für Kopplung, Lesegeräteliste und Zahlungssitzungen wird die Reader Connect-API von Zettle verwendet (reader-connect.zettle.com/v1/integrator): Beim Koppeln wird mit dem Code des Lesegeräts ein Verknüpfungsangebot angenommen. Jedes Lesegerät entspricht einer Verknüpfung.
Zahlung am Lesegerät starten fordert den Shop auf, eine Sitzung für die gewählte Verknüpfung zu öffnen. Die Zahlungsseite öffnet dann einen WebSocket zu Zettle, fragt den Status des Lesegeräts ab und sendet die Zahlungsanforderung über den Gesamtbetrag der Bestellung ohne Trinkgeld, sobald das Lesegerät bereit ist. Fortschrittsmeldungen kommen über denselben Socket zurück. Zahlung abbrechen sendet darüber eine Abbruchanforderung.
Wenn das Lesegerät COMPLETED meldet, sendet die Seite das Ergebnis an den Shop. Dieser akzeptiert es nur, wenn der Betrag mit dem Gesamtbetrag der Bestellung übereinstimmt. Er speichert die Kartenzahlungs-ID von Zettle als Transaktions-ID und gibt die Bestellung auf. Die Bestellung kann erst aufgegeben werden, wenn diese Prüfung erfolgreich war.
Für automatisierte Tests ersetzt PRWC_USE_MOCK_READER (oder der Filter paypal_reader_for_woocommerce_use_mock_reader) zusammen mit PRWC_MOCK_CANCEL_BEHAVIOR Zettle durch ein simuliertes Lesegerät. Diese Option erscheint nie in den Einstellungen. Solange sie aktiv ist, zeigt WP Admin eine Warnung an.
Weiterführende Dokumentation
- Der Legacy-Tab
- Kasse
- Checkout-Einstellungen
- Erweiterungen
- Ein Problem auf GitHub melden. Bei Fragen zu Ihrem Zettle-Konto, zu Lesegeräten und Ländern wenden Sie sich an PayPal.