VibeFox Tranzila for OpenCart — Guida

Requisiti

OpenCart: 3.0.x (testato con la versione 3.0.5.0) o 4.0.2 e successive (testato con la versione 4.1.0.3).

PHP: 8.0 o successiva.

Valuta: ILS, USD, EUR o GBP. Per le altre valute dei clienti il metodo di pagamento viene nascosto al checkout.

Terminale Tranzila: ti serve il nome del terminale. La password del terminale (TranzilaPW) è necessaria per l'handshake e per i rimborsi dalla pagina dell'ordine. Alcuni terminali richiedono anche una password di credito separata (CreditPass) per i rimborsi. Il nome del terminale e le password sono forniti da Tranzila: consulta le impostazioni del tuo terminale o chiedi al supporto Tranzila. Per i test, Tranzila ti fornisce un terminale di prova separato; inserisci il suo nome come nome del terminale.

IP reale del visitatore: le notifiche di pagamento vengono verificate in base all'indirizzo IP del server Tranzila. Se il tuo negozio è dietro un proxy o una CDN come Cloudflare, il web server deve passare a PHP l'IP reale del visitatore (REMOTE_ADDR).

Chiave di licenza VibeFox: si acquista 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. Estrailo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 wcp_tranzila_payment_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_tranzila_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. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_tranzila_payment_gateway-oc3-(version).ocmod.zip. L'estensione non ha modifiche OCMOD, quindi Extensions > Modifications non deve essere aggiornato. Invece dell'installer puoi anche 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 Tranzila 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 con la matita) per aprire la pagina delle impostazioni. Incolla la tua chiave di licenza VibeFox in License key, nel blocco della licenza in cima alla pagina, e clicca su Activate (vedi Chiave di licenza).

4. Inserisci il Terminal name (supplier) e la Terminal password (TranzilaPW) se usi l'handshake o i rimborsi.

5. Lascia attivo Notifications e controlla Trusted IP: deve elencare gli indirizzi IP da cui Tranzila invia le notifiche. Conferma l'elenco con il supporto Tranzila. L'URL di notifica viene inviato con ogni pagamento, quindi non devi copiarlo da nessuna parte.

6. Consigliato: attiva l'handshake nel terminale Tranzila, consenti lì l'IP del tuo server, poi attiva Handshake nell'estensione.

7. Attiva Enable/Disable, clicca su Save e prova un pagamento con il terminale di test Tranzila.

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_tranzila_payment_gateway.ocmod.zip. Non rinominare il file: OpenCart 4 prende 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 Tranzila Payment Gateway, clicca su Install (il pulsante verde +), poi su Edit (il pulsante con la matita).

4. Inserisci la chiave di licenza e le impostazioni come nei passaggi da 3 a 7 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono gli stessi in entrambe le versioni.

Una nuova installazione parte con il metodo di pagamento disattivato.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Tranzila Payment Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni la pagina ti avvisa quando il nome del terminale è vuoto (in tal caso il metodo di pagamento viene nascosto al checkout), quando le notifiche sono disattivate o Trusted IP è vuoto (gli ordini pagati vengono in tal caso trattenuti per la revisione manuale), quando l'handshake è attivo senza password del terminale (la pagina di pagamento non può essere aperta) e quando la valuta predefinita del negozio non è supportata. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio la pagina non rifiuta mai tutto in una volta. Un Title vuoto o più lungo di 128 caratteri, un nome di terminale non valido, una voce non valida in Trusted IP, un campo numerico che non è un numero intero, oppure un Sort Order, un Total, una Geo Zone o uno stato dell'ordine non validi non vengono salvati: la pagina mostra il messaggio in un blocco rosso sopra le impostazioni e il campo ripropone il valore precedente. Un numero fuori dall'intervallo consentito viene salvato come il valore consentito più vicino, e la pagina te lo segnala, per esempio che 5000 è fuori da 400–1500 ed è stato salvato come 1500. Tutti gli altri campi vengono salvati.

Tranzila

Enable/Disable: Enable Tranzila Payment Gateway attiva o disattiva il metodo di pagamento. Predefinito: off.

Title: il nome del metodo di pagamento che il cliente vede al checkout e il titolo della pagina di pagamento. È anche il nome del metodo di pagamento memorizzato nell'ordine, quindi è obbligatorio e può avere al massimo 128 caratteri. Predefinito: Credit Card (Tranzila).

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Pay securely with your credit card on the Tranzila payment page.

Sort Order: la posizione di Tranzila tra i metodi di pagamento al checkout. Lascialo vuoto o inserisci un numero intero (sono ammessi valori negativi).

