VibeFox PayU for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo, con l'estensione cURL.

Valuta: la valuta di checkout del cliente deve essere una tra PLN, EUR, CZK, HUF, RON, BGN, GBP, USD, CHF, DKK, NOK, SEK, UAH. La valuta deve essere abilitata anche per il tuo punto vendita presso PayU. Per le altre valute il metodo di pagamento non viene mostrato al checkout.

Accesso a Internet per il tuo negozio: PayU invia le notifiche di pagamento al tuo negozio, quindi deve essere raggiungibile da Internet (non protetto da autenticazione HTTP né bloccato da un firewall). Senza notifiche, i pagamenti vengono comunque verificati quando il cliente torna da PayU.

Account PayU: servono quattro chiavi del tuo punto vendita (POS): POS ID, Second key (MD5), OAuth client_id e OAuth client_secret. Si trovano nel pannello commerciante PayU in Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. Le chiavi sandbox provengono da un account sandbox PayU separato.

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona per 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_payu_payment-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_payu_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, fai clic su Upload e scegli il file wcp_payu_payment-oc3-(version).ocmod.zip. L'estensione non contiene modifiche OCMOD, quindi non è necessario aggiornare Extensions > Modifications. In alternativa all'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 PayU Payment e fai clic su Install (il pulsante verde +). Il tuo utente amministratore deve avere il permesso di modificare l'elenco delle estensioni di pagamento.

3. Fai clic 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 fai clic su Activate (vedi Chiave di licenza).

4. Inserisci le quattro chiavi Sandbox e le quattro chiavi Live (vedi Configurazione). Non è necessario configurare alcun URL di notifica in PayU.

5. Attiva Enable/Disable e fai clic su Save. Lascia Test Mode attivo finché non hai effettuato un pagamento di prova, poi disattivalo per accettare pagamenti reali con le chiavi Live.

OpenCart 4

1. Nell'area di amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file wcp_payu_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. Fai clic su Install (il pulsante verde +) accanto ad esso.

3. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox PayU Payment, fai clic su Install (il pulsante verde +), poi su Edit (il pulsante con la matita).

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

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

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox PayU Payment > 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 la modalità sandbox è attiva (La modalità sandbox (test) è attiva: i pagamenti vanno al sandbox PayU e non viene addebitato denaro reale. Non spedire ordini pagati in modalità test.), quando manca una delle quattro chiavi della modalità corrente (in tal caso PayU non viene mostrato al checkout) e quando PayU non accetta la valuta predefinita del negozio (in tal caso PayU è nascosto per gli ordini in quella valuta). Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio vengono rimossi spazi e interruzioni di riga da tutte le chiavi, perché copiando dal pannello PayU spesso se ne aggiungono. Title non può essere vuoto né superare 128 caratteri (la pagina mostra Inserisci un titolo per il metodo di pagamento (massimo 128 caratteri).), Sort Order deve essere un numero intero (sono ammessi numeri negativi), Total deve essere un numero maggiore o uguale a 0, e la zona geografica e gli stati dell'ordine devono esistere. Altrimenti non viene salvato nulla. Il salvataggio delle impostazioni cancella anche i token di accesso PayU memorizzati nella cache.

PayU

Enable/Disable: Enable PayU payment gateway 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: PayU. Obbligatorio, massimo 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Pay securely via PayU.

Sort Order: la posizione di PayU tra i metodi di pagamento al checkout. Lascia vuoto o inserisci un numero intero.

Geo Zone: offri PayU 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 PayU. Lascia vuoto per offrire PayU per qualsiasi importo.

Credenziali API

Trova le chiavi nel pannello commerciante PayU: Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. Le chiavi sandbox provengono da un account sandbox PayU separato. Tutte e quattro le chiavi di una modalità devono essere compilate. La sezione contiene link alla documentazione per sviluppatori PayU.

Test Mode: usa il sandbox PayU e le chiavi Sandbox qui sotto. Non viene addebitato denaro reale. Finché è attiva, i clienti vedono Modalità sandbox: nessun pagamento reale viene effettuato. nel passaggio Confirm Order. Disattivala per accettare pagamenti reali con le chiavi Live. Predefinito: attiva.

Live POS ID: il POS ID (merchantPosId) del tuo punto vendita di produzione.

