> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# I pulsanti di pagamento express non sono cliccabili in Upcart

> Questo articolo spiega come risolvere i problemi dei pulsanti di checkout express di Shopify quando non funzionano in Upcart

⚠️ **Avviso importante**

Lo snippet del tema qui sotto si applica a entrambe le versioni dei moduli carrello di Upcart — fa sì che Shopify renderizzi i pulsanti di checkout accelerato sulla pagina, che è ciò di cui Upcart ha bisogno indipendentemente dalla versione del modulo.

Il selettore `.additional-checkout-buttons` qui sotto è la classe di Shopify sul contenitore del checkout accelerato, non una classe di un modulo Upcart, quindi è la stessa su entrambe le versioni del carrello.

<div id="overview">
  ## Panoramica
</div>

A volte i pulsanti di checkout express non sono cliccabili o non appaiono all'interno di Upcart. Si tratta di un problema comune causato da come **Shopify controlla il rendering dei pulsanti di pagamento express** nei temi.

Questa guida spiega perché succede e cosa puoi fare per risolverlo.

***

<div id="required-setup-for-the-new-module">
  ## Configurazione richiesta per il nuovo modulo
</div>

⚠️ **Importante:** questi passaggi si applicano al **nuovo modulo Express Payments** di Upcart, non alla versione legacy.

Per far funzionare correttamente i pulsanti di checkout express in Upcart, devi aggiungere un piccolo snippet di codice al tuo tema Shopify. Senza questo snippet, Shopify non caricherà correttamente i pulsanti di pagamento all'interno del cart drawer. Prima di apportare queste modifiche, verifica che i metodi di pagamento pertinenti (ad es. Shop Pay, PayPal, Apple Pay, Google Pay) siano abilitati nelle impostazioni del tuo account Shopify Admin. Senza abilitare questi metodi, i pulsanti non saranno visibili. Inoltre, assicurati che lo snippet sia posizionato direttamente sotto il tag di apertura `<body>` nel file del tuo tema (ad es. `<body class="...">`). Se posizionato in modo errato, ad esempio dopo il tag di chiusura `</body>`, i pulsanti di checkout express potrebbero non funzionare correttamente.

***

<div id="how-to-fix">
  ## Come risolvere
</div>

1. Vai al tuo **Shopify Admin**.
2. Vai a **Online Store > Themes > Edit Code**.
3. Apri **layout/theme.liquid**, trova la riga `<body>` e aggiungi lo snippet qui sotto su una nuova riga direttamente sotto di essa. Deve andare lì — non in `cart-drawer.liquid` o altrove — perché i pulsanti devono esistere su ogni pagina in cui il carrello può aprirsi.

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
{% if additional_checkout_buttons %} <div style="display: none !important">     {{ content_for_additional_checkout_buttons }} </div> {% endif %}
```

1. Salva le modifiche e aggiorna il tuo negozio.
2. Riapri il cart drawer per verificare che i pulsanti di checkout express (come Shop Pay, PayPal, Apple Pay o Google Pay) ora appaiano e siano cliccabili.

Consulta la **guida al** [**modulo Express Payments**](/it/upcart/express_payments_module) per le istruzioni complete di configurazione.

***

<div id="why-this-happens">
  ## Perché succede
</div>

I pulsanti di pagamento express sono gestiti interamente da **Shopify**, non da Upcart. Ciò significa che:

* Upcart non renderizza i propri pulsanti. **Clona i pulsanti** di checkout accelerato **di Shopify** dalla pagina nel cart drawer, motivo per cui devono innanzitutto essere presenti sulla pagina — è ciò che garantisce lo snippet del tema qui sopra.
* **Apple Pay** verrà mostrato solo sui dispositivi Apple con Apple Pay configurato.
* Upcart non controlla quali pulsanti express appaiono, poiché il contenuto e la funzionalità sono gestiti da Shopify.

🎨 **Nota:**\
I pulsanti in Upcart fungono da contenitori visivi, mentre Shopify ne controlla la visualizzazione e il comportamento. Upcart non può modificarne l'aspetto o la funzione.

***

<div id="common-problems-and-fixes">
  ## Problemi comuni e soluzioni
</div>

<div id="1-the-buttons-arent-rendered-on-the-page">
  ## 1. I pulsanti non vengono renderizzati sulla pagina
</div>

Questa è la causa più comune. Upcart clona i pulsanti di Shopify dalla pagina, quindi se la pagina non li renderizza non c'è nulla da clonare e il carrello mostra uno spazio vuoto.

**Cosa fare:**

* Aggiungi lo snippet del tema dalla sezione **Come risolvere** qui sopra, direttamente sotto la riga `<body>` in `layout/theme.liquid`.

<Warning>
  **Non rimuovere i pulsanti express del tuo tema per "evitare un conflitto".** Upcart dipende dalla loro presenza. Rimuoverli dal tema, o disattivarli nelle impostazioni del tema, elimina la fonte da cui Upcart clona — il che peggiora il problema, non lo migliora.
</Warning>

***

<div id="3-css-is-blocking-the-buttons">
  ## 3. Il CSS sta bloccando i pulsanti
</div>

Alcuni temi nascondono i pulsanti express per impostazione predefinita usando CSS. Ad esempio:

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
.additional-checkout-buttons {   display: none !important; }
```

