Gateway PayPal Reader (Zettle)

Il gateway PayPal Reader consente di accettare pagamenti con carta di persona usando un terminale per carte PayPal Reader (Zettle) direttamente da WCPOS. Il browser trasmette lo stato del pagamento in tempo reale dal lettore tramite una connessione sicura alla Reader Connect API di Zettle, così il cassiere vede ogni fase del pagamento mentre avviene.

Funzionalità

Pagamenti con carta di persona

Accetta pagamenti con chip, contactless e portafogli mobili su un terminale PayPal Reader (Zettle)

Stato del pagamento in tempo reale

Il POS mostra l'avanzamento in tempo reale: connessione, pagamento in corso, completato o annullato

Importo verificato lato server

L'importo segnalato viene sempre confrontato con il totale dell'ordine prima che l'ordine venga effettuato

Associazione semplice

Collega un lettore dalle impostazioni del gateway utilizzando un codice di associazione mostrato sul dispositivo

Requisiti

WCPOS: Versione Pro richiesta per il pagamento POS

WordPress: WordPress 5.2+ con WooCommerce attivo

PHP: PHP 7.4 o superiore

Account Zettle: Un account commerciante sviluppatore Zettle, oltre a un Client ID Zettle e un'Assertion (JWT) dal portale Zettle Developer

Hardware compatibile: Un terminale per carte PayPal Reader (Zettle)

Connessione stabile: I pagamenti reali trasmettono lo stato al lettore tramite la rete e richiedono una connessione Internet

Hardware e regioni supportati

La disponibilità di PayPal Reader / Zettle, i modelli di lettore supportati e i paesi supportati sono determinati dal tuo account commerciante Zettle, non da WCPOS. Verifica con PayPal/Zettle che il lettore e la regione siano supportati prima dell'acquisto.

Installazione

1

Installare PayPal Reader for WooCommerce

Installa da WP Admin > POS > Impostazioni > Estensioni, oppure scarica l'ultimo asset zip del plugin (non il file zip o tarball del codice sorgente GitHub) dalla pagina delle release GitHub e caricalo tramite Plugin > Aggiungi Nuovo > Carica plugin. WooCommerce deve essere installato e attivo.

2

Configurare il gateway

1. Vai a WP Admin > WooCommerce > Impostazioni > Pagamenti
2. Trova PayPal Reader nell'elenco dei metodi di pagamento e apri le relative impostazioni
3. Lascia attiva l'opzione Abilita modalità di test mentre verifichi la configurazione. In modalità di test usa le credenziali del tuo account commerciante sviluppatore Zettle; disattivala in seguito per accettare pagamenti reali
4. Inserisci il tuo ID client Zettle — l'ID client OAuth di Zettle dal Portale per sviluppatori Zettle
5. Inserisci la tua Asserzione Zettle — la tua asserzione OAuth Zettle (JWT). Viene trattata come un segreto
6. Facoltativamente, imposta il Titolo e la Descrizione mostrati ai clienti
7. Salva le impostazioni

nota

La casella "Abilita PayPal Reader per il checkout web" riguarda solo il checkout del tuo negozio online — non è necessaria per il POS. Abiliterai il gateway per il POS in un passaggio successivo.

3

Associa il lettore

1. Dopo il salvataggio, scorri fino alla sezione Lettori associati in fondo alla schermata delle impostazioni (viene visualizzata dopo aver salvato l'ID client e l'asserzione)
2. Sul dispositivo PayPal Reader, apri Impostazioni → Collega a uno sviluppatore per visualizzare il codice di associazione
3. In Associa un nuovo lettore, inserisci il Codice di associazione e, facoltativamente, un Nome lettore (ad es. "Banco anteriore")
4. Fai clic su Associa lettore. Il lettore appare nell'elenco degli associati ed è pronto per accettare pagamenti

Importante

Un lettore deve essere abbinato correttamente prima di poter accettare pagamenti. Usa Disabbina nell'elenco dei lettori abbinati per rimuovere un lettore.

4

Abilita in WCPOS

1. Vai a WP Admin > POS > Impostazioni > Pagamento
2. Trova il metodo di pagamento PayPal Reader nell'elenco
3. Abilitalo per l'uso nel POS
4. Salva le impostazioni

Accettare un pagamento

1. Aggiungi articoli al carrello nel POS e procedi alla cassa
2. Seleziona PayPal Reader come metodo di pagamento
3. Scegli un lettore abbinato e avvia il pagamento. (Se non ne è abbinato nessuno, verrà richiesto di chiedere all'amministratore del negozio di abbinarne uno in WooCommerce → Settings → Payments → PayPal Reader.)
4. Il POS mostra lo stato in tempo reale durante la connessione: "Connessione al lettore…", "Lettore pronto. Richiesta del pagamento…", "Pagamento in corso…"
5. Il cliente avvicina o inserisce la carta nel lettore
6. In caso di esito positivo, l'importo viene verificato rispetto al totale dell'ordine, il riferimento della transazione viene registrato e l'ordine viene effettuato automaticamente
7. Usa Annulla pagamento in qualsiasi momento per annullare la richiesta sul lettore

Passaggio alla produzione

Dopo aver verificato tutto in modalità di test:

1. Disattiva Abilita modalità di test
2. Sostituisci le credenziali di test Zettle con il Client ID e l'Assertion di produzione
3. Salva — gli endpoint e il flusso sono identici; cambia solo l'account commerciante

Riepilogo dei requisiti e limitazioni

• L'ordine viene completato solo dopo un risultato confermato dal lettore. WCPOS non effettuerà l'ordine a meno che il pagamento non risulti completato.
• Protezione contro la mancata corrispondenza dell'importo. Se l'importo segnalato dal lettore non corrisponde al totale dell'ordine, il pagamento viene rifiutato — evita quindi di modificare il totale del carrello durante il pagamento.
• Connettività. I pagamenti live dipendono dal mantenimento, da parte del browser, di una sessione con l'API Reader Connect di Zettle; è necessaria una connessione Internet stabile.

Risoluzione dei problemi

La sezione Lettori associati non viene visualizzata

Salva prima il tuo ID client Zettle e Assertion. Il pannello di associazione appare solo dopo aver salvato entrambe le credenziali. In caso contrario vedrai "Salva il tuo ID client Zettle e Assertion qui sopra prima di associare un lettore."

Il lettore non si associa

• Sul lettore, assicurati di aver aperto Impostazioni → Collega a uno sviluppatore per ottenere un nuovo codice di associazione
• Inserisci il codice esattamente come mostrato, prima che scada
• Verifica che l'ID client Zettle e Assertion siano corretti e salvati
• Assicurati che il lettore e la rete dispongano di una connessione Internet stabile

Il pagamento viene rifiutato per una mancata corrispondenza dell'importo

Il plugin verifica l'importo comunicato dal lettore rispetto al totale dell'ordine e rifiuta qualsiasi mancata corrispondenza. Non modificare il carrello o il totale dell'ordine mentre è in corso un pagamento — annulla il pagamento, modifica il carrello, quindi avvia un nuovo pagamento.

Non vengono elaborati pagamenti reali / viene visualizzato un avviso di amministrazione su un 'lettore simulato'

Una costante di sviluppo/CI (PRWC_USE_MOCK_READER) è definita in wp-config.php. Rimuovere quella costante prima di accettare pagamenti reali — mentre è impostata, non viene elaborato alcun pagamento reale.

Ottenere aiuto

• Segnalare i problemi del gateway nel repository GitHub
• Contattare il supporto PayPal/Zettle per domande su account, hardware del lettore e disponibilità regionale