Salta al contenuto principale
Versione: 2.x

Gateway di pagamento PayPal Reader (Zettle)

La cassa invia il totale dell'ordine a un PayPal Reader, il cliente avvicina o inserisce la carta nel lettore e la vendita si conclude automaticamente quando il lettore segnala che il pagamento è completato. Questa pagina è divisa in due parti: accettare un pagamento alla cassa e configurare il gateway di pagamento in WP Admin.

Funzionalità Pro

L'estensione PayPal Reader richiede WCPOS Pro, sia per installarla dalla directory delle estensioni sia per usarla alla cassa.

Accettare un pagamento​

Prima di iniziare
  1. Aggiungi i prodotti al carrello e premi Cassa.

  2. Apri la scheda Legacy. La pagina di pagamento del negozio si apre all'interno del POS. Vedi La scheda Legacy.

  3. Scegli PayPal Reader. Il negozio potrebbe avergli assegnato un altro nome. Il pannello mostra Caricamento lettori…, poi Modalità: test. Pronto per avviare il pagamento. (oppure Modalità: produzione. dopo il passaggio ai pagamenti reali).

  4. Scegli il lettore. Ogni lettore associato è rappresentato da un pulsante con il suo nome, ad esempio Banco principale (pronto), e il primo è già selezionato. Tocca un altro lettore per usarlo al suo posto.

    avviso

    MODALITÀ TEST nella parte superiore del pannello è solo un'etichetta. Il lettore può comunque addebitare denaro reale. Vedi Modalità test e passaggio ai pagamenti reali.

  5. Premi Avvia pagamento sul lettore. Il pannello mostra Connessione al lettore…, poi Lettore pronto. Richiesta di pagamento…, e l'intero totale dell'ordine viene inviato a quel lettore.

  6. Il cliente avvicina o inserisce la carta nel lettore. Durante l'operazione, il pannello mostra Pagamento in corso…, con la fase corrente del lettore tra parentesi.

  7. Quando il lettore segnala che il pagamento è completato, il pannello mostra Pagamento completato. Invio dell'ordine… e il POS passa alla ricevuta.

Non serve premere Elabora pagamento in fondo alla scheda Legacy: la vendita si conclude automaticamente. Se lo premi prima che il lettore abbia terminato, il POS mostra Completa il pagamento con PayPal Reader prima di inoltrare l'ordine.

Il riquadro scuro sotto i pulsanti conserva una riga con l'orario per ogni fase. Consultalo quando un pagamento si interrompe.

Al lettore viene sempre inviato l'intero importo dell'ordine, quindi non è possibile suddividere una vendita tra il lettore e un altro metodo. Una volta ricevuto un pagamento per l'ordine, la scheda Legacy mostra Solo conto intero e non può essere usata; prima annulla quel pagamento.

Interrompere un pagamento​

Premi Annulla pagamento mentre il pagamento è in corso. Viene inviata al lettore una richiesta di annullamento e la cassa smette di riceverne gli aggiornamenti; il pannello mostra Pagamento annullato.

Controlla il lettore prima di effettuare un nuovo addebito

Dopo aver premuto Annulla pagamento, o se la pagina di pagamento viene chiusa o ricaricata mentre il lettore è in funzione, la cassa non riceve più aggiornamenti dal lettore. Se il lettore mostra comunque il pagamento come approvato, il cliente ha pagato: non addebitargli di nuovo l'importo. Registra il pagamento con il riquadro Carta nella scheda Pagamenti e verificalo nel tuo account Zettle.

Quando hai la certezza che al cliente non sia stato addebitato nulla, premi Avvia pagamento sul lettore per riprovare, oppure chiudi la scheda e usa un altro metodo.

Dopo la vendita​