Live Second Key (MD5): serve a verificare la firma delle notifiche PayU.

Live OAuth Client ID: il client_id OAuth del punto vendita.

Live OAuth Client Secret: il client_secret OAuth del punto vendita.

Sandbox POS ID: il POS ID del tuo punto vendita PayU sandbox.

Sandbox Second Key (MD5): serve a verificare la firma delle notifiche del sandbox PayU.

Sandbox OAuth Client ID: il client_id OAuth del punto vendita sandbox.

Sandbox OAuth Client Secret: il client_secret OAuth del punto vendita sandbox.

Le Second Key e i client secret salvati non vengono mai più mostrati. Il campo resta vuoto e mostra Salvato — lascia vuoto per mantenerlo. Inserisci un nuovo valore solo se vuoi cambiarlo. I POS ID e i client ID vengono mostrati come salvati.

Clear saved secrets: spunta un segreto e fai clic su Save per rimuoverlo. Un campo vuoto mantiene il valore salvato.

Ogni pagamento ricorda il proprio ambiente. Notifiche, verifiche di stato, ricezione o annullamento di un pagamento e rimborsi usano sempre le chiavi di quell'ambiente, quindi i pagamenti precedenti continuano a funzionare dopo il cambio di modalità. Una notifica firmata con la chiave sandbox non viene mai accettata per un pagamento reale, e viceversa.

Stati dell'ordine

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che PayU ha confermato il pagamento, tramite una notifica firmata o tramite la verifica dello stato al ritorno del cliente. OpenCart non ha lo stato On hold: gli stati di attesa sono predefiniti su Pending, e la scheda PayU dell'ordine e le sue note spiegano il motivo. Ogni campo qui sotto elenca i tuoi stati ordine di OpenCart; puoi crearne di nuovi in System > Localisation > Order Statuses.

Order Status After Payment: impostato quando PayU conferma il pagamento (COMPLETED) e importo e valuta corrispondono. Predefinito: Processing.

Awaiting PayU Payment Confirmation: il pagamento è autorizzato e attende di essere ricevuto (ricezione automatica disattivata o non riuscita). Usa Receive PayU payment o Cancel PayU payment nella scheda PayU dell'ordine. Predefinito: Pending.

PayU Payment On Hold: l'importo pagato o la valuta non corrispondono all'ordine, oppure un pagamento è stato completato per un ordine annullato. L'ordine non viene segnato come pagato; la nota spiega il motivo. Predefinito: Pending.

Payment Error Status: il pagamento di un ordine in attesa di conferma è stato annullato o rifiutato. Predefinito: Failed.

Cancelled Order Status: un pagamento PayU completato per un ordine in questo stato mette l'ordine in attesa invece di riaprirlo in silenzio. L'estensione non imposta mai questo stato. Predefinito: Canceled.

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

Notifiche di pagamento

