PayPal Lezer (Zettle) Gateway
Met de PayPal Reader-gateway kunt u persoonlijke kaartbetalingen accepteren met behulp van een PayPal Reader (Zettle)-kaartterminal, rechtstreeks van WCPOS. De browser streamt de live betalingsstatus van de lezer via een beveiligde verbinding met Zettle's Reader Connect API, zodat de kassier elke stap van de betaling ziet terwijl deze plaatsvindt.
Kenmerken
Persoonlijke kaartbetalingen
Accepteer chip-, contactloze en mobiele portemonnee-betalingen op een PayPal Reader-terminal (Zettle)
Live betalingsstatus
De POS toont de voortgang in realtime: verbinding maken, betaling in uitvoering, voltooid of geannuleerd
Bedrag geverifieerd aan de serverzijde
Voordat de bestelling wordt geplaatst, wordt het gerapporteerde bedrag altijd getoetst aan het ordertotaal
Eenvoudig koppelen
Koppel een lezer vanuit de gateway-instellingen met behulp van een koppelingscode die op het apparaat wordt weergegeven
Vereisten
Beschikbaarheid van PayPal-lezer / Zettle, ondersteunde lezermodellen en ondersteunde landen worden bepaald door uw Zettle-verkopersaccount, niet door WCPOS. Controleer vóór aankoop of uw lezer en regio worden ondersteund met PayPal/Zettle.
Installatie
Installeer de PayPal-lezer voor WooCommerce
Installeer vanaf WP Admin > POS > Settings > Extensions, of download de nieuwste plugin zip asset (niet de GitHub broncode zip of tarball) van de GitHub releases pagina en upload deze via Plugins > Add New > Upload Plugin. WooCommerce moet geïnstalleerd en actief zijn.
Configureer de gateway
- Navigeer naar
WP Admin > WooCommerce > Settings > Payments - Zoek PayPal Reader in de lijst met betaalmethoden en open de instellingen ervan
- Laat Testmodus inschakelen ingeschakeld terwijl u de instellingen verifieert. Gebruik de inloggegevens van uw Zettle-ontwikkelaarsaccount in de testmodus; schakel het later uit om live betalingen te accepteren
- Voer uw Zettle Client ID in: uw Zettle OAuth client ID uit de Zettle Developer Portal
- Voer uw Zettle-verklaring in: uw Zettle OAuth-verklaring (JWT). Dit wordt als geheim behandeld
- Stel optioneel de Titel en Beschrijving in die aan klanten worden getoond
- Sla de instellingen op
Het selectievakje 'PayPal-lezer inschakelen voor online afrekenen' is alleen bedoeld voor het afrekenen in uw online winkel. Het is niet vereist voor de POS. In een latere stap schakel je de gateway voor de POS in.
Koppel uw lezer
- Blader na het opslaan naar de sectie Gekoppelde lezers onderaan het instellingenscherm (deze verschijnt zodra uw klant-ID en bewering zijn opgeslagen)
- Open op het PayPal Reader-apparaat Instellingen → Koppelen met een ontwikkelaar om de koppelingscode weer te geven
- Voer onder Een nieuwe lezer koppelen de Koppelingscode in en optioneel een Lezersnaam (bijvoorbeeld 'Voorteller')
- Klik op Lezer koppelen. De lezer verschijnt in de gekoppelde lijst en is klaar om betalingen te accepteren
Een lezer moet succesvol zijn gekoppeld voordat u betalingen kunt ontvangen. Gebruik Ontkoppelen in de gekoppelde lijst om een lezer te verwijderen.
Schakel in WCPOS in
- Ga naar
WP Admin > POS > Settings > Checkout - Zoek de PayPal Reader-gateway in de lijst
- Schakel het in voor gebruik in de POS
- Sla uw instellingen op
Een betaling aannemen
- Voeg artikelen toe aan de winkelwagen in de POS en ga door naar afrekenen
- Selecteer PayPal Reader als betaalmethode
- Kies een gekoppelde lezer en start de betaling. (Als er geen zijn gekoppeld, wordt u gevraagd de winkelbeheerder te vragen er een te koppelen in
WooCommerce → Settings → Payments → PayPal Reader.) - De POS toont de livestatus terwijl deze verbinding maakt: 'Verbinden met reader...', 'Reader gereed. Bezig met betalen...', 'Betaling wordt uitgevoerd...'
- De klant tikt of steekt zijn kaart op de lezer
- Bij succes wordt het bedrag vergeleken met het totaal van de bestelling, wordt de transactiereferentie geregistreerd en wordt de bestelling automatisch geplaatst
- Gebruik Betaling annuleren op elk gewenst moment om het verzoek op de reader te annuleren
Live gaan
Wanneer je alles in de testmodus hebt geverifieerd:
- Uitschakelen Testmodus inschakelen
- Vervang uw Zettle-testreferenties door uw productie-client-ID en bewering
- Opslaan – de eindpunten en stroom zijn identiek; alleen het verkopersaccount verschilt
Samenvatting van vereisten en beperkingen
- De bestelling is pas voltooid na een bevestigd lezerresultaat. WCPOS zal de bestelling pas plaatsen als de betaling als voltooid wordt gerapporteerd.
- Bescherming tegen niet-overeenkomend bedrag. Als het bedrag dat de lezer rapporteert niet overeenkomt met het totaal van de bestelling, wordt de betaling geweigerd. Vermijd dus het bewerken van het totaal van het winkelwagentje tijdens de betaling.
- Connectiviteit. Live betalingen zijn afhankelijk van de browser die een sessie onderhoudt met Zettle's Reader Connect API; een stabiele internetverbinding is vereist.
Problemen oplossen
Het gedeelte Gekoppelde lezers wordt niet weergegeven
Sla eerst uw Zettle klant-ID en Bewering op. Het koppelingspaneel verschijnt pas zodra beide inloggegevens zijn opgeslagen. Anders ziet u 'Sla uw Zettle-klant-ID en -bevestiging hierboven op voordat u een lezer koppelt.'
De lezer kan niet koppelen
- Zorg ervoor dat u op de reader Instellingen → Koppelen met een ontwikkelaar hebt geopend om een nieuwe koppelingscode te krijgen
- Voer de code precies in zoals weergegeven, voordat deze verloopt
- Bevestig dat uw Zettle klant-ID en bewering correct zijn en opgeslagen
- Zorg ervoor dat de lezer en uw netwerk een stabiele internetverbinding hebben
Betaling wordt geweigerd bij een bedrag dat niet overeenkomt
De plug-in verifieert het door de lezer gerapporteerde bedrag ten opzichte van het totaal van de bestelling en weigert elke discrepantie. Wijzig het winkelwagentje of het totaalbedrag van de bestelling niet terwijl een betaling wordt uitgevoerd. Annuleer de betaling, pas het winkelwagentje aan en start vervolgens een nieuwe betaling.
Er worden geen echte betalingen verwerkt / er verschijnt een beheerderswaarschuwing over een 'neplezer'
In wp-config.php is een ontwikkelings-/CI-constante (PRWC_USE_MOCK_READER) gedefinieerd. Verwijder die constante voordat u live betalingen accepteert. Zolang deze is ingesteld, worden er geen echte betalingen verwerkt.
Hulp krijgen
- Gatewayproblemen melden in de GitHub-opslagplaats
- Neem contact op met PayPal/Zettle-ondersteuning voor vragen over accounts, lezerhardware en regionale beschikbaarheid