Geo Zone: offre Tranzila 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 Tranzila. Lascialo vuoto per offrire Tranzila per qualsiasi totale.

Terminale

Terminal name (supplier): il nome del tuo terminale Tranzila, per esempio myshop. Solo lettere, cifre, «-» e «_». Finché non viene inserito, il metodo di pagamento non viene mostrato al checkout. Per i test, inserisci il nome del tuo terminale di prova Tranzila.

Terminal password (TranzilaPW): la password API del terminale. È necessaria per l'handshake e per i rimborsi dalla pagina dell'ordine.

Refund password (CreditPass): solo se il tuo terminale richiede una password separata per le transazioni di credito (rimborsi). Altrimenti lascialo vuoto.

Le password salvate non vengono mai mostrate di nuovo. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo per cambiarlo. Per rimuovere una password salvata, spunta Clear saved password on save sotto il campo e clicca su Save.

Pagina di pagamento

Payment page version: la pagina Tranzila mostrata nell'iframe.

Payment page language: la lingua della pagina Tranzila: Site language, ebraico, inglese, russo, spagnolo, tedesco, francese o giapponese. Predefinito: Hebrew. Site language usa la lingua della vetrina del cliente quando è una di queste, altrimenti l'inglese.

iFrame width (px): da 300 a 1200. Predefinito: 600. Sugli schermi piccoli il riquadro non è mai più largo della pagina.

iFrame height (px): da 400 a 1500. Predefinito: 650.

Max installments: il numero massimo di rate (tashlumim) che il cliente può scegliere nella pagina di pagamento, fino a 36. 0 o 1 significa nessuna rata. Predefinito: 0. Il terminale deve essere abilitato a elaborare le rate.

Handshake: blocca l'importo con un token di handshake (consigliato). Prima di aprire la pagina di pagamento, il negozio chiede a Tranzila un token monouso legato all'importo, così l'importo non può essere modificato nel browser. Richiede la password del terminale, l'handshake attivo nel terminale Tranzila e l'IP del tuo server consentito lì. Predefinito: off.

Conferma del pagamento

Le notifiche Tranzila non sono firmate. Un ordine riceve lo stato di pagato solo quando la notifica proviene da un Trusted IP e il suo token della pagina di pagamento, l'ordine, il terminale, l'importo e la valuta corrispondono alla pagina di pagamento. Con l'handshake, deve corrispondere anche il token. Il ritorno del cliente dalla pagina di pagamento non segna mai un ordine come pagato.

Notifications: conferma automaticamente i pagamenti con le notifiche Tranzila (URL di notifica). Predefinito: on. Quando le notifiche sono disattivate, un cliente che torna da una pagina di pagamento riuscita porta l'ordine in On hold status, e tu confermi il pagamento manualmente dopo aver controllato il terminale Tranzila.

Notification URL: mostrato a titolo informativo. In OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_tranzila_payment_gateway/notify; in OpenCart 4: https://your-store/index.php?route=extension/wcp_tranzila_payment_gateway/payment/wcp_tranzila_payment_gateway.notify. È costruito a partire dall'indirizzo della vetrina della tua installazione di OpenCart. L'URL viene inviato a Tranzila con ogni pagamento, quindi non devi inserirlo nel terminale Tranzila. Funziona anche quando il negozio è in modalità manutenzione (in OpenCart 4 un'azione di avvio dell'estensione lascia passare la notifica e il ritorno del cliente).

Trusted IP: gli indirizzi IP o gli intervalli CIDR dei server Tranzila che inviano le notifiche, separati da virgole. Predefinito: 80.244.170.7. Conferma l'elenco attuale con il supporto Tranzila. Le notifiche da altri indirizzi vengono rifiutate. Se il campo è vuoto, le notifiche non possono essere verificate: un pagamento riuscito segnalato porta l'ordine in On hold status per la revisione manuale, e un rifiuto segnalato non cambia nulla.

Ordini

OpenCart crea l'ordine al passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo da una notifica Tranzila verificata. OpenCart non ha lo stato On hold, quindi si usa lo stato che scegli qui, e una nota dell'ordine ne spiega il motivo. Ogni campo qui sotto elenca i tuoi stati ordine di OpenCart.

Order status after payment: il pagamento è stato confermato da una notifica verificata (importo, valuta, terminale e token corrispondono). Predefinito: Processing.

On hold status: il pagamento richiede la tua verifica: importo, valuta o token di handshake non corrispondono, la notifica non è stata verificabile (nessun Trusted IP), oppure le notifiche sono disattivate e il cliente è tornato da una pagina di pagamento riuscita. Predefinito: Pending. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Refunded status: impostato quando il pagamento viene rimborsato per intero dalla pagina dell'ordine. Predefinito: Refunded.

