Salta al contenuto principale
Versione: 1.x

Gateway Terminal Stripe

Il gateway Terminal Stripe ti consente di accettare pagamenti di persona utilizzando lettori hardware Stripe Terminal direttamente all'interno di WCPOS. Questo gateway supporta sia lettori di schede fisici che la modalità simulatore per i test.

Caratteristiche​

Integrazione Hardware

Collega lettori fisici Stripe Terminal tramite connessione internet

Modalità Simulatore

Testa i pagamenti senza hardware utilizzando il simulatore di Stripe

Elaborazione in Tempo Reale

Elaborazione e conferma dei pagamenti istantanea

Transazioni Sicure

Elaborazione dei pagamenti conforme al PCI tramite Stripe

Ordini Telefonici (MOTO)

Accetta pagamenti con carta per telefono inserendo i dettagli nel lettore

Installazione​

1

Scarica e Installa

  1. Visita la pagina delle release di Stripe Terminal per WooCommerce
  2. Scarica l'ultimo file stripe-terminal-for-woocommerce.zip
  3. Nel tuo WordPress admin, vai su Plugin > Aggiungi Nuovo > Carica Plugin
  4. Carica il file zip e attiva il plugin
2

Configura le Impostazioni di Stripe

  1. Naviga a WP Admin > WooCommerce > Impostazioni > Pagamenti
  2. Trova Stripe Terminal nell'elenco dei metodi di pagamento
  3. Clicca su Stripe Terminal per accedere alle impostazioni
  4. Inserisci la tua Chiave Segreta Stripe (puoi ottenerla dal tuo Dashboard Stripe)
  5. Salva le impostazioni
nota

Non è necessario abilitare il gateway Terminal Stripe nelle impostazioni di WooCommerce. Sarà abilitato specificamente per il POS nel passaggio successivo.

3

Abilita in WCPOS

  1. Vai su WP Admin > POS > Impostazioni > Pagamenti
  2. Trova il gateway Stripe Terminal nell'elenco
  3. Abilita il gateway per l'uso nel POS
  4. Salva le tue impostazioni

Utilizzo​

Collegare un Lettore​

Quando selezioni il gateway Terminal Stripe durante il pagamento nel POS:

  1. Scegli il Metodo di Connessione: Puoi collegare un lettore fisico o usare il simulatore
  2. Lettore Fisico: Segui le istruzioni sullo schermo per collegare il tuo dispositivo Terminal Stripe
  3. Simulatore: Seleziona la modalità simulatore per testare vari scenari di pagamento senza hardware

Elaborazione dei Pagamenti​

  1. Aggiungi Articoli: Aggiungi prodotti al tuo carrello nel POS
  2. Seleziona il Gateway: Scegli "Stripe Terminal" come metodo di pagamento
  3. Collega il Lettore: Collega il tuo lettore o scegli la modalità simulatore
  4. Elabora il Pagamento: Segui le istruzioni per completare la transazione
  5. Conferma: L'ordine verrà automaticamente completato dopo il pagamento riuscito

Test con il Simulatore​

Il simulatore ti consente di testare vari metodi di pagamento e scenari:

  • Pagamenti con Carta: Testa diversi tipi di carta (Visa, Mastercard, ecc.)
  • Pagamenti Contactless: Simula transazioni tap-to-pay
  • Scenari di Errore: Testa pagamenti rifiutati e altre condizioni di errore
  • Importi Diversi: Testa vari importi di transazione

Ordini Telefonici (MOTO)​

MOTO (Mail Order/Telephone Order) ti consente di elaborare pagamenti con carta per clienti che non sono fisicamente presenti — ad esempio, quando prendi un ordine per telefono. Invece di toccare o inserire una carta, il commerciante inserisce direttamente i dettagli della carta nello schermo del lettore terminale.

Configurazione​

1

Richiedi accesso MOTO a Stripe

MOTO non è abilitato per impostazione predefinita. Contatta il supporto di Stripe e chiedi di abilitare i permessi MOTO per il tuo account. Questo è un processo rapido ma richiede approvazione manuale da parte di Stripe.

2

Abilita nelle impostazioni del plugin

  1. Naviga a WP Admin > WooCommerce > Impostazioni > Pagamenti > Stripe Terminal
  2. Seleziona la casella Ordini Telefonici (MOTO)
  3. Salva le impostazioni
