VibeFox Windcave for OpenCart — Guida

Requisiti

OpenCart: 3.0.x (testato su 3.0.5.0) o 4.0.2 e successive (testato su 4.1.0.3).

PHP: 8.0 o successivo.

Account Windcave: ti serve un account commerciante Windcave con credenziali REST API: un nome utente API e una chiave API. Windcave le rilascia separatamente per l'ambiente di test UAT (uat.windcave.com) e per la produzione (sec.windcave.com). Chiedile al supporto Windcave o al tuo account manager. Le chiavi PxPay non funzionano con questa estensione. I metodi di pagamento che vuoi offrire (carte, wallet e altri) devono essere abilitati nel tuo account Windcave.

Notifica: il tuo negozio deve essere raggiungibile da Internet, così che Windcave possa inviare la sua notifica di pagamento. Non c'è nulla da configurare in Windcave per questo.

Chiave di licenza VibeFox: acquistata su vibefox.net. Una chiave funziona su un dominio.

Installazione

Il download è un unico file zip con i pacchetti per entrambe le versioni di OpenCart. Decomprimilo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 wcp_windcave_payment_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_windcave_payment_gateway.ocmod.zip. Installa solo il pacchetto per la tua versione di OpenCart. La chiave di licenza è la stessa per entrambe le versioni.

OpenCart 3

1. Nell'area di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_windcave_payment_gateway-oc3-(version).ocmod.zip. L'estensione non ha modifiche OCMOD, quindi Extensions > Modifications non deve essere aggiornato. In alternativa all'installer puoi copiare il contenuto della cartella upload di questo pacchetto nella cartella radice del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Windcave Payment Gateway e clicca su Install (il pulsante verde +). Il tuo utente amministratore deve avere il permesso di modificare l'elenco delle estensioni di pagamento.

3. Clicca su Edit (il pulsante a matita) per aprire la pagina delle impostazioni. Inserisci la tua chiave di licenza VibeFox in License key, nel blocco della licenza in cima alla pagina, e clicca su Activate (vedi License key).

4. Inserisci il nome utente e la chiave della REST API: le credenziali UAT per la modalità test, le credenziali di produzione per i pagamenti reali (vedi Configuration).

5. Scegli il tipo di transazione e i metodi di pagamento, attiva Enable/Disable e clicca su Save. Effettua un pagamento di prova con Test mode attivo, poi disattiva Test mode per accettare pagamenti reali.

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_windcave_payment_gateway.ocmod.zip. Non rinominare il file: OpenCart 4 ricava il codice dell'estensione dal nome del file, e un pacchetto rinominato non funziona.

2. Il pacchetto compare nell'elenco delle estensioni installate nella stessa pagina. Clicca su Install (il pulsante verde +) accanto ad esso.

3. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Windcave Payment Gateway, clicca su Install (il pulsante verde +), poi su Edit (il pulsante a matita).

4. Inserisci la chiave di licenza, le credenziali REST API di Windcave e le impostazioni come nei passaggi da 3 a 5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni. Cambia solo l'indirizzo di notifica (vedi Windcave REST API).

Una nuova installazione parte con il metodo di pagamento disattivato.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Windcave Payment Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Con la modalità test attiva, la pagina mostra Test mode is on: payments go to the Windcave UAT environment and no real money is taken. Se il metodo di pagamento è abilitato ma la modalità corrente non ha nome utente o chiave API, la pagina avvisa che è nascosto al checkout, per esempio Windcave is enabled but the UAT API username / key are empty — the payment method is hidden at checkout. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non può essere vuoto e deve avere al massimo 128 caratteri (Enter a title for the payment method (at most 128 characters).), Sort Order deve essere un numero intero (Sort Order must be a whole number.), Total deve essere un numero maggiore o uguale a 0 (Total: enter a number, 0 or greater.), e la zona geografica e gli stati ordine selezionati devono esistere; altrimenti non viene salvato nulla e la pagina mostra l'errore.

Windcave

Enable/Disable: Enable Windcave payments attiva o disattiva il metodo di pagamento. Predefinito: off.

Title: il nome del metodo di pagamento che il cliente vede al checkout. È anche il nome salvato nell'ordine. Predefinito: Credit/Debit Card (Windcave). Obbligatorio, massimo 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: You will be redirected to the secure Windcave payment page to complete your payment.

