VibeFox TrustPay for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo.

Account finby (TrustPay): ti serve un progetto nel Merchant Portal di finby con il suo Project ID e la sua Secret key. Per i pagamenti di prova ti serve un progetto di test (playground) separato, con il proprio Project ID e la propria Secret key. Non servono altre chiavi: la Secret key viene usata sia per ottenere l'accesso all'API sia per verificare la firma delle notifiche di pagamento.

URL di notifica raggiungibile: finby deve poter raggiungere il tuo negozio da internet. Un firewall, un accesso di manutenzione o l'autenticazione HTTP davanti al negozio bloccano le notifiche di pagamento.

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_trustpay_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_trustpay_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_trustpay_gateway-oc3-(version).ocmod.zip. L'estensione non ha modifiche OCMOD, quindi Extensions > Modifications non deve essere aggiornato. Invece dell'installer puoi 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 TrustPay 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 di licenza in cima alla pagina, e clicca su Activate (vedi Chiave di licenza).

4. Inserisci il Project ID e la Secret key del tuo progetto di test e, per i pagamenti reali, del tuo progetto live (vedi Configurazione). L'URL di notifica viene inviato con ogni pagamento, quindi non serve configurare nulla nel Merchant Portal.

5. Attiva Enable / Disable e clicca su Save. Esegui 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_trustpay_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 TrustPay Gateway, clicca su Install (il pulsante verde +), poi su Edit (il pulsante a matita).

4. Inserisci la chiave di licenza e i progetti finby come ai passaggi da 3 a 5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono gli stessi in entrambe le versioni. Cambia solo l'URL di notifica (vedi Configurazione).

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

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox TrustPay 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 metodo di pagamento è attivo ma il Project ID o la Secret key della modalità corrente sono vuoti, e quando la valuta predefinita del negozio non è supportata. In entrambi i casi il metodo di pagamento viene nascosto al checkout. 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), Minimum total deve essere un numero maggiore o uguale a 0, e la zona geografica e gli stati ordine selezionati devono esistere. Altrimenti non viene salvato nulla e la pagina mostra il messaggio. Un Project ID deve contenere solo cifre: se salvi un altro valore, la pagina mostra must contain digits only — the previous value was kept. e gli altri campi vengono salvati.

TrustPay / finby

Enable / Disable: Enable TrustPay / finby card payments. attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

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

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Pay securely by card on the TrustPay / finby payment page.

Sort order: la posizione del metodo di pagamento al checkout. Lascia vuoto oppure inserisci un numero intero (sono ammessi valori negativi).

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

Minimum total: il totale del checkout, nella valuta predefinita del negozio, che un ordine deve raggiungere prima che venga proposto il metodo di pagamento. Lascia vuoto per nessun minimo.

Credenziali API

Copia il Project ID e la Secret key del tuo progetto dal Merchant Portal di finby (TrustPay). La sezione contiene un link al Merchant Portal. I pagamenti di prova usano un progetto di test (playground) separato, con il proprio Project ID e la propria Secret key. Lì non viene addebitato denaro reale.

Test mode: usa il progetto di test (nessun pagamento reale). I nuovi pagamenti e rimborsi usano le credenziali di test. I rimborsi di un ordine vanno sempre al progetto con cui è stato pagato l'ordine. Predefinito: attivo. Finché è attivo, i clienti vedono Test mode: no real payment will be taken. nel passaggio Confirm Order.

Live Project ID: il Project ID numerico del tuo progetto live.

Live Secret key: la Secret key del progetto live. Serve per ottenere i token di accesso all'API e per verificare le notifiche di pagamento.

Test Project ID: il Project ID numerico del tuo progetto di test (playground).

Test Secret key: la Secret key del progetto di test.

Le Secret key vengono salvate esattamente come inserite; vengono rimossi solo gli spazi iniziali e finali. Le Secret key salvate non vengono mai più mostrate. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo per cambiarlo. Il salvataggio delle impostazioni elimina anche i token di accesso all'API in cache, così le nuove credenziali vengono usate subito.

