# 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à[​](#features "Collegamento diretto a 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[​](#installation "Collegamento diretto a Installazione") 1 #### 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](https://github.com/wcpos/stripe-terminal-for-woocommerce/releases) e caricarlo tramite `Plugin > Aggiungi Nuovo > Carica plugin`. 2 #### Configurare le impostazioni di Stripe 1. Navigare a `WP Admin > WooCommerce > Impostazioni > Pagamenti` 2. Trovare **Stripe Terminal** nell'elenco dei metodi di pagamento 3. Fare clic su **Stripe Terminal** per accedere alle impostazioni 4. Inserire la propria **Stripe Secret Key** (è possibile ottenerla dalla Stripe Dashboard) 5. Salvare le impostazioni nota Non è necessario abilitare il gateway Stripe Terminal nelle impostazioni di WooCommerce. Verrà abilitato specificamente per il POS nel passaggio successivo. 3 #### Abilitazione in WCPOS 1. Andare su `WP Admin > POS > Impostazioni > Pagamento` 2. Trovare il gateway **Stripe Terminal** nell'elenco 3. Abilitare il gateway per l'utilizzo nel POS 4. Salvare le impostazioni ## Utilizzo[​](#usage "Collegamento diretto a Utilizzo") ### Connessione di un lettore[​](#connecting-a-reader "Collegamento diretto a Connessione di un lettore") Quando si seleziona il gateway Stripe Terminal durante il checkout nel POS: 1. **Scelta del metodo di connessione**: è possibile collegare un lettore fisico o utilizzare il simulatore 2. **Lettore fisico**: Seguire le istruzioni sullo schermo per collegare il dispositivo Stripe Terminal 3. **Simulatore**: Selezionare la modalità simulatore per testare vari scenari di pagamento senza hardware ### Elaborazione dei pagamenti[​](#processing-payments "Collegamento diretto a Elaborazione dei pagamenti") 1. **Aggiungere articoli**: Aggiungere i prodotti al carrello nel POS 2. **Selezionare il gateway**: Scegliere "Stripe Terminal" come metodo di pagamento 3. **Collegare il lettore**: Collegare il lettore o scegliere la modalità simulatore 4. **Elaborare il pagamento**: Seguire le indicazioni per completare la transazione 5. **Conferma**: L'ordine verrà automaticamente completato dopo l'avvenuto pagamento ### Test con il simulatore[​](#testing-with-simulator "Collegamento diretto a 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)[​](#phone-orders-moto "Collegamento diretto a 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[​](#setup "Collegamento diretto a Configurazione") 1 #### Richiedere l'accesso MOTO a Stripe MOTO non è abilitato per impostazione predefinita. Contattare il [supporto Stripe](https://support.stripe.com/contact) 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. 2 #### Abilitare nelle impostazioni del plugin 1. Navigare in `WP Admin > WooCommerce > Impostazioni > Pagamenti > Stripe Terminal` 2. Selezionare la casella **Ordini telefonici (MOTO)** 3. Salvare le impostazioni 3 #### Collegare un lettore compatibile MOTO funziona solo con lettori compatibili connessi a internet elencati in [Terminali supportati](#supported-terminals-internet-connected). L'opzione non verrà visualizzata per altri tipi di lettore. #### Ricevere un ordine telefonico[​](#taking-a-phone-order "Collegamento diretto a Ricevere un ordine telefonico") 1. Collegare un lettore compatibile (vedi [Terminali supportati](#supported-terminals-internet-connected)) 2. Nella schermata di pagamento, attivare l'opzione **Ordine telefonico** 3. Fare clic su **Riscuoti pagamento con carta** — il lettore mostrerà una schermata per l'inserimento del numero di carta anziché richiedere un avvicinamento/inserimento 4. Digitare sul lettore il numero di carta, la data di scadenza e il CVV del cliente 5. Da quel momento il pagamento viene elaborato normalmente consiglio 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. attenzione 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[​](#requirements "Collegamento diretto a Requisiti") Account Stripe : Account Stripe attivo con Terminal abilitato Chiavi API : Chiave segreta Stripe dalla propria dashboard WCPOS : Versione Pro necessaria per il checkout POS HTTPS : Il sito deve utilizzare SSL/HTTPS per la sicurezza ## Compatibilità hardware[​](#hardware-compatibility "Collegamento diretto a Compatibilità hardware") Requisiti di connettività 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)[​](#supported-terminals-internet-connected "Collegamento diretto a Terminali supportati (connessi a internet)") * **Stripe Reader S700/S710** ✅ - Terminale connesso via Ethernet/WiFi * **WisePOS E** ✅ - Terminale connesso via WiFi ### Terminali non supportati (Bluetooth)[​](#unsupported-terminals-bluetooth "Collegamento diretto a 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 è 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[​](#common-issues "Collegamento diretto a Problemi comuni") Il lettore non si connette * Assicurarsi di utilizzare un [terminale con connessione internet supportato](#supported-terminals-internet-connected) * 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](#supported-terminals-internet-connected)) — 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](https://support.stripe.com/contact) 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[​](#getting-help "Collegamento diretto a Assistenza") Per assistenza tecnica: * Visitare il [repository GitHub](https://github.com/wcpos/stripe-terminal-for-woocommerce) per segnalare problemi * Consultare la [documentazione di Stripe Terminal](https://stripe.com/docs/terminal) per indicazioni specifiche sull'hardware * Contattare il supporto Stripe per problemi relativi all'account ## Schermate[​](#screenshots "Collegamento diretto a 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