Sort Order: la posizione di Windcave tra i metodi di pagamento al checkout. Lascia vuoto o inserisci un numero intero; sono ammessi numeri negativi.

Geo Zone: offri Windcave solo per gli indirizzi di pagamento nella zona geografica selezionata. Predefinito: All zones. Le zone geografiche si configurano in System > Localisation > Geo Zones.

Total: il totale del checkout, nella valuta predefinita del negozio, che un ordine deve raggiungere prima che venga offerto Windcave: un numero maggiore o uguale a 0. Lascia vuoto per offrirlo per qualsiasi totale.

Windcave REST API

Inserisci le credenziali REST API rilasciate da Windcave (nome utente e chiave API, non le chiavi PxPay). Le credenziali di produzione e quelle UAT possono essere salvate insieme. La modalità test usa solo le credenziali UAT, la modalità live usa solo quelle di produzione. La sezione rimanda alla documentazione della REST API di Windcave.

Test mode: usa l'ambiente di test UAT di Windcave (uat.windcave.com). Non viene addebitato denaro reale. I nuovi pagamenti usano le credenziali UAT. Rimborsi e catture vanno sempre nell'ambiente in cui l'ordine è stato pagato. Predefinito: off.

Production API username: il nome utente della REST API per sec.windcave.com.

Production API key: la chiave della REST API per sec.windcave.com.

UAT API username: il nome utente della REST API per uat.windcave.com (modalità test).

UAT API key: la chiave della REST API per uat.windcave.com (modalità test).

Le chiavi API salvate non vengono mai più mostrate. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo se vuoi cambiarlo. Per rimuovere una chiave salvata, spunta Clear the saved key on save sotto il campo e clicca su Save.

Notification URL: mostra l'indirizzo a cui Windcave invia la sua notifica di pagamento (Fail-Proof Result Notification). Viene costruito a partire dall'indirizzo della vetrina della tua installazione di OpenCart e ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_windcave_payment_gateway/notify su OpenCart 3 e https://your-store/index.php?route=extension/wcp_windcave_payment_gateway/payment/wcp_windcave_payment_gateway.notify su OpenCart 4. Non c'è nulla da configurare in Windcave: l'estensione invia i suoi indirizzi di ritorno e questo indirizzo di notifica con ogni sessione di pagamento. L'indirizzo deve essere raggiungibile da Internet, altrimenti gli ordini vengono confermati solo quando il cliente torna da Windcave. Né il ritorno del cliente né la notifica sono firmati da Windcave, quindi l'estensione non si fida mai di loro da sola: legge sempre il risultato della sessione dalla REST API di Windcave, con le credenziali dell'ambiente in cui la sessione è stata creata.

Payment

Transaction type: come viene effettuato il pagamento. Predefinito: Purchase.

Payment methods: i metodi mostrati nella pagina di pagamento Windcave: Cards, Account2Account (bonifico bancario neozelandese), Apple Pay, Google Pay, PayPal, Alipay, WeChat Pay, UnionPay, Interac, humm. Puoi selezionarne più d'uno. I metodi devono essere abilitati nel tuo account Windcave. Lascia vuoto il campo (Every method enabled on the account) per mostrare tutti i metodi abilitati nell'account. Predefinito: Cards.

Orders

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che Windcave ha approvato il pagamento. Ogni campo qui sotto elenca i tuoi stati ordine OpenCart.

Order Status After Payment: impostato dopo un Purchase approvato o dopo una cattura. Predefinito: Processing.

Windcave Payment On Hold Status: un pagamento Auth autorizzato ma non ancora catturato, oppure un pagamento approvato che non corrisponde all'ordine (importo, valuta, riferimento). Una nota ne spiega il motivo; verificala prima della spedizione. Predefinito: Pending, perché OpenCart non ha lo stato On hold. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Cancelled Order Status: non impostato dall'estensione. Un pagamento approvato che arriva per un ordine in questo stato non lo modifica; una nota ti chiede di rimborsarlo in Windcave Payline o di ripristinare l'ordine. Predefinito: Canceled.

Refunded Status: impostato dopo che il pagamento è stato rimborsato per intero, oppure l'autorizzazione è stata rilasciata, dalla pagina dell'ordine. Predefinito: Refunded.

Advanced

