Salta al contenuto principale
Versione: 2.x

Gateway di pagamento Square Terminal

La cassa invia l'importo a uno Square Terminal, il cliente paga sul terminale e la vendita prosegue automaticamente quando Square approva il pagamento. Questa pagina è divisa in due parti: accettare un pagamento alla cassa e configurare l'estensione in WP Admin.

Funzionalità Pro

Square Terminal richiede WCPOS Pro 2.0 o versioni successive.

Accettare un pagamento​

Prima di iniziare
  • La cassa deve essere online e il terminale acceso. Se il riquadro Square Terminal non è presente, chiedi a chi gestisce WP Admin di configurarlo.
  • Se Apri e chiudi la cassa è attivo, la cassa deve essere aperta. La cassa non registra pagamenti mentre è chiusa e un addebito già effettuato sulla carta tramite il terminale dovrebbe essere rimborsato. Vedi Aprire la cassa.
  1. Aggiungi i prodotti al carrello e premi Cassa.
  2. Nella scheda Pagamenti, tocca il riquadro Square Terminal.
  3. Controlla la riga del terminale, con Terminale: e il nome del terminale. Se ci sono più terminali, premi Cambia e tocca quello della tua cassa. Finché non ne scegli uno, il pannello mostra Scegli un terminale.
  4. Lascia come importo il saldo dovuto oppure inserisci un importo inferiore per incassarne una parte con carta. Vedi Pagamenti suddivisi.
  5. Premi Invia $45.00 a Square Terminal (il pulsante riporta il tuo importo). Il pannello mostra Avvio del terminale…, poi In attesa del cliente sul terminale.
  6. Il cliente avvicina, inserisce o striscia la carta sul terminale.
  7. Quando Square approva il pagamento, le fasi passano a Approvato e Acquisito. Se il saldo viene così saldato, la vendita si conclude e viene mostrata la ricevuta; altrimenti, incassa il resto con lo stesso metodo o con un altro.

Durante il pagamento, il pannello mostra:

  • SUL TERMINALE e l'importo inviato.
  • Una riga di stato, ad esempio In attesa del cliente sul terminale.
  • Il metodo e il nome del terminale.
  • Quattro fasi: Inviato, Sul terminale, Approvato, Acquisito.
  • Dettagli: ogni fase segnalata da Square, con l'orario e gli ID di Lettore, Azione e Pagamento. Copia (Condividi su alcuni dispositivi) ti permette di passare il log a chi ti assiste.
Messaggi sullo stato del pagamento e cosa fare
  • Approvato, poi Acquisito: l'importo è stato incassato. Se il saldo viene così saldato, appare la ricevuta; altrimenti, incassa il resto.
  • Pagamento annullato: il terminale ha confermato l'annullamento. Premi Riprova o Scegli un altro metodo.
  • Tempo scaduto — pagamento annullato: nessuno ha pagato entro 5 minuti. Premi Riprova o Scegli un altro metodo.
  • Annullamento in corso — in attesa di conferma dal terminale: il terminale non ha risposto alla richiesta di annullamento. Attendi oppure premi Sblocca questo pagamento. Vedi Interrompere un pagamento.
  • Pagamento sbloccato: ora l'ordine può essere pagato con un altro metodo, ma il terminale potrebbe comunque aver addebitato la carta. Controlla prima lo schermo del terminale.

Interrompere un pagamento​

Annulla sul terminale chiede a Square di annullare il pagamento sul terminale. Il pannello mostra Annullamento in corso…, poi Pagamento annullato quando il terminale conferma. Premi Riprova per inviarlo di nuovo oppure Scegli un altro metodo per tornare ai riquadri.

Se il terminale non conferma (è spento, non ha segnale o è bloccato), il pannello mostra Annullamento in corso — in attesa di conferma dal terminale e propone Sblocca questo pagamento, con la frase Consente di pagare l'ordine con un altro metodo. Il negozio continua a controllare il terminale.

Controlla il terminale prima di effettuare un nuovo addebito

