Gateway per terminali Windcave
Il gateway per terminali Windcave consente di accettare pagamenti con carta in presenza su un terminale Windcave tramite Windcave HIT. I pagamenti vengono avviati da WCPOS e completati sul terminale; la conferma viene registrata nell'ordine WooCommerce.
La versione 0.1.0 è la prima release. Windcave richiede la certificazione QA di un'integrazione prima dell'uso in produzione e questa integrazione non è ancora certificata. Usala con credenziali Windcave UAT (test) fino al completamento della certificazione. Windcave assegna il Vendor ID durante la certificazione.
Funzionalità
Connessione HIT cloud
Connettiti tramite il servizio HIT cloud di Windcave, con uno Station ID per terminale e senza associazione locale
Istruzioni del terminale sullo schermo
Segui le istruzioni e usa i pulsanti del terminale dal pannello di pagamento, inclusi YES/NO per la verifica della firma e CANCEL
Completamento verificato
Gli ordini vengono completati solo dopo aver verificato il riferimento del pagamento, l'importo, l'ambiente, il totale dell'ordine e la valuta
Metti da parte un pagamento
Dopo un timeout, metti da parte il pagamento in attesa e continua mentre un controllo in background ne verifica lo stato
Notifiche dei risultati
Attiva le notifiche facoltative dei risultati (FPRN), così Windcave può avvisare il tuo sito come meccanismo di riserva rispetto al polling
Come funziona
Il gateway usa Windcave HIT (Host Initiated Transaction) su HTTPS. Environment seleziona l'endpoint UAT o di produzione e ogni terminale è identificato dal relativo Station ID assegnato da Windcave.
L'avvio di un pagamento invia al terminale il totale completo dell'ordine e la valuta. La pagina di pagamento interroga Windcave ogni 1.5 secondi, mostrando le istruzioni e i pulsanti disponibili sul terminale. Le Result notifications (FPRN) facoltative consentono a Windcave di avvisare il sito come meccanismo di riserva rispetto al polling.
Configurazione
Installa Windcave Terminal for WooCommerce
Scarica il file zip del plugin (non lo zip del codice sorgente GitHub) dalla pagina delle release GitHub. Caricalo tramite Plugin > Aggiungi Nuovo > Carica plugin e attivalo dopo aver installato e attivato WooCommerce.
Per l'attivazione sono necessari PHP 7.4+ e l'estensione PHP DOM (php-xml). Se ne manca una, l'attivazione viene rifiutata con un messaggio.
Ottieni le credenziali HIT da Windcave
Richiedi a Windcave un HIT username, una HIT key e uno Station ID per ogni terminale. Richiedi un account di sviluppo tramite il modulo dei requisiti di integrazione di Windcave.
Le credenziali UAT e di produzione sono separate. Usa le credenziali UAT mentre l'integrazione è in attesa di certificazione.
Configura il gateway
- Vai a
WP Admin > WooCommerce > Impostazioni > Pagamentie apri Windcave Terminal - Imposta Environment su
UAT (testing)(impostazione predefinita).Productionè da usare dopo la certificazione Windcave e con credenziali di produzione - Inserisci HIT username e HIT key forniti da Windcave
- Inserisci gli Station IDs, uno per riga
- (Facoltativo) Imposta un Default Station ID. Attiva Lock terminal selection per usare sempre quello predefinito e impedire ai cassieri di modificarlo
- Lascia vuoto Vendor ID finché Windcave non ne assegna uno durante la certificazione
- Salva le impostazioni
Attiva le notifiche dei risultati (facoltativo)
Attiva Result notifications (FPRN) e salva per chiedere a Windcave di avvisare il tuo sito quando è disponibile il risultato di una transazione. È un meccanismo di riserva rispetto al polling.
Attiva in WCPOS
- Vai a
WP Admin > POS > Impostazioni > Pagamento - Trova il gateway Windcave Terminal e attivalo per il POS
- Salva le impostazioni
La casella Enable/Disable nella schermata delle impostazioni WooCommerce controlla solo il checkout del negozio online. WCPOS usa questo gateway una volta configurato, indipendentemente dal fatto che la casella sia selezionata.
Riferimento delle impostazioni
| Impostazione | Funzione |
|---|---|
| Enable/Disable | Attiva il gateway per il checkout del negozio online. L'attivazione nel POS si gestisce in POS > Impostazioni > Pagamento |
| Title | Etichetta del checkout; predefinita: Windcave Terminal |
| Description | Descrizione del checkout; predefinita: Pay in person on the Windcave terminal. |
| Environment | UAT (testing) (predefinito) o Production. Ognuno usa credenziali HIT separate; per la produzione è necessaria la certificazione Windcave |
| HIT username | Nome utente HIT fornito da Windcave per l'ambiente selezionato |
| HIT key | Chiave HIT fornita da Windcave per l'ambiente selezionato |
| Station IDs | Uno Station ID fornito da Windcave per riga, uno per ogni terminale |
| Default Station ID | Station preselezionata, usata anche quando non ne viene selezionata una |
| Lock terminal selection | Usa sempre la Station predefinita, impedendo ai cassieri di modificarla. Ha effetto solo se è impostata una Station predefinita |
| Vendor ID | Assegnato da Windcave durante la certificazione. Lascialo vuoto finché Windcave non te lo fornisce |
| POS name | Nome inviato a Windcave per identificare il POS; predefinito: WCPOS |
| Result notifications (FPRN) | Chiede a Windcave di avvisare il sito quando è disponibile il risultato di una transazione, come meccanismo di riserva rispetto al polling. Disattivato per impostazione predefinita |
| Checkout logs | Mostra gli strumenti di registrazione nel pannello di pagamento. Disattivato per impostazione predefinita |
| Log level | Off, Errors only o Debug. Predefinito: Debug; registra richieste e risposte mascherando le chiavi e i dati delle carte |
| Support | Fornisce Download support bundle e un link per visualizzare i log in WooCommerce > Status > Log |
Non è disponibile un pulsante per testare la connessione: le credenziali e gli Station ID vengono verificati al primo pagamento.
Utilizzo
Elaborazione dei pagamenti
- Add Items: aggiungi prodotti al carrello nel POS
- Select Gateway: scegli Windcave Terminal come metodo di pagamento
- Choose Terminal: seleziona una Station o usa quella predefinita bloccata. La selezione è obbligatoria se ci sono due o più Station e non è impostata una predefinita
- Start Payment: fai clic su Start Terminal Payment per inviare il totale dell'ordine al terminale
- Follow Prompts: sullo schermo vengono mostrate le istruzioni e i pulsanti disponibili sul terminale, inclusi YES/NO per la verifica della firma e CANCEL quando disponibile
- Automatic Completion: dopo l'approvazione e la verifica, l'ordine viene completato e il POS passa alla ricevuta
Controlli del pagamento
- Start Terminal Payment: invia una nuova richiesta di pagamento alla Station selezionata
- Cancel Terminal Payment: preme il pulsante CANCEL del terminale quando è disponibile. In caso contrario, annulla il pagamento sul terminale o mettilo da parte quando compare l'opzione
- Set payment aside: compare dopo il timeout di 5 minuti. Affida il tentativo a un controllo in background di 10 minuti, così puoi accettare il pagamento in un altro modo; non annulla il pagamento su Windcave
- Ricaricare la pagina: riprende un pagamento già in corso
Ricevute
Il testo della ricevuta del terminale, se restituito da Windcave, viene salvato come nota privata dell'ordine in WooCommerce.
Rimborsi
I rimborsi da WooCommerce non sono supportati nella versione 0.1.0. Esegui il rimborso dal portale Windcave (Payline) o dal terminale, poi registra il rimborso in WooCommerce manualmente.
Log e pacchetto di supporto
Trova i log in WooCommerce > Status > Log, con origine windcave-terminal. Il livello di log predefinito è Debug e registra richieste e risposte Windcave, mascherando chiavi e dati delle carte.
Fai clic su Download support bundle nella schermata delle impostazioni del gateway per scaricare un file .json e invialo insieme al numero dell'ordine. Contiene dettagli dell'ambiente, impostazioni con chiave HIT e nome utente mascherati, tentativi di pagamento per un massimo di 20 ordini recenti senza le ricevute e le ultime 1,000 righe dei due file di log più recenti; le righe di log possono includere il testo delle ricevute del terminale con i numeri delle carte mascherati.
Se WooCommerce usa il gestore dei log nel database, il pacchetto non contiene righe di log. Esporta invece i log da WooCommerce > Status > Log.
Attiva Checkout logs per mostrare gli strumenti di registrazione nel pannello di pagamento.
Requisiti
Ambito e limitazioni
Questa integrazione non è ancora certificata da Windcave. Usa credenziali UAT fino al completamento della certificazione QA Windcave; non usarla in produzione prima della certificazione.
- I rimborsi da WooCommerce non sono supportati nella versione 0.1.0
- Mance, supplementi e prelievi di contanti non sono supportati
- Sono supportate solo valute con due decimali
- Al terminale viene addebitato il totale completo dell'ordine; non è possibile pagare solo una parte dell'ordine sul terminale
- Gli Station IDs vengono inseriti manualmente; i terminali non vengono rilevati automaticamente
- Il gateway è progettato per il POS. Nel negozio online funziona solo nella pagina order-pay
Risoluzione dei problemi
Problemi comuni
Attivazione rifiutata: è necessaria l'estensione PHP DOM (php-xml)
- Sul server manca l'estensione PHP DOM
- Chiedi al tuo hosting di abilitare php-xml. Per l'attivazione è necessario anche PHP 7.4+
Nessuno Station ID configurato
- L'impostazione Station IDs è vuota
- Aggiungi nelle impostazioni del gateway gli Station ID forniti da Windcave, uno per riga, e salva
Credenziali HIT Windcave non configurate
- HIT username o HIT key è vuoto
- Inseriscili entrambi nelle impostazioni del gateway e salva. Verifica che Environment corrisponda a queste credenziali
Il terminale sta ancora completando una transazione precedente
- È ancora in corso una transazione precedente su quella Station
- Completa o annulla la transazione sul terminale, quindi riprova
Windcave non ha registrato questa transazione
- Windcave non ha ancora registrato la transazione dopo il periodo di tolleranza iniziale di 30 secondi
- Avvia di nuovo il pagamento
Windcave ha approvato un pagamento, ma non è stato possibile applicarlo
- Il risultato approvato non ha superato i controlli necessari per completare quest'ordine
- Controlla il portale Windcave e le note dell'ordine prima di addebitare di nuovo
Questo pagamento è stato avviato in un ambiente diverso
- Environment è stato modificato mentre il pagamento era in corso
- Torna all'ambiente in cui è stato avviato il pagamento oppure controlla il portale Windcave
Richiedere assistenza
- Invia il pacchetto di supporto dalla schermata delle impostazioni del gateway insieme al numero dell'ordine
- Visita il repository GitHub per segnalare problemi
- Contatta il supporto Windcave per domande su account, credenziali e hardware