Per usare Nexi XPay su WooCommerce servono un servizio attivo, il modulo adatto e una configurazione verificata. Vedere il metodo alla cassa è soltanto il primo controllo: il pagamento deve essere associato all’ordine corretto e riconoscibile da chi prepara la spedizione. Questa guida propone un percorso di configurazione e collaudo per evitare di scoprire i problemi durante un acquisto reale.
Indice della guida
1. Verifica contratto, modulo e compatibilità
Il plugin collega il sito a XPay, ma non sostituisce l’attivazione del servizio di pagamento. Controlla account dell’attività, terminale abilitato e documentazione ricevuta da Nexi. La scheda ufficiale del plugin precisa che le funzioni dipendono dalla convenzione e dalla configurazione.
Nexi documenta sia il percorso con passaggio alla pagina di pagamento sia Build con checkout incorporato nel sito. Identifica la soluzione effettivamente prevista per il tuo negozio prima di seguire una procedura. Controlla versioni di WordPress, WooCommerce e PHP, tipo di checkout, tema ed estensioni. Per abbonamenti o funzioni particolari, verifica i requisiti specifici: la compatibilità del pagamento semplice non dimostra quella di ogni combinazione.
2. Prepara il negozio prima di collegare Nexi
Crea un backup verificabile e, quando possibile, una copia di prova del sito WordPress. Annota i metodi già attivi e gli ordini ancora aperti. Se sostituisci un vecchio collegamento, chiarisci come gestire eventuali rimborsi o rinnovi prima di disabilitarlo.
- Controlla che carrello e cassa si aprano correttamente tramite HTTPS.
- Prepara un prodotto semplice e una variante per le prove.
- Verifica imposte, coupon, zone di consegna e totale da pagare.
- Impedisci alla copia di prova di inviare richieste reali a corrieri o magazzino.
Individua una persona che controlli gli ordini dopo il collaudo. Un promemoria condiviso con numero d’ordine, risultato atteso e risultato ottenuto rende più facile riconoscere cosa manca e affidare la gestione al personale.
3. Installa il plugin e imposta le credenziali corrette
Da Plugin → Aggiungi nuovo cerca Nexi XPay e verifica che provenga da Nexi Payments. Dopo l’attivazione apri le impostazioni del pagamento. La procedura Nexi con API Key descrive la configurazione del modulo e il passaggio da test a produzione.
- Seleziona la tipologia di credenziali indicata per il servizio sottoscritto.
- Attiva la modalità di test e inserisci le credenziali di prova corrispondenti.
- Salva e controlla la disponibilità del metodo nella cassa.
Il plugin può presentare API Key oppure Alias e chiave MAC secondo il servizio: non convertire o mescolare questi dati. Se campi e documentazione non coincidono, controlla l’email di attivazione e chiedi a Nexi quale procedura usare. Conserva le chiavi nei campi previsti; escludile da screenshot e messaggi di assistenza.
4. Esegui acquisti di prova con esiti diversi
L’area di test Nexi fornisce dati per simulare pagamenti riusciti e non riusciti. Alcuni metodi alternativi richiedono un proprio ambiente di prova. Usa soltanto i dati previsti per il test, verificando prima che il negozio non stia operando in produzione.
Costruisci una piccola lista di casi: un articolo con spedizione, uno con coupon, un pagamento rifiutato e un acquisto interrotto. Ripetili da computer e telefono. Per esempio, con 40 euro di prodotti e 6 euro di consegna, il totale dell’ordine e quello richiesto dal pagamento devono essere 46 euro. Con un coupon, ricalcola il risultato atteso prima di riprovare.
Controlla pagina finale, note dell’ordine, scorte ed email. Se il pagamento risulta corretto ma manca la posta, segui anche la guida alle email degli ordini WooCommerce non ricevute.
5. Se Nexi conferma ma l’ordine non si aggiorna
Apri la transazione nel sistema Nexi e confronta riferimento, importo e risultato con WooCommerce. Non richiedere un secondo pagamento soltanto perché manca la conferma nel sito. La documentazione delle notifiche XPay chiarisce che un problema nella consegna della notifica non annulla automaticamente la transazione; inoltre, la comunicazione può arrivare prima o dopo il ritorno del cliente.
Fai verificare registri del plugin, raggiungibilità del sito e protezioni che potrebbero bloccare le comunicazioni. Nexi invita espressamente a collaudare firewall e possibili conflitti con altre estensioni. Non disattivare indistintamente tutte le protezioni sul negozio operativo: riproduci il problema nella copia di prova e restringi la verifica al passaggio interessato.
Per l’assistenza annota orario, ordine, codice d’errore e operazioni già tentate. Per problemi estesi ad altri metodi consulta i controlli sui pagamenti WooCommerce non riusciti.
6. Distingui autorizzazione, incasso e rimborso
Un’operazione autorizzata non va confusa con una somma già contabilizzata. La documentazione Nexi sulle operazioni distingue la contabilizzazione implicita da quella esplicita, che richiede una successiva conferma. Chiarisci quale modalità usa il tuo terminale e chi deve intervenire.
Prima di spedire, verifica l’esito richiesto dalla procedura concordata per il negozio. Per un rimborso, identifica ordine e transazione, controlla l’importo e verifica il risultato anche in Nexi. Evita di ripetere la stessa operazione da WooCommerce e dal portale senza sapere se la prima è riuscita.
Conserva un riferimento comune nella gestione dell’ordine. Se un intervento viene effettuato direttamente nel back office, controlla come viene riportato nel sito: la sincronizzazione non va presunta. La guida a resi e rimborsi WooCommerce aiuta a coordinare restituzione della merce e registrazione del rimborso.
7. Passa ai pagamenti reali e controlla i primi ordini
Concluso il collaudo, imposta le credenziali di produzione del terminale corretto e disattiva la modalità test. Per il percorso API Key, Nexi indica la generazione della chiave dal back office XPay Web accessibile tramite Nexi Business. Salva e ricontrolla la configurazione del negozio pubblico.
Organizza una prova reale concordata, tenendo conto di commissioni e condizioni del servizio. Verifica importo, conferma e modalità di incasso; se è previsto un rimborso, documentane l’esito. Lascia alla persona che gestisce gli ordini una procedura breve: dove vedere la transazione, come riconoscere un’anomalia e a chi segnalarla.
Nei primi ordini osserva eventuali differenze fra dispositivi o metodi utilizzati. Se hai attivato più strumenti di pagamento, controlla che le etichette alla cassa siano comprensibili e che ciascuno sia stato provato separatamente.
Domande frequenti
Il plugin Nexi XPay basta per ricevere pagamenti?
No. Serve anche il servizio XPay attivo con credenziali e funzioni abilitate per l’attività. Il plugin realizza il collegamento tecnico con WooCommerce.
Devo inserire API Key oppure Alias e chiave MAC?
Dipende dal servizio sottoscritto e dalla relativa documentazione. Usa la tipologia indicata per il tuo terminale e non mescolare credenziali di servizi o ambienti differenti.
Posso provare Nexi senza addebiti reali?
Sì, usando modalità, credenziali e carte dell’ambiente di test. Controlla l’ambiente selezionato prima di iniziare e verifica anche gli esiti negativi.
Il cliente ha pagato ma WooCommerce mostra un ordine in attesa: cosa faccio?
Confronta prima la transazione Nexi con l’ordine, poi verifica notifiche e registri. Non chiedere un altro pagamento finché non hai chiarito l’esito del primo.