PayPal Reader (Zettle)-betaalgateway
De kassa stuurt het besteltotaal naar een PayPal Reader. De klant houdt de kaart tegen de kaartlezer of steekt deze erin. De verkoop wordt automatisch afgerond zodra de kaartlezer meldt dat de betaling is voltooid. Deze pagina bestaat uit twee delen: een betaling ontvangen aan de kassa en de gateway instellen in WP Admin.
Voor de PayPal Reader-extensie heb je WCPOS Pro nodig, zowel om de extensie vanuit de extensiemap te installeren als om deze aan de kassa te gebruiken.
Een betaling ontvangen
- De kassa en je winkel zijn online. De betaling verloopt via de eigen betaalpagina van je winkel, binnen de POS.
- Iemand met toegang tot WP Admin heeft de gateway ingesteld en een kaartlezer gekoppeld.
- De kassa is geopend als je winkel Kassa openen en sluiten gebruikt. De kassa registreert geen betalingen zolang deze gesloten is. Zie Kassa's.
-
Vul de winkelwagen en druk op Afrekenen.
-
Open het tabblad Legacy. De betaalpagina van je winkel opent binnen de POS. Zie Het tabblad Legacy.
-
Kies PayPal Reader. Je winkel kan deze een andere naam hebben gegeven. Het paneel toont Kaartlezers laden…, gevolgd door Modus: test. Klaar om de betaling te starten. (of Modus: live. zodra de winkel is overgestapt op echte betalingen).
-
Kies de kaartlezer. Elke gekoppelde kaartlezer heeft een knop met de naam, zoals Voorste balie (gereed). De eerste is al geselecteerd. Tik op een andere om die te gebruiken.
waarschuwingTESTMODUS bovenaan het paneel is alleen een label. De kaartlezer kan nog steeds echt geld afschrijven. Zie Testmodus en overstappen op echte betalingen.
-
Druk op Betaling via kaartlezer starten. Het paneel toont Verbinding maken met kaartlezer…, gevolgd door Kaartlezer gereed. Betaling aanvragen…. Het volledige besteltotaal wordt naar die kaartlezer gestuurd.
-
De klant houdt de kaart tegen de kaartlezer of steekt deze erin. Tijdens de verwerking toont het paneel Betaling wordt verwerkt…, met de huidige stap van de kaartlezer tussen haakjes.
-
Zodra de kaartlezer meldt dat de betaling is voltooid, toont het paneel Betaling voltooid. Bestelling indienen… en gaat de POS verder naar de bon.
Je hoeft Betaling verwerken onderaan het tabblad Legacy niet te gebruiken: de verkoop wordt automatisch afgerond. Druk je erop voordat de kaartlezer klaar is, dan toont de POS Voltooi de PayPal Reader-betaling voordat je de bestelling plaatst.
Het donkere vak onder de knoppen houdt voor elke stap een regel met een tijdstip bij. Lees dit als een betaling halverwege stopt.
De kaartlezer verwerkt altijd het volledige bestelbedrag. Je kunt een verkoop dus niet verdelen over deze en een andere betaalmethode. Zodra er een betaling voor de bestelling is ontvangen, toont het tabblad Legacy de tekst Alleen volledige rekening en kun je het niet gebruiken. Annuleer die betaling eerst.
Een betaling stoppen
Druk tijdens de betaling op Betaling annuleren. Daarmee wordt de kaartlezer gevraagd te annuleren en stopt de kassa met het ontvangen van meldingen van de kaartlezer. Het paneel toont Betaling geannuleerd.
Na Betaling annuleren, of als de betaalpagina wordt gesloten of opnieuw geladen terwijl de kaartlezer bezig is, ontvangt de kassa geen meldingen meer van de kaartlezer. Als de kaartlezer de betaling toch als goedgekeurd toont, heeft de klant betaald: laat de klant niet opnieuw betalen. Registreer de betaling met de tegel Kaart op het tabblad Betalingen en controleer de betaling in je Zettle-account.
Zodra je zeker weet dat er bij de klant niets is afgeschreven, druk je op Betaling via kaartlezer starten om het opnieuw te proberen. Je kunt ook het tabblad sluiten en een andere betaalmethode gebruiken.
Na de verkoop
De bestelling wordt als betaald gemarkeerd. De transactie-ID is de ID van Zettle voor de kaartbetaling, zodat je dezelfde betaling in je Zettle-account kunt terugvinden. Bestelnotities leggen vast wanneer de betaling is gestart en op welke kaartlezer (via de koppelings-ID), en wanneer deze is voltooid, geweigerd vanwege een afwijkend bedrag of geannuleerd met Betaling annuleren.
Terugbetalingen
De extensie kan niet via Zettle terugbetalen, dus Terugbetalen naar PayPal Reader is niet beschikbaar.
Geef de klant geen contant geld. De terugbetaling op de kaart vindt plaats in Zettle. Contant terugbetalen registreert deze alleen in WCPOS. Als de kassa geopend is, verlaagt dit ook het verwachte contante bedrag in de kassalade met hetzelfde bedrag. Zie Contante terugbetalingen en de kassalade.
- Betaal het bedrag terug op de kaart via je Zettle-account.
- Registreer de terugbetaling bij de bestelling met Contant terugbetalen. Zie Bestemming van de terugbetaling.
Als er iets misgaat
Er zijn nog geen kaartlezers gekoppeld. Vraag de winkelbeheerder er een te koppelen… Er is geen kaartlezer gekoppeld aan het Zettle-account, dus Betaling via kaartlezer starten blijft grijs. Iemand met toegang tot WP Admin moet een kaartlezer koppelen: zie Een kaartlezer koppelen onder Instellen.
Het paneel blijft hangen op Verbinding maken met kaartlezer… De kaartlezer is niet klaar voor een betaling: deze staat mogelijk in de slaapstand, is uitgeschakeld, is offline of is ergens anders mee bezig. Haal de kaartlezer uit de slaapstand en controleer of het startscherm wordt weergegeven en de kaartlezer online is. Druk op Betaling annuleren, controleer of de kaartlezer geen ontvangen betaling toont zoals beschreven bij Een betaling stoppen en druk daarna opnieuw op Betaling via kaartlezer starten.
Betaling geannuleerd. De betaling is geannuleerd op de kaartlezer of met Betaling annuleren. Als je op Betaling annuleren hebt gedrukt, controleer dan eerst de kaartlezer zoals beschreven bij Een betaling stoppen. Start daarna opnieuw of gebruik een andere betaalmethode.
Betaling mislukt. Is er geld afgeschreven?
De tekst na Betaling mislukt. vertelt je of de klant heeft betaald en dus of je opnieuw mag laten betalen. Zoek de melding op en volg de bijbehorende instructies:
- Betaalbedrag komt niet overeen.: afgeschreven, eerst terugbetalen.
- Een reden tussen haakjes: niet afgeschreven, probeer het opnieuw.
- Verzoek mislukt., Ongeldig serverantwoord., Ongeldig verzoek. of Ongeldige toegang tot bestelling.: afgeschreven, registreer de betaling.
- Geen tekst erachter of een melding die hier niet staat: controleer voordat je het opnieuw probeert.
Betaalbedrag komt niet overeen: afgeschreven, eerst terugbetalen
Geld afgeschreven: ja. Het paneel toont Betaling mislukt. Betaalbedrag komt niet overeen. De kaartlezer heeft het geld afgeschreven, maar het besteltotaal is gewijzigd nadat de betaling is gestart. Daardoor wordt de bestelling geweigerd en blijft deze onbetaald. Betaal die betaling terug via je Zettle-account en start daarna een nieuwe betaling voor het juiste totaal. Voorkom dit door de winkelwagen niet te wijzigen terwijl een betaling via de kaartlezer loopt: druk op Betaling annuleren, wijzig de winkelwagen en start daarna een nieuwe betaling.
Een reden tussen haakjes: niet afgeschreven, probeer het opnieuw
Geld afgeschreven: nee. Het paneel toont Betaling mislukt. met een reden tussen haakjes. De kaartlezer of Zettle heeft de betaling niet ontvangen, bijvoorbeeld omdat de kaart is geweigerd. Druk op Betaling via kaartlezer starten of gebruik een andere betaalmethode.
Alleen Betaling mislukt. of een niet-vermelde melding: controleer voordat je het opnieuw probeert
Geld afgeschreven: onbekend. Het paneel toont alleen Betaling mislukt. De kassa heeft de verbinding met Zettle verloren en kan niet vaststellen of er geld is afgeschreven. Behandel een melding die niet op deze pagina staat op dezelfde manier. Controleer de kaartlezer en het betalingsoverzicht in je Zettle-account. Als de betaling daar staat, registreer deze dan zoals beschreven bij Een betaling stoppen. Begin pas opnieuw als je zeker weet dat er niets is afgeschreven. Kun je dat niet vaststellen, vraag het dan aan de beheerder van je Zettle-account voordat je opnieuw laat betalen.
Verzoek mislukt. of een andere hier vermelde melding: afgeschreven, registreer de betaling
Dit geldt alleen voor deze meldingen na Betaling mislukt.: Verzoek mislukt., Ongeldig serverantwoord., Ongeldig verzoek. en Ongeldige toegang tot bestelling. Volg bij elke andere melding de instructies bij Alleen Betaling mislukt..
Geld afgeschreven: ja. Het paneel toont deze meldingen alleen nadat de kaartlezer heeft gemeld dat de betaling is voltooid: de kaartlezer heeft de betaling ontvangen, maar de winkel kon deze niet registreren. Daardoor blijft de bestelling onbetaald. Zoek de betaling op in je Zettle-account en registreer deze zoals beschreven bij Een betaling stoppen. Staat de betaling niet in je Zettle-account, volg dan de instructies bij Alleen Betaling mislukt. en laat pas opnieuw betalen als je het zeker weet.
Andere meldingen
Zettle-inloggegevens zijn niet ingesteld. De Zettle-client-ID of Zettle-assertion is leeg. Vraag degene die de gateway heeft ingesteld om deze in te vullen: zie De gatewayinstellingen invullen onder Instellen.
Een melding die begint met Zettle OAuth-uitwisseling gaf HTTP … terug Zettle heeft de inloggegevens geweigerd. Vraag degene die de gateway heeft ingesteld om de Zettle-client-ID en Zettle-assertion te controleren.
Het paneel toont de knoppen, maar nooit Kaartlezers laden… De scripts van de betaalpagina worden niet geladen. Zie De betaalpagina van een gateway ziet er verkeerd uit.
Meldingen tijdens het instellen
Sla hierboven je Zettle-client-ID en assertion op voordat je een kaartlezer koppelt. Het onderdeel Gekoppelde kaartlezers wacht op beide inloggegevens. Vul ze in en sla ze op.
Voer eerst de koppelingscode in. Het veld Koppelingscode is leeg. Lees de code op de kaartlezer af en voer deze in.
Kan gekoppelde kaartlezers niet laden: gevolgd door het antwoord van Zettle. De instellingenpagina kon Zettle niet bereiken, of Zettle heeft de inloggegevens geweigerd. Controleer ze en sla ze opnieuw op.
Kaartlezer koppelen toont een melding die begint met Zettle API gaf HTTP … terug Zettle heeft de koppelingscode geweigerd. Open Instellingen → Koppelen met een ontwikkelaar op de kaartlezer voor een nieuwe code, neem deze exact over en controleer of de kaartlezer online is. Lukt het nog steeds niet, controleer dan of de Zettle-client-ID en Zettle-assertion zijn opgeslagen.
PayPal Reader: gesimuleerde kaartlezer is actief. Er is een ontwikkelaarsinstelling, PRWC_USE_MOCK_READER, gedefinieerd in wp-config.php. Zolang deze is ingesteld, worden er geen echte betalingen ontvangen. Vraag je ontwikkelaar of hostingprovider om deze te verwijderen.
Instellen
Dit deel is voor degene die WP Admin van de winkel beheert: vijf stappen, van het installeren van de extensie tot het inschakelen ervan voor de POS.
Installeren, inloggegevens invoeren, een kaartlezer koppelen en inschakelen voor de POS
De extensie installeren
Open WP Admin > POS > Settings > Extensions, zoek PayPal Reader for WooCommerce, klik op Installeren en daarna op Activeren. Zie Een extensie installeren.
Zonder de extensiemap download je het zipbestand van de plugin (niet het zipbestand met de broncode) van de GitHub-releasepagina. Upload het via Plugins > Add Plugin en daarna Plugin uploaden. WooCommerce moet actief zijn.
Je Zettle-inloggegevens ophalen
Vraag in de Zettle Developer Portal een Client-ID en een Assertion (een JWT) aan voor je Zettle-account. Gebruik eerst een Zettle-verkopersaccount voor ontwikkelaars (testaccount) om de gateway uit te proberen zonder echt geld af te schrijven.
Welke PayPal Reader-modellen en landen je kunt gebruiken, hangt af van je Zettle-account, niet van WCPOS. Vraag dit na bij PayPal voordat je een kaartlezer koopt.
De gatewayinstellingen invullen
- Ga naar
WP Admin > WooCommerce > Settings > Paymentsen open PayPal Reader. - Laat Testmodus inschakelen aangevinkt, zoals standaard het geval is, terwijl je de gateway met je testaccount uitprobeert.
- Voer de Zettle-client-ID en de Zettle-assertion in.
- Optioneel: wijzig de Titel die kassamedewerkers op de betaalpagina kiezen en de bijbehorende Beschrijving.
- Sla de instellingen op.
Een kaartlezer koppelen
- Scrol naar Gekoppelde kaartlezers onderaan dezelfde instellingenpagina. Dit onderdeel verschijnt zodra beide inloggegevens zijn opgeslagen.
- Open Instellingen → Koppelen met een ontwikkelaar op de PayPal Reader. De kaartlezer toont een koppelingscode.
- Voer onder Een nieuwe kaartlezer koppelen de Koppelingscode en een Naam van kaartlezer in, zoals
Front counter. Zonder naam krijgt de kaartlezer de naamWCPOS PayPal Reader. - Klik op Kaartlezer koppelen. De pagina toont Kaartlezer gekoppeld. en de kaartlezer wordt aan de lijst toegevoegd.
Elke kassa ziet alle kaartlezers die aan het Zettle-account zijn gekoppeld. De kassamedewerker kiest er een bij het afrekenen. Om een kaartlezer te verwijderen, klik je ernaast op Ontkoppelen en bevestig je dit.
Inschakelen voor de POS
Ga naar WP Admin > POS > Settings > Checkout, zoek PayPal Reader en zet Ingeschakeld aan. Zie Een gateway inschakelen.
Laat PayPal Reader inschakelen voor afrekenen in de webshop (niet nodig voor WCPOS) uitgevinkt. Hiermee wordt de gateway alleen in de webshop getoond. De POS gebruikt de gateway zodra deze hier is ingeschakeld.
Testmodus en overstappen op echte betalingen
Testmodus schakelt de kaartlezer niet over naar een sandbox. Zettle gebruikt dezelfde adressen voor testbetalingen en echte betalingen. Het account bij je inloggegevens bepaalt of er echt geld wordt overgemaakt. De testmodus verandert alleen labels op het betaalpaneel: de badge TESTMODUS en Modus: test. in de statusregel.
Om over te stappen op echte betalingen:
- Vervang de Zettle-client-ID en Zettle-assertion door die van je echte Zettle-account.
- Vink Testmodus inschakelen uit en sla de instellingen op.
- Controleer Gekoppelde kaartlezers. De lijst komt uit het Zettle-account, dus kaartlezers die aan het testaccount zijn gekoppeld staan er niet in. Koppel ze opnieuw zoals beschreven bij Een kaartlezer koppelen onder Instellen.
- Ontvang een kleine echte betaling en betaal deze terug via Zettle.
Overzicht van instellingen
Te vinden onder WP Admin > WooCommerce > Settings > Payments > PayPal Reader. De stappen hierboven behandelen de instellingen die je nodig hebt. Open de lijst om alle instellingen en hun standaardwaarden te bekijken.
Alle 6 instellingen en het koppelingspaneel
| Instelling | Functie |
|---|---|
| Inschakelen/Uitschakelen | PayPal Reader inschakelen voor afrekenen in de webshop (niet nodig voor WCPOS). Toont de gateway in de webshop. Laat dit uitgeschakeld: online werkt de gateway alleen op de betaalpagina van een bestaande bestelling. Standaard uitgeschakeld. De POS heeft een eigen schakelaar onder POS > Settings > Checkout |
| Titel | De naam die kassamedewerkers op de betaalpagina kiezen. Standaard PayPal Reader |
| Beschrijving | De tekst onder de titel. Standaard Pay in person using PayPal Reader. |
| Testmodus | Testmodus inschakelen. Toont de badge TESTMODUS op het betaalpaneel. Standaard ingeschakeld. Verandert niet waar betalingen naartoe gaan |
| Zettle-client-ID | Je Zettle OAuth-client-ID uit de Zettle Developer Portal |
| Zettle-assertion | Je Zettle OAuth-assertion (een JWT). Blijft verborgen, net als een wachtwoord |
In de sectie Gekoppelde kaartlezers onder de instellingen worden alle kaartlezers weergegeven met hun naam en Koppelings-ID, en de optie Ontkoppelen. Bij Een nieuwe kaartlezer koppelen voer je een Koppelingscode en een Naam van kaartlezer in.
Logs
Kijk eerst bij de bestelnotities: het starten en voltooien van een betaling, het weigeren vanwege een afwijkend bedrag en het indrukken van Betaling annuleren aan de kassa worden bij de bestelling vastgelegd. Een geweigerde kaartbetaling, annulering op de kaartlezer of verbroken verbinding wordt niet vastgelegd: lees daarvoor het logvak op de betaalpagina.
Als de kaartlezerservice van Zettle een verzoek weigert of niet bereikbaar is, legt de extensie dit ook vast onder WP Admin > WooCommerce > Status > Logs, met als bron paypal-reader-for-woocommerce. Stuur dat logbestand en het bestelnummer mee als je hulp vraagt.
Vereisten
Wat niet wordt ondersteund
- Terugbetalingen via Zettle vanuit WooCommerce of de POS.
- Fooien op de kaartlezer.
- Deelbetalingen: de kaartlezer verwerkt altijd het volledige bestelbedrag.
- Een betaling hervatten nadat de betaalpagina is gesloten of opnieuw geladen.
- Het normale afrekenscherm van de webshop. Online werkt de gateway alleen op de betaalpagina van een bestaande bestelling.
Hoe het werkt, voor ontwikkelaars
De winkel meldt zich bij Zettle aan met de JWT-bearer OAuth-grant (oauth.zettle.com) en bewaart het toegangstoken in de cache tot 30 seconden voordat het verloopt. Het koppelen, de lijst met kaartlezers en betaalsessies gebruiken de Reader Connect-API van Zettle (reader-connect.zettle.com/v1/integrator): bij het koppelen claimt de winkel met de code van de kaartlezer een koppelingsaanbod; elke kaartlezer is een koppeling.
Betaling via kaartlezer starten vraagt de winkel een sessie te openen voor de gekozen koppeling. De betaalpagina opent vervolgens een WebSocket naar Zettle, vraagt de status van de kaartlezer op en stuurt het betaalverzoek voor het besteltotaal, zonder fooi, zodra de kaartlezer gereed is. De voortgang wordt via dezelfde socket teruggestuurd. Betaling annuleren stuurt via die socket een annuleringsverzoek.
Als de kaartlezer COMPLETED meldt, stuurt de pagina het resultaat naar de winkel. Die accepteert het alleen als het bedrag overeenkomt met het besteltotaal. De winkel slaat de kaartbetalings-ID van Zettle op als transactie-ID en plaatst de bestelling. De bestelling kan pas worden geplaatst als deze controle is geslaagd.
Voor geautomatiseerde tests vervangt PRWC_USE_MOCK_READER (of het filter paypal_reader_for_woocommerce_use_mock_reader), samen met PRWC_MOCK_CANCEL_BEHAVIOR, Zettle door een gesimuleerde kaartlezer. Deze optie wordt nooit in de instellingen getoond. WP Admin geeft een waarschuwing zolang deze is ingeschakeld.
Gerelateerde documentatie
- Het tabblad Legacy
- Afrekenen
- Kassa-instellingen
- Extensies
- Meld een probleem op GitHub. Neem voor je Zettle-account, kaartlezers en landen contact op met PayPal.