VibeFox Nets Nexi for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo.

Account Nets: ti servono le chiavi segrete del tuo account Nets Easy (test e live). Vengono usate solo le chiavi segrete. Le chiavi di checkout non sono necessarie, perché i clienti pagano sulla pagina di pagamento ospitata da Nets.

Valute e metodi di pagamento: l'estensione non limita da sola le valute. Usa le valute attivate nel tuo account Nets; una valuta non supportata viene segnalata da Nets quando viene creato il pagamento. I metodi di pagamento visibili al cliente dipendono dal tuo contratto con Nets, dal paese e dalla valuta.

HTTPS per i webhook: Nets chiama solo indirizzi HTTPS pubblici di massimo 256 caratteri e senza "&", quindi il tuo negozio ha bisogno di HTTPS per ricevere i webhook. Senza HTTPS il pagamento viene comunque confermato quando il cliente torna al negozio, oppure con la verifica dello stato nella pagina dell'ordine.

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona su un solo dominio.

Installazione

Il download è un unico file zip con i pacchetti per entrambe le versioni di OpenCart. Decomprimilo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 wcp_nets_nexi_gateway-oc3-(versione).ocmod.zip e il pacchetto per OpenCart 4 wcp_nets_nexi_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, fai clic su Upload e scegli il file wcp_nets_nexi_gateway-oc3-(versione).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 Nets Nexi 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 la sezione Chiave di licenza).

4. Copia la chiave segreta di test dal portale di test di Nets Easy e incollala in Test Secret Key (vedi Configurazione). Non c'è nulla da configurare nel portale Nets.

5. Attiva Enable/Disable, lascia attivo Test Mode, fai clic su Save e effettua un ordine di prova. Poi inserisci la chiave segreta live e disattiva Test Mode.

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file wcp_nets_nexi_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. Fai clic su Install (il pulsante verde +) accanto a esso.

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

4. Inserisci la chiave di licenza e le chiavi segrete come ai passaggi 3–5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni. Cambia solo l'indirizzo del webhook (vedi Webhooks).

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 Nets Nexi 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 segreta della modalità selezionata, per esempio Nets Nexi: enter the Test Secret Key — the payment method is hidden at checkout until the key of the selected mode is set., e mostra Nets Nexi is in test mode: payments go to the Nets test environment and no real money is charged. finché la modalità test è attiva. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non deve essere vuoto (fino a 128 caratteri), Sort Order deve essere un numero intero, Total un numero pari o superiore a 0, e la geo zone e gli stati dell'ordine devono esistere; se un campo è errato, non viene salvato nulla.

Nets Nexi (Paesi nordici)

Enable/Disable: Enable Nets Nexi Gateway attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il titolo del metodo di pagamento mostrato ai clienti durante il checkout. È anche il nome del metodo di pagamento memorizzato nell'ordine. Predefinito: Nets Easy. Obbligatorio.

Description: il testo mostrato al cliente nel passaggio Confirm Order. Predefinito: Pay securely with Nets Easy.

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

Geo Zone: offri Nets solo per gli indirizzi di pagamento della geo zone selezionata. Predefinito: All zones. Le geo zone si configurano in System > Localisation > Geo Zones.

Total: il totale del carrello, nella valuta predefinita del negozio, che un ordine deve raggiungere prima che venga offerto Nets. Lascia il campo vuoto per offrire Nets per qualsiasi totale.

Chiavi API

Copia le chiavi segrete dal portale Nets Easy in Company > Integration: il portale di test (test.portal.dibspayment.eu) per la chiave di test e il portale live (portal.dibspayment.eu) per la chiave live. La sezione contiene i collegamenti a entrambi i portali. Le chiavi di checkout non sono necessarie.

Test Mode: la modalità test usa test.api.dibspayment.eu con la chiave segreta di test; la modalità live usa api.dibspayment.eu con la chiave segreta live. Rimborsi e acquisizioni di un ordine usano sempre l'ambiente in cui è stato pagato. Predefinito: attivo. Finché è attiva, i clienti vedono Test mode: no real money will be charged. nel passaggio Confirm Order.

Test Secret Key: la tua chiave API segreta dell'ambiente di test di Nets.