Debug log: registra le richieste API e gli eventi di pagamento in windcave_p_debug.log.php nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web. Finché questa opzione è disattiva, vengono registrati solo errori e avvisi. Chiavi API, dati della carta e dati personali dei clienti non vengono mai registrati. Predefinito: off.

Log: mostra la dimensione e le ultime voci del registro. Clicca su Clear log per svuotarlo.

Clean uninstall: elimina le impostazioni e i registri dell'estensione alla sua disinstallazione. I dati di pagamento salvati con gli ordini (gli ID transazione Windcave necessari per i rimborsi) vengono sempre conservati. Predefinito: off.

La versione dell'estensione è mostrata in fondo alla sezione.

Import / Export

Export: Download JSON salva le impostazioni in un file JSON. Le chiavi API non vengono esportate.

Import: incolla un JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. Le chiavi API salvate vengono mantenute.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit/Debit Card (Windcave)). Nel passaggio Confirm Order il cliente vede la tua descrizione; in modalità test vede anche Test mode: payments go to the Windcave UAT environment, no real money is taken. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente clicca su Confirm Order, l'estensione crea una sessione di pagamento Windcave per il totale dell'ordine nella valuta dell'ordine e invia il cliente alla Windcave Hosted Payment Page. Il numero d'ordine OpenCart viene inviato come riferimento commerciante, insieme alla lingua dell'ordine e al nome, all'e-mail, al telefono e all'indirizzo di fatturazione del cliente (e all'indirizzo di spedizione quando l'ordine richiede una spedizione). Su OpenCart 4 il cliente sceglie il metodo di pagamento con il pulsante Choose del blocco del metodo di pagamento, nella finestra Payment method options, e clicca su Confirm Order in fondo alla pagina del checkout.

Dopo il pagamento, il cliente torna nel tuo negozio. L'ordine viene segnato come pagato solo quando Windcave lo conferma: l'estensione chiede a Windcave, tramite la REST API, il risultato della sessione, sia quando il cliente torna sia quando arriva la notifica di Windcave. Un blocco per carrello assicura che il pagamento venga applicato una sola volta. L'ordine riceve poi il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento del magazzino, e il cliente vede la pagina di successo dell'ordine di OpenCart con Your Windcave payment has been received. Per un ordine trattenuto (un'autorizzazione o un pagamento che non corrisponde all'ordine) la pagina mostra Your payment was received by Windcave. The store will check it before processing your order — please do not pay again.

Se il cliente torna da un pagamento approvato ma il risultato non è ancora noto, una pagina Payment confirmation mostra We are waiting for Windcave to confirm your payment. You will receive an e-mail as soon as it is confirmed — please do not pay again. e un pulsante Check again. La notifica imposta lo stato dell'ordine appena Windcave conferma il pagamento.

Se il cliente torna senza un pagamento completato, l'ordine resta senza stato, il carrello viene conservato e la pagina di checkout mostra uno di questi messaggi:

Su OpenCart 4 questi messaggi sono mostrati sopra la pagina del checkout.

Il cliente può riprovare con lo stesso carrello (OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order; OpenCart 4 mantiene un solo ordine per il checkout e lo aggiorna, quindi lo stesso ordine viene pagato in una nuova sessione Windcave). Un nuovo tentativo controlla prima le sessioni precedenti del carrello: se una è già pagata, quel pagamento viene applicato, il cliente passa alla pagina di successo e non viene avviato un secondo pagamento; se il cliente non ha mai usato la pagina di pagamento e l'ordine non è cambiato, viene rimandato alla stessa pagina. Se il pagamento precedente è in fase di conferma in quel momento, il cliente vede Your previous payment for this order is being confirmed right now. Please wait a minute and check your e-mail before trying again.

Se Windcave non riesce ad avviare il pagamento, il cliente resta nel passaggio Confirm Order con un messaggio sopra il pulsante: Windcave could not start the payment with the details of this order. Please check your billing details and try again, or choose another payment method. oppure The payment could not be started because the payment service is temporarily unavailable. Please try again in a moment or choose another payment method. Il motivo viene scritto nel registro. Se la modalità corrente non ha credenziali, il cliente vede This payment method is not available at the moment. Please choose another payment method or contact us.

