VibeFox PayU India 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.

Valuta: rupia indiana (INR). PayU India addebita solo in rupie. Il tuo negozio deve avere la valuta INR (System > Localisation > Currencies). Per gli ordini in altre valute il metodo di pagamento viene nascosto al checkout.

Numero di telefono: PayU richiede un numero di telefono per ogni pagamento. Mantieni il campo Telephone nel checkout in modo che l'ordine ne abbia uno. Su OpenCart 4 il checkout non chiede il telefono per impostazione predefinita: se l'ordine non ha un numero di telefono, l'estensione mostra un proprio campo Phone nel passaggio di conferma (vedi Checkout).

Account PayU India: servono la Merchant Key e il Merchant Salt (v1) da PayU Dashboard > Payment Gateway > Key Salt Details. Passa la dashboard in Test Mode per vedere la coppia di test. Usa Salt v1, non Salt v2.

Accesso a Internet per il tuo negozio: necessario per il webhook facoltativo. Senza di esso, gli ordini vengono confermati quando il cliente torna da PayU.

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_india_payment-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_payu_india_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_india_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 India Payment Gateway 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 la Merchant Key e il Salt di test e la Merchant Key e il Salt di produzione (vedi Configurazione).

5. Consigliato: in PayU Dashboard > Webhooks aggiungi l'URL del webhook mostrato nella pagina delle impostazioni per i pagamenti riusciti e non riusciti.

6. Scegli il Mode, attiva Enable/Disable e fai clic su Save. Prova un pagamento in modalità Test, poi passa a Live.

OpenCart 4

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

4. Inserisci la chiave di licenza, le credenziali PayU e il webhook come nei passaggi da 3 a 6 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni. Cambiano solo gli URL di ritorno e di webhook (vedi URL di ritorno e webhook).

Una nuova installazione parte con il metodo di pagamento disattivato e la modalità Test selezionata.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox PayU India Payment Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni la pagina ti avvisa quando manca la chiave o il salt della modalità corrente, mostra La modalità test è attiva: i pagamenti vanno a test.payu.in e non viene addebitato denaro reale. in modalità Test, e mostra un errore quando la valuta predefinita del negozio non è INR: in tal caso il gateway viene mostrato al checkout solo se il cliente paga in INR. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non può essere vuoto né superare 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. Spazi e interruzioni di riga vengono rimossi da chiavi e salt, perché un salt con uno spazio incollato farebbe fallire ogni risposta PayU alla verifica. Se il metodo di pagamento è attivo senza la chiave e il salt della modalità corrente, la pagina ti avvisa dopo il salvataggio.

PayU India

La sezione inizia con una breve nota: carte, NetBanking, UPI e wallet sulla pagina di pagamento ospitata da PayU; risultati accettati solo con una firma PayU valida; solo rupie.

Enable/Disable: Enable PayU India Payment Gateway attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il titolo del metodo di pagamento che il cliente vede durante il checkout. È anche il nome del metodo di pagamento salvato nell'ordine. Predefinito: PayU India. Obbligatorio, massimo 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Pay securely via Credit/Debit Card, NetBanking, UPI, or Wallets through PayU.

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

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

Credenziali API

Copia la Merchant Key e il Merchant Salt (v1) da PayU Dashboard > Payment Gateway > Key Salt Details. Passa la dashboard in Test Mode per la coppia di test. La sezione contiene un link Open the PayU Dashboard.

Mode: l'ambiente PayU che usano i nuovi pagamenti.

I pagamenti già avviati mantengono la modalità in cui sono stati avviati: i loro risultati vengono verificati e i loro rimborsi inviati con la chiave e il salt di quella modalità, anche dopo il cambio di modalità.

Live Merchant Key: la tua Merchant Key PayU di produzione.

Live Merchant Salt (v1): il tuo Merchant Salt (v1) PayU di produzione. Firma le richieste e verifica le risposte PayU. Tienilo segreto.

Test Merchant Key: la tua Merchant Key PayU di test, usata solo in modalità Test.

