Salta al contenuto principale
Versione: 1.x

Gateway Terminal Stripe

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

Caratteristiche​

  • Integrazione Hardware: Collega i lettori fisici Stripe Terminal tramite connessione internet
  • Modalità Simulatore: Testa i pagamenti senza hardware utilizzando il simulatore di Stripe
  • Metodi di Pagamento Multipli: Supporto per vari tipi di carte e metodi di pagamento
  • Elaborazione in Tempo Reale: Elaborazione e conferma immediata dei pagamenti
  • Transazioni Sicure: Elaborazione dei pagamenti conforme PCI tramite Stripe
  • SDK Web-based: Utilizza l'SDK JavaScript di Stripe per la compatibilità con le applicazioni web

Installazione​

Passo 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

Passo 2: Configura le Impostazioni di 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 di Stripe (puoi ottenerla dal tuo Dashboard di 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.

Passo 3: Abilita in WooCommerce POS​

  1. Vai su WP Admin > WooCommerce 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​

Collegare un Lettore​

Quando selezioni il gateway Terminal Stripe 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 termine del pagamento

Test 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 Contactless: 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 di Stripe dal tuo dashboard
  • WooCommerce POS: Versione gratuita o Pro installata e attivata
  • 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 tramite applicazioni web ma richiede terminali connessi a internet solamente. I terminali Bluetooth non sono attualmente supportati.

Terminali Supportati (Connessi a Internet)​

  • Lettore Stripe S700 ✅ - 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. Questo abiliterà il supporto per tutti i lettori certificati da Stripe Terminal, inclusi M2 e WisePad 3.

Risoluzione dei Problemi​

Problemi Comuni​

Il Lettore Non Si Collega

  • Assicurati di utilizzare un terminale connesso a internet supportato (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 di 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 di Certificato SSL

  • Il Terminal Stripe 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:

Schermate​

Le schermate verranno aggiunte in un futuro aggiornamento per mostrare:

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