Gateway di pagamento Windcave Terminal
Windcave Terminal invia una vendita dalla cassa a un terminale Windcave. Il cliente paga sul terminale e la cassa registra il pagamento quando Windcave lo conferma.
Questa pagina parte dalla cassa. Amministratori del negozio: Configurare Windcave Terminal spiega le credenziali, le impostazioni in WP Admin e come verificare che tutto funzioni.
Windcave Terminal richiede WCPOS Pro 2.0 o successivo e la versione 1.0 o successiva dell'estensione.
Solo pagamenti di prova: non accettare ancora pagamenti reali con la carta di un cliente su Windcave. Windcave approva ogni integrazione per i punti vendita prima che accetti pagamenti reali e questa non è ancora stata approvata. L'estensione non è ancora stata usata su un terminale Windcave fisico. I pagamenti e i rimborsi sono stati testati con un servizio sostitutivo di Windcave HIT, realizzato sulla base della documentazione Windcave. Esegui una piccola vendita UAT e rimborsala prima di fare affidamento sull'estensione.Cosa non è stato testato
Accettare un pagamento con carta
Se Apri e chiudi la cassa è attivo, la cassa non registra un pagamento quando è chiusa e un pagamento con carta già incassato dovrà essere rimborsato. Per l'impostazione, vedi Casse.
- Premi Cassa nel carrello e tocca il riquadro Windcave Terminal nella scheda Pagamenti. Se i terminali richiedono una firma, usa invece la scheda Tradizionale: vedi Quando il terminale pone una domanda.
- Guarda sopra il tastierino. Se vedi Scegli un terminale, tocca l'ID stazione del terminale al tuo banco: il nome assegnato da Windcave a ciascun terminale, ad esempio
DOCS-STATION-1. Se vedi Terminale: seguito da un ID, quello è il terminale usato da questa cassa; premi Cambia per sceglierne un altro. La cassa ricorda la selezione. - Per addebitare sulla carta solo una parte del saldo, inserisci l'importo. Il resto rimane da pagare con un altro pagamento.
- Premi Invia … a Windcave Terminal. La cassa mostra Sul terminale con quattro passaggi: Inviato, Sul terminale, Approvato e Acquisito, che indica che il pagamento è stato incassato.
- Il cliente avvicina, inserisce o striscia la carta sul terminale. Quando il pagamento è acquisito e non resta nulla da pagare, si apre la ricevuta. Se resta un importo, incassalo con un altro riquadro.

