VibeFox Nets Nexi for WooCommerce — Guida

Requisiti

WordPress: 6.0 o successivo.

WooCommerce: 7.0 o successivo, installato e attivo. Il plugin non si attiva senza di esso.

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: il plugin non limita valute né paesi. Usa le valute abilitate nel tuo account Nets; una valuta non supportata viene segnalata da Nets al momento della creazione del pagamento. I metodi di pagamento visibili al cliente dipendono dal tuo contratto 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 sito deve usare HTTPS e permalink leggibili per ricevere i webhook. Su altri siti il pagamento viene comunque confermato quando il cliente torna al negozio, oppure tramite l'azione sull'ordine.

Chiave di licenza VibeFox: acquistata su vibefox.net. Una chiave funziona su un dominio.

Installazione

1. In WordPress vai su Plugins > Add New > Upload Plugin, scegli il file ZIP del plugin e fai clic su Install Now. Puoi anche caricare la cartella wcp_nets_nexi_gateway in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Payments > Nets Nexi (Nordics) > Manage, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugins.

4. Inserisci la tua chiave di licenza VibeFox nel blocco licenza in cima alla pagina e fai clic su Activate.

5. Copia la chiave segreta di test dal portale di test di Nets Easy e incollala in Test Secret Key (vedi Configurazione).

6. Attiva Enable/Disable, lascia Test Mode attivo ed effettua un ordine di prova. Poi inserisci la chiave segreta live e deseleziona Test Mode.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Payments > Nets Nexi (Nordics). Sopra i campi la pagina ti avvisa quando manca la chiave segreta della modalità selezionata (il metodo di pagamento viene quindi nascosto nel checkout), 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. Nell'elenco dei metodi di pagamento, Nets Nexi risulta da configurare finché la modalità selezionata non ha una chiave segreta.

Generale

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 nel checkout. Predefinito: Nets Easy.

Description: la descrizione del metodo di pagamento mostrata ai clienti nel checkout. Predefinito: Pay securely with Nets Easy.

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. Le chiavi di checkout non sono necessarie.

Test Mode: Enable 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.

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

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

Pagamento

Le notifiche di Nets (webhook) vengono registrate automaticamente con ogni pagamento. Non c'è nulla da configurare nel portale Nets. Questa sezione mostra l'URL del webhook. Ha questo formato: https://your-site/wc-api/nng_nets_nexi/. Se l'URL non è un indirizzo HTTPS pubblico, la sezione ti avvisa che il sito non riceve webhook; in tal caso i pagamenti vengono confermati quando il cliente torna al negozio o con l'azione sull'ordine Nets: check payment status and capture. Vengono registrati questi eventi:

Ogni webhook deve contenere il segreto casuale che il plugin ha creato per quell'ordine. I webhook senza il segreto corretto vengono rifiutati. Il webhook indica solo quale pagamento è cambiato: il pagamento stesso viene sempre riletto dalle API di Nets con la tua chiave segreta.

Order Status After Payment: lo stato dell'ordine una volta che Nets ha confermato e addebitato il pagamento. Lo stato viene impostato subito, così il cliente riceve una sola e-mail.

Avanzate

Debug log: Enable debug logging registra chiamate API e cambi di stato dei pagamenti in WooCommerce > Status > Logs, origine wcp_nets_nexi_gateway. Gli errori vengono sempre registrati. Chiavi e dati dei clienti non vengono registrati. Predefinito: disattivato.

Delete Data on Uninstall: Delete the plugin settings and logs when the plugin is deleted. Disattivare il plugin non elimina mai nulla. I dati di pagamento memorizzati sugli ordini vengono sempre conservati. Predefinito: disattivato.

Checkout

Il cliente sceglie il metodo di pagamento (per impostazione predefinita Nets Easy) e invia l'ordine. Il plugin crea un pagamento Nets con le righe dell'ordine, la spedizione e le commissioni nella valuta dell'ordine, e invia il cliente alla pagina di pagamento ospitata da Nets. E-mail, nome, indirizzo e numero di telefono del cliente vengono passati a Nets quando Nets accetta il loro formato; la pagina dei tuoi termini e condizioni è collegata nella pagina Nets. In modalità test il checkout mostra Test mode: no real money will be charged.