Lo sblocco non annulla il pagamento presso Square. Il negozio continua a verificarlo in background, circa ogni 10 minuti. Controlla lo schermo del terminale prima di incassare con un altro metodo. Se indica che il pagamento è andato a buon fine, non incassare di nuovo: il negozio registrerà quel pagamento nell'ordine durante uno dei controlli successivi. Vedi Se qualcosa non funziona.

Sblocca questo pagamento sblocca l'ordine; non conferma che il pagamento sia stato annullato. Il pannello mostra Pagamento sbloccato. Prima di premere Scegli un altro metodo, controlla il terminale: se indica che il pagamento è andato a buon fine, non effettuare un nuovo addebito e attendi che l'ordine si aggiorni. Se indica che il pagamento è stato annullato, Scegli un altro metodo ti riporta ai riquadri per incassare con un altro metodo. Se non riesci a determinarlo (il terminale è spento, non ha segnale o non mostra nulla), l'esito è sconosciuto: se incassi con un altro metodo e il controllo del negozio rileva in seguito il pagamento sul terminale, registra anche quel pagamento nell'ordine e dovrai rimborsare uno dei due dall'ordine. Vedi Rimborsi.

Se nessuno paga sul terminale entro 5 minuti, il pagamento viene annullato e il pannello mostra Tempo scaduto — pagamento annullato.

Se qualcosa non funziona​

Nessun terminale configurato per Square Terminal. Nessun terminale è ancora associato all'estensione. Chiedi a chi gestisce WP Admin di associarne uno.

In uso per l'ordine #… Quel terminale sta elaborando il pagamento di un altro ordine. Completa o annulla prima quel pagamento oppure scegli un altro terminale.

Pagamento fallito e il motivo. Premi Riprova oppure Scegli un altro metodo. Dettagli mostra quanto segnalato da Square.

Annullamento in corso — in attesa di conferma dal terminale. Il terminale non ha risposto alla richiesta di annullamento. Attendi oppure premi Sblocca questo pagamento. Vedi Interrompere un pagamento.

Il pagamento sul terminale è riuscito, ma la cassa è ancora in attesa. Mentre attende, la cassa continua a interrogare Square e prosegue quando Square risponde; con un webhook il negozio riceve la notifica prima. Se la cassa smette di attendere (viene chiusa oppure sblocchi il pagamento), il controllo in background del negozio, circa ogni 10 minuti, registra i pagamenti non rilevati dalla cassa. Non incassare con un altro metodo durante l'attesa: controlla prima lo schermo del terminale.

Il riquadro non è presente. Il gateway di pagamento non è abilitato per il POS. Vedi Abilitare per il POS.

Problemi di configurazione, per chi gestisce WP Admin
Il terminale non compare nell'elenco

Deve essere associato a questa estensione: usa Crea codice dispositivo e inserisci il codice sul terminale. Un terminale associato tramite la dashboard di Square o l'app Square non compare finché non viene associato qui. Se Cerca lettori lo elenca sotto Altri dispositivi visibili a Square in questo punto vendita, il dispositivo esiste ma appartiene a un'altra applicazione. Controlla anche che l'ID punto vendita corrisponda al punto vendita a cui il terminale è connesso.

Non riesci ad associare il terminale

Il codice è valido per 5 minuti: creane uno nuovo. Il terminale deve essere online e disconnesso dall'app Square o da qualsiasi altra integrazione, perché il codice lo connette all'account e all'ID punto vendita impostati qui. L'Ambiente deve corrispondere a quello dell'account.

La verifica delle impostazioni non riesce

Se hai effettuato la connessione, controlla che la riga Account Square mostri ancora Connesso a Square. Se usi un tuo token di accesso, verifica che sia per l'Ambiente selezionato: un token sandbox non funziona in Produzione e viceversa. Controlla che l'ID punto vendita appartenga a quell'account.

È necessario riconnettersi a Square

Le autorizzazioni Square si rinnovano automaticamente. Quando un rinnovo non può essere completato, l'estensione interrompe l'autorizzazione e ti chiede di riconnetterti. Premi Riconnetti a Square; non occorre modificare altro.

Dove trovare i log

WooCommerce > Status > Log, origine square-terminal-for-woocommerce. Le fasi principali vengono scritte anche nelle note dell'ordine, con il prefisso Square Terminal:.

Configurazione​