Su OpenCart 4, se l'ordine del checkout ha ricevuto uno stato senza un pagamento Windcave o è stato chiuso dal negozio nel frattempo, il successivo Confirm Order riporta il cliente al checkout con This order can no longer be paid. Please check your cart and confirm the order again. sopra la pagina del checkout, e il carrello viene pagato con un nuovo ordine. Se l'ordine del checkout è già pagato ma il carrello è cambiato da allora, incluso un nuovo quantitativo, il cliente torna al checkout e il nuovo carrello viene pagato con un nuovo ordine.

La notifica e il ritorno del cliente funzionano anche mentre il negozio è in modalità manutenzione: OpenCart 3 lascia passare le richieste delle estensioni di pagamento, e su OpenCart 4 l'estensione aggiunge per esse un'azione di avvio.

L'estensione non prevede abbonamenti o pagamenti ricorrenti, carte salvate, un modulo carta integrato nel tuo sito (il cliente paga sempre nella pagina Windcave), supporto per la API PxPay 2.0, e non aggiunge sovrapprezzi. Se Windcave aggiunge un sovrapprezzo, l'ordine viene abbinato alla transazione principale.

Ordini e rimborsi

Order statuses

Nessuno stato (ordine mancante): il cliente è stato inviato a Windcave e non ha pagato, Windcave non ha ancora confermato il pagamento, oppure il pagamento è stato rifiutato, annullato o è scaduto. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Order Status After Payment (predefinito Processing): un pagamento Purchase è stato approvato e corrisponde all'ordine. Una nota mostra l'importo, l'ID transazione, il codice di autorizzazione, il tipo di carta con il numero mascherato e l'ambiente (UAT o produzione).

Windcave Payment On Hold Status, autorizzato (predefinito Pending): un pagamento Auth è stato approvato ma non ancora catturato. La nota spiega come catturarlo o rilasciarlo.

Windcave Payment On Hold Status, non corrisponde (predefinito Pending): Windcave ha riportato un importo, una valuta, un riferimento commerciante o un tipo di transazione diversi dall'ordine (per esempio, il carrello è stato modificato in un'altra scheda dopo l'avvio del pagamento), oppure l'ordine aveva già uno stato impostato da qualcun altro. La nota elenca le differenze. Il denaro approvato può comunque essere rimborsato dalla scheda dell'ordine. Verifica il pagamento in Windcave Payline prima della spedizione e rimborsalo se necessario.

Refunded Status (predefinito Refunded): il pagamento è stato rimborsato per intero oppure l'autorizzazione è stata rilasciata tramite l'estensione.

Se un pagamento approvato arriva per un ordine in Cancelled Order Status, oppure un secondo pagamento approvato arriva per un ordine o un carrello già pagato, l'ordine non viene modificato. Una nota con l'ID transazione ti chiede di rimborsarlo in Windcave Payline (o di ripristinare manualmente l'ordine annullato).

Le note sono voci della History dell'ordine che il cliente non vede.

VibeFox Windcave Payment Gateway tab

In Sales > Orders apri un ordine pagato con Windcave. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Windcave Payment Gateway mostra il Transaction ID, il Session ID, il Type / status con l'ambiente, l'Amount paid, l'Auth code / card, la Capture transaction oppure un'autorizzazione rilasciata, il Payment total / refunded, un'etichetta Test mode (UAT) per i pagamenti di prova, il pulsante di cattura, il modulo di rimborso con lo storico, le Windcave sessions of this cart e le Windcave notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Capture (Auth mode)

Per un ordine in Windcave Payment On Hold Status con un'autorizzazione non ancora catturata o rilasciata, la scheda mostra Capture Windcave payment. Cliccalo e conferma Capture the authorised amount through Windcave now? L'importo autorizzato viene catturato, l'ordine passa a Order Status After Payment e la transazione di cattura compare nella scheda. Se Windcave non accetta la cattura, la scheda mostra Windcave capture failed: con il motivo, il motivo viene aggiunto alle note e l'ordine resta trattenuto. La cattura richiede il permesso di modificare l'estensione e le credenziali dell'ambiente del pagamento.

Refunds

Nella scheda VibeFox Windcave Payment Gateway inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Windcave. Conferma la domanda Refund this amount through Windcave? This cannot be undone. Sono supportati rimborsi totali e parziali. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). I rimborsi vengono conteggiati sull'importo e sulla valuta approvati da Windcave, quindi dopo una discrepanza puoi rimborsare fino a quanto il cliente ha effettivamente pagato, non fino al totale dell'ordine. Un rimborso dopo una cattura va sulla transazione di cattura. Il rimborso viene inviato all'ambiente (UAT o produzione) e all'account in cui il pagamento è stato effettuato, quindi le credenziali di quell'ambiente devono essere salvate. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note con l'ID transazione Windcave. Un rimborso totale imposta l'ordine su Refunded Status senza avvisare il cliente e senza rimettere i prodotti in magazzino, come un cambio di stato manuale. Un rimborso parziale non modifica lo stato.

