Salta al contenuto principale
Versione: 2.x

Gateway di pagamento Stripe Terminal

Stripe Terminal porta un lettore di carte Stripe alla tua cassa. La cassa invia l'importo al lettore, il cliente avvicina, inserisce o striscia la carta e la vendita si conclude quando Stripe acquisisce il pagamento e non rimane nulla da pagare. Questa pagina ti guida nella configurazione iniziale, nel collegamento di un lettore a ogni cassa e nell'incasso del primo pagamento.

Hai già completato la configurazione? Collega un lettore a questa cassa oppure incassa un pagamento.

Funzionalità Pro

Stripe Terminal richiede WCPOS Pro 2.0.0 o una versione successiva. Senza, l'estensione non funziona.

Scegli i lettori​

Stripe vende tre tipi di lettore. Il tipo utilizzabile da una cassa dipende dalla piattaforma su cui viene eseguito il POS.

  • Lettore smart — funziona su ogni cassa: browser, app desktop, iPhone, iPad e Android. Stripe Reader S700 e S710, BBPOS WisePOS E. Si collega alla tua rete e il negozio gli invia il pagamento.
  • Lettore Bluetooth — solo nelle app iOS e Android. Stripe Reader M2, BBPOS WisePad 3. Si abbina al telefono o al tablet.
  • Tap to Pay — in arrivo nelle app iOS e Android con un aggiornamento dell'app. Non serve un lettore: il cliente avvicina la carta direttamente al telefono.

Un browser o l'app desktop non possono accedere a un lettore Bluetooth o al chip contactless di un telefono, quindi queste casse usano un lettore smart. Acquista i lettori nel negozio Terminal della Dashboard Stripe.

Quale lettore Bluetooth scegliere

Stripe vende Stripe Reader M2 negli Stati Uniti e BBPOS WisePad 3 negli altri paesi, tra cui Regno Unito, Europa, Canada e Australia. Controlla nel negozio Terminal quale è disponibile per te.

Configura il gateway di pagamento​

Un amministratore esegue questa operazione una sola volta per negozio, in WP Admin.

  1. Installa l'estensione. Scarica il file zip del plugin, stripe-terminal-for-woocommerce.zip, dalle risorse della release su GitHub e caricalo da Plugin > Add Plugin, poi Carica plugin. Il file zip «Source code» di GitHub non è installabile.
  2. Aggiungi le chiavi. Vai su WP Admin > WooCommerce > Impostazioni > Pagamenti, apri Stripe Terminal e incolla la Chiave segreta live, oltre alla Chiave segreta di test se vuoi prima fare una prova. Entrambe provengono dalla Dashboard Stripe. Una volta salvata, la chiave viene mostrata come una serie di punti con la dicitura (salvata; lascia vuoto per conservarla).
  3. Scegli una sede Terminal per i lettori Bluetooth e Tap to Pay. Creane una in modalità di test e una in modalità live nella Dashboard Stripe, in Terminal → Sedi, poi selezionale nei campi Sede Terminal (test) e Sede Terminal (live).
  4. Seleziona i lettori consentiti dal negozio in Connessioni POS: Lettori smart, Lettori Bluetooth e Tap to Pay oppure entrambi. Per usare i lettori Bluetooth o Tap to Pay nelle app, seleziona Lettori Bluetooth e Tap to Pay e deseleziona Lettori smart. Vedi Lettori smart, Bluetooth o entrambi.
  5. Salva le impostazioni, poi verifica che nella riga del webhook sottostante compaia Segreto di firma memorizzato.
  6. Attivalo per il POS. Vai su WP Admin > POS > Impostazioni > Pagamento, attiva Stripe Terminal e salva. Non è necessario abilitarlo nell'elenco dei pagamenti di WooCommerce; vedi Impostazioni della cassa.
Scegli una sede Terminal prima del primo collegamento

Senza una sede, un lettore Bluetooth o Tap to Pay non possono collegarsi e la cassa mostra Seleziona una sede Terminal nelle impostazioni di Stripe Terminal prima di collegare un lettore mobile.

