Checkout WooCommerce non funziona? Cause, errori comuni e soluzioni

Cos’è il checkout WooCommerce

Il checkout WooCommerce è la fase finale del processo di acquisto. È la pagina in cui il cliente inserisce i dati di fatturazione, sceglie il metodo di spedizione, seleziona il metodo di pagamento e conferma l’ordine.

Anche se sembra una semplice pagina, in realtà il checkout esegue molte operazioni tecniche nello stesso momento. Controlla i campi obbligatori, verifica il carrello, calcola spedizioni e tasse, comunica con il gateway di pagamento, crea l’ordine nel database e invia le email di conferma.

Per questo motivo il checkout WooCommerce può smettere di funzionare per molte cause diverse: plugin in conflitto, errori JavaScript, problemi di cache, configurazioni errate di Stripe o PayPal, limiti server, tema non compatibile o aggiornamenti non completati correttamente.

Sintomi più comuni quando il checkout WooCommerce non funziona

Prima di intervenire è importante capire esattamente cosa succede. Il problema può sembrare generico, ma ogni sintomo può indicare una causa diversa.

Se il checkout non funziona, ogni minuto può significare ordini persi. Per questo è importante non procedere a tentativi casuali, ma seguire una diagnosi ordinata.

Perché il checkout WooCommerce non funziona

Le cause più comuni sono quasi sempre legate a conflitti tra plugin, tema, cache, server o sistemi di pagamento.

1. Plugin incompatibili

WooCommerce lavora insieme a molti plugin: pagamenti, spedizioni, fatturazione elettronica, campi personalizzati, email, coupon, traduzioni, sicurezza, cache e marketing. Basta un plugin non aggiornato o scritto male per bloccare il checkout.

2. Tema non compatibile

Alcuni temi modificano il layout del checkout, sovrascrivono i template WooCommerce o caricano script personalizzati. Dopo un aggiornamento di WooCommerce, questi template possono diventare obsoleti e generare errori.

3. Cache configurata male

La pagina checkout non dovrebbe mai essere servita da cache statica. Se il checkout viene memorizzato in cache, il cliente può vedere dati errati, carrelli svuotati, sessioni scadute o pulsanti non funzionanti.

4. Errori JavaScript

WooCommerce usa JavaScript per aggiornare carrello, spedizioni, pagamenti e campi dinamici. Se uno script va in errore, il checkout può bloccarsi completamente.

5. Problemi AJAX

Il checkout utilizza richieste AJAX per comunicare con WordPress senza ricaricare la pagina. Se queste richieste vengono bloccate da cache, firewall, plugin di sicurezza o problemi server, il processo di ordine può fallire.

6. Gateway di pagamento configurato male

Stripe, PayPal, Nexi, Satispay, Scalapay e altri sistemi di pagamento richiedono API, webhook, certificato SSL e configurazioni corrette. Una chiave errata o un webhook non funzionante può impedire la conclusione dell’ordine.

7. Limiti del server

Memory limit basso, timeout PHP, versione PHP obsoleta o hosting lento possono causare errori durante il checkout, soprattutto su negozi WooCommerce con molti plugin attivi.

Come capire perché il checkout WooCommerce non funziona

La diagnosi deve essere fatta con metodo. Il primo errore da evitare è disattivare plugin a caso su un sito online senza backup, perché potresti peggiorare la situazione o perdere configurazioni importanti.

Checklist iniziale

• Fai un backup completo del sito e del database.
• Verifica se il problema avviene con tutti i prodotti o solo con alcuni.
• Controlla se il problema avviene con tutti i metodi di pagamento.
• Prova il checkout da desktop e da smartphone.
• Prova con un browser diverso o in navigazione anonima.
• Controlla se il problema è iniziato dopo un aggiornamento.
• Verifica gli ultimi plugin installati o modificati.

Controlla i log WooCommerce

Vai in:

WooCommerce → Stato → Log

Qui puoi trovare errori generati da gateway di pagamento, plugin di spedizione, API esterne o funzioni WooCommerce.

Controlla la console del browser

Da Chrome puoi aprire gli strumenti sviluppatore con:

CTRL + SHIFT + I

Poi vai nella scheda “Console”. Se vedi errori rossi, probabilmente uno script sta bloccando il checkout.

Controlla gli errori PHP

Se il problema è lato server, potresti trovare errori nel file debug.log di WordPress o nei log dell’hosting.

Errori come fatal error, allowed memory size exhausted o uncaught error indicano quasi sempre un problema tecnico che richiede intervento sul sito.

Plugin incompatibili con il checkout WooCommerce

I plugin sono una delle cause più frequenti di checkout WooCommerce bloccato. Il problema può nascere dopo un aggiornamento, dopo l’installazione di un nuovo plugin o dopo una modifica alle impostazioni.