Per un pagamento Auth non catturato, il pulsante è Release authorisation (void) e può essere rilasciato solo l'importo intero. Un importo parziale dà un errore che ti chiede di rimborsare l'importo intero o di catturare prima il pagamento.

Se Windcave rifiuta il rimborso, la scheda mostra Windcave declined the refund: con il motivo, e nessun rimborso viene registrato. Se Windcave sta ancora elaborando il rimborso, la scheda mostra Windcave has not confirmed the refund yet. See the order notes. e il rimborso non viene registrato. Verifica la transazione in Windcave Payline: se è stata approvata, registra il rimborso manualmente; altrimenti riprova. Un nuovo tentativo dello stesso rimborso non viene inviato due volte a Windcave.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite Windcave. I rimborsi effettuati in Windcave Payline non vengono comunicati al negozio.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox di vibefox.net. Il blocco della licenza License — VibeFox Windcave Payment Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Windcave Payment Gateway > Edit, sopra le impostazioni. Inserisci la chiave in License key e clicca su Activate. Dopodiché il blocco mostra la chiave mascherata, lo stato (per esempio la data fino alla quale la licenza è attiva e il tuo dominio) e i pulsanti Check now per controllare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuovere la chiave da questo negozio. Sotto compaiono la riga Product: opencart-payment-windcave e il collegamento Manage licenses and domains in your account, che apre il tuo account vibefox.net. Possono cambiare la chiave solo gli utenti amministratori con il permesso Modify per l'estensione. I testi del blocco seguono la lingua dell'amministrazione (sono inclusi inglese e russo).

Se la chiave non viene accettata, il blocco indica il motivo, per esempio Key not found, This key belongs to another product, Domain limit reached o License expired on seguito da una data. Dopo un cambio dell'indirizzo del negozio, o dopo aver liberato uno slot di dominio nel tuo account, clicca su Check now. Se il server delle licenze non è raggiungibile, l'estensione continua a funzionare con l'ultimo stato noto.

Una chiave funziona su un dominio: l'indirizzo del negozio dalla configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, Windcave non viene mostrato ai clienti al checkout. Se comunque un pagamento viene avviato, il cliente vede This payment method is not available. Please choose another one. Un utente amministratore connesso al pannello nello stesso browser vede ancora il metodo di pagamento nel negozio, contrassegnato come (unlicensed — visible to admins only), così puoi configurare e provare l'estensione prima di acquistare una chiave. Su OpenCart 4 questa anteprima non è disponibile: il negozio non vede l'accesso dell'amministratore, quindi senza una chiave attiva il metodo di pagamento è nascosto a tutti. Dopo aver aperto una volta la pagina Edit, nella Dashboard dell'amministrazione compare un promemoria. Chiudilo con × per nasconderlo per 7 giorni. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati dalla notifica o al ritorno del cliente, e i rimborsi e le catture funzionano.

Quando una licenza scade, l'estensione continua a funzionare, ma gli aggiornamenti e il supporto richiedono un rinnovo. Lo stato viene controllato di nuovo automaticamente quando apri la Dashboard dell'amministrazione o la pagina Edit: una volta al giorno nei primi 14 giorni dopo l'inserimento della chiave, poi una volta alla settimana. Non serve alcun cron job. La disinstallazione dell'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