Test Merchant Salt (v1): il tuo Merchant Salt (v1) PayU di test, usato solo in modalità Test.

I salt 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. Per rimuovere un salt salvato, spunta Clear the saved salt on save sotto il campo e fai clic su Save.

URL di ritorno e webhook

Return URL: su OpenCart 3 ha un aspetto del tipo https://your-store/index.php?route=extension/payment/wcp_payu_india_payment/back, su OpenCart 4 https://your-store/index.php?route=extension/wcp_payu_india_payment/payment/wcp_payu_india_payment.back. Viene inviato automaticamente a PayU con ogni pagamento; non c'è nulla da configurare.

Webhook URL: su OpenCart 3 ha un aspetto del tipo https://your-store/index.php?route=extension/payment/wcp_payu_india_payment/webhook, su OpenCart 4 https://your-store/index.php?route=extension/wcp_payu_india_payment/payment/wcp_payu_india_payment.webhook. Facoltativo ma consigliato: conferma i pagamenti anche se il cliente chiude il browser prima di tornare. Aggiungilo in PayU Dashboard > Webhooks per i pagamenti riusciti e non riusciti. Copia l'URL esattamente come lo mostra la pagina delle impostazioni. Deve essere raggiungibile da Internet (nessuna autenticazione di base né blocco del firewall). La modalità manutenzione del negozio non lo blocca.

Il webhook trasporta lo stesso risultato firmato del ritorno del cliente. I webhook senza un hash PayU valido vengono rifiutati.

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che PayU ha inviato un risultato firmato correttamente. Un pagamento non riuscito o annullato lascia l'ordine senza stato, e il cliente torna al checkout con il carrello conservato. Ogni campo qui sotto elenca i tuoi stati ordine di OpenCart.

Order Status After Payment: un pagamento riuscito con l'importo previsto in INR, confermato da verify_payment quando Verify Payment è attivo. Predefinito: Processing.

Awaiting PayU Payment Status: PayU segnala il pagamento come in sospeso (UPI collect, NetBanking in corso). L'ordine riceve lo stato dopo il pagamento quando PayU lo conferma. Predefinito: Pending.

On Hold (Review) Status: PayU ha segnalato un pagamento riuscito che richiede una verifica manuale (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 Error Status: un pagamento in sospeso che PayU ha poi segnalato come non riuscito. Predefinito: Failed.

Refunded Status: impostato quando tutto ciò che è stato pagato è stato rimborsato dalla pagina dell'ordine. Predefinito: Refunded.

Cancelled Order Status: lo stato che il tuo negozio usa per gli ordini annullati. Un pagamento ricevuto per un ordine del genere lo mette in verifica invece di segnarlo come pagato. L'estensione non imposta mai questo stato. Predefinito: Canceled.

Avanzate

Verify Payment: ricontrolla ogni pagamento riuscito con l'API verify_payment di PayU. Consigliato. Se la verifica non può essere completata, l'ordine viene messo in verifica invece di essere segnato come pagato. Predefinito: attivo.

Enable Logging: registra gli eventi del gateway per la risoluzione dei problemi in payu_p_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web. Errori e avvisi vengono sempre registrati; questa opzione aggiunge gli altri eventi, come ogni modulo di pagamento e ogni risultato PayU. Chiavi, salt e dati personali dei clienti non vengono mai registrati. Predefinito: disattivato.

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

Delete data on uninstall: elimina le impostazioni del gateway e il registro quando l'estensione viene disinstallata. Ordini e registrazioni delle transazioni PayU non vengono mai eliminati. Predefinito: disattivato.

Importa / Esporta

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

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

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita PayU India). Nel passaggio Confirm Order il cliente vede 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 fa clic su Confirm Order in fondo alla pagina di checkout. Se l'ordine non ha un numero di telefono, il blocco di conferma di OpenCart 4 mostra anche il campo Phone con il suggerimento PayU India richiede il numero di telefono del pagatore. Il numero inserito lì viene inviato a PayU e conservato per il tentativo successivo; il numero di telefono dell'ordine ha la precedenza. Quando il cliente fa clic su Confirm Order, l'estensione verifica la valuta, le credenziali della modalità corrente e il numero di telefono dell'ordine. Senza numero di telefono il cliente resta nel passaggio con PayU India richiede un numero di telefono. Inserisci il tuo numero di telefono e riprova. Altrimenti l'estensione crea una richiesta di pagamento firmata per il totale dell'ordine in INR, e il browser la invia subito alla pagina di pagamento ospitata da PayU. La pagina mostra Verrai reindirizzato a PayU per completare il pagamento. e un pulsante Pay with PayU nel caso in cui il browser non continui da solo. Sulla pagina PayU il cliente paga con carta, NetBanking, UPI o wallet.

