Salta al contenuto principale
Versione: 1.x

Gateway Stripe Terminal

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

Caratteristiche​

Integrazione Hardware

Collega lettori Stripe Terminal fisici 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 PCI tramite Stripe

Installazione​

1

Scarica e Installa

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

Configura le Impostazioni Stripe

  1. Naviga su 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 Stripe Terminal nelle impostazioni di WooCommerce. Verrà abilitato specificamente per il POS nel passaggio successivo.

3

Abilita in WCPOS

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

Utilizzo​

Connessione di un Lettore​

Quando scegli il gateway Stripe Terminal durante il checkout nel POS:

  1. Scegli Metodo di Connessione: Puoi collegare un lettore fisico o utilizzare il simulatore
  2. Lettore Fisico: Segui le istruzioni sullo schermo per collegare il tuo dispositivo Stripe Terminal
  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 Gateway: Scegli "Stripe Terminal" come metodo di pagamento
  3. Collega Lettore: Collega il tuo lettore o scegli la modalità simulatore
  4. Elabora Pagamento: Segui le istruzioni per completare la transazione
  5. Conferma: L'ordine sarà automaticamente completato al momento del pagamento riuscito

Testare con il Simulatore​

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

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

Requisiti​

Account Stripe: Account Stripe attivo con Terminal abilitato
Chiavi API: Chiave segreta Stripe dal tuo dashboard
WCPOS: La 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 il SDK JavaScript di Stripe, il che significa che funziona tramite applicazioni web ma richiede terminali solo connessi a internet. I terminali Bluetooth non sono attualmente supportati.

Terminali Supportati (Connessi a Internet)​

  • Lettore Stripe S700 ✅ - Terminale connesso tramite Ethernet/WiFi
  • WisePOS E ✅ - Terminale connesso tramite 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 terminali Bluetooth sarà aggiunto alle applicazioni iOS e Android nel Q1 2026. Questo abiliterà il supporto per tutti i lettori certificati Stripe Terminal, inclusi M2 e WisePad 3.

Problemi Comuni​

Il lettore non si connette
  • Assicurati di utilizzare un terminale supportato connesso a internet (S700 o WisePOS E)
  • 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
  • Controlla che il tuo account Stripe sia attivo e in regola
  • Verifica che la carta utilizzata sia valida
  • Assicurati che siano disponibili fondi sufficienti
Errori certifcato SSL
  • Stripe Terminal richiede HTTPS - assicurati che il tuo sito disponga di un certificato SSL valido
  • Controlla che il tuo certificato SSL sia configurato correttamente

Richiesta di Aiuto​

Per supporto tecnico:

Screenshot​

Gli screenshot saranno aggiunti in un futuro aggiornamento per mostrare:

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