- Windcave Terminal — il riquadro, contornato dopo averlo toccato.
- ID stazione sotto Scegli un terminale — tocca quello al tuo banco. Dopo averne selezionato uno per questa cassa, la riga mostra Terminale: e il relativo ID, insieme a Cambia.
- Da pagare — l'importo di questo pagamento. Inserisci un importo inferiore per addebitare sulla carta solo una parte del saldo.
- Saldo completo — riporta in Da pagare l'intero importo ancora dovuto.
- Invia … a Windcave Terminal — avvia il pagamento sul terminale. È disattivato finché non viene scelto un terminale.
- Tradizionale — l'altra scheda di pagamento, per i gateway con una propria pagina di pagamento. Usala se il terminale richiede una firma.
Dettagli, sotto i quattro passaggi, apre il registro del pagamento e mostra la stazione a cui è stato inviato. Il terminale non supporta mance, supplementi o prelievi di contante.
Quando il terminale pone una domanda
Un terminale può fermarsi e chiedere qualcosa, ad esempio se la firma del cliente corrisponde. In questa versione la scheda Pagamenti non mostra queste domande. La scheda Tradizionale invece le mostra:
- Apri la scheda Tradizionale e scegli Windcave Terminal. Vedi La scheda Tradizionale.
- Avvia il pagamento da lì. L'importo dell'intero ordine viene riscosso in un'unica operazione.
- Quando il terminale pone una domanda, la pagina di pagamento la mostra insieme ai pulsanti del terminale, ad esempio SÌ e NO. Premi la risposta desiderata.
Annullare un pagamento
Premi Annulla sul terminale prima che il cliente paghi. Funziona solo mentre il terminale offre l'opzione ANNULLA. In caso contrario, la cassa mostra Il terminale non offre l'opzione di annullamento in questo momento. Annulla sul terminale.
L'annullamento è una richiesta. Se la carta è già stata letta, il pagamento potrebbe comunque andare a buon fine: la cassa mostra Annullamento in corso — in attesa di conferma dal terminale, continua a controllare e mostra l'esito. Attendi prima di riscuotere il pagamento con un altro metodo.
Se la cassa non riesce a ottenere una risposta, propone Rilascia questo pagamento. Il rilascio non equivale all'annullamento: premi il pulsante solo dopo che un responsabile ha controllato il portale Windcave e verificato che non risulti alcun pagamento approvato per l'ordine. A quel punto l'ordine può essere pagato con un altro metodo, mentre il negozio continua a controllare il terminale.
Se qualcosa va storto
Quando il cliente potrebbe aver pagato
In questi due casi la carta potrebbe essere già stata addebitata. Un responsabile deve prima controllare il portale Windcave, dove la vendita è elencata con il numero dell'ordine.
Impossibile confermare l'esito del terminale. Controlla Windcave prima di riscuotere di nuovo il pagamento. La cassa ha ripetuto la richiesta per un pagamento già inviato, ma la risposta di Windcave non era chiara. Riscuoti di nuovo il pagamento solo dopo che un responsabile ha cercato la vendita nel portale e ha verificato che non sia presente.
Pagamento non riuscito: il terminale ha confermato un importo diverso. Il terminale ha approvato un importo diverso da quello inviato dalla cassa, che quindi non l'ha registrato, ma la carta potrebbe essere stata addebitata. Non riscuotere un altro pagamento: chiedi a un responsabile di trovare la vendita nel portale usando il numero dell'ordine e confrontare l'importo addebitato dal terminale con quello dell'ordine.
Altri messaggi
Pagamento non riuscito: carta rifiutata
Premi Riprova per inviarlo di nuovo al terminale oppure Scegli un altro metodo per pagare con un altro riquadro.
Il terminale sta ancora completando una transazione precedente
La stazione è occupata con un altro pagamento. Completa o annulla l'operazione sul terminale, poi premi Riprova.
Il pagamento non riesce subito dopo l'invio
L'estensione attende 30 secondi che Windcave registri un nuovo pagamento. Se entro questo tempo Windcave non lo registra, l'estensione lo considera non inviato e il pagamento non va a buon fine. Verifica che il terminale sia acceso e online e che il suo ID stazione sia nelle impostazioni, poi premi Riprova.
Il terminale pone una domanda e la cassa continua ad attendere
La scheda Pagamenti non mostra le domande del terminale, quindi attende che il pagamento termini. Premi Annulla sul terminale oppure annulla direttamente sul terminale, poi riscuoti il pagamento dalla scheda Tradizionale. Vedi Quando il terminale pone una domanda.
Tempo scaduto — pagamento annullato
Nessuno ha pagato entro 5 minuti. Controlla il terminale, poi premi Riprova.
Il riquadro Windcave Terminal è disattivato o non è presente
Sotto i riquadri, la cassa indica il motivo. Per tutti i motivi possibili, vedi Quando non è possibile usare un riquadro.
- In uso per l'ordine #… — la stazione è occupata con il pagamento di un altro ordine. Completa o annulla quel pagamento, oppure premi Cambia e scegli un'altra stazione.
- Richiede una connessione — la cassa è offline. Un pagamento con terminale passa dal negozio, quindi usa un altro tipo di pagamento o attendi che la connessione sia ripristinata.
- Nessun riquadro — al gateway mancano Nome utente HIT, Chiave HIT o ID stazione, oppure non è attivato in WCPOS. Un responsabile deve controllare la configurazione.
Rimborsare un pagamento Windcave
Il rimborso passa da Windcave e torna alla stazione che ha riscosso la vendita, per l'intero importo o solo una parte.
- Nel POS, apri il rimborso dell'ordine. Vedi Rimborsi.
- Scegli Rimborso su Windcave Terminal e premi Elabora rimborso.
- Il negozio attende fino a 20 secondi la risposta di Windcave, poi aggiunge l'esito alle note dell'ordine.
Anche un rimborso in WP Admin, effettuato con il pulsante WooCommerce Rimborsa … tramite Windcave Terminal, funziona allo stesso modo.
Se lo stato del rimborso rimane In attesa di pagamento, controllalo nel portale Windcave prima di riprovare.
Un rimborso rimane in attesa
Windcave non ha risposto entro 20 secondi oppure ha approvato un importo diverso da quello richiesto. Il negozio non riprova. Cerca il rimborso nel portale Windcave: se è andato a buon fine, il cliente ha ricevuto il denaro; altrimenti, esegui di nuovo il rimborso.
Impossibile rimborsare una vendita effettuata con la versione 0.1
Il rimborso si interrompe con Configura una stazione predefinita nelle impostazioni POS prima di rimborsare questa vendita. La versione 0.1 dell'estensione non registrava quale stazione avesse riscosso la vendita, quindi la versione 1.0 la rimborsa usando una stazione predefinita per l'intero negozio. Ora le casse scelgono la propria stazione in Impostazioni > Lettori di carte, ma WCPOS 2.0 non ha ancora un'impostazione predefinita per l'intero negozio. Rimborsa la vendita nel portale Windcave o sul terminale, poi registrala in WooCommerce con Rimborsa … manualmente.
Configurare Windcave Terminal
Un amministratore esegue questa operazione una volta per negozio in WP Admin, poi seleziona una stazione su ciascuna cassa. Il negozio raggiunge ogni terminale tramite Windcave su internet, quindi non è necessario associarli e ogni cassa può usare qualsiasi terminale del negozio.
Requisiti
Servono le credenziali HIT, ovvero un Nome utente HIT e una Chiave HIT, nonché l'ID stazione di ciascun terminale. Windcave fornisce tutte queste credenziali; WP Admin non può recuperarle né crearle. Contatta Windcave e chiedi le credenziali HIT UAT e l'ID stazione di ogni terminale, oppure usa il modulo dei requisiti di integrazione di Windcave per un account di sviluppo. UAT e produzione hanno ciascuno un proprio nome utente e una propria chiave; Windcave rilascia un ID fornitore quando certifica l'integrazione.
Installare l'estensione
Apri WP Admin > POS > Impostazioni > Estensioni, trova Windcave Terminal for WooCommerce, installala e attivala. È necessaria la versione 1.0 o successiva; la versione 0.1 è per WCPOS precedente alla 2.0. Vedi Estensioni.
Puoi anche caricare lo zip del plugin (non lo zip del codice sorgente) dalla pagina delle release su GitHub, seguendo Plugin > Add Plugin > Carica plugin.
Senza WCPOS Pro 2.0, WP Admin mostra Windcave Terminal richiede WooCommerce POS Pro 2.0 o successivo. e il gateway non viene aggiunto. L'attivazione viene rifiutata se PHP è precedente alla versione 7.4 o se manca l'estensione DOM: chiedi al tuo hosting di abilitare php-xml.
Inserire le credenziali HIT
Vai a WP Admin > WooCommerce > Impostazioni > Pagamenti e apri Windcave Terminal.