Questa parte è rivolta a chi gestisce WP Admin del negozio. Il negozio invia ogni pagamento a Square e Square lo invia al terminale associato, quindi la cassa deve essere connessa al negozio. Esegui questi quattro passaggi nell'ordine indicato:

  1. Installa l'estensione dalla directory delle estensioni.
  2. Connettiti a Square e scegli il punto vendita.
  3. Associa il terminale oppure usa i dispositivi di test di Square nell'ambiente sandbox.
  4. Abilita per il POS.

Installare l'estensione​

Apri WP Admin > POS > Impostazioni > Estensioni, trova Square Terminal, 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. Senza WCPOS Pro 2.0 l'estensione non svolge alcuna funzione e segnala che è necessario.

Connettersi a Square​

  1. Vai su WP Admin > WooCommerce > Impostazioni > Pagamenti e apri Square Terminal.
  2. In Account Square, scegli l'Ambiente: Modalità di test (sandbox) (predefinita) per fare delle prove oppure Produzione per i pagamenti reali. Sceglilo prima di connetterti: una connessione vale per un solo ambiente.
  3. Fai clic su Connetti a Square e approva le richieste di Square.
  4. Scegli l'ID punto vendita: il punto vendita Square per il quale il terminale accetta pagamenti.
  5. In Quale dispositivo Square usi?, lascia Square Terminal.

Usi già il plugin ufficiale WooCommerce Square? Ambiente e ID punto vendita vengono precompilati con i suoi valori. Salva per applicarli. I due plugin non condividono le credenziali, quindi devi comunque connetterti qui.

Preferisci usare un tuo token di accesso? Apri Impostazioni avanzate e incolla un Token di accesso sandbox o un Token di accesso di produzione invece di effettuare la connessione.

Associare il terminale​

In Terminale, fai clic su Crea codice dispositivo e inserisci il codice sul terminale entro 5 minuti. Poi fai clic su Cerca lettori. Trovi tutti i passaggi, il contenuto dell'elenco e i dispositivi di test sandbox in Terminali associati e dispositivi di test.

Abilitare per il POS​

Vai su WP Admin > POS > Impostazioni > Pagamento, trova Square Terminal e attiva Abilitato. Vedi Abilitare un gateway di pagamento.

nota

Square Terminal è riservato al personale alla cassa; non viene mai proposto durante il pagamento nel negozio online. L'interruttore Abilitato nell'elenco Pagamenti di WooCommerce non ha alcun effetto su di esso.

Terminali associati e dispositivi di test​

Un terminale deve essere associato a questa estensione prima che un cassiere possa selezionarlo. L'associazione genera un codice dispositivo Square ed è l'unico modo in cui l'estensione può raggiungere il terminale.

  1. In Terminale, fai clic su Crea codice dispositivo. La schermata mostra Codice di associazione: … — inseriscilo sul terminale entro 5 minuti.
  2. Sul terminale, apri la schermata di accesso tramite codice dispositivo e inserisci il codice. Se il terminale è connesso all'app Square o a un'altra integrazione, disconnettilo prima: la schermata del codice dispositivo non è accessibile mentre è in uso altrove.
  3. Fai clic su Cerca lettori. Il terminale ora compare sotto Associati a questo plugin — selezionabili alla cassa.

Cerca lettori elenca i dispositivi visibili a Square in due gruppi:

  • Associati a questo plugin — selezionabili alla cassa: i terminali che i cassieri possono selezionare.
  • Altri dispositivi visibili a Square in questo punto vendita: terminali configurati da un'altra applicazione. Non possono essere selezionati qui finché non li associ con un nuovo codice.

Verifica impostazioni chiede a Square se la connessione (o il token di accesso) e il punto vendita funzionano. In caso affermativo, mostra Credenziali Square e punto vendita verificati.

Un elenco vuoto prima dell'associazione è normale

Square elenca solo i terminali associati con un codice dispositivo. Un terminale su cui è in esecuzione l'app Square non compare affatto finché non vi viene inserito un codice dispositivo.

Modalità di test: i dispositivi di test di Square al posto di un terminale