Notification URL: mostra l'indirizzo a cui PayU invia le notifiche. Su OpenCart 3 ha un aspetto del tipo https://your-store/index.php?route=extension/payment/wcp_payu_payment/notify, su OpenCart 4 https://your-store/index.php?route=extension/wcp_payu_payment/payment/wcp_payu_payment.notify. È costruito dall'indirizzo della vetrina della tua installazione di OpenCart. L'estensione lo invia a PayU con ogni pagamento, quindi non c'è nulla da configurare nel pannello PayU. Assicurati che sia raggiungibile da Internet (non bloccato da un firewall o da un'autenticazione HTTP). Le notifiche funzionano anche quando il negozio è in modalità manutenzione (su OpenCart 4 tramite l'azione di avvio dell'estensione, che lascia passare anche il ritorno del cliente da PayU). Le notifiche senza firma valida vengono rifiutate.

Avanzate

Receive payments automatically: riceve automaticamente i pagamenti in attesa di conferma. Questo conta solo se la ricezione automatica è disattivata per il tuo punto vendita nel pannello PayU: i pagamenti restano in attesa di conferma (WAITING_FOR_CONFIRMATION). Con questa opzione attiva, l'estensione riceve subito questi pagamenti e l'ordine ottiene lo stato di pagato quando PayU comunica che il pagamento è completato. Quando è disattivata, o se la ricezione non riesce, l'ordine riceve Awaiting PayU Payment Confirmation e tu ricevi o annulli il pagamento con i pulsanti nella scheda PayU dell'ordine. Predefinito: attiva.

Logging: registra eventi tecnici (numeri d'ordine, ID ordine PayU, stati, errori; senza chiavi né dati personali) in wc_pu_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web. Gli errori vengono sempre registrati; gli altri eventi solo quando questa opzione è attiva. Predefinito: disattivato.

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

Delete data on uninstall: se attiva, disinstallando l'estensione vengono rimosse le impostazioni del gateway e il registro. Ordini e dati di pagamento (transazioni e rimborsi PayU) non vengono mai eliminati. I token di accesso PayU in cache vengono sempre rimossi. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. I segreti non vengono esportati.

Import: incolla il JSON esportato in precedenza e fai clic su Import per ripristinare le impostazioni. I segreti salvati vengono mantenuti.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita PayU). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota Verrai reindirizzato a PayU per completare il pagamento (BLIK, bonifico bancario, carta e altri metodi). 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 fa clic su Confirm Order, l'estensione crea un ordine PayU per il totale dell'ordine nella valuta dell'ordine, con la descrizione Order #, il numero d'ordine e il nome del tuo negozio, e con i prodotti, il metodo di spedizione e le altre righe di totale dell'ordine da mostrare nella pagina PayU. Email, nome e telefono del cliente vengono passati a PayU, e la lingua della pagina PayU segue la lingua della vetrina. Il cliente viene portato alla pagina PayU, sceglie lì un metodo e paga.

Ogni tentativo ottiene un proprio ordine PayU. Quando il cliente riprova (OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, OpenCart 4 aggiorna l'ordine del checkout), i pagamenti PayU non completati dei tentativi precedenti dello stesso ordine e dello stesso carrello vengono annullati presso PayU, così un vecchio link di pagamento non può essere pagato due volte. Se un pagamento precedente risulta già pagato, viene applicato al suo posto, e un ordine o un carrello già pagato, in attesa o in attesa di conferma va direttamente alla pagina di successo senza un secondo pagamento. Una modifica del carrello, compresa una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.

Il ritorno del cliente nel tuo negozio, da solo, non salda mai un ordine. L'ordine viene segnato come pagato solo dopo che PayU lo ha confermato: con una notifica firmata con la Second Key dell'ambiente del pagamento, oppure con una verifica lato server dello stato dell'ordine PayU quando il cliente torna (al massimo una volta ogni 10 secondi per pagamento). Importo e valuta devono corrispondere. L'ordine riceve quindi il suo stato nel modo standard di OpenCart, con le consuete email d'ordine e l'aggiornamento del magazzino. L'estensione gestisce questi stati PayU:

Dopo un pagamento confermato il cliente vede la pagina di successo dell'ordine di OpenCart. Per un ordine in attesa di conferma o in attesa, la pagina aggiunge Il tuo pagamento è in fase di verifica. Ti invieremo un'email non appena sarà confermato. Quando un ordine del genere viene pagato in seguito o il suo pagamento fallisce, OpenCart comunica al cliente il nuovo stato. Se il pagamento dell'ordine è fallito, la pagina mostra Il tuo pagamento PayU non è stato completato. Contattaci per questo ordine.

Se PayU non ha ancora confermato il pagamento quando il cliente torna, una pagina Payment confirmation mostra Non abbiamo ancora ricevuto la conferma del pagamento da PayU. Se il pagamento è stato interrotto, puoi riprovare: (oppure, quando PayU ha segnalato un errore, Il pagamento non è stato completato. Puoi riprovare:) con i pulsanti Pay again (torna al checkout) e Check again. La notifica imposta lo stato dell'ordine appena arriva. Se il pagamento è stato annullato, il cliente torna al checkout con Il pagamento non è stato completato. Puoi riprovare o scegliere un altro metodo di pagamento. Il carrello viene conservato. Su OpenCart 4 questo messaggio viene mostrato sopra la pagina di checkout.

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

Se PayU non riesce ad avviare il pagamento, il cliente resta nel passaggio Confirm Order con Errore di pagamento. Riprova o scegli un altro metodo di pagamento. Il motivo tecnico viene scritto nel registro. Se mancano le chiavi della modalità corrente, il messaggio è Il gateway di pagamento non è configurato correttamente. Contatta l'amministratore.

Il cliente sceglie il metodo di pagamento nella pagina PayU, non nel tuo checkout. L'estensione non ha un modulo di carta sul tuo sito, né carte salvate o pagamenti con un clic, né abbonamenti, né widget PayU di rate o di credito. Usa un punto vendita per ogni ambiente.

Ordini e rimborsi

Stati dell'ordine

Nessuno stato (ordine mancante): il cliente è stato inviato a PayU e non ha pagato, il pagamento è stato annullato, oppure PayU 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 l'ID ordine PayU, l'importo e l'ambiente (sandbox o live).

Awaiting PayU Payment Confirmation (predefinito Pending): il pagamento è autorizzato e attende la tua azione (ricezione automatica disattivata, oppure ricezione non riuscita).

PayU Payment On Hold (predefinito Pending): l'importo pagato o la valuta non corrispondevano all'ordine, un pagamento in attesa di conferma aveva un importo diverso, oppure un pagamento è stato completato per un ordine che era stato annullato. La nota indica quale caso si è verificato. Controlla l'ordine ed evadilo oppure rimborsa il pagamento.

Payment Error Status (predefinito Failed): il pagamento di un ordine in attesa di conferma è stato annullato o rifiutato.

Refunded Status (predefinito Refunded): il pagamento è stato rimborsato integralmente tramite l'estensione.

Ogni notifica viene elaborata una sola volta: le notifiche ripetute non aggiungono note né modificano di nuovo l'ordine. Se per un ordine già pagato o rimborsato, oppure per un altro ordine di un carrello già pagato, viene completato un altro pagamento, una nota sull'ordine pagato ti chiede di rimborsarlo nel pannello PayU. Un pagamento in attesa di conferma su un ordine già pagato o chiuso viene annullato automaticamente, così il denaro non viene addebitato due volte.

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

Scheda VibeFox PayU Payment

In Sales > Orders apri un ordine pagato con PayU. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox PayU Payment mostra il PayU order ID con l'etichetta Sandbox per i pagamenti sandbox, l'extOrderId, il PayU status, il Payment amount, gli importi Paid / refunded, il modulo di rimborso, lo storico dei Refunds, i PayU payment attempts dell'ordine e le PayU notes. La scheda è mostrata agli utenti che hanno accesso all'estensione; le sue azioni richiedono il permesso di modificare l'estensione (impostato in System > Users > User Groups).

Pagamenti in attesa di conferma

Per un ordine con un pagamento in attesa di conferma, la scheda mostra Receive PayU payment e Cancel PayU payment. Dopo che confermi la domanda, l'azione viene inviata a PayU con le chiavi dell'ambiente del pagamento, aggiunta alle note con il tuo nome utente, e il nuovo stato PayU viene applicato subito: un pagamento ricevuto imposta Order Status After Payment, uno annullato Payment Error Status.

Rimborsi

Nella scheda inserisci l'Amount (viene precompilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e fai clic su Refund via PayU. Conferma la domanda Refund this amount through PayU? This cannot be undone. Sono supportati rimborsi totali e parziali. I rimborsi sono disponibili una volta che PayU ha completato il pagamento. Il rimborso viene inviato per l'ordine PayU effettivamente pagato, con le chiavi dell'ambiente del pagamento, quindi quelle chiavi devono essere impostate. I rimborsi vengono effettuati nell'importo e nella valuta addebitati da PayU; quindi, dopo una discrepanza di importo o valuta, puoi rimborsare fino a quanto il cliente ha realmente pagato, non fino al totale dell'ordine. Il motivo viene inviato come descrizione del rimborso. Se PayU rifiuta il rimborso, la scheda mostra l'errore di PayU e non viene registrato alcun rimborso. Un rimborso totale imposta l'ordine su Refunded Status, senza avvisare il cliente e senza rimettere i prodotti in magazzino. Un rimborso parziale non cambia lo stato.

I rimborsi sono asincroni presso PayU. L'estensione aggiunge subito una nota con l'ID e lo stato del rimborso PayU; lo stato finale arriva più tardi con una notifica PayU e viene aggiunto alle note e allo storico dei rimborsi. Se PayU annulla un rimborso, la nota indica che il denaro non è stato restituito al cliente e l'importo può essere rimborsato di nuovo.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite PayU.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox PayU Payment è il primo blocco di Extensions > Extensions > Payments > VibeFox PayU Payment > Edit, sopra le impostazioni. Incolla la chiave in License key e fai clic 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 ricontrollare 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-payu 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 modificare 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, oppure dopo aver liberato uno slot di dominio nel tuo account, fai clic su Check now. Se il server delle licenze non è raggiungibile, l'estensione continua a funzionare con l'ultimo stato noto.

Una chiave funziona per 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, PayU non viene mostrato ai clienti al checkout. Se un pagamento viene comunque avviato, 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 con (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'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 notifiche, 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 alla settimana. Non serve alcun cron job. La disinstallazione dell'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

PayU non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che tutte e quattro le chiavi della modalità corrente siano compilate: le chiavi Sandbox in modalità sandbox, le chiavi Live in modalità live. Verifica che la valuta del cliente sia una di quelle supportate, 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 quando mancano chiavi o quando la valuta del negozio non è supportata.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: PayU non ha ancora inviato la notifica, e la verifica dello stato nella pagina di ritorno non ha rilevato un pagamento completato. Verifica che l'URL di notifica mostrato nelle impostazioni sia raggiungibile da Internet. Attiva Logging per vedere cosa arriva. Il cliente può anche fare clic su Check again nella pagina Payment confirmation.

La notifica risponde Invalid signature: la notifica non è stata firmata con la Second Key di nessuno dei due ambienti. Controlla Live Second Key (MD5) e Sandbox Second Key (MD5). La risposta Invalid signature for this payment significa che la notifica è stata firmata con la chiave dell'altro ambiente rispetto a quello del pagamento.

La notifica risponde Ignored: unknown PayU order: l'ordine PayU non è stato creato da questo negozio, per esempio da un altro negozio sullo stesso punto vendita. PayU smette di ritentare.

La notifica risponde Busy, retry later: il carrello era in fase di conferma da un'altra richiesta nello stesso momento. PayU ripete la notifica. Attiva Logging per vedere il motivo.

L'URL di notifica mostra POST expected nel browser: è normale. L'URL accetta solo notifiche da PayU.

Il cliente vede Payment error dopo Confirm Order: attiva Logging e controlla il campo Log nella pagina dell'estensione. Il registro mostra il codice HTTP e lo stato PayU. Could not authenticate with PayU (check the OAuth client ID / secret). significa chiavi OAuth errate della modalità corrente. This payment method is not available. significa che la sessione di checkout non corrisponde più all'ordine oppure che il metodo di pagamento è stato disattivato nel frattempo: il cliente deve ricaricare il checkout.

L'ordine è in PayU Payment On Hold: leggi le note nella scheda VibeFox PayU Payment (vedi Stati dell'ordine), poi evadi l'ordine oppure rimborsa il pagamento.

L'ordine è in Awaiting PayU Payment Confirmation: la ricezione automatica è disattivata per il tuo punto vendita e il pagamento attende la tua azione. Usa Receive PayU payment o Cancel PayU payment nella scheda.

Il rimborso non riesce o non c'è il modulo di rimborso: la scheda indica il motivo. Refunds are available once PayU has completed the payment. significa che PayU non ha ancora completato un pagamento per l'ordine. Un messaggio che indica che mancano le chiavi Sandbox o Live significa che il pagamento è stato effettuato in quell'ambiente e che le sue chiavi non sono impostate. Inseriscile e riprova. Senza il permesso di modificare l'estensione, la scheda mostra You do not have permission to refund (modify this extension).

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e fai clic su Uninstall (il pulsante rosso −) accanto a VibeFox PayU 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 degli ordini della sezione Order statuses, che tornano ai valori predefiniti alla reinstallazione. Vengono rimossi anche l'evento OpenCart dell'estensione e i token di accesso PayU in cache (su OpenCart 4 anche i suoi eventi e la sua azione di avvio, che lascia passare le notifiche e il ritorno del cliente in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimossi le altre impostazioni del gateway (titolo, descrizione, modalità test, chiavi, ricezione automatica, logging) e il registro. Se è disattivo, vengono conservati per una reinstallazione successiva. Le transazioni e i rimborsi PayU vengono sempre conservati, quindi gli ordini pagati in precedenza possono essere rimborsati anche dopo una reinstallazione. Gli ordini esistenti conservano 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 PayU Payment nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

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