Ogni clic su Confirm Order avvia un nuovo tentativo con un proprio ID di transazione PayU (txnid), che inizia con il numero dell'ordine ed è salvato con il suo importo e la sua modalità. OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, OpenCart 4 aggiorna l'ordine del checkout, quindi lì un nuovo tentativo paga lo stesso ordine. Un pagamento effettuato su una pagina di pagamento precedente ancora aperta dello stesso ordine viene comunque accettato. Se un altro ordine dello stesso carrello è già pagato, in attesa di PayU o in verifica, il cliente va direttamente alla pagina di successo e non viene creato alcun nuovo modulo di pagamento. Una modifica del carrello, compresa una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.

PayU invia il risultato insieme al cliente e, se configurato, tramite webhook. Un risultato viene accettato solo con un hash PayU valido, calcolato con la chiave e il salt della modalità in cui il pagamento è stato avviato, e solo per un ID di transazione emesso per quell'ordine. Con Verify Payment attivo, un risultato riuscito viene anche verificato tramite l'API verify_payment di PayU. L'importo pagato deve essere uguale all'importo del tentativo e al totale dell'ordine, fino all'ultimo paisa, in INR. L'ordine viene segnato come pagato solo dopo che PayU lo ha confermato in questo modo, e riceve poi il suo stato nel modo standard di OpenCart, con le consuete email d'ordine e l'aggiornamento del magazzino. L'estensione gestisce questi risultati PayU:

Dopo un pagamento riuscito o in sospeso, il cliente vede la pagina di successo dell'ordine di OpenCart. Un pagamento in sospeso aggiunge Il tuo pagamento PayU è in sospeso. L'ordine verrà aggiornato non appena PayU confermerà il risultato: non è necessario pagare di nuovo., un ordine in verifica aggiunge Il tuo pagamento è in fase di verifica. Ti contatteremo se serve qualcos'altro., e un ordine non pagato nello stato di errore di pagamento o annullato mostra Il tuo pagamento PayU non è stato completato. Contattaci per questo ordine.

Dopo un pagamento non riuscito il cliente torna al checkout con un messaggio: Il pagamento non è stato completato. Riprova o scegli un metodo di pagamento diverso., Il pagamento è stato annullato. Puoi riprovare. oppure, quando non è stato possibile verificare il risultato, Non siamo riusciti a confermare il risultato del pagamento. Se il tuo conto è stato addebitato, contattaci prima di pagare di nuovo. Se il risultato è ancora in elaborazione quando il cliente torna, una pagina mostra Stiamo confermando il tuo pagamento PayU. Se hai completato il pagamento, il tuo ordine verrà aggiornato a breve — non pagare di nuovo. con Check again e Back to checkout. Su OpenCart 4 questi messaggi vengono mostrati 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 senza pagamento (per esempio il suo pagamento in attesa è fallito o lo hai annullato), il cliente torna al checkout con il messaggio Il tuo ordine precedente è stato annullato o il suo pagamento non è riuscito. Conferma di nuovo l'ordine. Se l'ordine era stato pagato e poi annullato o rimborsato dal negozio, il messaggio è Il tuo ordine precedente è stato annullato o rimborsato dal negozio. Conferma di nuovo l'ordine per pagare con un nuovo ordine. Se era stato pagato per un carrello precedente e il carrello è cambiato da allora, il messaggio è Il tuo ordine precedente è già stato pagato. Il carrello è cambiato: conferma di nuovo l'ordine per pagare il carrello attuale. Il successivo Confirm Order paga un nuovo ordine. Un ordine chiuso non viene mai mostrato come pagato.