In Modalità di test (sandbox) non ci sono codici dispositivo né dispositivi da associare. La cassa elenca invece i dispositivi di test di Square, al posto dei terminali associati. Ognuno simula un esito senza bisogno di hardware:

Dispositivo di testEsito simulato
Sandbox: operazione riuscita (addebito di $25 o meno)Un pagamento con carta approvato. Mantieni l'importo a $25 o meno.
Sandbox: operazione riuscita con mancia del 20%Un pagamento con mancia. Square non accetta mance qui, quindi il pagamento fallisce: Il terminale ha confermato un importo diverso.
Sandbox: il cliente annulla sul terminaleIl cliente annulla sul terminale.
Sandbox: timeout immediatoNessuno paga e il tempo per il pagamento scade immediatamente.
Sandbox: terminale offline (rimane in attesa di pagamento)Un terminale che non risponde mai. Usalo per provare a interrompere un pagamento senza hardware.

Webhook​

Un webhook è facoltativo. Consente a Square di avvisare il negozio non appena un pagamento cambia stato, così la cassa può proseguire prima. Senza webhook, la cassa chiede l'esito a Square durante l'attesa e il controllo in background del negozio, circa ogni 10 minuti, registra gli esiti non rilevati dalla cassa. In entrambi i casi, il negozio registra un pagamento solo quando Square conferma il pagamento stesso; non basta che Square contrassegni come conclusa la procedura di pagamento.

Aggiungere un webhook

Questa procedura funziona solo se hai configurato l'estensione con un tuo token di accesso, in Impostazioni avanzate. Se hai usato Connetti a Square, hai autorizzato l'applicazione WCPOS, non una tua applicazione, quindi non hai un'applicazione a cui aggiungere una sottoscrizione né una chiave di firma da copiare. I pagamenti vengono comunque confermati tramite i controlli della cassa e il controllo in background.

Con un tuo token di accesso, usa la tua applicazione nella dashboard per sviluppatori di Square:

  1. Nella schermata delle impostazioni, nella riga Webhook sotto Terminale, fai clic su Copia per copiare l'URL del webhook.
  2. Nella dashboard per sviluppatori di Square, apri la tua applicazione e vai su Webhook.
  3. Aggiungi una sottoscrizione per l'evento terminal.checkout.updated, usando quell'URL come URL di notifica.
  4. Copia la Chiave di firma della sottoscrizione in Chiave di firma del webhook, in Impostazioni avanzate, e salva.

La riga Webhook mostra quindi Verificato … fa una volta ricevuto un webhook firmato.

L'URL deve corrispondere esattamente

Square firma ogni webhook con l'URL di notifica fornito. Se l'URL in Square differisce anche solo di un carattere da quello nella schermata delle impostazioni, ogni invio fallisce. Usa Copia invece di digitarlo.

Aggiornamento dalla versione 0.x

La versione 1.0.0 mostra un nuovo URL del webhook. Se hai già una sottoscrizione, sostituisci il suo URL di notifica in Square con quello mostrato ora nella schermata delle impostazioni; la modifica mantiene la chiave di firma. URL del webhook personalizzato non modifica questo URL; si applica solo alla pagina di pagamento dell'estensione. Se l'indirizzo pubblico del sito è diverso da quello mostrato, i webhook non supereranno la verifica: i pagamenti vengono comunque confermati tramite i controlli della cassa e il controllo in background.

Le sottoscrizioni ai webhook di Square appartengono a un'applicazione Square e non possono essere aggiunte con il token di accesso di un venditore, quindi l'estensione non può aggiungere la sottoscrizione per te.

Se la verifica dei webhook smette di funzionare​

La riga Webhook mostra Non ancora verificato finché non arriva un webhook che supera la verifica con le impostazioni attuali.

Sono stati effettuati pagamenti, ma compare ancora Non ancora verificato

Controlla che:

  1. La Chiave di firma del webhook corrisponda alla chiave della sottoscrizione in Square.
  2. L'URL di notifica in Square corrisponda esattamente a quello nella schermata delle impostazioni.
  3. La sottoscrizione includa terminal.checkout.updated.
  4. Il sito sia raggiungibile da Internet tramite HTTPS. La dashboard di Square mostra ogni tentativo di invio.

