VibeFox Tpay for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo. Per la verifica della firma JWS delle notifiche servono l'estensione OpenSSL e il HTTPS in uscita verso secure.tpay.com.

Valuta: solo lo złoty polacco (PLN). Tpay regola i pagamenti in PLN e la sua Open API non ha un campo valuta. Aggiungi PLN in System > Localisation > Currencies se il tuo negozio non lo ha: Tpay viene mostrato solo quando il cliente paga in PLN.

Accesso a Internet per il tuo negozio: Tpay invia le notifiche di pagamento al tuo negozio, quindi l'indirizzo di notifica deve essere raggiungibile da Internet (non bloccato da un firewall o da un'autenticazione HTTP).

Account Tpay: ti servono questi valori dal pannello commerciante Tpay: il Merchant ID (l'ID del tuo account Tpay), le chiavi Open API Client ID e Client secret (Integration, API) e il codice di sicurezza (Settings, Notifications). Le chiavi sandbox provengono da un account sandbox Tpay separato.

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona su un solo 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_tpay_payment-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_tpay_payment.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_tpay_payment-oc3-(version).ocmod.zip. L'estensione non contiene 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 principale del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Tpay Payment 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 le chiavi sandbox e le chiavi di produzione (vedi Configurazione). Nel pannello Tpay non va impostato nulla tranne il codice di sicurezza: l'indirizzo di notifica viene inviato con ogni transazione.

5. Attiva Enable/Disable e clicca su Save. Prova un pagamento in modalità sandbox, poi disattiva Sandbox mode per accettare pagamenti reali.

OpenCart 4

1. Nell'area di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_tpay_payment.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 Tpay Payment, clicca su Install (il pulsante verde +), poi su Edit (il pulsante con la matita).

4. Inserisci la chiave di licenza e le chiavi Tpay 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 delle notifiche (vedi Notifiche di pagamento).

Una nuova installazione parte con il metodo di pagamento disattivato e la modalità sandbox attiva.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Tpay Payment > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni la pagina mostra Sandbox mode is on: payments go to the Tpay sandbox and no real money is charged. finché la modalità sandbox è attiva. Avvisa quando le chiavi della modalità attuale sono incomplete (Tpay non viene allora mostrato al checkout), quando la valuta predefinita del negozio non è PLN (Tpay viene mostrato solo se il cliente paga in PLN) e quando manca l'estensione PHP OpenSSL con la verifica JWS attiva (i pagamenti non verrebbero allora confermati). Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non deve essere vuoto né superare 128 caratteri, Sort Order deve essere un numero intero (sono ammessi valori negativi), Total deve essere un numero pari o maggiore di 0 e gli stati dell'ordine devono esistere; altrimenti non viene salvato nulla. Le chiavi mancanti non impediscono il salvataggio. Gli spazi incollati insieme al Merchant ID o al Client ID vengono rimossi, e i segreti vengono ripuliti dagli spazi.

Tpay

Enable/Disable: Enable Tpay payments attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il titolo del metodo di pagamento mostrato al cliente al checkout. È anche il nome del metodo di pagamento salvato nell'ordine. Predefinito: Tpay. Obbligatorio, massimo 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Pay with BLIK, online bank transfer or card on the secure Tpay page.

Sandbox mode: usa la sandbox Tpay (pagamenti di prova, nessun denaro reale) con le chiavi sandbox e openapi.sandbox.tpay.com. Disattivalo per accettare pagamenti reali con le chiavi di produzione. I rimborsi vanno sempre all'ambiente in cui l'ordine è stato pagato. Predefinito: attivo.

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

Geo Zone: offri Tpay 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 Tpay venga offerto. Lascialo vuoto per offrire Tpay per qualsiasi totale.

Chiavi di produzione

Dove trovarle: nel pannello commerciante Tpay (la sezione rimanda ad esso) sotto Integration, API (chiavi Open API: Client ID e Secret); il Merchant ID è l'ID del tuo account Tpay; il codice di sicurezza si trova in Settings, Notifications.

Merchant ID: l'ID del tuo account Tpay (cifre). Tpay lo invia in ogni notifica.

Client ID: il Client ID dell'Open API.

Client secret: il Client secret dell'Open API.

Security code: serve a verificare il checksum MD5 delle notifiche Tpay.

Chiavi sandbox

La sandbox è un account di prova Tpay separato con le proprie chiavi (la sezione rimanda alla documentazione API di Tpay). Viene usata solo quando Sandbox mode è attivo.

Sandbox Merchant ID: il Merchant ID dell'account sandbox.

Sandbox Client ID: il Client ID dell'Open API dell'account sandbox.

Sandbox Client secret: il Client secret dell'Open API dell'account sandbox.

Sandbox Security code: il codice di sicurezza delle notifiche dell'account sandbox.

I segreti salvati (Client secret e Security code di entrambi gli ambienti) non vengono mai mostrati di nuovo. Il campo resta vuoto e mostra Saved - leave empty to keep it. Inserisci un nuovo valore solo se vuoi cambiarlo. Per rimuovere un segreto salvato, spunta Clear the saved value sotto il campo e clicca su Save.

Notifiche di pagamento

Notification URL: Tpay conferma i pagamenti all'indirizzo mostrato qui. Su OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_tpay_payment/notify, su OpenCart 4 così: https://your-store/index.php?route=extension/wcp_tpay_payment/payment/wcp_tpay_payment.notify. È costruito a partire dall'indirizzo della vetrina della tua installazione di OpenCart. L'indirizzo viene inviato automaticamente con ogni transazione; nel pannello Tpay non va impostato nulla tranne il codice di sicurezza. Un ordine riceve il suo stato solo dopo una notifica con checksum e firma validi e con un importo corrispondente (oppure con una verifica di stato corrispondente quando il cliente torna). Tpay ripete una notifica finché il tuo negozio non la accetta. La modalità manutenzione non blocca l'indirizzo (su OpenCart 4 l'estensione aggiunge un'azione di avvio, startup action, per le notifiche e per il ritorno del cliente).

JWS signature: verifica anche la X-JWS-Signature delle notifiche con il certificato Tpay (consigliato). Richiede l'estensione PHP OpenSSL e il HTTPS in uscita verso secure.tpay.com. I certificati vengono memorizzati in cache per un giorno. Il checksum MD5 viene sempre verificato. Predefinito: attivo.

Ordini

OpenCart crea l'ordine al passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che Tpay ha confermato il pagamento (tramite notifica o verifica di stato). Ciascun campo sotto elenca i tuoi stati ordine di OpenCart.

Paid Order Status: lo stato dopo un pagamento confermato. Predefinito: In lavorazione.

On Hold (Review) Status: il pagamento richiede la tua verifica (vedi Stati dell'ordine). Predefinito: In attesa, perché OpenCart non ha lo stato In sospeso. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Cancelled Order Status: l'estensione non imposta mai questo stato. Un pagamento per un ordine in questo stato mette l'ordine in verifica invece di riaprirlo in silenzio. Predefinito: Annullato.

Refunded Status: impostato dopo il rimborso totale del pagamento dalla pagina dell'ordine. Predefinito: Rimborsato.

Avanzate

Debug log: registra gli eventi di pagamento: solo eventi tecnici (nessuna chiave, nessun dato dei clienti) in wc_tp_debug.log.php nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web e, al raggiungimento di 5 MB, viene spostato in una copia vecchia. Predefinito: disattivato. Finché è disattivato non viene scritto nulla, errori compresi, quindi attivalo prima di cercare la causa di un problema.

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

Delete data on uninstall: se attivo, la disinstallazione dell'estensione rimuove le impostazioni del gateway e il registro. Gli ordini e i relativi dati di pagamento Tpay vengono sempre conservati. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. I Client secret e i Security code non vengono esportati.

Import: incolla un JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. I Client secret e i Security code salvati vengono mantenuti.

Checkout

Al passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Tpay). Al passaggio Confirm Order il cliente vede la tua descrizione e la nota You will be redirected to the secure Tpay page to complete the payment. In modalità sandbox viene mostrato anche Sandbox mode - no real money is charged. OpenCart crea l'ordine in questo passaggio, ancora senza stato. 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 di checkout.

Quando il cliente clicca su Confirm Order, l'estensione crea una transazione Tpay per il totale dell'ordine in PLN, con la descrizione Order # e il numero dell'ordine, passa nome, e-mail, indirizzo di pagamento e telefono del cliente e invia il cliente alla pagina di pagamento Tpay. La pagina è mostrata in polacco, inglese o ucraino, in base alla lingua dell'ordine (le altre lingue ricevono l'inglese). Lì il cliente sceglie BLIK, un bonifico bancario, una carta o un altro metodo attivato nel tuo account Tpay, e paga.

L'ordine viene segnato come pagato solo quando Tpay lo conferma. Tpay invia una notifica al tuo negozio; l'estensione verifica il checksum MD5 con il codice di sicurezza, il Merchant ID e (se attiva) la firma JWS, usando le chiavi dell'ambiente in cui il pagamento è stato avviato, poi l'importo: deve essere uguale all'importo richiesto per questo tentativo di pagamento e al totale dell'ordine, e l'importo pagato non può essere inferiore. Le notifiche senza checksum o firma validi vengono rifiutate. L'ordine riceve poi il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento delle scorte.

Dopo il pagamento, il cliente torna nel tuo negozio. Il solo ritorno non segna nulla come pagato. Se la notifica non è ancora arrivata, l'estensione chiede alle API Tpay lo stato della transazione (al massimo ogni 10 secondi) e applica gli stessi controlli. Quando il pagamento viene confermato, il cliente vede la pagina di conferma ordine di OpenCart. Finché non è confermato, una pagina Payment confirmation mostra Tpay has not confirmed your payment yet. If you have paid, refresh this page in a moment. If the payment did not go through, you can try again: con un pulsante Refresh e un pulsante Pay again che riporta al checkout. La notifica imposta lo stato dell'ordine non appena arriva. Se l'ordine è passato in verifica, la pagina di successo mostra anche Your payment is being verified. We will contact you as soon as it is confirmed.

Se Tpay segnala che il pagamento non è andato a buon fine, il cliente torna al checkout con Tpay reports that the payment did not go through. Please try again or choose another payment method. Se il pagamento fallisce sulla pagina Tpay, Tpay riporta il cliente alla pagina di checkout. Il carrello viene conservato in entrambi i casi.

OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order. OpenCart 4 conserva un unico ordine per il checkout e lo aggiorna, quindi Pay again avvia un nuovo tentativo dello stesso ordine. Ogni tentativo di pagamento ha il proprio riferimento. Quando il cliente paga di nuovo, le precedenti transazioni Tpay non pagate dell'ordine e degli altri ordini dello stesso carrello vengono annullate presso Tpay; un pagamento già andato a buon fine tramite un link precedente viene comunque accettato. Se un altro ordine dello stesso carrello è già pagato, il cliente va alla pagina di successo invece di avviare un nuovo pagamento.

Su OpenCart 4, se l'ordine di questo checkout è stato chiuso nel frattempo dal negozio, oppure è già pagato ma il carrello è cambiato da allora, anche con una nuova quantità, il cliente torna al checkout con Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. Per un ordine che il negozio ha annullato prima di qualsiasi pagamento, il messaggio è Order #… was cancelled by the store before the payment was completed. No Tpay payment was received for it. Please place a new order or contact us. Il successivo Confirm Order paga un nuovo ordine. Su OpenCart 4 questi messaggi, il messaggio sul pagamento non riuscito e We could not match this payment to an order. If you were charged, please contact us. vengono mostrati sopra la pagina di checkout.

Se Tpay non può avviare il pagamento, il cliente resta al passaggio Confirm Order con The Tpay payment could not be started. Please try again or choose another payment method. e il motivo viene scritto nel registro (quando Debug log è attivo). Altri messaggi: Tpay accepts payments in Polish złoty (PLN) only. Please choose another payment method. e The order total must be greater than zero.

L'estensione funziona solo in PLN. Nel negozio non c'è la scelta della banca o del codice BLIK (il cliente sceglie nella pagina Tpay), non ci sono carte salvate, abbonamenti, pulsanti Apple Pay o Google Pay nel negozio né calcolatori di rate.

Ordini e rimborsi

Stati dell'ordine

Nessuno stato (ordine mancante): il cliente è stato inviato a Tpay e non ha pagato, oppure Tpay non ha ancora confermato il pagamento. Anche un pagamento non riuscito lascia l'ordine senza stato. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Paid Order Status (default Processing): Tpay ha confermato il pagamento. Una nota mostra il titolo della transazione Tpay (TR-...), l'importo pagato, se la conferma è arrivata con la notifica o con la verifica di stato, l'ambiente e un eventuale pagamento in eccesso.

On Hold (Review) Status (default Pending): è arrivato un pagamento, ma la valuta dell'ordine non è PLN, il suo importo non corrispondeva a quello richiesto o al totale dell'ordine (per esempio, l'ordine è stato modificato dopo l'avvio del pagamento), è stata pagata solo una parte, oppure il pagamento è arrivato per un ordine nello stato Cancelled Order Status. La nota lo spiega. Controlla il pagamento nel pannello Tpay ed evadi o rimborsa l'ordine. Se il cliente paga poi l'importo corretto con un altro tentativo, l'ordine passa al Paid Order Status.

Refunded Status (default Refunded): il pagamento è stato rimborsato interamente tramite l'estensione.

Se Tpay segnala un altro pagamento per un ordine già pagato o rimborsato, l'ordine non viene modificato; una nota ti chiede di rimborsare il pagamento in eccesso nel pannello Tpay, se necessario. Un pagamento per un altro ordine di un carrello già pagato lascia quell'ordine senza stato ed è annotato sull'ordine pagato. Un pagamento non riuscito per un ordine che ha già uno stato, uno storno (chargeback) e uno stato Tpay sconosciuto aggiungono solo una nota.

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

Scheda VibeFox Tpay Payment

In Sales > Orders apri un ordine pagato con Tpay. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Tpay Payment mostra il titolo della Tpay transaction e il Transaction ID, il riferimento del pagamento (CRC), l'Environment (un'etichetta Sandbox per i pagamenti sandbox), lo Status del pagamento e come è stato confermato, l'importo pagato, Order total / refunded, Refundable (paid through Tpay) quando differisce dal totale dell'ordine, il modulo di rimborso, lo storico dei rimborsi, i Payment attempts dell'ordine (con link cancelled per i link annullati) e le Payment notes. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional, kept in the note), e clicca su Refund via Tpay. Conferma la domanda Refund this amount through Tpay? This cannot be undone. Sono supportati rimborsi totali e parziali per gli ordini con un pagamento ricevuto tramite Tpay, inclusi quelli in verifica. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). Puoi rimborsare fino all'importo incassato dalla transazione Tpay che ha effettuato il pagamento, e comunque non oltre il totale dell'ordine. Il rimborso viene inviato all'ambiente (sandbox o produzione) in cui l'ordine è stato pagato, quindi le chiavi di quell'ambiente devono essere impostate. Il rimborso si considera eseguito solo quando Tpay lo conferma; un rimborso rifiutato o non confermato da Tpay viene mostrato come errore e non viene registrato. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note, insieme al motivo che hai inserito (il motivo non viene inviato a Tpay). Il rimborso dell'intero importo rimborsabile imposta l'ordine al Refunded Status senza notificare il cliente e senza restituire i prodotti alle scorte, come un cambio di stato manuale. Un rimborso parziale non cambia lo stato.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite Tpay. I rimborsi eseguiti nel pannello commerciante Tpay non vengono aggiunti automaticamente a OpenCart.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco di licenza License — VibeFox Tpay Payment è il primo blocco di Extensions > Extensions > Payments > VibeFox Tpay Payment > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca su Activate. Dopo, 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 verificare 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-tpay e il collegamento Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo gli utenti amministratori con il permesso Modify sull'estensione possono cambiare la chiave. 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 aver cambiato l'indirizzo del negozio, o dopo aver liberato un posto 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 solo dominio: l'indirizzo del negozio dalla configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il suo posto dominio. Liberalo nel tuo account vibefox.net.