**Cosa fare:**

* Rivedi il CSS del tuo tema.
* Chiedi al tuo sviluppatore di tema di assicurarsi che nessuna regola CSS stia nascondendo o disabilitando i pulsanti nel drawer di Upcart.

***

<div id="4-legacy-settings-are-interfering">
  ## 4. Impostazioni legacy interferiscono
</div>

Se hai usato la versione precedente del modulo Express Payments, le impostazioni salvate potrebbero entrare in conflitto con la nuova configurazione.

**Cosa fare:**

* Apri il vecchio modulo Express Payments (se ancora visibile).
* Deseleziona tutte le opzioni precedenti e salva.
* Riprova usando il nuovo modulo.

***

<div id="still-having-issues">
  ## Hai ancora problemi?
</div>

<div id="disable-shadow-dom-in-upcart">
  ## Disabilitare lo Shadow DOM in Upcart
</div>

In alcuni casi, i pulsanti di pagamento express potrebbero non caricarsi o non aggiornarsi perché lo **Shadow DOM** è abilitato in Upcart.

**Cos'è lo Shadow DOM?**\
Lo Shadow DOM isola Upcart dal resto del codice del tuo negozio per migliorare la stabilità. Tuttavia, in rari casi, questa separazione può impedire ai pulsanti express di Shopify di aggiornarsi correttamente.

**Come disabilitare lo Shadow DOM:**

1. Vai a **Upcart > Cart Editor > Settings > Cart settings**, poi espandi **Advanced Settings**.
2. Deseleziona **Render Cart in Shadow DOM**.
3. Salva e riprova.

⚠️ **Importante:**\
Testa sempre il tuo carrello dopo aver disattivato lo Shadow DOM, poiché potrebbe influire su come altre app o elementi del tema interagiscono con Upcart.

💡 **Nota:** disabilitare lo Shadow DOM può risolvere questo problema ma può introdurre conflitti CSS con il tuo tema. Consulta il documento sull'[impostazione Shadow DOM](/it/upcart/render_cart_in_shadow_dom_setting) per il compromesso completo.

***

<div id="need-more-help">
  ## Ti serve altro aiuto?
</div>

Se il problema persiste dopo aver completato questi passaggi:

* Contatta il tuo **sviluppatore di tema** per rimuovere codice o impostazioni in conflitto.
* Puoi anche rivolgerti a un [**esperto Shopify**](https://www.shopify.com/partners/directory) per modifiche avanzate al tema o assistenza con l'integrazione.

***

<div id="references">
  ## Riferimenti
</div>

* Shopify Help – Accelerated Checkouts
* Shopify Dev Docs – Express Payment Buttons
