Gateway Stripe Terminal
Il gateway Stripe Terminal consente di accettare pagamenti in presenza utilizzando lettori hardware Stripe Terminal direttamente in WCPOS. Questo gateway supporta sia lettori di carte fisici sia la modalità simulatore per i test.
Funzionalità
Integrazione hardware
Collegamento di lettori Stripe Terminal fisici tramite connessione internet
Modalità simulatore
Test dei pagamenti senza hardware utilizzando il simulatore di Stripe
Elaborazione in tempo reale
Elaborazione e conferma istantanea dei pagamenti
Transazioni sicure
Elaborazione dei pagamenti conforme PCI tramite Stripe
Ordini telefonici (MOTO)
Accettare pagamenti con carta per telefono inserendo i dettagli nel lettore
Installazione
Installare Stripe Terminal per WooCommerce
Installare da WP Admin > POS > Impostazioni > Estensioni, oppure scaricare l'ultimo asset zip del plugin (non lo zip del codice sorgente GitHub né il tarball) dalla pagina delle release su GitHub e caricarlo tramite Plugin > Aggiungi Nuovo > Carica plugin.
Configurare le impostazioni di Stripe
- Navigare a
WP Admin > WooCommerce > Impostazioni > Pagamenti - Trovare Stripe Terminal nell'elenco dei metodi di pagamento
- Fare clic su Stripe Terminal per accedere alle impostazioni
- Inserire la propria Stripe Secret Key (è possibile ottenerla dalla Stripe Dashboard)
- Salvare le impostazioni
Non è necessario abilitare il gateway Stripe Terminal nelle impostazioni di WooCommerce. Verrà abilitato specificamente per il POS nel passaggio successivo.
Abilitazione in WCPOS
- Andare su
WP Admin > POS > Impostazioni > Pagamento - Trovare il gateway Stripe Terminal nell'elenco
- Abilitare il gateway per l'utilizzo nel POS
- Salvare le impostazioni
Utilizzo
Connessione di un lettore
Quando si seleziona il gateway Stripe Terminal durante il checkout nel POS:
- Scelta del metodo di connessione: è possibile collegare un lettore fisico o utilizzare il simulatore
- Lettore fisico: Seguire le istruzioni sullo schermo per collegare il dispositivo Stripe Terminal
- Simulatore: Selezionare la modalità simulatore per testare vari scenari di pagamento senza hardware
Elaborazione dei pagamenti
- Aggiungere articoli: Aggiungere i prodotti al carrello nel POS
- Selezionare il gateway: Scegliere "Stripe Terminal" come metodo di pagamento
- Collegare il lettore: Collegare il lettore o scegliere la modalità simulatore
- Elaborare il pagamento: Seguire le indicazioni per completare la transazione
- Conferma: L'ordine verrà automaticamente completato dopo l'avvenuto pagamento
Test con il simulatore
Il simulatore consente di testare vari metodi di pagamento e scenari:
- Pagamenti con carta: Testare diversi tipi di carta (Visa, Mastercard, ecc.)
- Pagamenti contactless: Simulare transazioni tap-to-pay
- Scenari di errore: Testare pagamenti rifiutati e altre condizioni di errore
- Importi diversi: Testare vari importi di transazione
Ordini telefonici (MOTO)
MOTO (Mail Order/Telephone Order) consente di elaborare pagamenti con carta per clienti non fisicamente presenti — ad esempio, quando si riceve un ordine per telefono. Invece di avvicinare o inserire una carta, l'esercente digita i dati della carta direttamente sullo schermo del lettore del terminale.
Configurazione
Richiedere l'accesso MOTO a Stripe
MOTO non è abilitato per impostazione predefinita. Contattare il supporto Stripe e richiedere l'abilitazione dei permessi MOTO per il proprio account. Si tratta di un processo rapido ma che richiede l'approvazione manuale da parte di Stripe.
Abilitare nelle impostazioni del plugin
- Navigare in
WP Admin > WooCommerce > Impostazioni > Pagamenti > Stripe Terminal - Selezionare la casella Ordini telefonici (MOTO)
- Salvare le impostazioni
Collegare un lettore compatibile
MOTO funziona solo con lettori compatibili connessi a internet elencati in Terminali supportati. L'opzione non verrà visualizzata per altri tipi di lettore.
Ricevere un ordine telefonico
- Collegare un lettore compatibile (vedi Terminali supportati)
- Nella schermata di pagamento, attivare l'opzione Ordine telefonico
- Fare clic su Riscuoti pagamento con carta — il lettore mostrerà una schermata per l'inserimento del numero di carta anziché richiedere un avvicinamento/inserimento
- Digitare sul lettore il numero di carta, la data di scadenza e il CVV del cliente
- Da quel momento il pagamento viene elaborato normalmente
I pagamenti MOTO utilizzano card come tipo di metodo di pagamento anziché card_present. Ciò significa che dal punto di vista di Stripe vengono trattati come transazioni online, pertanto si applicano le commissioni standard per l'elaborazione delle carte online anziché le tariffe per le transazioni in presenza.
L'opzione Ordine telefonico viene visualizzata solo quando tutte e tre le condizioni sono soddisfatte: l'impostazione MOTO è abilitata nelle impostazioni del plugin, un lettore compatibile è collegato e il lettore non è un simulatore. Se l'opzione non è visibile, verificare queste condizioni.
Requisiti
Compatibilità hardware
Questa implementazione utilizza l'SDK JavaScript di Stripe, il che significa che funziona tramite applicazioni web ma richiede solo terminali connessi a internet. I terminali Bluetooth non sono attualmente supportati.
Terminali supportati (connessi a internet)
- Stripe Reader S700/S710 ✅ - Terminale connesso via Ethernet/WiFi
- WisePOS E ✅ - Terminale connesso via WiFi
Terminali non supportati (Bluetooth)
- BBPOS Chipper 2X BT ❌ - Solo Bluetooth
- BBPOS WisePad 3 ❌ - Solo Bluetooth
- Verifone P400 ❌ - Solo Bluetooth
Il supporto per i terminali Bluetooth è previsto in una futura versione dell'app per iOS e Android. Quando disponibile, consentirà il supporto per tutti i lettori certificati Stripe Terminal, inclusi M2 e WisePad 3.
Problemi comuni
Il lettore non si connette
- Assicurarsi di utilizzare un terminale con connessione internet supportato
- Verificare che il terminale sia connesso al WiFi/Ethernet e online
- Verificare che il proprio account Stripe abbia Terminal abilitato
- Confermare che il terminale sia registrato nella Dashboard Stripe
Pagamento rifiutato
- Verificare che il proprio account Stripe sia attivo e in regola
- Verificare che la carta utilizzata sia valida
- Assicurarsi che i fondi disponibili siano sufficienti
L'opzione Ordine telefonico non viene visualizzata
- Verificare che l'impostazione Ordini telefonici (MOTO) sia abilitata in
WooCommerce > Impostazioni > Pagamenti > Stripe Terminal - Assicurarsi di essere connessi a un lettore compatibile (vedere Terminali supportati) — l'interruttore è nascosto per altri tipi di lettore
- L'interruttore non viene visualizzato quando si utilizza il simulatore
Il pagamento MOTO non riesce e restituisce un errore
- Verificare che Stripe abbia abilitato le autorizzazioni MOTO sul proprio account — contattare l'assistenza Stripe se non è ancora stato fatto
- Verificare che i dati della carta siano stati inseriti correttamente sul lettore
- I pagamenti MOTO possono essere soggetti a controlli antifrode più rigorosi — assicurarsi che la carta sia valida e disponga di fondi sufficienti
Errori del certificato SSL
- Stripe Terminal richiede HTTPS — assicurarsi che il sito disponga di un certificato SSL valido
- Verificare che il certificato SSL sia configurato correttamente
Assistenza
Per assistenza tecnica:
- Visitare il repository GitHub per segnalare problemi
- Consultare la documentazione di Stripe Terminal per indicazioni specifiche sull'hardware
- Contattare il supporto Stripe per problemi relativi all'account
Schermate
Le schermate verranno aggiunte in un aggiornamento futuro per mostrare:
- Configurazione del gateway nelle impostazioni di pagamento di WooCommerce
- Interfaccia di cassa del POS con selezione di Stripe Terminal
- Interfaccia di test del simulatore con vari metodi di pagamento