L'ordine viene contrassegnato come pagato e il suo ID transazione è l'ID assegnato da Zettle al pagamento con carta, così puoi ritrovare lo stesso pagamento nel tuo account Zettle. Le note dell'ordine registrano quando è iniziato il pagamento e su quale lettore (tramite il suo ID collegamento), e quando è stato completato, rifiutato per una mancata corrispondenza dell'importo o annullato con Annulla pagamento.

Rimborsi​

L'estensione non può effettuare rimborsi tramite Zettle, quindi Rimborso su PayPal Reader non è disponibile.

avviso

Non consegnare contanti al cliente. Il rimborso sulla carta viene effettuato in Zettle, mentre Rimborso in contanti lo registra soltanto in WCPOS. Se il registratore di cassa è aperto, questa operazione riduce dello stesso importo anche i contanti previsti nel cassetto. Vedi Rimborsi in contanti e cassetto.

  1. Effettua il rimborso sulla carta dal tuo account Zettle.
  2. Registra il rimborso sull'ordine con Rimborso in contanti. Vedi Destinazione del rimborso.

Se qualcosa va storto​

Nessun lettore ancora associato. Chiedi all'amministratore del negozio di associarne uno… All'account Zettle non è associato alcun lettore, quindi Avvia pagamento sul lettore rimane disattivato. Una persona con accesso a WP Admin deve associarne uno: vedi Associa un lettore in Configurazione.

Il pannello rimane su Connessione al lettore… Il lettore non è pronto per un pagamento: potrebbe essere in standby, spento, offline o impegnato in un'altra operazione. Riattivalo e verifica che mostri la schermata iniziale e sia online. Premi Annulla pagamento, controlla che il lettore non mostri alcun pagamento ricevuto, come indicato in Interrompere un pagamento, poi premi di nuovo Avvia pagamento sul lettore.

Pagamento annullato. Il pagamento è stato annullato sul lettore o con Annulla pagamento. Se hai premuto Annulla pagamento, controlla prima il lettore, come indicato in Interrompere un pagamento. Poi avvia di nuovo il pagamento oppure usa un altro metodo.

Pagamento fallito. L'importo è stato addebitato sulla carta?​

Il testo che segue Pagamento fallito. indica se il cliente ha pagato e quindi se puoi effettuare un nuovo addebito. Individua il messaggio, poi segui le istruzioni per il caso corrispondente:

L'importo del pagamento non corrisponde: addebito effettuato, prima effettua il rimborso​

Addebito sulla carta: sì. Il pannello mostra Pagamento fallito. L'importo del pagamento non corrisponde. Il lettore ha incassato il denaro, ma il totale dell'ordine è cambiato dopo l'avvio del pagamento, quindi l'ordine viene rifiutato e rimane non pagato. Rimborsa quel pagamento dal tuo account Zettle, poi avvia un nuovo pagamento per il totale corretto. Per evitarlo, non modificare il carrello mentre è in corso un pagamento sul lettore: premi Annulla pagamento, modifica il carrello, poi avvia un nuovo pagamento.

Un motivo tra parentesi: nessun addebito, riprova​

Addebito sulla carta: no. Il pannello mostra Pagamento fallito. con un motivo tra parentesi. Il lettore o Zettle non ha incassato il pagamento, ad esempio perché la carta è stata rifiutata. Premi Avvia pagamento sul lettore oppure usa un altro metodo.

Solo Pagamento fallito. o un messaggio non elencato: verifica prima di riprovare​

Addebito sulla carta: impossibile determinarlo. Il pannello mostra solo Pagamento fallito. La cassa ha perso la connessione a Zettle e non può stabilire se l'importo sia stato addebitato sulla carta. Procedi allo stesso modo per un messaggio non elencato in questa pagina. Controlla il lettore e l'elenco dei pagamenti nel tuo account Zettle. Se il pagamento è presente, registralo come indicato in Interrompere un pagamento. Ricomincia solo quando hai la certezza che il pagamento non sia stato incassato; se non riesci a determinarlo, chiedi a chi gestisce il tuo account Zettle prima di effettuare un nuovo addebito.

