- Aiuto shopify, Assistenza Shopify, Codice liquid shopify, Configurazione tasse shopify, Consulenza ecommerce freelance, Errore checkout
- Francesco Guiducci
Aiuto Shopify: 5 controlli quando checkout, spedizioni o tema non funzionano
Risposta diretta: quando checkout, spedizioni, pagamenti o tema Shopify smettono di funzionare, non parto dal codice. Riproduco il problema e isolo il livello coinvolto: mercato e paese, spedizione, pagamento, app o tema. Lo stesso sintomo può avere cause diverse; il fix corretto è quello dimostrato dal comportamento reale dello store.
La parte più importante dell’assistenza Shopify è evitare modifiche casuali. Un messaggio al checkout può dipendere da mercato, indirizzo, prodotto, profilo di spedizione, sede, metodo di pagamento o app. Se cambio il tema prima di capire quale livello genera l’errore, rischio di aggiungere un secondo problema al primo.
Metodo
Prima riproduco, poi isolo, infine modifico. Se non riesco a descrivere esattamente quando compare il problema, non considero ancora dimostrata la causa.
1. Prima raccolgo un caso riproducibile
Prima di toccare codice o impostazioni raccolgo gli elementi che permettono di ripetere il problema nelle stesse condizioni:
- URL esatto;
- prodotto e variante;
- quantità e contenuto del carrello;
- paese, mercato e valuta se rilevanti;
- indirizzo o almeno area geografica usata nel test;
- dispositivo e browser;
- testo esatto dell’errore o screenshot;
- passaggi che portano all’errore;
- modifiche recenti a tema, app, spedizioni o pagamenti;
- indicazione se il problema avviene sempre o solo in alcuni casi.
Se il problema compare soltanto con un prodotto, una nazione o una combinazione di articoli, questa differenza è già un indizio utile.
2. Il mio ordine di diagnosi
| Sintomo | Primo livello che controllo | Perché |
|---|---|---|
| Nessuna spedizione disponibile | Mercato + profili/spedizione + prodotto | La tariffa deve essere compatibile con paese, articoli, sedi e condizioni |
| Pagamento rifiutato | Gateway + cronologia checkout/ordine | Il tema raramente spiega da solo un rifiuto del provider |
| Pulsante o variante non risponde | Tema + JavaScript + app | È un comportamento storefront e può esserci un conflitto frontend |
| Problema solo in un paese | Mercati + spedizione + valuta/metodo | La configurazione può cambiare in base alla destinazione |
| Problema iniziato dopo una modifica | Diff prima/dopo | La correlazione temporale restringe la ricerca ma non prova ancora la causa |
3. Mercato e paese: il primo controllo quando il problema è geografico
Se un cliente non riesce ad acquistare da un determinato paese, verifico che quel paese appartenga a un mercato attivo e che le impostazioni pertinenti siano compatibili con il carrello. Non basta controllare una singola tariffa.
Esempio pratico
Un prodotto viene acquistato correttamente dall’Italia ma non dalla Svizzera. Prima di toccare il tema verifico mercato, disponibilità della spedizione per quel paese, profilo del prodotto e condizioni applicate al carrello. Se il problema è nella configurazione geografica, il CSS o Liquid non c’entrano.
4. Spedizioni: profili, sedi, prodotti e condizioni devono combaciare
La documentazione Shopify segnala che le tariffe al checkout dipendono da più elementi: prodotto, mercato, sedi, profili di spedizione, imballaggio e, quando presenti, account del corriere. Inoltre Shopify sta migrando gradualmente le configurazioni verso le opzioni di spedizione per mercato, quindi durante una diagnosi controllo lo stato reale dello store invece di presumere che tutti gli account abbiano la stessa interfaccia.
Per una tariffa che non compare verifico almeno:
- prodotto assegnato al profilo corretto;
- sede di evasione corretta;
- zona che include l’indirizzo del cliente;
- tariffa compatibile con peso o valore del carrello;
- scorte nella sede che deve evadere l’ordine;
- eventuali profili creati o controllati da app;
- carrelli composti da prodotti di profili o sedi differenti.
Errore comune
Testare una tariffa con un carrello diverso da quello del cliente. Se cambiano prodotto, quantità, peso, sede o indirizzo, non sto più riproducendo lo stesso caso.
5. Pagamenti: prima leggo il segnale del gateway
Se il cliente raggiunge il pagamento ma la transazione fallisce, distinguo configurazione dello store, risposta del gateway e condizioni del singolo tentativo. Shopify indica come punto di diagnosi la cronologia dei checkout abbandonati o dell’ordine, quando disponibile.
Non attribuisco automaticamente il problema al tema. Controllo il metodo utilizzato, il messaggio registrato, eventuali requisiti mancanti e la documentazione del provider. Quando possibile uso modalità di test invece di generare transazioni reali soltanto per fare debug.
6. App e script: installazione recente non significa automaticamente colpevole
Una nuova app è un indizio temporale, non una prova. Controllo se carica effettivamente app embed, script, blocchi o asset sulla pagina coinvolta e se compaiono errori compatibili con il sintomo.
Allo stesso modo, un’app disinstallata non lascia necessariamente residui. Cerco evidenza nel tema prima di cancellare codice. Il rischio opposto è rimuovere snippet o script che servono ancora a un’altra funzione.
7. Tema e regressioni: su Online Store 2.0 non guardo solo theme.liquid
Se il problema compare dopo una modifica grafica o funzionale, confronto il comportamento con una copia del tema e identifico il file o la configurazione realmente coinvolta. Su Online Store 2.0 una modifica può vivere in sezioni, snippet, asset, template JSON, app block o Custom Liquid salvato nelle impostazioni del template.
Questo è particolarmente importante quando una sezione Custom Liquid non esiste come file .liquid: il suo contenuto può essere salvato direttamente nel JSON del template. Cercare soltanto in theme.liquid può quindi portare a una falsa conclusione.
8. Quando NON intervengo sul codice
- Il problema è spiegato da una tariffa di spedizione mancante o incompatibile.
- Il gateway restituisce un errore che richiede configurazione o intervento del provider.
- Il paese non è configurato nel percorso commerciale previsto.
- La funzione appartiene a un’app di terze parti e il tema non controlla quel comportamento.
- Il problema non è riproducibile e mancano dati sufficienti per attribuirlo al tema.
Modificare Liquid o JavaScript in questi casi non sarebbe “assistenza tecnica”: sarebbe un tentativo senza root cause.
9. Quando invece il codice è il livello corretto
Intervengo sul tema quando la causa è stata isolata nello storefront: errore JavaScript, logica Liquid, CSS che impedisce un’interazione, sezione mal configurata, regressione introdotta da una modifica o integrazione frontend che posso controllare.
Lavoro su una copia del tema e verifico non solo il caso segnalato, ma anche i flussi collegati. Un fix su varianti, per esempio, deve essere controllato insieme al pulsante di acquisto, disponibilità, prezzo e carrello.
10. Regression test minimo dopo un fix Shopify
- caso originale che generava il bug;
- mobile e desktop;
- prodotto con e senza varianti, se pertinente;
- menu e ricerca se è stato toccato JavaScript globale;
- carrello e drawer;
- spedizione o mercato coinvolto;
- tracking o pixel se il codice modificato interagisce con eventi;
- app collegate al componente;
- console browser senza nuovi errori rilevanti.
11. Problema dello store o problema della piattaforma?
Non uso “Shopify non funziona” come diagnosi. Se l’errore riguarda una configurazione, il tema o un’app specifica, cerco la causa nello store. Se il comportamento sembra riguardare una funzione della piattaforma o un servizio esterno, verifico lo stato e la documentazione corrente prima di modificare il codice.
La distinzione è importante anche per comunicare correttamente il problema: un fix del tema non può correggere un malfunzionamento del provider di pagamento, e una configurazione delle spedizioni non risolve un errore JavaScript nel selettore varianti.
12. Checklist che mi invierei prima di aprire un ticket tecnico
- “Cosa succede” descritto in una frase concreta.
- “Cosa dovrebbe succedere” altrettanto chiaro.
- URL e prodotto coinvolti.
- Passaggi di riproduzione numerati.
- Screenshot o messaggio esatto.
- Paese e carrello se il problema è al checkout.
- Browser/dispositivo se è un problema frontend.
- Ultima modifica nota prima della comparsa.
- Indicazione se succede anche su una copia del tema o su altri prodotti.
Fonti ufficiali
- Shopify Help Center — Risoluzione dei problemi e verifica delle tariffe di spedizione
- Shopify Help Center — Risoluzione dei problemi dei canali di pagamento
Sono Francesco Guiducci, Shopify specialist freelance. Seguo direttamente diagnosi e interventi tecnici su Basic, Grow e Advanced. Se hai un problema puntuale trovi il servizio Assistenza e manutenzione Shopify; se invece vuoi capire lo stato complessivo dello store, parto dal mio Audit Shopify.
Aggiornato il 13 settembre 2026.