Il cliente paga e torna alla pagina di conferma ordine del tuo negozio. L'ordine viene segnato come pagato solo dopo la conferma di Nets: il plugin rilegge il pagamento dalle API di Nets, confronta l'importo e la valuta prenotati con l'ordine, addebita la prenotazione e solo dopo completa l'ordine. Questo avviene tramite il webhook, al ritorno del cliente sulla pagina di conferma ordine, oppure con l'azione sull'ordine Nets: check payment status and capture.

Se il cliente annulla sulla pagina Nets, torna al checkout o alla pagina Pay for order con il messaggio The Nets payment was cancelled. You can try again or choose another payment method. Un cliente può pagare di nuovo un ordine non pagato. Il plugin controlla prima il pagamento precedente; se è già stato pagato, l'ordine viene confermato. Altrimenti la sessione Nets precedente viene chiusa prima di avviarne una nuova. Se un pagamento dell'ordine è trattenuto per la tua verifica, il cliente vede A payment for this order is already being reviewed by the shop. Please contact us instead of paying again.

Se Nets non riesce ad avviare il pagamento, il cliente vede un breve messaggio, ad 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. oppure The payment service could not be reached. Please try again in a moment. I dettagli vengono scritti nel log.

Il metodo di pagamento funziona nel checkout classico, nel blocco Checkout e nella pagina Pay for order. È compatibile con WooCommerce High-Performance Order Storage (HPOS).

Il plugin usa solo la pagina di pagamento ospitata. Non prevede un checkout Nets integrato nella pagina, abbonamenti o pagamenti ricorrenti, carte salvate, commissioni sulle fatture, modalità solo autorizzazione né acquisizioni parziali per spedizione.

Ordini e rimborsi

Stati dell'ordine

Pending payment: il cliente è stato inviato a Nets e non ha ancora pagato. La nota dell'ordine mostra l'ID del pagamento Nets, l'importo e l'ambiente.

Processing or Completed: Nets ha confermato e addebitato il pagamento. Lo stato segue Order Status After Payment. La nota dell'ordine mostra l'ID del pagamento, l'ID dell'addebito e il metodo di pagamento. L'ID transazione è l'ID del pagamento Nets.

On hold: importo o valuta in Nets differiscono dall'ordine (non acquisito), l'acquisizione è stata rifiutata, oppure il cliente ha pagato dopo che l'ordine era stato annullato (prenotato, non acquisito). La nota dell'ordine lo spiega. Dopo aver verificato l'ordine, acquisisci con l'azione Nets: check payment status and capture, oppure annulla la prenotazione nel portale Nets.

Cancelled: la prenotazione dell'ultimo pagamento dell'ordine è stata annullata, ad esempio nel portale Nets.

Webhook ripetuti e ricaricamenti non addebitano mai due volte né aggiungono note, scalature di stock o e-mail duplicate, e un ordine pagato, rimborsato o annullato dopo il pagamento non viene mai riaperto. Se un vecchio link di pagamento viene completato per un ordine già pagato, la seconda prenotazione viene rilasciata automaticamente; se è già stata addebitata, una nota ti chiede di rimborsarla nel portale Nets.

Azione sull'ordine

Per gli ordini non pagati con un pagamento Nets, l'elenco delle azioni sull'ordine contiene Nets: check payment status and capture. Legge il pagamento da Nets e acquisisce una prenotazione corrispondente. Se non cambia nulla, una nota spiega il motivo, ad esempio che il cliente non ha ancora completato il pagamento.

Rimborsi

Apri l'ordine, fai clic su Refund, inserisci l'importo e fai clic su Refund via Nets Easy (il pulsante usa il titolo del metodo di pagamento). Rimborsi totali e parziali sono supportati una volta addebitato il pagamento; un pagamento solo prenotato può essere annullato nel portale Nets. Il rimborso va sull'addebito dell'ordine nell'ambiente in cui è stato pagato. Se Nets non accetta il rimborso, WooCommerce mostra l'errore e non viene registrato alcun rimborso. Un rimborso riuscito viene aggiunto alle note dell'ordine con l'ID di rimborso Nets.