Richiesta fallita. o un altro messaggio elencato qui: addebito effettuato, registra il pagamento​

Questo caso riguarda soltanto i seguenti messaggi dopo Pagamento fallito.: Richiesta fallita., Risposta del server non valida., Richiesta non valida. e Accesso all'ordine non valido. Per qualsiasi altro messaggio, segui invece Solo Pagamento fallito..

Addebito sulla carta: sì. Il pannello mostra questi messaggi solo dopo che il lettore ha segnalato il completamento del pagamento: il lettore ha incassato il pagamento, ma il negozio non è riuscito a registrarlo, quindi l'ordine rimane non pagato. Trova il pagamento nel tuo account Zettle e registralo come indicato in Interrompere un pagamento. Se non è presente nel tuo account Zettle, segui Solo Pagamento fallito. e non effettuare un nuovo addebito finché non hai chiarito l'esito.

Altri messaggi​

Le credenziali Zettle non sono configurate. Il campo ID client Zettle o Asserzione Zettle è vuoto. Chiedi a chi ha configurato il gateway di pagamento di compilarli: vedi Compila le impostazioni del gateway di pagamento in Configurazione.

Un messaggio che inizia con Lo scambio OAuth di Zettle ha restituito HTTP … Zettle ha rifiutato le credenziali. Chiedi a chi ha configurato il gateway di pagamento di verificare ID client Zettle e Asserzione Zettle.

Il pannello mostra i pulsanti ma non compare mai Caricamento lettori… Gli script della pagina di pagamento non vengono caricati. Vedi La pagina di pagamento di un gateway di pagamento non viene visualizzata correttamente.

Messaggi durante la configurazione

Salva l'ID client e l'asserzione Zettle qui sopra prima di associare un lettore. La sezione Lettori associati attende entrambe le credenziali. Inseriscile e salva.

Inserisci prima il codice di associazione. Il campo Codice di associazione è vuoto. Leggi il codice sul lettore e inseriscilo.

Impossibile caricare i lettori associati: seguito dalla risposta di Zettle. La pagina delle impostazioni non è riuscita a contattare Zettle, oppure Zettle ha rifiutato le credenziali. Controllale e salva di nuovo.

Associa lettore mostra un messaggio che inizia con L'API Zettle ha restituito HTTP … Zettle ha rifiutato il codice di associazione. Sul lettore, apri Impostazioni → Collega a uno sviluppatore per ottenere un nuovo codice, inseriscilo esattamente come appare e verifica che il lettore sia online. Se l'operazione continua a non riuscire, verifica che ID client Zettle e Asserzione Zettle siano salvati.

PayPal Reader: il lettore simulato è attivo. Un'impostazione per sviluppatori, PRWC_USE_MOCK_READER, è definita in wp-config.php. Quando è impostata, non vengono incassati pagamenti reali. Chiedi al tuo sviluppatore o al fornitore di hosting di rimuoverla.

Configurazione​

Questa parte è rivolta a chi gestisce WP Admin del negozio: cinque passaggi, dall'installazione dell'estensione alla sua attivazione per il POS.

Installa, inserisci le credenziali, associa un lettore e abilitalo per il POS
1

Installa l'estensione

Apri WP Admin > POS > Impostazioni > Estensioni, trova PayPal Reader for WooCommerce, fai clic su Installa, poi su Attiva. Vedi Installare un'estensione.

Se non usi la directory, scarica lo zip del plugin (non lo zip del codice sorgente) dalla pagina delle release su GitHub e caricalo da Plugin > Add Plugin, poi Carica plugin. WooCommerce deve essere attivo.

2

Ottieni le credenziali Zettle

Nel portale per sviluppatori Zettle, ottieni un ID client e un'Asserzione (un JWT) per il tuo account Zettle. Per provare il gateway di pagamento senza incassare denaro reale, usa inizialmente un account esercente Zettle per sviluppatori (di test).

