VibeFox Paytrail 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: EUR. Paytrail accetta solo euro. Per un ordine in qualsiasi altra valuta, il metodo di pagamento non viene mostrato al checkout. Gli importi vengono inviati in centesimi.

Accesso a internet per il negozio: Paytrail conferma ogni pagamento con una callback server-to-server, quindi il negozio dovrebbe essere raggiungibile da internet. Senza le callback, gli ordini vengono comunque confermati quando il cliente torna da Paytrail.

Account Paytrail: ti servono il tuo Merchant ID e la tua chiave segreta, mostrati nel Merchant Panel di Paytrail (dettagli dell'account o dell'integrazione). Per i test non serve alcun account: la modalità test usa l'account di prova pubblico di Paytrail. I metodi di pagamento stessi si abilitano nel tuo account Paytrail.

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. Estrailo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 wcp_paytrail_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_paytrail_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_paytrail_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 principale del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Paytrail 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. Per provare prima l'estensione, attiva Test mode. Per i pagamenti reali, disattivalo e inserisci il tuo Merchant ID e la tua Secret key. Non occorre configurare alcun URL di callback in Paytrail.

5. Attiva Enable/Disable e clicca su Save.

OpenCart 4

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

4. Inserisci la chiave di licenza e le impostazioni Paytrail 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'URL di callback (vedi Ordini).

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

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Paytrail Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni, la pagina mostra La modalità test è attiva. I pagamenti usano l'account di prova pubblico di Paytrail — non viene addebitato denaro reale. quando la modalità test è attiva. In modalità live avvisa se mancano il merchant ID o la chiave segreta, oppure se il merchant ID è l'account di prova pubblico 375917; in questi casi Paytrail non viene mostrato al checkout. Avvisa anche se la valuta predefinita del negozio non è EUR: in tal caso Paytrail viene mostrato solo quando il cliente paga in EUR. 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 i 128 caratteri, Sort Order deve essere un numero intero (sono ammessi i numeri negativi), Total deve essere un numero pari o superiore a 0, e la geo zone e gli stati dell'ordine devono esistere; altrimenti non viene salvato nulla. Un merchant ID che contiene altro oltre alle cifre non viene salvato: compare l'errore Il merchant ID Paytrail deve contenere solo cifre. È stato mantenuto il valore precedente. e le altre impostazioni vengono salvate.

Paytrail

La sezione inizia con una breve nota sulla pagina di pagamento Paytrail e sulla regola per cui l'ordine riceve uno stato solo dopo che Paytrail ha confermato il pagamento.

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

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

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma, accanto all'icona di Paytrail. Predefinito: Pay securely with Finnish online banking, card, mobile payment or invoice on the Paytrail payment page.

Sort Order: la posizione di Paytrail tra i metodi di pagamento al checkout. Lascialo vuoto oppure inserisci un numero intero.

Geo Zone: offri Paytrail solo per gli indirizzi di pagamento nella geo zone selezionata. Predefinito: All zones. Le geo zone 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 Paytrail. Lascialo vuoto per offrire Paytrail per qualsiasi totale.

Credenziali API

Il tuo Merchant ID e la tua chiave segreta sono mostrati nel Merchant Panel di Paytrail (dettagli dell'account o dell'integrazione). La sezione contiene un link a Paytrail. Sono supportati solo pagamenti in EUR.

Test mode: usa l'account di prova pubblico di Paytrail (Merchant ID 375917) per i nuovi pagamenti, al posto delle tue credenziali. Non viene addebitato denaro reale e non servono chiavi. I clienti vedono Modalità test: nessun pagamento reale verrà effettuato. nel passaggio Confirm Order. La chiave segreta dell'account di prova è pubblica, quindi chiunque potrebbe simulare un pagamento effettuato in modalità test. Non lasciare mai la modalità test attiva in un negozio live. Predefinito: disattivato.

