> ## 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.

# Przyciski płatności ekspresowych nieklikalne w Upcart

> Ten artykuł wyjaśnia, jak rozwiązywać problemy z przyciskami ekspresowego checkout Shopify, gdy nie działają w Upcart

⚠️ **Ważna informacja**

Poniższy snippet szablonu dotyczy obu wersji modułów koszyka Upcart — sprawia, że Shopify renderuje przyciski przyspieszonego checkout na stronie, czego Upcart potrzebuje niezależnie od wersji modułu.

Poniższy selektor `.additional-checkout-buttons` to własna klasa Shopify na kontenerze przyspieszonego checkout, a nie klasa modułu Upcart, więc jest taka sama w obu wersjach koszyka.

<div id="overview">
  ## Przegląd
</div>

Czasami przyciski ekspresowego checkout nie są klikalne lub nie pojawiają się w Upcart. To częsty problem spowodowany tym, jak **Shopify kontroluje renderowanie przycisków płatności ekspresowych** w szablonach.

Ten przewodnik wyjaśnia, dlaczego tak się dzieje i co możesz zrobić, aby to naprawić.

***

<div id="required-setup-for-the-new-module">
  ## Wymagana konfiguracja dla nowego modułu
</div>

⚠️ **Ważne:** Te kroki dotyczą **nowego modułu Express Payments** w Upcart, a nie wersji starszej.

Aby przyciski ekspresowego checkout działały poprawnie w Upcart, musisz dodać mały fragment kodu do swojego szablonu Shopify. Bez tego snippetu Shopify nie załaduje poprawnie przycisków płatności w koszyku wysuwanym. Przed wprowadzeniem tych zmian zweryfikuj, że odpowiednie metody płatności (np. Shop Pay, PayPal, Apple Pay, Google Pay) są włączone w ustawieniach konta w panelu administracyjnym Shopify. Bez włączenia tych metod przyciski nie będą widoczne. Dodatkowo upewnij się, że snippet jest umieszczony bezpośrednio pod otwierającym tagiem `<body>` w pliku szablonu (np. `<body class="...">`). Jeśli zostanie umieszczony nieprawidłowo, na przykład po zamykającym tagu `</body>`, przyciski ekspresowego checkout mogą nie działać poprawnie.

***

<div id="how-to-fix">
  ## Jak to naprawić
</div>

1. Przejdź do **panelu administracyjnego Shopify**.
2. Przejdź do **Online Store > Themes > Edit Code**.
3. Otwórz **layout/theme.liquid**, znajdź linię `<body>` i dodaj poniższy snippet w nowej linii bezpośrednio pod nią. Musi się tam znaleźć — nie w `cart-drawer.liquid` ani nigdzie indziej — ponieważ przyciski muszą istnieć na każdej stronie, na której koszyk może się otworzyć.