Plugin che possono creare conflitti

• plugin per campi checkout personalizzati;
• plugin di spedizione avanzata;
• plugin di pagamento;
• plugin di fatturazione elettronica;
• plugin di cache;
• plugin di sicurezza;
• plugin di traduzione;
• plugin per coupon e sconti;
• plugin per upsell, cross-sell e carrelli dinamici;
• plugin per checkout one-page.

Se il problema è iniziato dopo l’installazione o l’aggiornamento di un plugin, quello è il primo elemento da controllare.

Problemi del tema con il checkout WooCommerce

Anche il tema può causare problemi nel checkout. Questo succede soprattutto quando il tema modifica i template WooCommerce oppure utilizza funzioni personalizzate per carrello, pagamento e pagina ordine.

WooCommerce aggiorna periodicamente i suoi template. Se il tema non viene mantenuto correttamente, alcuni file possono diventare obsoleti.

Segnali di un problema legato al tema

• il checkout si vede male graficamente;
• alcuni campi non sono cliccabili;
• il pulsante ordine non risponde;
• la pagina funziona con un tema standard ma non con il tema attivo;
• dopo un aggiornamento WooCommerce il checkout si rompe;
• il problema compare solo da mobile.

In questi casi è necessario verificare se il tema contiene override WooCommerce obsoleti.

Cache e checkout WooCommerce: una causa molto frequente

La cache è utile per velocizzare un sito WordPress, ma su WooCommerce deve essere configurata correttamente. Carrello, checkout e area account sono pagine dinamiche e non devono essere trattate come normali pagine statiche.

Pagine da escludere dalla cache

• /cart/
• /checkout/
• /my-account/
• endpoint ordine ricevuto;
• endpoint pagamento;
• URL AJAX WooCommerce.

Plugin cache da controllare

• LiteSpeed Cache;
• WP Rocket;
• W3 Total Cache;
• WP Super Cache;
• Autoptimize;
• plugin cache dell’hosting;
• Cloudflare;
• Redis Object Cache.

Se il checkout funziona dopo aver svuotato o disattivato temporaneamente la cache, il problema è quasi certamente nella configurazione della cache.

Errori JavaScript nel checkout WooCommerce

Gli errori JavaScript sono tra le cause più frequenti quando il checkout WooCommerce non funziona. In molti casi il cliente arriva alla pagina di pagamento, compila tutti i campi, clicca su “Effettua ordine”, ma non succede nulla.

Questo accade perché uno script necessario al funzionamento del checkout viene bloccato, caricato in modo errato oppure entra in conflitto con altri script del tema o dei plugin.

Sintomi tipici di un errore JavaScript

• il pulsante “Effettua ordine” non risponde;
• il checkout resta bloccato senza mostrare errori;
• i metodi di pagamento non si aggiornano;
• i campi obbligatori non vengono validati;
• la spedizione non cambia quando si modifica l’indirizzo;
• Stripe o PayPal non caricano correttamente il modulo di pagamento.

Come controllare la console JavaScript

Apri la pagina checkout, clicca con il tasto destro e seleziona “Ispeziona”. Poi vai nella scheda “Console”. Se sono presenti errori rossi, uno script sta probabilmente bloccando il checkout.

Chrome → Tasto destro → Ispeziona → Console

Gli errori più comuni riguardano file JavaScript del tema, plugin di ottimizzazione, librerie jQuery, sistemi di pagamento o script caricati in ritardo.

Problemi AJAX nel checkout WooCommerce

WooCommerce usa AJAX per aggiornare il checkout senza ricaricare completamente la pagina. Questo permette di aggiornare spedizioni, totale ordine, metodi di pagamento e validazione dei campi in modo dinamico.

Se le richieste AJAX vengono bloccate o falliscono, il checkout può restare in caricamento infinito oppure impedire la creazione dell’ordine.

Sintomi di un problema AJAX

• il checkout carica all’infinito;
• il totale ordine non si aggiorna;
• il metodo di spedizione non cambia;
• compare un errore generico durante il pagamento;
• l’ordine non viene registrato in WooCommerce;
• il cliente viene riportato al carrello.

Cosa controllare

• plugin di cache;
• firewall applicativi;
• Cloudflare;
• ModSecurity dell’hosting;
• plugin di sicurezza WordPress;
• errori 403 o 500 su admin-ajax.php;
• ottimizzazioni JavaScript troppo aggressive.

Un controllo utile è aprire la scheda “Network” del browser e verificare se le richieste verso admin-ajax.php o verso gli endpoint WooCommerce restituiscono errori.

Chrome → Ispeziona → Network → Filtra per XHR / Fetch

Stripe non funziona nel checkout WooCommerce