- Ambiente — lascia UAT (test), il valore predefinito. Produzione si usa dopo che Windcave ha certificato l'integrazione e con credenziali di produzione.
- Nome utente HIT — fornito da Windcave per l'ambiente scelto.
- Chiave HIT — fornita da Windcave. Dopo il salvataggio, il campo rimane vuoto: lascialo vuoto per mantenere la chiave salvata.
- ID stazione — uno per riga, uno per terminale. Li fornisce Windcave; non vengono rilevati automaticamente.
- ID fornitore — lascialo vuoto finché Windcave non ne fornisce uno.
- Nome POS — il nome del POS presso Windcave. Per impostazione predefinita,
WCPOS.
Sotto, Notifiche dell'esito (FPRN) è facoltativo. Se selezionato, Windcave comunica al negozio quando un esito è pronto, come verifica aggiuntiva rispetto ai controlli della cassa. Per funzionare, il sito deve essere raggiungibile da internet.
Fai clic su Salva modifiche.
Attivarlo in WCPOS
Vai a WP Admin > POS > Impostazioni > Pagamento, trova Windcave Terminal nella tabella Gateway di pagamento e attiva Abilitato. Questa schermata salva automaticamente le modifiche; non c'è un pulsante Salva.
Lascia disattivata l'opzione Abilita/Disabilita nella pagina delle impostazioni WooCommerce. Il POS usa il gateway quando qui è attivo Abilitato, indipendentemente dalla casella. Vedi Impostazioni di cassa.