Il webhook funziona anche quando 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 PayU).

L'estensione addebita solo in INR e non prevede l'elaborazione multivaluta (MCP). Non ha carte salvate né tokenizzazione, né abbonamenti, né modulo di carta integrato (seamless), né gestione di EMI o offerte, né checkout PayU con un clic.

Ordini e rimborsi

Stati dell'ordine

Nessuno stato (ordine mancante): il cliente è stato inviato a PayU e non ha pagato, oppure il pagamento non è riuscito o è stato annullato. 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 PayU payment successful. Transaction ID: …, Mode: …, Bank: …

Awaiting PayU Payment Status (predefinito Pending): un pagamento UPI o NetBanking è ancora in sospeso presso PayU. L'ordine riceve lo stato di pagato quando PayU lo conferma.

On Hold (Review) Status (predefinito Pending): l'importo o la valuta pagati differiscono dall'ordine, l'API verify_payment non è stata raggiunta o non ha ancora confermato il pagamento, oppure è arrivato un pagamento per un ordine nello stato Cancelled Order Status. La nota indica il motivo. Controlla la transazione nel PayU Dashboard, poi imposta lo stato di pagato oppure annulla l'ordine e rimborsa il pagamento. Quando è fallita solo la verifica, l'ordine viene pagato automaticamente alla successiva consegna del risultato.

Payment Error Status (predefinito Failed): un pagamento in sospeso è stato in seguito rifiutato o annullato. Un successivo risultato riuscito paga comunque l'ordine.

Refunded Status (predefinito Refunded): tutto ciò che è stato pagato è stato rimborsato tramite l'estensione.

Se PayU segnala un altro pagamento riuscito per un ordine già pagato, l'ordine non cambia e una nota ti chiede di rimborsare il duplicato nel PayU Dashboard. Un pagamento per un altro ordine dello stesso carrello già pagato lascia quell'ordine senza stato, con una nota sull'ordine pagato. Un pagamento PayU per un ordine passato a un altro metodo di pagamento riceve solo una nota.

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

Scheda VibeFox PayU India Payment Gateway

In Sales > Orders apri un ordine pagato con PayU India. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox PayU India Payment Gateway mostra il PayU transaction ID (mihpayid), lo Store transaction ID (txnid), l'Environment con un badge Test mode per i pagamenti di test, lo Status PayU, il Mode / bank del pagamento, gli importi Paid / refund requested (INR), il modulo di rimborso, lo storico dei rimborsi e le PayU notes dell'ordine. Per un ordine in verifica mostra un promemoria a controllare il pagamento. La scheda è mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox PayU India Payment Gateway 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; l'importo deve essere maggiore di zero e non superiore a quanto resta del pagamento addebitato da PayU. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). Il rimborso viene inviato tramite l'API rimborsi PayU con la chiave e il salt della modalità in cui è stato fatto il pagamento, quindi quelle credenziali devono essere impostate. Per ordine viene eseguita una sola richiesta PayU alla volta. Se PayU rifiuta il rimborso, la scheda mostra PayU refund failed: con il messaggio di PayU, e non viene registrato alcun rimborso.