Stripe è uno dei gateway di pagamento più utilizzati su WooCommerce, ma può bloccare il checkout se non è configurato correttamente.

I problemi più comuni riguardano chiavi API errate, webhook mancanti, modalità test attiva, SSL non valido, plugin non aggiornato o conflitti JavaScript.

Problemi Stripe più frequenti

• pagamento rifiutato senza motivo apparente;
• errore durante la conferma del pagamento;
• ordine creato ma pagamento non completato;
• ordine segnato come fallito;
• modulo carta non visibile;
• Apple Pay o Google Pay non disponibili;
• webhook Stripe non funzionante;
• modalità test attiva per errore.

Controlli da fare su Stripe

• verifica che le chiavi API siano corrette;
• controlla se il sito è in modalità test o live;
• verifica il certificato SSL;
• controlla i webhook configurati su Stripe;
• aggiorna il plugin ufficiale Stripe per WooCommerce;
• controlla i log WooCommerce relativi a Stripe;
• verifica eventuali errori JavaScript nella console.

Se Stripe non comunica correttamente con WooCommerce, il cliente può completare il pagamento ma l’ordine può restare in stato “in attesa”, “fallito” o non essere aggiornato correttamente.

PayPal non funziona nel checkout WooCommerce

Anche PayPal può causare problemi nel checkout WooCommerce, soprattutto quando le credenziali API non sono corrette, il plugin è obsoleto oppure il redirect verso PayPal non viene completato.

Sintomi tipici

• il cliente non viene reindirizzato a PayPal;
• il pagamento viene completato ma l’ordine resta in sospeso;
• PayPal mostra un errore generico;
• il pulsante PayPal non compare;
• il checkout resta bloccato dopo il ritorno da PayPal;
• l’ordine viene duplicato o non aggiornato.

Controlli consigliati

• verifica le credenziali API PayPal;
• controlla che non sia attiva la modalità sandbox;
• aggiorna il plugin PayPal;
• verifica i log WooCommerce;
• controlla eventuali blocchi da firewall o sicurezza;
• verifica che l’URL di ritorno funzioni correttamente;
• controlla se il problema avviene solo con PayPal o con tutti i metodi di pagamento.

Checkout WooCommerce non funziona da mobile

A volte il checkout WooCommerce funziona correttamente da desktop, ma non da smartphone. Questo è un problema molto serio, perché gran parte degli acquisti online avviene da dispositivi mobili.

Cause più comuni su smartphone

• layout del tema non ottimizzato;
• pulsante ordine nascosto o non cliccabile;
• popup che coprono il checkout;
• banner cookie invasivo;
• errori JavaScript solo su mobile;
• problemi con Apple Pay o Google Pay;
• cache mobile separata configurata male;
• campi checkout troppo stretti o sovrapposti.

Il test va fatto almeno da iPhone, Android, Chrome mobile e Safari mobile. Non basta ridurre la finestra del browser da desktop, perché alcuni problemi compaiono solo su dispositivi reali.

Come prevenire problemi al checkout WooCommerce

Il checkout è la parte più delicata di un eCommerce. Per questo non dovrebbe essere controllato solo quando smette di funzionare, ma dopo ogni aggiornamento importante.

Checklist di prevenzione

• fai sempre un backup prima degli aggiornamenti;
• usa un ambiente di staging per testare modifiche importanti;
• controlla il checkout dopo ogni aggiornamento di WooCommerce;
• verifica periodicamente Stripe, PayPal e altri gateway;
• escludi carrello e checkout dalla cache;
• mantieni PHP, tema e plugin aggiornati;
• controlla i log WooCommerce;
• effettua ordini di test periodici;
• non installare plugin inutili sul checkout;
• monitora errori 500, 403 e problemi AJAX.

Una manutenzione regolare riduce il rischio di perdere vendite per problemi tecnici non visibili immediatamente.

Se vuoi prevenire blocchi, errori e malfunzionamenti ricorrenti, puoi valutare anche il servizio di manutenzione WordPress.

Quando chiedere assistenza per il checkout WooCommerce

Puoi provare a fare alcuni controlli di base, ma ci sono situazioni in cui è meglio fermarsi e chiedere supporto tecnico, soprattutto se il sito sta già perdendo ordini.

Chiedi assistenza se:

• il checkout è completamente bloccato;
• i clienti non riescono a pagare;
• Stripe o PayPal restituiscono errori;
• gli ordini non vengono creati;
• il problema è iniziato dopo un aggiornamento;
• la console mostra errori JavaScript;
• i log WooCommerce mostrano errori PHP;
• non sai quale plugin sta causando il conflitto;
• hai paura di peggiorare la situazione disattivando plugin.

FAQ sul checkout WooCommerce che non funziona