I rimborsi effettuati direttamente nel portale Nets non diventano rimborsi WooCommerce. Se necessario, crea un rimborso manuale in WooCommerce senza usare Refund via Nets Easy.

Chiave di licenza

Il plugin funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza si trova in cima a WooCommerce > Settings > Payments > Nets Nexi (Nordics). Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, ad esempio la data fino alla quale la licenza è attiva, e il tuo dominio. Usa Check now per verificare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuoverla da questo sito. Il link Manage licenses and domains in your account apre il tuo account vibefox.net.

Una chiave funziona su un dominio. Rimuovere la chiave da un sito non libera lo slot del dominio. Liberalo nel tuo account vibefox.net.

Senza una chiave attiva, Nets Nexi non viene mostrato ai clienti nel checkout. Se un pagamento viene avviato comunque, il cliente vede This payment method is not available. Please choose another one. I gestori del negozio connessi vedono ancora il metodo di pagamento, contrassegnato con (unlicensed — visible to admins only), così puoi configurare e testare il plugin prima di acquistare una chiave. Un promemoria compare nella pagina Plugins e nelle pagine di WooCommerce. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati e i rimborsi funzionano.

Quando una licenza scade, il plugin continua a funzionare, ma aggiornamenti e assistenza richiedono il rinnovo. Lo stato viene verificato di nuovo automaticamente in background.

Risoluzione dei problemi

Nets Nexi non compare nel 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.

Il pagamento è andato a buon fine, ma l'ordine resta in Pending payment: il webhook non ha raggiunto il tuo negozio. Verifica che il sito usi HTTPS e permalink leggibili, in modo che l'URL del webhook nella sezione Payment sia un indirizzo HTTPS pubblico senza "&", e che la chiave segreta dell'ambiente del pagamento sia impostata. Poi usa l'azione sull'ordine Nets: check payment status and capture. L'ordine viene confermato anche quando il cliente torna alla pagina di conferma ordine.

Webhook answers Unauthorized: il webhook non conteneva il segreto di quell'ordine. I webhook vengono accettati solo con il segreto registrato con il pagamento.

Webhook answers Busy, retry later, Payment lookup failed o Payment not reserved yet: un'altra richiesta stava aggiornando l'ordine, le API di Nets non erano raggiungibili, oppure la prenotazione non era ancora visibile. Nets ritenta il webhook automaticamente.

Il cliente vede un errore quando effettua l'ordine: attiva Debug log e controlla WooCommerce > Status > Logs, origine wcp_nets_nexi_gateway. 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.

Order is On hold after payment: leggi la nota dell'ordine. Se l'acquisizione è stata rifiutata, riprova con l'azione sull'ordine Nets: check payment status and capture oppure addebita nel portale Nets. Se importo o valuta differiscono, verifica il pagamento nel portale Nets. Se il cliente ha pagato dopo l'annullamento, verifica l'ordine e acquisisci o annulla la prenotazione.

Refund via Nets Easy manca o non funziona: i rimborsi sono possibili solo dopo l'addebito del pagamento. Controlla nella nota dell'ordine che l'addebito ci sia. Un rimborso usa la chiave segreta dell'ambiente in cui l'ordine è stato pagato, quindi tale chiave deve essere impostata.

The license block shows an error: segui il messaggio nel blocco. Ad esempio, se la chiave è già usata su un altro dominio, libera uno slot nel tuo account vibefox.net e fai clic su Check now. Se l'indirizzo del sito è cambiato, fai clic su Check now per attivare la chiave per il nuovo dominio. Se il server delle licenze non è raggiungibile, il plugin continua a funzionare con l'ultimo stato noto.

Disinstallazione

Disattivare il plugin conserva tutti i dati. Per rimuoverlo, disattivalo ed eliminalo dalla pagina Plugins. La chiave di licenza e lo stato della licenza di questo plugin vengono sempre rimossi. Le impostazioni del gateway e i registri vengono rimossi solo se Delete Data on Uninstall era attivo. Altrimenti restano disponibili per una futura reinstallazione. Gli ordini esistenti conservano le note di pagamento e gli ID delle transazioni.

Nets, Nets Easy e Nexi sono marchi dei rispettivi proprietari. Questo plugin non è affiliato né approvato da Nets o Nexi.