Modificare l'ambiente, l'URL del webhook o la chiave di firma reimposta la riga fino all'arrivo del webhook successivo. È un comportamento voluto: un webhook verificato con le vecchie impostazioni non dà alcuna indicazione sulla validità di quelle nuove.

Riferimento delle impostazioni​

In WP Admin > WooCommerce > Impostazioni > Pagamenti > Square Terminal, nell'ordine della configurazione. Apri un gruppo per visualizzarne le impostazioni.

Account Square
  • Ambiente: Modalità di test (sandbox) (predefinita) oppure Produzione. Una connessione vale per un solo ambiente.
  • Connetti a Square: autorizza questo sito presso Square. Al termine, mostra Connesso a Square, l'esercente e Disconnetti.
  • ID punto vendita: il punto vendita Square per il quale il terminale accetta pagamenti.
  • Quale dispositivo Square usi?: Square Terminal (questa pagina, l'opzione predefinita) oppure Square Reader.
Terminale
  • Crea codice dispositivo, Cerca lettori, Verifica impostazioni: associa un terminale, elenca i dispositivi visibili a Square, verifica la configurazione. Vedi Terminali associati e dispositivi di test.
  • Webhook: indica se è arrivato un webhook firmato e mostra l'URL con il pulsante Copia. Vedi Webhook.
Comportamento della cassa
  • Salta schermata della ricevuta: il terminale torna in attesa senza mostrare la propria schermata della ricevuta.
  • Richiedi firma: chiede al cliente di firmare sul terminale, se il pagamento lo supporta.
  • Log di debug della cassa: un pannello di log copiabili nella pagina di pagamento dell'estensione. Serve per l'assistenza; puoi lasciarlo disattivato.
Impostazioni avanzate
  • Token di accesso sandbox, Token di accesso di produzione: necessari solo se non effettui la connessione sopra.
  • Chiave di firma del webhook: facoltativa. Consente al negozio di verificare i webhook; i pagamenti vengono confermati anche senza.
  • URL del webhook personalizzato: solo per la pagina di pagamento dell'estensione. Vedi Webhook.

La sezione Impostazioni avanzate è chiusa per impostazione predefinita anche nella schermata delle impostazioni.

Square Reader al posto di un terminale​

Imposta Quale dispositivo Square usi? su Square Reader per accettare il pagamento nell'app Square Point of Sale, con uno Square Reader associato al telefono o al tablet. La schermata delle impostazioni mostra quindi un elenco di cinque passaggi, Configura il tuo Square Reader.

I cinque passaggi per configurare Square Reader
  1. Connetti il tuo account Square.
  2. Scegli il punto vendita.
  3. Registra il negozio presso Square: incolla il tuo ID applicazione.
  4. Fornisci a Square l'indirizzo di ritorno del negozio.
  5. Configura il telefono o il tablet.

Alla cassa, il pagamento avviene nella pagina di pagamento dell'estensione, nella scheda Legacy: premi Apri Square Point of Sale e completa il pagamento nell'app Square. Funziona solo:

  • in Produzione, non in modalità di test;
  • su un telefono o tablet Android o iOS con l'app Square Point of Sale installata. In tutti gli altri casi il pulsante è disattivato e ne indica il motivo.

Rimborsi​

Rimborsa un pagamento Square Terminal dall'ordine: l'importo viene restituito sulla carta del cliente tramite Square. Sono supportati anche i rimborsi parziali. Vedi Rimborsi.

Un pagamento accettato nella pagina di pagamento dell'estensione, ad esempio con una versione precedente alla 1.0.0, va invece rimborsato dalla dashboard di Square.

Requisiti​

WCPOS Pro: Versione 2.0.0 o successiva
Account Square: Un account venditore Square attivo e un punto vendita Square
Square Terminal: Online e associato a questa estensione tramite un codice dispositivo per il tuo account e punto vendita Square (vedi Terminali associati e dispositivi di test sopra)
Connessione: La cassa e il negozio devono essere online. Il negozio invia ogni pagamento al terminale associato, quindi qualsiasi cassa può usare qualsiasi terminale associato
Sito HTTPS pubblico: Solo per i webhook; i pagamenti vengono confermati anche senza