Windcave non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che la modalità corrente abbia entrambe le credenziali: UAT API username e UAT API key in modalità test, Production API username e Production API key in modalità live. La pagina delle impostazioni mostra un avviso quando mancano. Verifica anche che l'indirizzo di pagamento sia nella Geo Zone selezionata e che l'ordine raggiunga il Total impostato nelle impostazioni.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: l'estensione non è ancora riuscita a ottenere il risultato da Windcave. Controlla il campo Log nella pagina dell'estensione: gli errori vengono sempre registrati, per esempio quando la sessione non può essere verificata. Verifica che le credenziali dell'ambiente del pagamento siano salvate e corrette. Il controllo viene ripetuto quando Windcave invia di nuovo la notifica (l'estensione risponde con payment could not be verified yet, retry later e un codice di errore, così Windcave riprova), quando il cliente clicca su Check again e quando il cliente avvia un nuovo pagamento per lo stesso carrello. Il tuo server deve accettare le richieste di Windcave all'indirizzo Notification URL mostrato nelle impostazioni.

La notifica risponde order not found: la sessione non è stata creata da questo negozio, per esempio una sessione di un altro negozio che usa lo stesso account Windcave. Viene ignorata.

Authentication failed nel registro: il nome utente o la chiave della REST API sono errati, oppure appartengono all'altro ambiente. Le credenziali UAT funzionano solo in modalità test, quelle di produzione solo in modalità live. Le chiavi PxPay non funzionano.

Il cliente vede che Windcave non ha potuto avviare il pagamento con i dati di questo ordine: Windcave ha rifiutato la richiesta di sessione, per esempio per la valuta o per un metodo di pagamento non abilitato nel tuo account. Il motivo esatto è nel registro.

Il cliente vede This payment method is not available. dopo Confirm Order: la sessione di checkout non corrisponde più all'ordine, oppure il metodo di pagamento è stato disattivato nel frattempo. Il cliente ricarica il checkout.

L'ordine è nello stato di verifica dopo il pagamento: leggi le note nella scheda VibeFox Windcave Payment Gateway. O il pagamento è un Auth in attesa di cattura, oppure l'importo pagato, la valuta o il riferimento commerciante non corrispondevano all'ordine. Cattura, evadi o rimborsa il pagamento.

Pagamenti di prova e pagamenti reali: UAT e produzione sono separati. Ogni sessione viene verificata nell'ambiente in cui è stata creata, e rimborsi e catture vanno nell'ambiente del pagamento, anche se cambi Test mode in seguito.

Il rimborso fallisce con un messaggio sull'ambiente: il pagamento è stato effettuato in UAT o in produzione, e per quell'ambiente non ci sono credenziali salvate. Inseriscile e riprova.

Nella scheda dell'ordine manca Capture Windcave payment: il pulsante viene mostrato solo per gli ordini in Windcave Payment On Hold Status pagati con Auth e non ancora catturati o rilasciati, solo quando le credenziali dell'ambiente del pagamento sono salvate, e solo per gli utenti che possono modificare l'estensione.

Dove trovare i dettagli: errori e avvisi vengono sempre scritti nel registro; attiva Debug log per registrare anche le richieste API e gli eventi di pagamento.

Per gli sviluppatori: prima della creazione della sessione Windcave, l'estensione attiva l'evento OpenCart windcave_p_session_request con i parametri della sessione e l'ordine.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Windcave Payment Gateway. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart rimuove sempre le proprie impostazioni dell'estensione: Enable/Disable, Sort Order, Geo Zone, Total e gli stati ordine della sezione Orders, che tornano ai valori predefiniti in caso di reinstallazione. Anche l'evento OpenCart dell'estensione viene rimosso (su OpenCart 4 anche i suoi eventi e la sua azione di avvio, che in modalità manutenzione lascia passare la notifica e il ritorno del cliente). Se Clean uninstall è attivo, vengono rimosse le altre impostazioni (titolo, descrizione, modalità test, credenziali API, tipo di transazione, metodi di pagamento, registrazione) e il registro. Se è disattivo, vengono conservate per una reinstallazione successiva. Sessioni, transazioni e rimborsi Windcave vengono sempre conservati, quindi gli ordini pagati in precedenza possono ancora essere rimborsati e catturati dopo una reinstallazione. Gli ordini esistenti mantengono le loro note di pagamento.

Su OpenCart 4, per rimuovere anche i file dell'estensione, vai su Extensions > Installer dopo la disinstallazione e clicca su Uninstall (il pulsante arancione −) accanto a VibeFox Windcave Payment Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

Windcave è un marchio del rispettivo titolare. Questa estensione non è affiliata né approvata da Windcave.