Clear saved secrets: seleziona una Secret key e clicca su Save per rimuoverla. Un campo vuoto mantiene il valore salvato.

Stati ordine

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che finby lo conferma con una notifica firmata. Ogni campo qui sotto elenca i tuoi stati ordine OpenCart. OpenCart non ha stati propri per un pagamento TrustPay in attesa o sospeso, quindi entrambi usano In attesa come predefinito; le note dell'ordine e la scheda dell'ordine li distinguono. Puoi creare i tuoi stati in System > Localisation > Order Statuses e selezionarli qui.

Order status after payment: lo stato di un ordine pagato. Predefinito: In lavorazione. Seleziona Completato se gli ordini pagati devono essere completati subito. Lo stato viene impostato in un solo passaggio, quindi il cliente riceve una sola e-mail.

Awaiting TrustPay payment: finby ha segnalato l'ultimo pagamento come in sospeso; l'ordine passa allo stato pagato quando finby lo conferma. Predefinito: In attesa.

TrustPay payment on hold: il pagamento è stato solo autorizzato (da catturare nel Merchant Portal), oppure l'importo o la valuta pagati non corrispondono alla richiesta di pagamento o al totale dell'ordine. Predefinito: In attesa.

Payment error: finby ha rifiutato l'ultimo pagamento di un ordine in attesa. Un pagamento confermato successivamente sposta comunque l'ordine allo stato pagato. Predefinito: Fallito.

Cancelled order status: l'estensione non lo imposta. Un ordine in questo stato non viene mai riaperto da un pagamento tardivo; viene aggiunta una nota. Predefinito: Annullato.

Refunded order status: impostato dopo un rimborso totale dalla pagina dell'ordine. Predefinito: Rimborsato.

Notifiche di pagamento

L'ordine viene contrassegnato come pagato solo dopo che finby lo conferma con una notifica firmata. L'estensione invia automaticamente l'URL di notifica con ogni pagamento, quindi non devi configurarlo. La sezione mostra l'URL sotto Notification URL. In OpenCart 3 ha questa forma https://your-store/index.php?route=extension/payment/wcp_trustpay_gateway/callback, in OpenCart 4 https://your-store/index.php?route=extension/wcp_trustpay_gateway/payment/wcp_trustpay_gateway.callback. È costruito dall'indirizzo del negozio della tua installazione OpenCart. Puoi anche inserirlo come URL di notifica dei tuoi progetti nel Merchant Portal. Le notifiche senza una firma valida vengono rifiutate. L'URL 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).

L'estensione non chiede da sola a finby lo stato del pagamento. Se una notifica non raggiunge il tuo negozio, l'ordine resta senza stato finché finby non la consegna. finby ripete le notifiche.

Advanced

Debug logging: aggiunge richieste API e notifiche a trustpay_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. Gli errori vengono sempre registrati, anche quando questa opzione è disattivata. Il registro non contiene chiavi, token, dati della carta o dati dei clienti. Predefinito: disattivato.

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 dell'estensione e il registro. I dati degli ordini vengono conservati: ordini, registrazioni dei pagamenti TrustPay e rimborsi. Predefinito: disattivato.

Import / Export

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

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

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Card payment (TrustPay)). Viene proposto solo quando la valuta del cliente è una delle valute supportate: EUR, CZK, HUF, GBP, PLN, NOK, SEK, DKK, BGN, RON, CHF e USD. Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota You will be redirected to the secure TrustPay / finby payment page to pay by card. OpenCart crea l'ordine in questo passaggio, ancora senza stato. In 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.