PayU mette in coda i rimborsi e li completa in modo asincrono; il cliente di solito riceve il denaro entro 5–7 giorni lavorativi. Lo storico dei rimborsi e le note mostrano l'importo, l'ID della richiesta PayU e il motivo. Un rimborso totale imposta l'ordine sul Refunded Status senza avvisare il cliente e senza rimettere i prodotti in magazzino, come un cambio di stato manuale. Un rimborso parziale non cambia lo stato. I rimborsi sono disponibili quando PayU ha comunicato l'ID transazione del pagamento. L'estensione non verifica in seguito lo stato del rimborso.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite PayU. I rimborsi effettuati nel PayU Dashboard 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 PayU India Payment Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox PayU India Payment Gateway > 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-india 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 India 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, 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 India non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che la chiave e il salt del Mode selezionato siano compilati. Verifica che il cliente paghi in INR, 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 credenziali mancanti e per una valuta del negozio diversa da INR.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: il cliente non è tornato nel negozio e non è arrivato alcun webhook. Aggiungi l'URL del webhook dalla pagina delle impostazioni in PayU Dashboard > Webhooks per i pagamenti riusciti e non riusciti, e assicurati che sia raggiungibile da Internet.

Il webhook risponde invalid_signature: l'hash PayU non corrispondeva. Verifica che chiave e salt della modalità del pagamento siano corretti e che si usi Salt v1, non Salt v2. Anche un risultato di un pagamento reale firmato con il salt di test, o viceversa, viene rifiutato. Non viene modificato nulla.

Il webhook risponde not_configured: manca la chiave o il salt della modalità in cui il pagamento è stato avviato. Inseriscili; PayU riproverà il webhook.

Il webhook risponde verify_unavailable: l'API verify_payment non è ancora riuscita a confermare il pagamento. L'ordine è in verifica, e la consegna successiva verifica di nuovo.

Il webhook risponde busy o retry: il ritorno del cliente con lo stesso carrello era in elaborazione nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. PayU riproverà il webhook. Il motivo viene scritto nel registro.

Il webhook risponde ignored_unknown_txnid: la transazione non è stata avviata da questo negozio, per esempio da un altro negozio che usa lo stesso account PayU. Non viene modificato nulla.

Il cliente vede PayU India richiede un numero di telefono: l'ordine non ha un numero di telefono. Mantieni il campo Telephone nel checkout. Su OpenCart 4 il cliente può inserire il numero nel campo Phone del blocco di conferma.

Il cliente vede This payment method is not available. Please reload the checkout page.: il metodo di pagamento è stato disattivato nel frattempo, mancano le credenziali, oppure il checkout non corrisponde più all'ordine. Il cliente ricarica il checkout.

L'ordine è nello stato di verifica: leggi le note nella scheda VibeFox PayU India Payment Gateway. Il motivo è una discrepanza di importo o valuta, una verifica fallita o in sospeso, oppure un pagamento per un ordine annullato.

Il rimborso non riesce: PayU transaction ID not found for this order. significa che l'ordine non ha ancora un pagamento PayU. This payment was made in Test mode, but the Merchant Key/Salt of that mode are not set. (o Live mode) significa che devi prima inserire le credenziali di quella modalità. Invalid refund amount: at most … INR can be refunded. significa che l'importo è superiore a quanto resta del pagamento.

Poche informazioni nel registro: errori e avvisi vengono sempre scritti; attiva Enable Logging per vedere anche ogni modulo di pagamento e ogni risultato PayU.

Per gli sviluppatori: prima che la richiesta di pagamento venga firmata, l'estensione attiva l'evento OpenCart payu_p_request_fields con i campi della richiesta e l'ordine. Chiave, ID transazione, importo e URL di ritorno non possono essere modificati tramite esso.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e fai clic su Uninstall (il pulsante rosso −) accanto a VibeFox PayU India Payment Gateway. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart rimuove sempre le proprie impostazioni dell'estensione: Enable/Disable, Sort Order, Geo Zone, Total e gli stati degli ordini della sezione Orders, che tornano ai valori predefiniti alla reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 anche i suoi eventi e la sua azione di avvio, che lascia passare il webhook e il ritorno del cliente in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, modalità, chiavi, salt, verifica del pagamento, logging) e il registro. Se è disattivo, vengono conservati per una reinstallazione successiva. Le registrazioni delle transazioni PayU e le richieste di rimborso vengono sempre conservate, 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 India Payment Gateway 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.