Cancelled order status: l'estensione non lo imposta. Un ordine in questo stato che viene pagato più tardi viene riaperto con una nota che ti ricorda di controllare le scorte. Predefinito: Canceled.

Payment error status: l'estensione non lo imposta. Un ordine in questo stato viene pagato da un successivo pagamento Tranzila approvato. Predefinito: Failed.

Avanzate

Debug log: registra gli eventi della pagina di pagamento, delle notifiche e dei rimborsi in tranzila_p_debug.log.php, nella cartella dei log di OpenCart (storage/logs; in OpenCart 4 system/storage/logs). Il file non può essere aperto dal web e, al raggiungimento di 5 MB, viene spostato in tranzila_p_debug.old.log.php. Avvisi ed errori vengono sempre registrati, anche quando questa opzione è disattivata. Password, token e dati dei clienti non vengono mai scritti. Predefinito: off.

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

Delete data on uninstall: se attivo, disinstallando l'estensione vengono rimosse le impostazioni e il registro. Le transazioni e i rimborsi Tranzila vengono sempre conservati, perché gli ordini precedenti ne hanno bisogno. Predefinito: off.

Importa / Esporta

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

Import: incolla il JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. Le password salvate vengono conservate.

Checkout

Al passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit Card (Tranzila)). Al passaggio Confirm Order il cliente vede la tua descrizione e la nota After you confirm, you will enter your card details on the secure Tranzila payment page. The order is confirmed once Tranzila confirms the payment. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente clicca su Confirm Order, passa a una pagina di pagamento del tuo negozio. Lì la pagina di pagamento Tranzila si apre in un iframe, con il totale dell'ordine nella valuta dell'ordine, i dati di fatturazione e un breve elenco dei prodotti. La pagina dice Enter your card details on the secure Tranzila payment page below. If it does not load, click "Proceed to payment". Sotto il riquadro c'è il link Choose another payment method. Se sono consentite le rate, il cliente sceglie il numero di rate nella pagina Tranzila. In OpenCart 4 il cliente sceglie il metodo di pagamento con il pulsante Choose del blocco dei metodi di pagamento, nella finestra Payment method options, e clicca su Confirm Order in fondo alla pagina di checkout.

Ogni visualizzazione della pagina di pagamento è un nuovo tentativo di pagamento con il proprio token (e il proprio token di handshake). Ricaricare la pagina apre un nuovo tentativo per l'ordine della stessa sessione del cliente; un link alla pagina di pagamento aperto in un altro browser riporta al checkout.

Dopo un pagamento riuscito, Tranzila riporta il cliente indietro e l'intera finestra prosegue. L'ordine viene segnato come pagato solo quando Tranzila lo conferma con una notifica. L'ordine riceve poi il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento delle scorte. Quando un ordine in attesa viene pagato più tardi, il cliente riceve l'e-mail sul nuovo stato dell'ordine. Se la notifica è già arrivata, il cliente vede la pagina di successo dell'ordine di OpenCart con Your payment with Tranzila has been received. Se l'ordine è in attesa di revisione, la pagina mostra Your payment is being reviewed by the store. You will receive an e-mail once it is confirmed. Se la notifica non è ancora arrivata, una pagina Payment confirmation mostra Your payment is being confirmed by Tranzila. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. con i pulsanti Check again e Back to checkout.

Se il pagamento viene rifiutato o annullato, il cliente torna al checkout con il messaggio The payment was not completed. You have not been charged — please try again or choose another payment method. Quando Tranzila riporta un codice di risposta, vengono aggiunti il motivo e il codice, per esempio che la carta è scaduta. Il carrello viene conservato e l'ordine resta senza stato. In OpenCart 4 questo messaggio viene mostrato sopra la pagina di checkout. OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, OpenCart 4 aggiorna l'ordine del checkout; un carrello già pagato da uno di questi ordini non viene addebitato di nuovo. Una modifica del carrello, inclusa una nuova quantità, conta come un nuovo carrello che richiede il proprio pagamento.