Senza una chiave attiva, Tpay 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 che ha effettuato l'accesso all'amministrazione 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, e i rimborsi funzionano.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene verificato di nuovo 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. La disinstallazione dell'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

Tpay non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che tutte e quattro le chiavi della modalità attuale siano inserite (Merchant ID, Client ID, Client secret, Security code). Verifica che il cliente paghi in PLN, che l'indirizzo di pagamento sia nella Geo Zone selezionata e che l'ordine raggiunga il Total impostato nelle impostazioni. La pagina delle impostazioni mostra un avviso per le chiavi mancanti e per una valuta del negozio diversa da PLN.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: Tpay non è riuscito a consegnare la notifica oppure questa è stata rifiutata. Attiva Debug log e controlla il campo Log nella pagina dell'estensione. Le cause più comuni sono un codice di sicurezza o un Merchant ID errati per l'ambiente del pagamento, un indirizzo di notifica bloccato (firewall, autenticazione HTTP) o un server senza OpenSSL o senza HTTPS in uscita per la verifica JWS. L'ordine riceve comunque il suo stato quando il cliente torna nel negozio dopo aver pagato.

Notification answered FALSE - invalid checksum: il Merchant ID o il codice di sicurezza nelle impostazioni non corrispondono all'account Tpay (sandbox o produzione) del pagamento.