```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. Zapisz zmiany i odśwież swój sklep.
2. Otwórz ponownie koszyk wysuwany, aby zweryfikować, że przyciski ekspresowego checkout (takie jak Shop Pay, PayPal, Apple Pay czy Google Pay) teraz się pojawiają i są klikalne.

Zapoznaj się z **przewodnikiem** po [**module Express Payments**](/pl/upcart/express_payments_module), aby uzyskać pełne instrukcje konfiguracji.

***

<div id="why-this-happens">
  ## Dlaczego tak się dzieje
</div>

Przyciski płatności ekspresowych są w pełni zarządzane przez **Shopify**, a nie Upcart. Oznacza to, że:

* Upcart nie renderuje własnych przycisków. **Klonuje przyciski** przyspieszonego checkout **Shopify** ze strony do koszyka wysuwanego, dlatego muszą one w ogóle być obecne na stronie — to właśnie gwarantuje powyższy snippet szablonu.
* **Apple Pay** pokaże się tylko na urządzeniach Apple z skonfigurowanym Apple Pay.
* Upcart nie kontroluje, które przyciski ekspresowe się pojawiają, ponieważ zawartość i funkcjonalność są obsługiwane przez Shopify.

🎨 **Uwaga:**\
Przyciski w Upcart działają jako wizualne kontenery, podczas gdy Shopify kontroluje ich wyświetlanie i zachowanie. Upcart nie może modyfikować ich wyglądu ani działania.

***

<div id="common-problems-and-fixes">
  ## Typowe problemy i rozwiązania
</div>

<div id="1-the-buttons-arent-rendered-on-the-page">
  ## 1. Przyciski nie są renderowane na stronie
</div>

To najczęstsza przyczyna. Upcart klonuje przyciski Shopify ze strony, więc jeśli strona ich nie renderuje, nie ma czego klonować i koszyk pokazuje puste miejsce.

**Co zrobić:**

* Dodaj snippet szablonu z sekcji **Jak to naprawić** powyżej, bezpośrednio pod linią `<body>` w `layout/theme.liquid`.

<Warning>
  **Nie usuwaj własnych przycisków ekspresowych szablonu, aby „uniknąć konfliktu”.** Upcart zależy od ich obecności. Usunięcie ich z szablonu lub wyłączenie w ustawieniach szablonu usuwa źródło, z którego Upcart klonuje — co pogarsza ten problem, a nie go rozwiązuje.
</Warning>

***

<div id="3-css-is-blocking-the-buttons">
  ## 3. CSS blokuje przyciski
</div>

Niektóre szablony domyślnie ukrywają przyciski ekspresowe za pomocą CSS. Na przykład:

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

**Co zrobić:**

* Przejrzyj CSS swojego szablonu.
* Poproś dewelopera szablonu, aby upewnił się, że żadne reguły CSS nie ukrywają ani nie wyłączają przycisków w koszyku Upcart.

***

<div id="4-legacy-settings-are-interfering">
  ## 4. Starsze ustawienia zakłócają działanie
</div>

Jeśli używałeś starszej wersji modułu Express Payments, zapisane ustawienia mogą kolidować z nową konfiguracją.

**Co zrobić:**

* Otwórz stary moduł Express Payments (jeśli nadal jest widoczny).
* Odznacz wszelkie wcześniejsze opcje i zapisz.
* Przetestuj ponownie, używając nowego modułu.

***

<div id="still-having-issues">
  ## Nadal masz problemy?
</div>

<div id="disable-shadow-dom-in-upcart">
  ## Wyłącz Shadow DOM w Upcart
</div>

W niektórych przypadkach przyciski płatności ekspresowych mogą nie ładować się lub nie aktualizować, ponieważ w Upcart włączony jest **Shadow DOM**.

**Czym jest Shadow DOM?**\
Shadow DOM izoluje Upcart od reszty kodu Twojego sklepu, aby poprawić stabilność. Jednak w rzadkich przypadkach ta separacja może uniemożliwić poprawne aktualizowanie się przycisków ekspresowych Shopify.

**Jak wyłączyć Shadow DOM:**

1. Przejdź do **Upcart > Cart Editor > Settings > Cart settings**, następnie rozwiń **Advanced Settings**.
2. Odznacz **Render Cart in Shadow DOM**.
3. Zapisz i przetestuj ponownie.

⚠️ **Ważne:**\
Zawsze testuj swój koszyk po wyłączeniu Shadow DOM, ponieważ może to wpłynąć na to, jak inne aplikacje lub elementy szablonu wchodzą w interakcję z Upcart.

💡 **Uwaga:** Wyłączenie Shadow DOM może rozwiązać ten problem, ale może wprowadzić konflikty CSS z Twoim szablonem. Zobacz dokument o [ustawieniu Shadow DOM](/pl/upcart/render_cart_in_shadow_dom_setting), aby poznać pełen kompromis.

***

<div id="need-more-help">
  ## Potrzebujesz dalszej pomocy?
</div>

Jeśli problem nadal występuje po wykonaniu tych kroków:

* Skontaktuj się z **deweloperem szablonu**, aby pomógł usunąć konfliktujący kod lub ustawienia.
* Możesz też skontaktować się z [**ekspertem Shopify**](https://www.shopify.com/partners/directory) w sprawie zaawansowanych edycji szablonu lub pomocy w integracji.

***

<div id="references">
  ## Materiały źródłowe
</div>

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