- Windcave Terminal — la riga dell'estensione nella tabella Gateway di pagamento.
- Abilitato — l'interruttore accanto all'ID del gateway; attivalo. Dopo il ricaricamento, la cassa mostra il riquadro Windcave Terminal.
Scegliere la stazione per ogni cassa
Su ciascuna cassa, apri Impostazioni > Lettori di carte. Ogni ID stazione inserito è elencato come lettore sotto Lettori intelligenti e contrassegnato Online: l'estensione non chiede a Windcave se il terminale è acceso. Premi Usa questo lettore sulla stazione al banco; la riga mostra Selezionato. Il cassiere può ancora premere Cambia al momento del pagamento.
Se c'è una sola stazione, non devi scegliere: è già Selezionato su ogni cassa. Vedi Scegliere un lettore intelligente.
Verificare che funzioni
- Nella pagina delle impostazioni Windcave Terminal, la riga sotto le impostazioni mostra
uat: HIT credentials configured (not verified).Significa che nome utente e chiave sono salvati, non che Windcave li abbia accettati.HIT credentials missing.indica che uno dei due è vuoto. - Su una cassa, ricarica il POS e premi Cassa. Tra i metodi di pagamento è presente il riquadro Windcave Terminal. Toccalo: gli ID stazione compaiono sopra il tastierino, sotto Scegli un terminale oppure come Terminale: con l'ID usato da questa cassa.
- Esegui una piccola vendita su un terminale UAT, poi rimborsala. Non c'è un pulsante per testare la connessione: questa prima vendita verifica le credenziali e l'ID stazione.
Aggiornare dalla versione 0.1
- Aggiorna prima WCPOS, WCPOS Pro e l'app alla versione 2.0, poi aggiorna l'estensione.
- Un pagamento in corso durante l'aggiornamento viene mantenuto. Non viene addebitato due volte.
- Un pagamento accantonato dalla versione 0.1 viene mantenuto se l'ordine non è ancora stato pagato. In caso contrario, all'ordine viene aggiunta una nota: Windcave TxnRef … era stato accantonato prima dell'aggiornamento alla versione 1.0.0 e non viene più seguito automaticamente. Controlla il pagamento nel portale Windcave: se è stato approvato, rimborsalo lì oppure registralo manualmente nell'ordine.
- Queste impostazioni della versione 0.1 non sono più disponibili: ID stazione predefinito, Blocca selezione del terminale, Log di cassa e Livello di log. Ora le casse scelgono la propria stazione in Impostazioni > Lettori di carte.
- Anche l'opzione di accantonamento non è più disponibile e il testo della ricevuta del terminale non viene più aggiunto all'ordine come nota privata.
- Per rimborsare una vendita effettuata con la versione 0.1, vedi Rimborsare un pagamento Windcave.
Riferimento delle impostazioni
In WP Admin > WooCommerce > Impostazioni > Pagamenti > Windcave Terminal:
| Impostazione | Funzione |
|---|---|
| Abilita/Disabilita | Offre il gateway nella pagina di pagamento del negozio online. Lascialo disattivato: il POS ha il proprio interruttore in POS > Impostazioni > Pagamento |
| Titolo | Il nome del riquadro alla cassa. Per impostazione predefinita è Windcave Terminal |
| Descrizione | Per impostazione predefinita è Pay in person on the Windcave terminal. |
| Ambiente | UAT (test) (predefinito) o Produzione. Ciascun ambiente ha credenziali HIT distinte; per la produzione è necessaria la certificazione Windcave. Un pagamento avviato in un ambiente viene sempre controllato in quello stesso ambiente |
| Nome utente HIT | Rilasciato da Windcave per l'ambiente scelto |
| Chiave HIT | Fornita da Windcave. Dopo il salvataggio non viene più mostrata; lasciala vuota per mantenerla |
| ID stazione | Uno per riga e uno per terminale. I duplicati vengono rimossi |
| ID fornitore | Concordato con Windcave durante la certificazione. Lascialo vuoto fino a quel momento |
| Nome POS | Il nome con cui il tuo POS è identificato presso Windcave. Il valore predefinito è WCPOS |
| Notifiche dell'esito (FPRN) | Windcave comunica anche al negozio quando un esito è disponibile, come ulteriore verifica oltre ai controlli della cassa. Disattivate per impostazione predefinita |
Log e pacchetto per l'assistenza
In fondo alla pagina delle impostazioni si trovano il pacchetto di assistenza, la riga delle credenziali e un link ai log.