Notification answered FALSE - invalid JWS signature: non è stato possibile verificare la firma, per esempio perché manca OpenSSL o il certificato Tpay non può essere scaricato. Correggi il server oppure, se necessario, disattiva JWS signature; il checksum MD5 viene comunque verificato.

Notification answered FALSE - busy, retry later oppure FALSE - order could not be updated: il carrello era in elaborazione da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. Tpay ripete la notifica automaticamente. Attiva Debug log per vedere il motivo.

L'URL di notifica mostra FALSE - POST only in the browser: è normale. L'URL accetta solo notifiche da Tpay.

L'ordine è nello stato di verifica: leggi le note nella scheda VibeFox Tpay Payment (vedi Stati dell'ordine), controlla il pagamento nel pannello Tpay, poi evadi l'ordine o rimborsa il pagamento.

Il cliente ha visto The Tpay payment could not be started: le chiavi della modalità attuale sono errate oppure Tpay ha rifiutato la richiesta. Attiva Debug log; il registro mostra l'errore di Tpay.

Il cliente ha visto This payment method is not available: la sessione di checkout non corrisponde più all'ordine, oppure il metodo di pagamento è stato disattivato o ha perso le chiavi nel frattempo. Il cliente ricarica il checkout.

Il cliente ha visto We could not match this payment to an order: il link di ritorno non apparteneva all'ordine. Se il cliente è stato addebitato, la notifica imposta comunque lo stato dell'ordine; controlla il pannello Tpay.