Live Secret Key: la tua chiave API segreta dell'ambiente live di Nets.

Le chiavi salvate non vengono mai mostrate di nuovo. Il campo resta vuoto e mostra Saved — leave empty to keep it. Digita un nuovo valore solo per cambiarla. Per rimuovere una chiave salvata, spunta Clear the saved key on save sotto il campo e fai clic su Save.

Pagamento

Webhooks: le notifiche di Nets (webhook) vengono registrate automaticamente con ogni pagamento. Non c'è nulla da configurare nel portale Nets. Il campo mostra l'indirizzo a cui vengono inviate. Su OpenCart 3 ha un aspetto come https://your-store/index.php?route=extension/payment/wcp_nets_nexi_gateway/webhook, su OpenCart 4 come https://your-store/index.php?route=extension/wcp_nets_nexi_gateway/payment/wcp_nets_nexi_gateway.webhook. È costruito a partire dall'indirizzo del negozio della tua installazione di OpenCart. Se non è un indirizzo HTTPS pubblico, il campo ti avvisa che il negozio non riceve webhook; in tal caso i pagamenti vengono confermati quando il cliente torna al negozio, oppure con Nets: check payment status and capture nella pagina dell'ordine. Vengono registrati questi eventi:

Ogni webhook deve contenere il segreto casuale che l'estensione ha creato per quel pagamento. I webhook senza il segreto corretto vengono rifiutati. Il webhook indica solo all'estensione quale pagamento è cambiato: il pagamento stesso viene sempre letto dall'API di Nets con la chiave segreta dell'ambiente in cui è stato effettuato.

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante, missing order). Riceve uno stato solo dopo che il pagamento è stato riletto dall'API di Nets (webhook, ritorno del cliente o Nets: check payment status and capture nella pagina dell'ordine) e una prenotazione corrispondente è stata addebitata. Ogni campo di stato qui sotto elenca i tuoi stati ordine di OpenCart.

Order Status After Payment: lo stato dell'ordine una volta che Nets ha confermato e addebitato il pagamento. Predefinito: Processing. Scegli Complete per segnare come completati gli ordini pagati.

Nets Payment On Hold Status: l'importo o la valuta differiscono dall'ordine, l'acquisizione non è riuscita oppure il cliente ha pagato dopo che l'ordine è stato annullato. Nulla viene acquisito automaticamente e una nota ne spiega il motivo. Predefinito: Pending, perché OpenCart non ha uno stato On hold. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Cancelled Status: impostato quando la prenotazione dell'ordine viene annullata nel portale Nets. Predefinito: Canceled.

Refunded Status: impostato dopo che il pagamento è stato rimborsato interamente dalla pagina dell'ordine. Predefinito: Refunded.

Avanzate

Debug log: registra le chiamate API e i cambiamenti di stato dei pagamenti in nng_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web. Chiavi e dati dei clienti non vengono registrati. Errori e avvisi vengono sempre registrati, anche quando l'opzione è disattivata. Predefinito: disattivato.

Log: mostra la dimensione e gli ultimi inserimenti del log. Fai clic su Clear log per svuotarlo.

Delete Data on Uninstall: se attivo, la disinstallazione dell'estensione rimuove le impostazioni del gateway e il log. I dati di pagamento e rimborso di Nets degli ordini vengono sempre conservati. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. Le chiavi segrete non vengono esportate.

Import: incolla un JSON esportato in precedenza e fai clic su Import per ripristinare le impostazioni. Le chiavi segrete salvate vengono mantenute.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Nets Easy). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota You will be redirected to the Nets payment page to pay securely. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente fa clic su Confirm Order, l'estensione crea un pagamento Nets per il totale dell'ordine nella valuta dell'ordine, con i prodotti, la spedizione e gli altri totali dell'ordine (coupon, buoni, commissioni) come righe dell'ordine, e invia il cliente alla pagina di pagamento ospitata da Nets. Su OpenCart 4 il cliente sceglie il metodo di pagamento con il pulsante Choose nel blocco del metodo di pagamento, nella finestra Payment method options, e fa clic su Confirm Order in fondo alla pagina del checkout. Il riferimento del pagamento presso Nets è il numero d'ordine di OpenCart. L'e-mail, il nome, l'indirizzo di spedizione e il numero di telefono del cliente vengono inviati a Nets quando Nets accetta il loro formato. La pagina dei termini di checkout del tuo negozio è collegata nella pagina Nets (se non impostata, la home page del negozio).