3

Collega un lettore compatibile

MOTO funziona solo con lettori compatibili con connessione internet elencati in Terminali Supportati. Il toggle non apparirà per altri tipi di lettore.

Prendere un Ordine Telefonico​

  1. Collega un lettore compatibile (vedi Terminali Supportati)
  2. Nella schermata di pagamento, attiva l'opzione Ordine Telefonico
  3. Clicca su Raccogli Pagamento con Carta — il lettore mostrerà una schermata di inserimento numero di carta invece di richiedere un tocco/inserimento
  4. Inserisci il numero della carta del cliente, la scadenza e il CVV nel lettore
  5. Il pagamento viene elaborato normalmente da lì
consiglio

I pagamenti MOTO utilizzano card come tipo di metodo di pagamento anziché card_present. Ciò significa che vengono trattati più come transazioni online dal punto di vista di Stripe, quindi si applicano le normali commissioni di elaborazione delle carte online anziché le tariffe in persona.

attenzione

Il toggle Ordine Telefonico appare solo quando sono soddisfatte tutte e tre le condizioni: l'impostazione MOTO è abilitata nelle impostazioni del plugin, un lettore compatibile è collegato e il lettore non è un simulatore. Se non vedi il toggle, controlla queste condizioni.

Requisiti​

Account Stripe: Account Stripe attivo con Terminal abilitato
Chiavi API: Chiave segreta Stripe dal tuo dashboard
WCPOS: Versione Pro richiesta per il checkout POS
HTTPS: Il tuo sito deve utilizzare SSL/HTTPS per la sicurezza

Compatibilità Hardware​

Requisiti di Connettività

Questa implementazione utilizza l'SDK JavaScript di Stripe, il che significa che funziona attraverso le applicazioni web ma richiede solo terminali con connessione a internet. I terminali Bluetooth non sono attualmente supportati.

Terminali Supportati (Internet-Connessi)​

  • Lettore Stripe 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
Supporto Futuro

Il supporto per i terminali Bluetooth sarà aggiunto alle applicazioni iOS e Android nel Q1 2026. Ciò abiliterà il supporto per tutti i lettori certificati Terminal Stripe, incluso il M2 e l'WisePad 3.

Problemi Comuni​

Il lettore non si connette
  • Assicurati di utilizzare un terminale connesso a internet supportato
  • Verifica che il terminale sia connesso a WiFi/Ethernet e online
  • Controlla che il tuo account Stripe abbia il Terminal abilitato
  • Conferma che il terminale sia registrato nel tuo Dashboard Stripe
Pagamento rifiutato
  • Verifica che il tuo account Stripe sia attivo e in buono stato
  • Accertati che la carta utilizzata sia valida
  • Assicurati che ci siano fondi sufficienti disponibili
Il toggle Ordine Telefonico non viene visualizzato
  • Verifica che l'impostazione Ordini Telefonici (MOTO) sia abilitata in WooCommerce > Impostazioni > Pagamenti > Stripe Terminal
  • Assicurati di essere connesso a un lettore compatibile (vedi Terminali Supportati) — il toggle è nascosto per altri tipi di lettore
  • Il toggle non appare quando si utilizza il simulatore
Il pagamento MOTO fallisce con un errore
  • Conferma che Stripe abbia abilitato i permessi MOTO sul tuo account — contatta il supporto di Stripe se non l'hai già fatto
  • Ricontrolla che i dettagli della carta siano stati inseriti correttamente nel lettore
  • I pagamenti MOTO possono avere controlli antifrode più rigorosi — assicurati che la carta sia valida e abbia fondi sufficienti
Errori di certificato SSL
  • Stripe Terminal richiede HTTPS - assicurati che il tuo sito abbia un certificato SSL valido
  • Controlla che il tuo certificato SSL sia configurato correttamente

Ottenere Aiuto​

Per supporto tecnico:

Screenshot​

Gli screenshot saranno aggiunti in un aggiornamento futuro per mostrare:

  • Configurazione del gateway nelle impostazioni di pagamento di WooCommerce
  • Interfaccia di checkout del POS con selezione di Stripe Terminal
  • Interfaccia di test del simulatore con vari metodi di pagamento