Il rimborso non riesce: se il messaggio dice che mancano le chiavi, inserisci le chiavi dell'ambiente in cui l'ordine è stato pagato. Se dice che l'importo è troppo alto, si può rimborsare al massimo l'importo mostrato. Se Tpay non ha confermato il rimborso, controlla la transazione nel pannello commerciante Tpay prima di riprovare. Se la scheda indica Tpay transaction ID not found., l'ordine non ha un pagamento Tpay confermato da rimborsare.

Per gli sviluppatori: prima della creazione della transazione Tpay, l'estensione attiva l'evento OpenCart wc_tp_transaction_data con i dati della transazione, l'ordine e l'ambiente.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Tpay Payment. 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. Vengono rimossi sempre anche l'evento OpenCart dell'estensione (su OpenCart 4 anche i suoi eventi e la sua azione di avvio, startup action) e i token di accesso Tpay e i certificati in cache. Se Delete data on uninstall è attivo, vengono rimosse anche le altre impostazioni del gateway (titolo, descrizione, modalità sandbox, chiavi, firma JWS, interruttore del registro di debug) e il registro. Se è disattivo, restano conservate per una reinstallazione successiva. Le transazioni e i rimborsi Tpay vengono sempre conservati, quindi gli ordini pagati in precedenza possono essere rimborsati anche dopo una reinstallazione. Gli ordini esistenti conservano le note di pagamento.

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

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