I modelli di PayPal Reader utilizzabili e i paesi supportati dipendono dal tuo account Zettle, non da WCPOS. Verifica con PayPal prima di acquistare un lettore.

3

Compila le impostazioni del gateway di pagamento

  1. Vai in WP Admin > WooCommerce > Impostazioni > Pagamenti e apri PayPal Reader.
  2. Lascia selezionata l'opzione Abilita modalità test, come previsto per impostazione predefinita, durante le prove con il tuo account di test.
  3. Inserisci ID client Zettle e Asserzione Zettle.
  4. Facoltativo: modifica il Titolo che i cassieri selezionano nella pagina di pagamento e la relativa Descrizione.
  5. Salva.
4

Associa un lettore

  1. Scorri fino a Lettori associati in fondo alla stessa pagina delle impostazioni. La sezione compare dopo il salvataggio di entrambe le credenziali.
  2. Sul PayPal Reader, apri Impostazioni → Collega a uno sviluppatore. Il lettore mostra un codice di associazione.
  3. In Associa un nuovo lettore, inserisci il Codice di associazione e un Nome lettore, ad esempio Front counter. Se non specifichi un nome, verrà chiamato WCPOS PayPal Reader.
  4. Fai clic su Associa lettore. La pagina mostra Lettore associato. e il lettore viene aggiunto all'elenco.

Ogni cassa vede tutti i lettori associati all'account Zettle e il cassiere ne sceglie uno al momento del pagamento. Per rimuoverne uno, fai clic su Dissocia accanto al lettore e conferma.

5

Abilitalo per il POS

Vai in WP Admin > POS > Impostazioni > Pagamento, trova PayPal Reader e attiva Abilitato. Vedi Abilitare un gateway di pagamento.

nota

Lascia deselezionata l'opzione Abilita PayPal Reader per il checkout web (non necessario per WCPOS). Serve solo a mostrare il gateway di pagamento nel negozio online; il POS lo usa una volta abilitato qui.

Modalità test e passaggio ai pagamenti reali​

La Modalità test non passa il lettore a un ambiente di prova. Zettle usa gli stessi indirizzi per i pagamenti di test e quelli reali ed è l'account associato alle credenziali a determinare se viene trasferito denaro reale. La modalità test cambia soltanto le etichette del pannello di pagamento: il contrassegno MODALITÀ TEST e Modalità: test. nella riga di stato.

Per passare ai pagamenti reali:

  1. Sostituisci ID client Zettle e Asserzione Zettle con quelli del tuo account Zettle reale.
  2. Deseleziona Abilita modalità test e salva.
  3. Controlla Lettori associati. L'elenco proviene dall'account Zettle, quindi i lettori associati all'account di test non sono presenti: associali di nuovo, come indicato in Associa un lettore in Configurazione.
  4. Incassa un piccolo pagamento reale e rimborsalo in Zettle.

Riferimento delle impostazioni​

In WP Admin > WooCommerce > Impostazioni > Pagamenti > PayPal Reader. I passaggi precedenti illustrano le impostazioni necessarie; apri l'elenco per consultarle tutte con i rispettivi valori predefiniti.

Tutte le 6 impostazioni e il pannello di associazione
ImpostazioneFunzione
Abilita/DisabilitaAbilita PayPal Reader per il checkout web (non necessario per WCPOS). Mostra il gateway di pagamento nel negozio online. Lascia l'opzione disattivata: online funziona solo sulla pagina di pagamento di un ordine esistente. Disattivata per impostazione predefinita. Il POS ha un interruttore dedicato in POS > Impostazioni > Pagamento
TitoloIl nome che i cassieri selezionano nella pagina di pagamento. Il valore predefinito è PayPal Reader
DescrizioneLa riga mostrata sotto il titolo. Il valore predefinito è Pay in person using PayPal Reader.
Modalità testAbilita modalità test. Mostra il contrassegno MODALITÀ TEST nel pannello di pagamento. Attivata per impostazione predefinita. Non cambia la destinazione dei pagamenti
ID client ZettleIl tuo ID client OAuth di Zettle, ottenuto dal portale per sviluppatori Zettle
Asserzione ZettleLa tua asserzione OAuth di Zettle (un JWT). Viene nascosta come una password