Merchant ID: il tuo Merchant ID Paytrail (solo cifre). Viene usato quando la modalità test è disattivata. A differenza della chiave segreta, viene mostrato nella pagina dopo il salvataggio.

Secret key: la tua chiave segreta Paytrail. Viene usata quando la modalità test è disattivata. La chiave salvata non viene mai mostrata di nuovo. Il campo resta vuoto e mostra Salvata — lasciare vuoto per mantenerla. Inserisci un nuovo valore solo se vuoi cambiarla. Per rimuovere la chiave segreta salvata, spunta Clear saved secret key sotto il campo e clicca su Save.

Callback e rimborsi usano sempre le credenziali della modalità in cui il pagamento è stato effettuato, quindi passare da test a live non compromette gli ordini precedenti.

Ordini

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

Callback URL: mostra l'URL a cui Paytrail conferma ogni pagamento server-to-server. Nel caso di OpenCart 3 ha la forma https://your-store/index.php?route=extension/payment/wcp_paytrail_gateway/callback, su OpenCart 4 https://your-store/index.php?route=extension/wcp_paytrail_gateway/payment/wcp_paytrail_gateway.callback. Viene inviato con ogni pagamento, quindi nel pannello di Paytrail non c'è nulla da configurare, ma il negozio deve essere raggiungibile da internet.

Order status after payment: lo stato di un ordine pagato. Predefinito: Processing. Seleziona Complete se ogni ordine pagato deve essere completato subito.