- Riga delle credenziali — in questo negozio non configurato mostra
HIT credentials missing.. Dovrebbe mostrareHIT credentials configured (not verified).. - Visualizza log — apre
WooCommerce > Status > Log, sorgentewindcave-terminal. - Scarica pacchetto di assistenza — un file per l'assistenza WCPOS.
I log registrano ogni richiesta inviata a Windcave e la relativa risposta, oscurando la chiave HIT e i numeri delle carte.
Se un pagamento non va a buon fine, fai clic su Scarica pacchetto di assistenza e invia il file all'assistenza WCPOS insieme al numero dell'ordine. Questo pulsante è aggiunto da WCPOS Pro: il pacchetto include tutti i provider di pagamento POS del sito, rimuovendo segreti e numeri delle carte.
Funzionalità non supportate
- Pagamenti reali, finché Windcave non certifica l'integrazione.
- Mance, supplementi, prelievi di contante o autorizzazioni con acquisizione successiva.
- Rispondere alle domande del terminale nella scheda Pagamenti. Usa la scheda Tradizionale.
- Rilevamento automatico dei terminali: ogni ID stazione va inserito manualmente.
- Verificare le credenziali HIT prima del primo pagamento.
Come funziona, per gli sviluppatori
Il gateway usa Windcave HIT (Host Initiated Transaction) tramite HTTPS: uat.windcave.com per UAT e sec.windcave.com per la produzione. Ogni terminale è identificato dal proprio ID stazione.
Un pagamento invia una richiesta Purchase per l'importo indicato sulla cassa, usando Order # e il numero dell'ordine come riferimento commerciale; WCPOS Pro ne controlla poi lo stato fino al completamento. Se la cassa riprova, l'estensione interroga prima lo stesso riferimento della transazione, invece di avviare un'altra Purchase. Se Windcave non registra una Purchase entro 30 secondi, viene considerata non inviata.
Con Notifiche dell'esito (FPRN) attive, ogni Purchase chiede a Windcave di chiamare il webhook dei pagamenti WCPOS del negozio, wp-json/wcpos/v2/payments/webhook con provider=windcave e il riferimento della transazione. La chiamata è solo una notifica: il negozio chiede poi direttamente a Windcave l'esito.
Un rimborso è un Refund HIT abbinato alla transazione Windcave originale, per l'importo inserito. Il negozio ne controlla lo stato ogni 2 secondi per un massimo di 20 secondi.
Documentazione correlata
- Lettori di carte
- Scheda Tradizionale
- Rimborsi
- Impostazioni di cassa
- Segnala un problema su GitHub. Per account, credenziali e terminali, contatta Windcave.