OpenCart 4 mantiene l'ordine nel checkout finché non viene mostrata la pagina di successo. Dopo un pagamento rifiutato il cliente paga di nuovo lo stesso ordine con un nuovo tentativo di pagamento. Se quell'ordine nel frattempo è stato chiuso (per esempio l'hai annullato), o è stato pagato per un carrello che nel frattempo è cambiato, il cliente torna al checkout con This order can no longer be paid. Please confirm your order again., e il successivo Confirm Order paga un nuovo ordine.

Se la pagina di pagamento non può essere aperta, per esempio quando l'handshake fallisce, il cliente resta al passaggio Confirm Order con un breve messaggio sopra il pulsante, come Could not connect to Tranzila. Please try again in a moment. Il motivo tecnico viene scritto nel registro.

L'estensione accetta solo pagamenti singoli con carta, sulla pagina Tranzila. Non prevede carte o token salvati, abbonamenti, autorizzazione e cattura separate (J5), pulsanti propri di Bit, Apple Pay o Google Pay (ciò che offre la tua pagina di pagamento Tranzila viene mostrato nell'iframe) né fatture Tranzila.

Ordini e rimborsi

Stati dell'ordine

Nessuno stato (ordine mancante): il cliente è stato inviato alla pagina di pagamento e non ha pagato, il pagamento è stato rifiutato oppure la notifica Tranzila non è ancora arrivata. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders. Su OpenCart 4.1 un ordine così può anche avere lo stato Voided, che OpenCart imposta quando il passaggio di conferma viene mostrato di nuovo; l'estensione lo conta come un ordine senza stato.

Stato dell'ordine dopo il pagamento (predefinito Processing): il pagamento è stato confermato da una notifica verificata. Una nota mostra l'importo, la transazione Tranzila (index), il numero di autorizzazione e il numero di rate, se presenti.

On hold status (predefinito Pending): il pagamento è stato segnalato ma non accettato automaticamente: importo, valuta o token di handshake non corrispondevano, la notifica non ha potuto essere verificata perché Trusted IP è vuoto, oppure le notifiche sono disattivate e il cliente è tornato da una pagina di pagamento riuscita. La nota spiega il motivo. Controlla il pagamento nel terminale Tranzila e cambia lo stato manualmente.

Refunded status (predefinito Refunded): il pagamento è stato rimborsato per intero tramite l'estensione.

Se arriva un pagamento per un ordine in stato di attesa, annullato o di errore di pagamento, l'ordine riceve il Order status after payment; un ordine annullato riceve inoltre una nota che ti chiede di controllare le scorte prima della spedizione. Se arriva un secondo pagamento per un ordine già pagato o rimborsato, oppure per un altro ordine di un carrello già pagato, l'ordine non viene modificato. Una nota sull'ordine pagato ti chiede di verificarlo e di rimborsare il duplicato nel terminale Tranzila. Le notifiche ripetute della stessa transazione vengono ignorate.

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

Scheda VibeFox Tranzila Payment Gateway

In Sales > Orders apri un ordine pagato con Tranzila. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Tranzila Payment Gateway mostra la Transaction (index), l'Authorization, il Terminal, lo Status, gli importi Paid / refunded, il numero di Installments, il modulo di rimborso, lo storico dei rimborsi, tutte le Payment pages of the cart con il loro esito e le Tranzila notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox Tranzila Payment Gateway inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Tranzila. Conferma la domanda Refund this amount via Tranzila? This cannot be undone. Sono supportati rimborsi totali e parziali. Ti serve il permesso di modificare gli ordini (sale/order in System > Users > User Groups). Il rimborso viene eseguito come transazione di credito Tranzila sul pagamento originale, sul terminale che lo ha incassato, per l'importo e nella valuta effettivamente addebitati da Tranzila. Quindi, dopo una differenza di importo o di valuta, puoi rimborsare fino a quanto il cliente ha realmente pagato, non fino al totale dell'ordine.

Il modulo è disponibile quando la password del terminale è impostata e l'ordine ha una transazione Tranzila confermata. Altrimenti la scheda spiega il motivo, per esempio Refunds need the terminal password (TranzilaPW) in the gateway settings. Un ordine pagato su un terminale diverso da quello attualmente nelle impostazioni (per esempio un terminale di test) non può essere rimborsato dalla pagina dell'ordine; rimborsalo in quel terminale Tranzila.

Se Tranzila non accetta il rimborso, la scheda mostra l'errore, per esempio Tranzila declined the refund con il codice e il suo significato, e non viene registrato alcun rimborso. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note con la transazione di credito Tranzila. Un rimborso totale imposta l'ordine su Refunded status senza avvisare il cliente e senza rimettere i prodotti in magazzino, come un cambio manuale di stato. Un rimborso parziale non cambia lo stato.