Dopo il pagamento, il cliente torna al tuo negozio. L'ordine viene segnato come pagato solo dopo la conferma di Nets: l'estensione legge il pagamento dall'API di Nets, confronta l'importo e la valuta prenotati con l'ordine, addebita la prenotazione e solo dopo imposta lo stato dell'ordine. Questo avviene con il webhook o quando il cliente torna, a seconda di quale arriva per primo. L'ordine riceve poi il suo stato nel modo standard di OpenCart, con la consueta e-mail d'ordine e l'aggiornamento del magazzino, e il cliente vede la pagina di successo dell'ordine di OpenCart. Se il pagamento non può ancora essere confermato (Nets non era raggiungibile, oppure un'altra richiesta lo stava confermando in quel momento), una pagina Payment confirmation mostra Your Nets payment is being confirmed. Your order will be updated as soon as it is confirmed — please do not pay again. con i pulsanti Check again e Back to checkout.

Se il cliente annulla nella pagina Nets, torna al checkout con The Nets payment was cancelled. You can try again or choose another payment method. Se non è stato pagato nulla, il messaggio è The payment was not completed. You can try again or choose another payment method. Su OpenCart 4 questi messaggi compaiono sopra la pagina del checkout. Il carrello viene conservato. OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, mentre OpenCart 4 mantiene un solo ordine per il checkout e paga di nuovo lo stesso ordine con un nuovo pagamento Nets. In un nuovo tentativo, l'estensione controlla prima i pagamenti precedenti del carrello; se uno è già pagato, viene confermato quell'ordine invece di avviare un nuovo pagamento. Altrimenti le sessioni Nets precedenti vengono chiuse prima di avviarne una nuova. Quando un altro ordine dello stesso carrello è già pagato o in sospeso, il cliente va alla pagina di successo.

Su OpenCart 4 l'ordine resta nel checkout finché non viene mostrata la pagina di successo. Se quell'ordine è stato chiuso senza pagamento nel frattempo (per esempio l'hai annullato, anche dopo aver annullato la prenotazione nel portale Nets), il cliente torna al checkout con il messaggio Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order., anche quando torna da Nets, e il successivo clic su Confirm Order paga un nuovo ordine. Un ordine del carrello che è stato pagato e poi annullato o rimborsato non tiene più occupato il carrello.

Se Nets non riesce ad avviare il pagamento, il cliente resta nel passaggio Confirm Order con un breve messaggio, per esempio Nets could not start the payment with the details of this order. Please check your address and phone number, or choose another payment method., This payment method is temporarily unavailable. Please choose another payment method. o The payment service could not be reached. Please try again in a moment. Un totale d'ordine pari a zero produce The order total must be greater than zero to pay with Nets. I dettagli vengono scritti nel log.

Il webhook funziona anche mentre il negozio è in modalità manutenzione, perché OpenCart 3 lascia passare le richieste delle estensioni di pagamento e su OpenCart 4 l'estensione aggiunge un'azione di startup per questo, che permette anche al cliente di tornare da Nets.

L'estensione usa solo la pagina di pagamento ospitata. Non ha un checkout Nets integrato nella pagina, né abbonamenti o pagamenti ricorrenti, né carte salvate, né commissioni di fattura, né modalità di sola autorizzazione, né acquisizioni parziali per spedizione.

Ordini e rimborsi

Stati dell'ordine

No status (missing order): il cliente è stato inviato a Nets e non ha pagato, oppure il pagamento non è ancora confermato. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Order Status After Payment (default Processing): Nets ha confermato e addebitato il pagamento. Una nota mostra l'ID del pagamento, l'ID dell'addebito e il metodo di pagamento.

Nets Payment On Hold Status (default Pending): l'importo o la valuta presso Nets differisce dall'ordine (non acquisito), l'addebito è stato rifiutato, oppure il cliente ha pagato dopo che l'ordine era stato annullato (prenotato, non acquisito). La nota lo spiega. Nulla viene acquisito automaticamente. Dopo aver controllato l'ordine, acquisisci con Nets: check payment status and capture oppure annulla la prenotazione nel portale Nets.

Cancelled Status (default Canceled): la prenotazione dell'ordine è stata annullata, per esempio nel portale Nets.

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

Quando un webhook o il ritorno del cliente sposta un ordine dallo stato in sospeso allo stato pagato o lo annulla, OpenCart avvisa il cliente. I webhook ripetuti e i ricaricamenti della pagina non addebitano mai due volte né aggiungono note duplicate, e un ordine pagato non viene mai modificato di nuovo dagli eventi di Nets. Se un vecchio link di pagamento viene completato per un ordine già pagato, o per un altro ordine dello stesso carrello, la seconda prenotazione viene rilasciata automaticamente; se era già stata addebitata, una nota ti chiede di rimborsarla nel portale Nets. Se l'ordine è stato segnato come pagato in un altro modo, un pagamento Nets prenotato non viene acquisito e una nota lo indica.

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

Scheda VibeFox Nets Nexi Gateway

In Sales > Orders apri un ordine pagato con Nets. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Nets Nexi Gateway mostra il blocco Nets Easy payment: l'ID del pagamento, l'ID dell'addebito, l'ambiente (con l'etichetta Test environment per i pagamenti di test), lo stato e il metodo di pagamento, gli importi prenotati e addebitati presso Nets, il totale dell'ordine e l'importo rimborsato, il modulo di rimborso, lo storico dei rimborsi e le Nets notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione; i suoi pulsanti richiedono il permesso di modificare l'estensione (impostato in System > Users > User Groups).

Nets: check payment status and capture: mostrato per gli ordini non ancora pagati. Legge il pagamento da Nets e acquisisce una prenotazione che corrisponde all'ordine, anche dopo un'acquisizione non riuscita o dopo aver controllato un ordine in sospeso. Se non cambia nulla, una nota spiega il motivo, per esempio che il cliente non ha ancora completato il pagamento. Uno stato impostato da questo pulsante, come uno stato impostato da un rimborso, viene modificato direttamente, come cambio di stato manuale, senza e-mail né movimenti di magazzino.

Rimborsi

Nella scheda inserisci il Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e fai clic su Refund via Nets. Conferma la domanda Refund this amount through Nets? This cannot be undone. I rimborsi totali e parziali sono supportati una volta addebitato il pagamento, fino al totale dell'ordine; un pagamento solo prenotato può essere annullato nel portale Nets. Il rimborso va sull'addebito dell'ordine nell'ambiente in cui il pagamento è stato effettuato, quindi la chiave segreta di quell'ambiente deve essere impostata. Se Nets non accetta il rimborso, la scheda mostra l'errore e nessun rimborso viene registrato. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note con l'ID di rimborso Nets. Un rimborso totale imposta l'ordine su Refunded Status; un rimborso parziale non cambia lo stato.

Le restituzioni di prodotti in Sales > Returns non rimandano denaro tramite Nets. I rimborsi effettuati nel portale Nets non vengono sincronizzati; aggiorna l'ordine manualmente se necessario.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox di vibefox.net. Il blocco della licenza License — VibeFox Nets Nexi Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Nets Nexi 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 verificare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuovere la chiave da questo negozio. Sotto si trovano la riga Product: opencart-payment-nets-nexi e il collegamento Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo gli utenti amministratori con il permesso Modify sull'estensione possono cambiare la chiave. I testi del blocco seguono la lingua del pannello di 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, 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 su un solo dominio. Rimuovere la chiave dal negozio non libera lo slot del dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, Nets 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 al pannello di amministrazione nello stesso browser vede ancora il metodo di pagamento nel negozio, contrassegnato con (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'amministratore, quindi senza una chiave attiva il metodo di pagamento è nascosto a tutti. Dopo aver aperto una volta la pagina Edit, nella Dashboard dell'amministrazione compare un promemoria. Chiudilo con × per nasconderlo per 7 giorni. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati e i rimborsi funzionano.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene verificato di nuovo automaticamente quando apri la Dashboard o la pagina Edit dell'amministrazione: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta a settimana. Non serve alcun cron job. La disinstallazione dell'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

Nets Nexi non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che la modalità selezionata abbia una chiave segreta: Test Secret Key in modalità test, Live Secret Key in modalità live. La pagina delle impostazioni mostra un avviso quando la chiave manca. Controlla anche che l'indirizzo di pagamento rientri nella Geo Zone selezionata e che l'ordine raggiunga il Total impostato nelle impostazioni.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: il webhook non ha raggiunto il tuo negozio. Verifica che il negozio usi HTTPS, in modo che l'indirizzo in Webhooks sia un indirizzo HTTPS pubblico, e che la chiave segreta dell'ambiente del pagamento sia impostata. L'ordine riceve il suo stato anche quando il cliente torna al negozio dopo il pagamento, oppure con Nets: check payment status and capture nella scheda dell'ordine.

Il webhook risponde Unauthorized: il webhook non conteneva il segreto di quel pagamento. I webhook vengono accettati solo con il segreto registrato con il pagamento.

Il webhook risponde Unknown payment: il pagamento non è stato creato da questo negozio.

Il webhook risponde Busy, retry later, Payment lookup failed o Payment not reserved yet: un'altra richiesta stava confermando lo stesso carrello, l'API di Nets non era raggiungibile, oppure la prenotazione non era ancora visibile. Nets ripete il webhook automaticamente.

Il webhook risponde Order could not be updated, retry later: non è stato possibile impostare lo stato dell'ordine. Nets ripete il webhook. Attiva Debug log per vedere il motivo.

L'URL del webhook mostra Method not allowed nel browser: è normale. L'indirizzo accetta solo richieste da Nets.

Il cliente vede un errore dopo Confirm Order: attiva Debug log e controlla il campo Log nella pagina dell'estensione. This payment method is temporarily unavailable. Please choose another payment method. di solito indica una chiave segreta errata o mancante. Una valuta rifiutata viene segnalata da Nets nel log. This payment method is not available. significa che la sessione di checkout non corrisponde più all'ordine, oppure che il metodo di pagamento nel frattempo è stato disattivato: il cliente ricarica il checkout.

Il cliente vede We could not match this payment to an order: il link di ritorno è incompleto o appartiene a un altro ordine. Se il cliente è stato addebitato, cerca il pagamento nel portale Nets e controlla l'ordine.

L'ordine è nello stato in sospeso dopo il pagamento: leggi le Nets notes nella scheda. Se l'acquisizione è stata rifiutata, riprova con Nets: check payment status and capture oppure addebitalo nel portale Nets. Se l'importo o la valuta non corrispondono, controlla il pagamento nel portale Nets. Se il cliente ha pagato dopo l'annullamento, controlla l'ordine e acquisisci o annulla la prenotazione.

Refund via Nets manca o non funziona: i rimborsi sono possibili solo dopo che il pagamento è stato addebitato; la scheda mostra allora un ID di addebito. Un rimborso usa la chiave segreta dell'ambiente in cui l'ordine è stato pagato, quindi quella chiave deve essere impostata; altrimenti la scheda indica quale chiave di ambiente manca.

Per gli sviluppatori: prima che il pagamento venga creato, l'estensione attiva l'evento OpenCart nng_create_payment_payload con il corpo della richiesta e l'ordine; nng_currency_decimals modifica i decimali di una valuta.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e fai clic su Uninstall (il pulsante rosso −) accanto a VibeFox Nets Nexi 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 Payment, che tornano ai valori predefiniti alla reinstallazione. Su OpenCart 4 vengono rimossi anche gli eventi dell'estensione e la sua azione di startup, che lascia passare il webhook in modalità manutenzione. Se Delete Data on Uninstall è attivo, vengono rimosse anche le altre impostazioni del gateway (titolo, descrizione, modalità test, chiavi segrete, registrazione) e il log. Se è disattivo, vengono conservate per una futura reinstallazione. I dati di pagamento Nets degli ordini (pagamenti, addebiti e rimborsi) 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, vai su Extensions > Installer dopo la disinstallazione, fai clic su Uninstall (il pulsante arancione −) accanto a VibeFox Nets Nexi Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

Nets, Nets Easy e Nexi sono marchi dei rispettivi proprietari. Questa estensione non è affiliata né approvata da Nets o Nexi.