Tutte le impostazioni della pagina del gateway di pagamento
  • Titolo e Descrizione — il nome e il testo che vedono i clienti. La cassa mostra il titolo sul riquadro.
  • Chiave segreta live e Chiave segreta di test — dalla Dashboard Stripe.
  • Terminale predefinito — il lettore smart con cui la cassa incassa i pagamenti finché non ne viene scelto un altro.
  • Terminali abilitati — limita le casse ai lettori smart selezionati. Lascia il campo vuoto per consentire tutti i lettori dell'account.
  • Blocca la selezione del terminale — I cassieri non possono cambiare il terminale alla cassa del POS. Richiede un Terminale predefinito.
  • Connessioni POS — i tipi di lettore che le casse possono usare: Lettori smart (il negozio controlla il lettore tramite la rete) e Lettori Bluetooth e Tap to Pay (l'app POS controlla il lettore). Vedi Lettori smart, Bluetooth o entrambi.
  • Sede Terminal (test) e Sede Terminal (live) — le sedi in cui vengono registrati i lettori Bluetooth e Tap to Pay quando l'app li collega.
  • Modalità di test — Abilita la modalità di test. Un sito senza HTTPS rimane in modalità di test: Stripe Terminal richiede HTTPS per i pagamenti reali.
  • Ordini telefonici (MOTO) — Attiva i pagamenti per ordini telefonici tramite Stripe Terminal. Consulta Ordini telefonici (MOTO).
  • Mantieni attivo il lettore (sperimentale) — invia ping al lettore per evitare che il primo pagamento dopo un periodo di inattività sia lento. Sconsigliato quando più casse condividono un lettore.

Sotto i campi, la pagina elenca le Sedi Stripe Terminal e la riga del webhook.

Lettori smart, Bluetooth o entrambi​

Connessioni POS è un'impostazione del negozio: determina il tipo di lettore usato da ogni cassa.

  • Solo Lettori smart: ogni cassa incassa i pagamenti con un lettore smart.
  • Solo Lettori Bluetooth e Tap to Pay: le app iOS e Android incassano i pagamenti con un lettore Bluetooth o con il telefono. Su una cassa nel browser o nell'app desktop, il riquadro Stripe è raggruppato sotto … non disponibili al momento, con la dicitura Per questo metodo di pagamento sono consentiti solo i lettori dell'app. Abilita i lettori smart nella relativa pagina delle impostazioni di WooCommerce per incassare da questa cassa.
  • Entrambi: le casse usano i lettori smart. I lettori Bluetooth e Tap to Pay rimangono inutilizzati finché non deselezioni Lettori smart.
Modifica dei tipi di lettore o aggiornamento

Deselezionare un tipo cambia solo il modo in cui le casse incasseranno i pagamenti successivi. Ogni pagamento viene rimborsato tramite la connessione con cui è stato incassato, lettore smart o app, e il webhook di Stripe continua a funzionare. Un aggiornamento da una versione precedente mantiene la connessione salvata, oppure i lettori smart se era stato salvato solo un Terminale predefinito. Una nuova installazione ha entrambe le opzioni selezionate, quindi le app usano i lettori smart finché non deselezioni Lettori smart.

Collega un lettore a questa cassa​

Ogni cassa mantiene il proprio lettore. Nel POS, tocca Impostazioni in fondo al menu laterale, poi Lettori di carte.

Impostazioni con Lettori di carte selezionato, su una cassa il cui negozio non ha ancora lettori di carte configurati
  1. Non ci sono lettori di carte configurati per questo negozio — è il messaggio mostrato finché il gateway di pagamento non viene configurato con un tipo di lettore utilizzabile da questa cassa. Dopo la configurazione, al suo posto compaiono le sezioni descritte di seguito per i lettori utilizzabili da questa cassa (nel browser o nell'app desktop, solo Lettori smart).

Lettori smart​

Registra ogni lettore smart nella Dashboard Stripe con il codice mostrato dal lettore. Finché non lo fai, non compare in Terminale predefinito, in Terminali abilitati o sulla cassa.

La sezione Lettori smart contiene una riga per ogni lettore consentito dal negozio: il nome del lettore con quello del gateway di pagamento accanto, la sede Terminal sotto e lo stato Online o Offline. La cassa incassa i pagamenti con il lettore nella riga contrassegnata come Selezionato. Per cambiarlo, tocca Usa questo lettore su un altro lettore online; da quel momento la cassa usa quello.

Quale lettore viene usato automaticamente?
  • Nessuna scelta effettuata: la cassa usa il Terminale predefinito finché è online e libero.
  • Un solo lettore smart nel negozio: non serve scegliere. Finché è online e non è occupato con un'altra vendita, la cassa lo usa per incassare.
  • Impostato dal negozio: il Terminale predefinito con Blocca la selezione del terminale attivo. Finché è online, risulta Selezionato su ogni cassa e nessuna riga offre Usa questo lettore.

Lettori Bluetooth​

Nell'app iOS o Android:

  1. Accendi il lettore e tienilo vicino al telefono o al tablet.
  2. In Impostazioni → Lettori di carte, tocca Collega un lettore. Se il negozio ha più gateway di pagamento per i lettori, viene chiesto quale usare: Collega un lettore con, poi Stripe Terminal.
  3. La riga mostra Ricerca dei lettori… Accendi il lettore e tienilo vicino a questo dispositivo., poi 1 lettore trovato. È il tuo? oppure 3 lettori trovati. Qual è il tuo? Tocca Collega accanto al tuo.
  4. Al primo collegamento viene installato un aggiornamento del software del lettore. La riga mostra Installazione del software del lettore con una barra di avanzamento e Tieni il lettore acceso e carico. Il primo aggiornamento richiede circa 10 minuti. Prima di iniziare, carica il lettore oltre la metà e rimani su questa schermata.
  5. La riga mostra Collegato, con il livello della batteria del lettore, ad esempio Collegato · 80%.

I collegamenti successivi richiedono pochi secondi e la cassa si ricollega allo stesso lettore alla vendita successiva. Quando nessun lettore è collegato, la sezione Lettori Bluetooth mostra Nessun lettore ancora collegato. Accendi il lettore e tienilo vicino a questo telefono.

Tap to Pay​

Tap to Pay arriverà nelle app iOS e Android con un aggiornamento dell'app; ecco come funzionerà quando sarà disponibile nella tua app. Su un telefono con l'app iOS o Android, la sezione Questo telefono contiene una riga Tap to Pay su iPhone o Tap to Pay su Android. Un gestore del negozio o un amministratore tocca Configura Tap to Pay. Gli altri utenti vedono Non configurato · chiedi a un amministratore.

La prima volta, il telefono chiede di accettare i termini del fornitore: su iPhone, Apple chiede di collegare un Apple ID e di accettare i propri termini per Tap to Pay. Una volta completata la configurazione, la riga mostra Pronto. Tap to Pay richiede una connessione per incassare un pagamento.

I messaggi che possono comparire nella riga di un lettore

Ogni riga mostra il nome del lettore, il suo numero di serie, la sede Terminal e una riga di stato:

  • Collegato · 80% — pronto a incassare pagamenti, con il livello di batteria residua. Tap to Pay mostra Pronto.
  • Non collegato — la cassa ricorda questo lettore ma al momento non è collegata. Tocca Collega.
  • Collegamento a … — attendi. Il pulsante mostra Collegamento….
  • Installazione del software del lettore — l'aggiornamento; vedi Lettori Bluetooth, passaggio 4.
  • Nessun lettore trovato. Accendi il lettore e riprova. — tocca Riprova oppure Non vedi il tuo lettore? per aprire la guida del lettore.
  • Impossibile collegarsi: … — segue il motivo fornito da Stripe. Tocca Riprova oppure Aiuto.
  • Attiva il Bluetooth per collegare un lettore. — il Bluetooth è disattivato su questo dispositivo.
  • Consenti l'accesso al lettore nelle impostazioni dell'app. — l'app non ha ricevuto l'autorizzazione a usare il Bluetooth. Concedila nelle impostazioni del telefono.

Il menu ⋮ accanto a una riga contiene Dimentica: la cassa smette di ricollegarsi a quel lettore alla vendita successiva. Puoi collegarlo di nuovo da questa pagina. Scollega, il pulsante nella riga di un lettore collegato, interrompe il collegamento per il momento. Se un lettore rimane bloccato perché occupato dall'app, il menu offre anche Libera il lettore.

Fai una prova prima di iniziare a incassare​

Seleziona Modalità di test nella pagina delle impostazioni del gateway di pagamento (WP Admin > WooCommerce > Impostazioni > Pagamenti > Stripe Terminal) e salva. I pagamenti vengono quindi inviati all'account di test di Stripe e non viene trasferito denaro. Esegui una vendita di prova seguendo i passaggi in Incassa un pagamento.

  • Lettori smart: un lettore simulato registrato nel tuo account di test Stripe compare insieme a quelli reali, così puoi effettuare una vendita senza hardware.
  • Lettori Bluetooth e lettori smart reali: paga con la carta fisica di test di Stripe, ordinabile nel negozio Terminal della Dashboard Stripe. Le ultime due cifre dell'importo determinano l'esito: .00 approva il pagamento, .05 lo rifiuta e .02 richiede il PIN 1234.

Al termine, deseleziona Modalità di test e salva prima di incassare un pagamento reale.

Incassa un pagamento​

Apri prima la cassa

Se Apri e chiudi la cassa è attivo, la cassa non registra i pagamenti quando è chiusa e un pagamento con carta già incassato dovrebbe essere rimborsato. Vedi Aprire la cassa.

  1. Aggiungi i prodotti al carrello e premi Cassa.

  2. Tocca il riquadro Stripe Terminal nel pannello dei pagamenti.

  3. Controlla il lettore. Per un lettore smart compare Terminale: …, con Cambia per sceglierne un altro quando il negozio lo consente. Per un lettore Bluetooth compare Collegato · 80%, oppure Nessun lettore collegato con un link a Impostazioni → Lettori di carte.

  4. Premi Invia … a Stripe Terminal, poi lascia che il cliente paghi:

    • Lettore smart: la cassa mostra In attesa del cliente sul terminale mentre il cliente avvicina, inserisce o striscia la carta sul lettore.
    • Lettore Bluetooth: la cassa mostra Presenta la carta sul lettore.
    • Tap to Pay: il telefono mostra la propria schermata Tap to Pay e il cliente avvicina la carta o il telefono al tuo.

    La cassa spunta le fasi Inviato, Sul terminale, Approvato e Acquisito.

  5. Quando non rimane nulla da pagare, si apre la schermata della ricevuta: stampa la ricevuta o inviala per email, poi premi Nuova vendita. Vedi Verifica il pagamento. Se rimane una parte del totale da pagare, incassala con un altro metodo; vedi Pagamenti suddivisi.

Per interrompere, premi Annulla sul terminale. Se la carta viene rifiutata, compare Pagamento fallito: … con Riprova e Scegli un altro metodo. Vedi Su un lettore di carte.

Il riquadro non consente di inserire i dati della carta. Per un ordine telefonico, consulta Ordini telefonici (MOTO).

Le mance aggiunte dai clienti sul lettore compaiono nell'ordine come voce aggiuntiva Mancia. WisePad 3, WisePOS E, S700 e S710 possono richiedere una mancia; M2 non può farlo. Attiva le mance per i tuoi lettori nella Dashboard Stripe.

Ordini telefonici (MOTO)​

MOTO (mail order, telephone order: ordine per corrispondenza o telefonico) consente di accettare il pagamento con carta di un cliente assente: inserisci il numero della carta, la data di scadenza e il codice di sicurezza sullo schermo del lettore invece di avvicinare la carta. Gli ordini telefonici si effettuano solo nella scheda Tradizionale della schermata di cassa, nel pannello di Stripe. Il riquadro Stripe Terminal nella scheda Pagamenti non consente di inserire i dati della carta.

L'interruttore Ordine telefonico viene mostrato solo quando sono soddisfatte tutte e tre queste condizioni:

  1. Stripe attiva MOTO per il tuo account. Non è attivo per impostazione predefinita: contatta l'assistenza Stripe.
  2. Seleziona Ordini telefonici (MOTO). Vai a WP Admin > WooCommerce > Impostazioni > Pagamenti > Stripe Terminal, seleziona Ordini telefonici (MOTO) e salva.
  3. Usa un lettore smart S700, S710 o WisePOS E. L'interruttore viene mostrato quando uno di questi lettori è connesso nel pannello di Stripe. Non viene mai mostrato per un P400, M2, WisePad 3, Tap to Pay o un lettore simulato.

Quando è selezionato Ordini telefonici (MOTO), il pannello di Stripe sostituisce quello consueto per tutti i pagamenti Stripe Terminal nella scheda Tradizionale, non solo per gli ordini telefonici. Se l'opzione non è selezionata, la scheda Tradizionale mostra un selettore Terminale con Invia al terminale, Annulla e Riprova; il pagamento viene registrato come uno proveniente dal pannello dei metodi di pagamento.

Per accettare un ordine telefonico:

La scheda Legacy della cassa con Stripe Terminal selezionato nella pagina di pagamento del gateway, l'inizio dell'elenco Lettori disponibili sotto e il pulsante Elabora pagamento
  1. Legacy — la scheda che mostra la pagina di pagamento del negozio all'interno della cassa.
  2. La pagina di pagamento del negozio — scegli Stripe Terminal qui, poi scorri verso il basso fino a Lettori disponibili, Collega e Ordine telefonico.
  3. Elabora pagamento — il pulsante della cassa sotto la pagina, come per qualsiasi pagamento Legacy. Un ordine telefonico si avvia con Paga con il terminale sulla pagina.
  1. Premi Cassa, apri la scheda Tradizionale e scegli Stripe Terminal.
  2. In Lettori disponibili, premi Collega sul tuo lettore.
  3. Attiva Ordine telefonico.
  4. Premi Paga con il terminale. Il lettore mostra una schermata per inserire i dati della carta invece di chiedere di avvicinarla.
  5. Digita il numero della carta, la data di scadenza e il codice di sicurezza sul lettore.
consiglio

Stripe considera un ordine telefonico come un pagamento con carta non presente, quindi non si applicano né le tariffe dei pagamenti con carta in presenza né il relativo trasferimento della responsabilità per frodi.

Se qualcosa va storto​

Il lettore non si collega. Un lettore smart deve essere connesso al Wi-Fi o a Ethernet, risultare online nella Dashboard Stripe ed essere registrato lì. Un lettore Bluetooth richiede l'app iOS o Android, il Bluetooth attivo e l'autorizzazione dell'app a usarlo.

«Seleziona una sede Terminal…». Il gateway di pagamento non ha una sede Terminal per la modalità in uso, test o live. Vedi Configura il gateway di pagamento, passaggio 3.

Il primo collegamento richiede molto tempo. È l'aggiornamento del software del lettore, che dura circa 10 minuti. Tieni il lettore acceso e carico e rimani su questa schermata. Il collegamento successivo richiede pochi secondi.

Il riquadro Stripe indica che non è disponibile. Su una cassa nel browser o nell'app desktop, il negozio consente solo i lettori dell'app. Vedi Lettori smart, Bluetooth o entrambi. Quando sei offline, i lettori di carte attendono la connessione; vedi Modalità offline.

Lettori di carte mostra Per questo negozio sono consentiti solo i lettori dell'app. La causa è la stessa, su una cassa nel browser o nell'app desktop: abilita Lettori smart in Connessioni POS oppure usa l'app iOS o Android. Vedi Lettori smart, Bluetooth o entrambi.

La carta viene rifiutata. Chiedi un'altra carta o un altro metodo di pagamento. In modalità di test, controlla le ultime due cifre dell'importo.

Manca l'interruttore Ordine telefonico. Gli ordini telefonici si effettuano solo dalla scheda Tradizionale, non dal riquadro Stripe Terminal. Verifica che Ordini telefonici (MOTO) sia selezionato, che sia connesso un S700, S710 o WisePOS E e che non si tratti di un lettore simulato.

Un ordine telefonico non va a buon fine. Stripe non ha ancora attivato MOTO per il tuo account oppure i dati della carta sono stati digitati in modo errato.

Il problema persiste? Segnala un bug su GitHub, consulta la documentazione di Stripe Terminal per il lettore oppure contatta l'assistenza Stripe per questioni relative al tuo account.