Quando il cliente clicca su Confirm Order, l'estensione crea presso finby una richiesta di pagamento con carta per il totale dell'ordine nella valuta dell'ordine. Gli importi in HUF vengono inviati senza decimali. Nome, indirizzo ed e-mail del cliente vengono inviati per il 3-D Secure, e il numero d'ordine OpenCart viene inviato come riferimento. I pagamenti con carta richiedono un indirizzo: se manca via, città, CAP o paese, il cliente vede Please enter your billing address (street, city, postcode and country) — it is required for card payments. In OpenCart 4, che per impostazione predefinita non chiede un indirizzo di pagamento, i campi mancanti vengono ripresi dall'indirizzo di spedizione. Il cliente viene reindirizzato alla pagina di pagamento di finby e paga lì con la carta. La pagina si apre nella lingua del negozio quando finby la supporta, altrimenti in inglese.

Dopo il pagamento, il cliente torna nel tuo negozio. L'ordine viene contrassegnato come pagato solo dopo che finby lo conferma con la notifica firmata. Il ritorno in sé non modifica mai lo stato del pagamento. Se la notifica è già arrivata, il cliente vede la pagina di successo dell'ordine di OpenCart. In caso contrario, una pagina Payment confirmation riporta TrustPay / finby is confirming your card payment. Your order is confirmed as soon as the payment is confirmed, and you will receive an e-mail — there is no need to pay again. Ha un pulsante Check again e un pulsante Back to checkout. Mentre l'ordine è in stato di attesa o sospeso, la pagina di successo mostra Your card payment is being confirmed by TrustPay / finby. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Quando poi un ordine in attesa o sospeso viene pagato, oppure finby rifiuta il suo pagamento, il cliente riceve l'e-mail sul nuovo stato dell'ordine. Se finby ha rifiutato il pagamento o l'ordine non pagato è stato annullato, la pagina di successo mostra Your card payment was not completed. Please contact us about this order. In OpenCart 4, quando il cliente torna dalla pagina di pagamento di finby, una breve pagina intermedia riapre l'indirizzo di ritorno del tuo negozio, così carrello e accesso del cliente vengono mantenuti.

Se il cliente annulla nella pagina di pagamento, torna al checkout con The card payment was cancelled. You can try again or choose another payment method. Se la pagina di pagamento restituisce un errore, oppure finby ha già rifiutato il pagamento, il messaggio è The card payment was not completed. Please try again or choose another payment method. Il carrello viene conservato e il cliente può pagare di nuovo. In OpenCart 4 questi messaggi vengono mostrati sopra la pagina del 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 viene pagato da un solo ordine: appena un ordine del carrello ha uno stato TrustPay, confermare di nuovo il carrello porta alla pagina di successo invece che a un secondo pagamento. Una modifica del carrello, anche una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.