Le restituzioni di prodotti in Sales > Returns non rimandano denaro tramite Tranzila. I rimborsi effettuati nel terminale Tranzila non vengono comunicati al negozio. Aggiorna l'ordine manualmente se necessario.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox di vibefox.net. Il blocco della licenza License — VibeFox Tranzila Payment Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Tranzila Payment Gateway > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca su Activate. Dopo di ciò 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 si trovano la riga Product: opencart-payment-tranzila e il link Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo gli utenti amministratori con il permesso Modify per l'estensione possono cambiare la chiave. I testi del blocco seguono la lingua dell'amministrazione (sono incluse le versioni in inglese e in 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 aver cambiato l'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, Tranzila non viene mostrato ai clienti al checkout. Se un pagamento viene avviato comunque, il cliente vede This payment method is not available. Please choose another one. Un utente amministratore connesso all'amministrazione nello stesso browser vede ancora il metodo di pagamento nel negozio, contrassegnato da (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 all'amministrazione, 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 confermati dalla notifica Tranzila e dal ritorno al negozio, e i rimborsi funzionano.

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

Risoluzione dei problemi

Tranzila non compare al checkout: controlla che la licenza sia attiva, che Enable/Disable sia attivo, che Terminal name (supplier) sia compilato e che la valuta del cliente sia ILS, USD, EUR o GBP. La pagina delle impostazioni mostra un avviso quando manca il nome del terminale o la valuta predefinita non è supportata. Controlla 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: la notifica non è arrivata o è stata rifiutata. Controlla che Notifications sia attivo e che Trusted IP elenchi gli indirizzi da cui Tranzila invia le notifiche. Gli errori vengono sempre scritti nel registro; controlla il campo Log nella pagina dell'estensione. Il messaggio secondo cui un IP non è nell'elenco Trusted IP indica che bisogna correggere l'impostazione Trusted IP o la configurazione del proxy: dietro un proxy o una CDN il web server deve passare a PHP l'IP reale del visitatore. Per gli sviluppatori il cui negozio si trova dietro un reverse proxy fidato, l'estensione attiva l'evento di OpenCart wcp_tranzila_payment_gateway/remote_ip per impostare l'IP.

La notifica risponde Forbidden: proviene da un indirizzo IP che non è in Trusted IP.

La notifica risponde Bad request o Not found: l'ordine, il token della pagina di pagamento, il terminale o l'indice della transazione nella notifica non corrispondono a una pagina di pagamento di questo negozio.

La notifica risponde Accepted for manual review: Trusted IP è vuoto, quindi la notifica non ha potuto essere verificata. Un pagamento riuscito porta l'ordine in attesa. Compila Trusted IP per confermare automaticamente i pagamenti.

La notifica risponde Busy, retry: il carrello era in elaborazione da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. Il registro mostra il motivo. Controlla il pagamento nel terminale Tranzila.

Alcuni ordini sono nello stato in attesa: leggi le note nella scheda VibeFox Tranzila Payment Gateway. Importo, valuta o token di handshake non corrispondevano, oppure la notifica non ha potuto essere verificata (Trusted IP vuoto, o notifiche disattivate). Controlla il pagamento nel terminale Tranzila e cambia lo stato manualmente.

La pagina di pagamento non si apre con l'handshake attivo: controlla il nome del terminale e la password del terminale, che l'handshake sia attivo nel terminale Tranzila e che l'IP del tuo server sia consentito lì. Il registro mostra il motivo.

I rimborsi non riescono: i rimborsi richiedono la Terminal password (TranzilaPW). Alcuni terminali richiedono anche una password di credito separata; inseriscila in Refund password (CreditPass). Gli ordini pagati su un altro terminale devono essere rimborsati in quel terminale. Se la risposta di Tranzila è inattesa, la scheda indica che il rimborso non è stato confermato: controlla il terminale Tranzila prima di riprovare. Senza il permesso di modificare gli ordini, la scheda mostra You do not have permission to refund orders.

Altre valute: l'estensione supporta solo ILS, USD, EUR e GBP.

Per gli sviluppatori: prima che la pagina di pagamento venga mostrata, l'estensione attiva l'evento di OpenCart wcp_tranzila_payment_gateway/payment_page_params con i campi della pagina di pagamento e dell'ordine.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Tranzila 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 dell'ordine della sezione Orders, che tornano ai valori predefiniti alla reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 anche i suoi eventi e la sua azione di avvio, che lascia passare la notifica e il ritorno del cliente in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni (titolo, descrizione, terminale, password, pagina di pagamento, conferma del pagamento, registrazione) e il registro. Se è disattivo, vengono conservate per una reinstallazione successiva. Le transazioni e i rimborsi Tranzila vengono sempre conservati, quindi gli ordini pagati in precedenza possono essere rimborsati anche dopo una reinstallazione. Gli ordini esistenti mantengono le proprie note di pagamento.

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

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