Lettori associati, sotto le impostazioni, elenca ogni lettore per nome e ID collegamento, con il pulsante Dissocia. Associa un nuovo lettore richiede un Codice di associazione e un Nome lettore.

Log​

Le note dell'ordine sono il primo posto da controllare: vi vengono annotati l'avvio di un pagamento, il suo completamento o il rifiuto per l'importo, e l'uso di Annulla pagamento alla cassa. Il rifiuto della carta, l'annullamento sul lettore o la perdita della connessione non vengono annotati: consulta il riquadro dei log nella pagina di pagamento.

Quando il servizio lettori di Zettle rifiuta una richiesta o non è raggiungibile, l'estensione registra l'evento anche in WP Admin > WooCommerce > Status > Log, sotto la sorgente paypal-reader-for-woocommerce. Invia quel log e il numero d'ordine quando chiedi assistenza.

Requisiti​

Account Zettle: Un account esercente PayPal Zettle, con un ID client e un'asserzione (JWT) ottenuti dal portale per sviluppatori Zettle
Lettore: Un PayPal Reader associato a quell'account. I modelli e i paesi supportati dipendono dal tuo account Zettle
Connessione: Solo online. La cassa comunica con il lettore tramite Zettle via internet, quindi la cassa, il lettore e il negozio devono tutti disporre di una connessione
WCPOS: WCPOS Pro
Server: WordPress 5.2 o successivo, WooCommerce e PHP 7.4 o successivo

Funzioni non supportate​

  • Rimborsi tramite Zettle da WooCommerce o dal POS.
  • Mance sul lettore.
  • Pagamenti parziali: al lettore viene sempre inviato l'intero importo dell'ordine.
  • Ripresa di un pagamento dopo la chiusura o il ricaricamento della pagina di pagamento.
  • Il normale checkout del negozio online. Online funziona solo sulla pagina di pagamento di un ordine esistente.
Come funziona, per gli sviluppatori

Il negozio accede a Zettle con il flusso OAuth JWT-bearer (oauth.zettle.com) e conserva il token di accesso nella cache fino a 30 secondi prima della scadenza. L'associazione, l'elenco dei lettori e le sessioni di pagamento usano l'API Reader Connect di Zettle (reader-connect.zettle.com/v1/integrator): l'associazione accetta un'offerta di collegamento tramite il codice del lettore e ogni lettore corrisponde a un collegamento.

Avvia pagamento sul lettore chiede al negozio di aprire una sessione per il collegamento scelto. La pagina di pagamento apre quindi un WebSocket verso Zettle, richiede lo stato del lettore e, quando il lettore è pronto, invia la richiesta di pagamento per il totale dell'ordine, senza mance. Gli aggiornamenti sull'avanzamento arrivano tramite lo stesso socket. Annulla pagamento invia una richiesta di annullamento su quel socket.

Quando il lettore segnala COMPLETED, la pagina invia il risultato al negozio, che lo accetta solo se l'importo corrisponde al totale dell'ordine. Il negozio salva l'ID del pagamento con carta di Zettle come ID transazione e inoltra l'ordine. L'ordine non può essere inoltrato finché questo controllo non viene superato.

Per i test automatizzati, PRWC_USE_MOCK_READER (o il filtro paypal_reader_for_woocommerce_use_mock_reader), insieme a PRWC_MOCK_CANCEL_BEHAVIOR, sostituisce Zettle con un lettore simulato. Questa opzione non compare mai nelle impostazioni e WP Admin mostra un avviso quando è attiva.