Awaiting payment status: Paytrail segnala il pagamento come in attesa o ritardato (una fattura o una rateizzazione in attesa dell'approvazione del fornitore). L'ordine viene aggiornato automaticamente quando Paytrail conferma o rifiuta il pagamento. Predefinito: Pending.

Payment on hold status: il pagamento richiede la tua attenzione (vedi Stati dell'ordine). Predefinito: Pending, perché OpenCart non ha lo stato On hold. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Payment failed status: impostato quando un pagamento Paytrail in attesa fallisce. Predefinito: Failed.

Refunded status: impostato dopo che il pagamento è stato rimborsato per intero dalla pagina dell'ordine. Predefinito: Refunded.

Avanzate

Debug log: registra richieste API e callback in ptg_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 ptg_debug.old.log.php. Dati personali e chiavi non vengono registrati. Errori e avvisi vengono sempre registrati. Predefinito: disattivato.

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

Delete data on uninstall: se attivo, disinstallando l'estensione vengono rimosse le impostazioni del gateway e il log. Disattivare l'estensione non cancella mai nulla. I dati delle transazioni Paytrail degli ordini vengono sempre conservati, perché i rimborsi degli ordini vecchi ne hanno bisogno. Predefinito: disattivato.

Import / Export

Export: Download JSON salva le impostazioni in un file JSON. Il merchant ID e la chiave segreta non vengono esportati.

Import: incolla il JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. Il merchant ID e la chiave segreta salvati vengono mantenuti.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Paytrail). Nel passaggio Confirm Order il cliente vede l'icona di Paytrail e la tua descrizione. 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 dei metodi 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 un pagamento Paytrail per il totale dell'ordine in euro, con il numero dell'ordine come riferimento, e vi allega le righe dell'ordine: prodotti con opzioni e imposte, buoni regalo acquistati, spedizione e altri costi. Coupon, credito del negozio, punti fedeltà e buoni regalo utilizzati vengono distribuiti sulle righe. Le righe corrispondono sempre all'importo del pagamento; un eventuale arrotondamento viene assorbito da una riga oppure inviato come riga Rounding. Vengono inviati i dati di contatto del cliente, e gli indirizzi di fatturazione e di consegna solo se sono completi. La lingua della pagina di pagamento è finlandese, svedese o inglese, in base alla lingua del cliente.

Il cliente viene inviato alla pagina di pagamento Paytrail, sceglie un metodo di pagamento abilitato nel tuo account Paytrail e paga. Paytrail conferma poi il pagamento due volte: rimanda il cliente al tuo negozio e chiama l'URL di callback server-to-server. Entrambe le conferme vengono accettate solo con una firma valida creata con le credenziali di quel tentativo di pagamento, e solo per un tentativo creato per quell'ordine. L'importo pagato viene confrontato con il totale dell'ordine. L'ordine viene segnato come pagato solo dopo la conferma di Paytrail in questo modo, e riceve quindi il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento del magazzino. L'estensione gestisce questi stati di Paytrail:

Dopo un pagamento riuscito il cliente vede la pagina di successo dell'ordine di OpenCart con Il tuo pagamento Paytrail è stato ricevuto. Per un pagamento in attesa, la pagina mostra Il tuo pagamento Paytrail è in attesa di conferma da parte del fornitore del servizio di pagamento. L'ordine verrà aggiornato automaticamente — non pagare di nuovo. Se la callback sta registrando il pagamento proprio in quel momento, una pagina Payment confirmation chiede al cliente di non pagare di nuovo e offre Check again.

Dopo un pagamento annullato o fallito, il cliente torna al checkout con Il pagamento Paytrail è stato annullato o è fallito. Puoi riprovare o scegliere un altro metodo di pagamento. Se il pagamento non è ancora concluso, il messaggio è Il pagamento Paytrail non è ancora stato completato. Puoi riprovare o scegliere un altro metodo di pagamento. Il carrello viene conservato. Su OpenCart 4 questi messaggi vengono mostrati sopra la pagina di checkout. Un ritorno che non può essere verificato mostra una pagina Payment Error con Payment verification failed. e non modifica nulla.

Se Paytrail non riesce ad avviare il pagamento, il cliente resta nel passaggio Confirm Order con un breve messaggio sopra il pulsante, per esempio Impossibile connettersi a Paytrail. Riprova tra poco., Paytrail è temporaneamente non disponibile. Scegli un altro metodo di pagamento. (credenziali errate) oppure Paytrail non è riuscito ad avviare il pagamento. Controlla i dati di fatturazione e riprova, oppure scegli un altro metodo di pagamento. Il motivo tecnico viene scritto nel log. Un totale al di fuori dei limiti di Paytrail mostra Questo totale d'ordine non può essere pagato con Paytrail. Scegli un altro metodo di pagamento.

OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, OpenCart 4 aggiorna l'ordine del checkout (un nuovo tentativo paga lo stesso ordine). Se il carrello è già stato pagato con un altro ordine, il cliente va direttamente alla pagina di successo e non viene avviato alcun nuovo pagamento. Un pagamento Paytrail non può essere annullato tramite API, quindi una pagina di pagamento più vecchia resta pagabile. Se il cliente la paga comunque, il secondo pagamento viene segnalato sull'ordine pagato come duplicato da rimborsare, e l'altro ordine resta senza stato. Una modifica del carrello, compresa una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.

Su OpenCart 4 l'ordine resta nel checkout finché non viene mostrata la pagina di successo. Se nel frattempo quell'ordine è stato chiuso senza pagamento (per esempio lo hai annullato), il cliente torna al checkout con il messaggio Il tuo ordine precedente è stato annullato o rimborsato. Conferma di nuovo l'ordine per pagare con un nuovo ordine. Se il pagamento in attesa di quell'ordine è fallito, il messaggio è Il pagamento Paytrail è stato annullato o è fallito. Puoi riprovare o scegliere un altro metodo di pagamento. Il successivo Confirm Order paga un nuovo ordine. Se quell'ordine era già stato pagato per un carrello precedente e il carrello è cambiato da allora, il cliente torna al checkout, e il successivo Confirm Order paga un nuovo ordine del carrello attuale. Un ordine chiuso non viene mai mostrato come pagato.

La callback funziona anche mentre il negozio è in modalità manutenzione, perché OpenCart lascia passare le richieste delle estensioni di pagamento (su OpenCart 4 l'estensione aggiunge a questo scopo una propria azione di avvio, che lascia passare anche il ritorno del cliente da Paytrail).

Il cliente sceglie il metodo di pagamento nella pagina di Paytrail, non nel tuo checkout. L'estensione non prevede tokenizzazione delle carte né carte salvate, abbonamenti, shop-in-shop, attivazione manuale delle fatture né report di regolamento.

Ordini e rimborsi

Stati dell'ordine

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

Order status after payment (predefinito Processing): il pagamento è stato confermato. Una nota mostra la transazione Paytrail, il metodo di pagamento usato in Paytrail e l'importo, con TEST mode — no real money. per i pagamenti di prova.

Awaiting payment status (predefinito Pending): il pagamento è in attesa presso il fornitore (fattura o pagamento differito). L'ordine passa allo stato pagato quando Paytrail conferma il pagamento, oppure allo stato fallito quando il pagamento fallisce.

Payment on hold status (predefinito Pending): l'importo pagato differisce dal totale dell'ordine (viene registrato l'importo effettivamente pagato), il pagamento è arrivato dopo che l'ordine era stato portato a un altro stato, per esempio annullato, oppure è stato ricevuto un pagamento di prova mentre l'estensione era in modalità live (nessun denaro reale, nulla da rimborsare). La nota spiega il motivo. Controlla l'ordine, poi evadilo o rimborsa il pagamento.

Payment failed status (predefinito Failed): un pagamento Paytrail in attesa è fallito o è stato annullato.

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

Callback ripetute o parallele vengono applicate una sola volta, senza note duplicate. Un ordine pagato, rimborsato o completato non viene mai riaperto da una callback successiva. Se viene pagato un secondo tentativo di un ordine o di un carrello già pagato, l'ordine non viene modificato; una nota Duplicate payment ti chiede di rimborsarlo nel Merchant Panel di Paytrail.

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

Scheda VibeFox Paytrail Gateway

In Sales > Orders apri un ordine pagato con Paytrail. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Paytrail Gateway elenca i tentativi di pagamento dell'ordine (data, transazione Paytrail e timbro con l'etichetta Test per i pagamenti di prova, importo, metodo di pagamento, stato e risultato in Paytrail), gli importi Paid / refunded, il modulo di rimborso, lo storico dei rimborsi e le Paytrail notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox Paytrail Gateway inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un motivo per la nota dell'ordine, e clicca su Refund via Paytrail. Conferma la domanda Rimborsare questo importo tramite Paytrail? L'operazione non può essere annullata. Sono supportati rimborsi totali e parziali, solo per importi. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). Puoi rimborsare fino all'importo effettivamente incassato da Paytrail, quindi dopo una discrepanza di importo il limite è quanto ha pagato il cliente, non il totale dell'ordine. Il rimborso usa le credenziali della modalità in cui il pagamento è stato effettuato, quindi per un pagamento live devono essere impostate le credenziali live. I rimborsi sono disponibili una volta che Paytrail ha confermato il pagamento.

Se il metodo di pagamento non supporta i rimborsi diretti, l'estensione avvia automaticamente un rimborso via e-mail: Paytrail invia un'e-mail al cliente per inserire un conto bancario. Questo richiede l'e-mail del cliente sull'ordine. La nota indica quale tipo di rimborso è stato avviato.

Un rimborso può essere completato subito oppure elaborato più tardi. La conferma successiva di Paytrail viene aggiunta come nota. Se Paytrail non è riuscito a completare il rimborso, una nota segnala che il denaro non è stato restituito al cliente e il rimborso non viene più considerato effettuato; rimborsa il cliente in un altro modo. Se Paytrail rifiuta subito il rimborso, la scheda mostra l'errore e nessun rimborso viene registrato. Un rimborso totale imposta l'ordine sul Refunded status senza avvisare il cliente e senza rimettere i prodotti a magazzino, come una modifica manuale dello stato. Un rimborso parziale non cambia lo stato.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite Paytrail. I rimborsi effettuati nel Merchant Panel di Paytrail non vengono sincronizzati con OpenCart.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox Paytrail Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Paytrail Gateway > Edit, sopra le impostazioni. Incolla 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 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-paytrail 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 spiega 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, oppure 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. Libera il posto nel tuo account vibefox.net.

Senza una chiave attiva, Paytrail 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 come (unlicensed — visible to admins only), così puoi configurare e testare l'estensione prima di acquistare una chiave. Su OpenCart 4 questa anteprima non è disponibile: il negozio non vede l'accesso dell'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 comunque confermati dalle callback e dal ritorno del cliente, 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 nei primi 14 giorni dopo l'inserimento della chiave, poi una volta alla settimana. Non serve alcun cron job. Disinstallando l'estensione vengono sempre rimossi la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

Paytrail non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che sia attiva Test mode oppure siano compilati Merchant ID e Secret key (e non sia inserito l'account di prova pubblico 375917). Controlla che il cliente paghi in EUR, 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 credenziali mancanti e per una valuta del negozio diversa da EUR.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: la callback non riesce a raggiungere il tuo negozio e il cliente non è tornato al negozio. Il Callback URL mostrato nella sezione Orders deve essere raggiungibile da internet (nessuna autenticazione di base né firewall di mezzo).

Callback o ritorno risponde Payment verification failed.: la firma non è valida, oppure il pagamento non appartiene a nessun tentativo di pagamento dell'ordine. Non cambia nulla. Verifica che la Secret key sia corretta e appartenga al Merchant ID.

La callback risponde Temporarily unavailable: l'ordine era in fase di conferma da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. Paytrail richiama. Controlla il campo Log per il motivo.

Il cliente vede un errore dopo Confirm Order: controlla il campo Log nella pagina dell'estensione. Per esempio Paytrail API error (401) indica credenziali errate. Attiva Debug log per maggiori dettagli. This payment method is not available. Please reload the checkout page. significa che il metodo di pagamento è stato disattivato nel frattempo oppure che il checkout non corrisponde più all'ordine.

Il merchant ID non viene salvato: deve contenere solo cifre. Copialo di nuovo dal Merchant Panel di Paytrail.

L'ordine è nello stato on hold: leggi le note nella scheda VibeFox Paytrail Gateway. Il motivo può essere un importo pagato diverso, un pagamento arrivato dopo un cambio di stato oppure un pagamento di prova in modalità live.

Il rimborso non riesce: leggi il messaggio. This order has no confirmed Paytrail payment. Refund it manually. significa che non c'è alcun pagamento Paytrail confermato da rimborsare. The live Paytrail credentials used for this payment are missing. Enter them in the Paytrail settings. significa che il pagamento è stato effettuato in modalità live e le credenziali live non sono impostate. Invalid refund amount: at most … significa che l'importo è superiore a quanto resta da rimborsare. This payment method supports only e-mail refunds, but the order has no billing e-mail. significa che l'ordine ha bisogno dell'e-mail del cliente.

Per gli sviluppatori: prima che la richiesta di pagamento venga firmata e inviata, l'estensione attiva l'evento OpenCart ptg_payment_request con la richiesta e l'ordine.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Paytrail 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. Anche l'evento OpenCart dell'estensione viene rimosso (su OpenCart 4 anche i suoi eventi e la sua azione di avvio, che lascia passare la callback e il ritorno del cliente in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, modalità test, merchant ID, chiave segreta, registrazione) e il log. Se è disattivo, vengono conservate per una futura reinstallazione. Le transazioni e i rimborsi Paytrail vengono sempre conservati, quindi gli ordini pagati in precedenza possono ancora essere rimborsati dopo una reinstallazione. Gli ordini esistenti mantengono le loro note di pagamento.

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

Paytrail è un marchio registrato del rispettivo proprietario. Questa estensione non è affiliata né approvata da Paytrail.