OpenCart 4 mantiene l'ordine nel checkout fino alla visualizzazione della pagina di successo. Dopo un pagamento annullato o non riuscito, il cliente paga lo stesso ordine con una nuova richiesta di pagamento finby. Se nel frattempo quell'ordine è stato chiuso, il cliente torna al checkout e il successivo Confirm Order paga un nuovo ordine: dopo un pagamento rifiutato o un ordine non pagato annullato, con The card payment was not completed. Please try again or choose another payment method.; altrimenti (per esempio se hai annullato o rimborsato l'ordine) con Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order.

Se finby non riesce ad avviare il pagamento, il cliente resta nel passaggio Confirm Order con We could not start the card payment. Please try again in a moment or choose another payment method. sopra il pulsante. Il motivo tecnico viene scritto nel registro.

L'estensione accetta solo pagamenti con carta, come acquisto in un unico passaggio sulla pagina di finby. Non prevede bonifici bancari o altri metodi di pagamento finby, nessun pulsante Apple Pay o Google Pay sul tuo sito, nessuna carta salvata, nessun abbonamento o pagamento ricorrente, nessuna autorizzazione e cattura separate e nessun controllo periodico dello stato.

Ordini e rimborsi

Stati ordine

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

Stato ordine dopo il pagamento (predefinito In lavorazione): finby ha confermato il pagamento, e importo e valuta corrispondono alla richiesta di pagamento e al totale dell'ordine. Una nota mostra l'importo, la richiesta di pagamento e il progetto (test o live).

Pagamento TrustPay in attesa (predefinito In attesa): finby ha segnalato l'ultimo pagamento come in sospeso. L'ordine passa allo stato pagato quando finby conferma il pagamento.

Pagamento TrustPay sospeso (predefinito In attesa): viene impostato in due casi. Il pagamento è stato solo autorizzato, non catturato: cattura o annulla nel Merchant Portal di finby, poi aggiorna l'ordine. Oppure importo o valuta pagati non corrispondono alla richiesta di pagamento o al totale dell'ordine: verifica il pagamento prima della spedizione. La nota spiega il caso. Il denaro è stato ricevuto, quindi è possibile un rimborso.

Errore di pagamento (predefinito Fallito): finby ha rifiutato l'ultimo pagamento di un ordine in attesa. La nota mostra il motivo quando finby lo invia. Un pagamento confermato successivamente sposta comunque l'ordine allo stato pagato.

Stato ordine rimborsato (predefinito Rimborsato): il pagamento è stato rimborsato interamente tramite l'estensione.

Gli ordini annullati o rimborsati non vengono mai riaperti da un pagamento tardivo. Una nota ti chiede di ripristinare l'ordine o di rimborsare il pagamento nel Merchant Portal. Se arriva un secondo pagamento per un ordine già pagato, oppure per un altro ordine di un carrello che ha già un ordine pagato, l'ordine non viene modificato e una nota ti chiede di rimborsare il duplicato nel Merchant Portal. Contestazioni e dispute segnalate da finby vengono aggiunte come note.

Le note sono voci della History dell'ordine che il cliente non vede. Vengono scritte nella lingua predefinita del negozio.

VibeFox TrustPay Gateway tab

In Sales > Orders apri un ordine pagato con TrustPay. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox TrustPay Gateway mostra il Payment request ID, il Payment ID, il Project con un badge Test project per i pagamenti di prova, lo Status, gli importi Requested / paid e Paid / refunded, il modulo di rimborso, lo storico dei rimborsi, le Payment requests of this order e le TrustPay notes. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox TrustPay Gateway inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via TrustPay. Conferma la domanda Refund this amount through TrustPay? 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 effettuati nell'importo e nella valuta che finby ha indicato per il pagamento, quindi dopo una differenza di importo puoi rimborsare fino a quanto il cliente ha effettivamente pagato, non fino al totale dell'ordine. I rimborsi in HUF devono essere importi interi.

Il rimborso va al progetto con cui è stato pagato l'ordine (test o live), anche se nel frattempo hai cambiato modalità. Il Project ID e la Secret key di quel progetto devono essere impostati, e il suo Project ID non deve essere cambiato. Un rimborso viene registrato solo se finby lo accetta. Altrimenti la scheda mostra TrustPay refused the refund: con il motivo, e non viene registrato alcun rimborso. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note. Un rimborso totale imposta l'ordine su Refunded order 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.

I resi di prodotti in Sales > Returns non rimandano denaro tramite finby. I rimborsi effettuati nel Merchant Portal di finby non vengono registrati come rimborsi. Se finby invia una notifica al riguardo, viene aggiunta come nota e lo stato dell'ordine non cambia.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco di licenza License — VibeFox TrustPay Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox TrustPay Gateway > Edit, sopra le impostazioni. Inserisci 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 controllare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuovere la chiave da questo negozio. Sotto ci sono la riga Product: opencart-payment-trustpay 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 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 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 solo 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, il pagamento con carta non viene mostrato ai clienti al checkout. Se comunque viene avviato un pagamento, 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 con (unlicensed — visible to admins only), così puoi configurare e provare l'estensione prima di acquistare una chiave. In 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 TrustPay e dal ritorno al negozio, e i rimborsi funzionano.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono un rinnovo. Lo stato viene controllato di nuovo automaticamente quando apri la Dashboard o la pagina Edit dell'amministrazione: una volta al giorno nei 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

Card payment (TrustPay) non appare al checkout: controlla che la licenza sia attiva, che Enable / Disable sia attivo e che la modalità corrente abbia il suo Project ID e la sua Secret key: Test Project ID e Test Secret key in modalità test, Live Project ID e Live Secret key in modalità live. La valuta del cliente deve essere una delle valute supportate. La pagina delle impostazioni mostra un avviso quando mancano le credenziali o la valuta predefinita non è supportata. Controlla anche che l'indirizzo di pagamento sia nella Geo zone selezionata e che l'ordine raggiunga il Minimum total.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: la notifica non ha raggiunto il tuo negozio. Controlla che l'URL mostrato sotto Notification URL sia raggiungibile da internet (nessun firewall, accesso di manutenzione o autenticazione HTTP). finby ripete la notifica e l'ordine riceve il suo stato quando arriva. Gli errori vengono sempre scritti nel registro; guarda il campo Log nella pagina dell'estensione.

Il registro mostra Notification rejected: invalid signature or unknown project: la notifica proviene da un progetto il cui Project ID non è nelle impostazioni, oppure la Secret key di quel progetto è errata. Il negozio risponde Invalid signature e non viene modificato nulla. Controlla il Project ID e la Secret key della modalità in cui è stato effettuato il pagamento.

Il registro mostra Notification ignored: la notifica appartiene a una richiesta di pagamento che questo negozio non ha creato per quell'ordine, oppure a un altro progetto o modalità rispetto a quello con cui è stato avviato il pagamento. Non viene modificato nulla.

La notifica riceve la risposta Busy, retry later o Temporary error: il carrello era in aggiornamento da un'altra notifica nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. finby la ripeterà. Il registro mostra il motivo.

Il cliente vede We could not start the card payment: apri il registro. Un Project ID o una Secret key errati producono un messaggio che indica che finby ha rifiutato le credenziali del progetto. Controlla che le credenziali di test siano nei campi di test e quelle live nei campi live.

Card payment is temporarily unavailable: il cliente vede questo messaggio quando la modalità corrente non ha Project ID o Secret key. Inseriscili e salva.

L'ordine è nello stato sospeso: leggi le note nella scheda VibeFox TrustPay Gateway (vedi Stati ordine). Controlla il pagamento nel Merchant Portal prima della spedizione, poi evadi l'ordine o rimborsa il pagamento.

Il rimborso fallisce con un messaggio sul progetto: l'ordine è stato pagato tramite il progetto di test o live, e il Project ID o la Secret key di quella modalità non sono impostati, oppure ora è salvato un altro Project ID. Inserisci le credenziali di quel progetto, oppure rimborsa il pagamento nel Merchant Portal di finby.

Invalid refund amount: at most … can be refunded: l'importo è superiore a quanto pagato meno i rimborsi già effettuati tramite l'estensione.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox TrustPay Gateway. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart rimuove sempre le impostazioni proprie dell'estensione: Enable / Disable, Sort order, Geo zone, Minimum total e gli stati ordine, che tornano ai valori predefiniti in caso di reinstallazione. Vengono rimossi anche l'evento OpenCart dell'estensione e i token di accesso all'API in cache (in 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, modalità test, Project ID, Secret key, registrazione) e il registro. Se è disattivo, vengono conservate per una reinstallazione successiva. Le registrazioni dei pagamenti TrustPay e i rimborsi vengono sempre conservati, quindi gli ordini pagati in precedenza possono ancora essere rimborsati dopo una reinstallazione. Gli ordini esistenti conservano le loro note di pagamento.

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

TrustPay e finby sono marchi dei rispettivi proprietari. Questa estensione non è affiliata né approvata da TrustPay o finby.