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

# FAQ

> Najczęstsze pytania o ItemShop 3.0: strona jako kod, szablony, SDK, płatności i plugin.

## Strona sklepu

> **Czy muszę umieć programować?**
>
> Nie. Wybierasz gotowy [szablon](https://andcze.mintlify.site/pl/site/templates.md), zmieniasz logo, kolory i teksty, a większe zmiany opisujesz słowami w [AI edytorze](https://andcze.mintlify.site/pl/site/ai-editor.md) — AI edytuje pliki, buduje podgląd, a Ty klikasz **Opublikuj**. Kod jest dostępny dla tych, którzy chcą go zmieniać ręcznie.

> **Co z moim sklepem z konfiguratora bloków?**
>
> Działa dalej bez zmian aż do migracji. Migracja tworzy nowy projekt strony z szablonu `bento` i przenosi nazwę, kolory, logo, hero i linki. Szczegóły: [Migracja](https://andcze.mintlify.site/pl/site/migration.md).

> **Czy mogę wgrać własną stronę?**
>
> Tak — jako zip, przeciągnięty folder w panelu albo z terminala przez `itemshop deploy`. Może to być projekt Vite + React albo czysty HTML/CSS/JS. Zobacz [Własny kod](https://andcze.mintlify.site/pl/site/custom-code.md) i [CLI](https://andcze.mintlify.site/pl/site/cli.md).

> **Czy moja strona może mieć backend?**
>
> Nie. ItemShop hostuje wyłącznie statyczny wynik builda — żaden Twój kod nie działa po stronie serwera. Dane (produkty, kasa, status zamówienia, widżety) strona pobiera w przeglądarce z publicznego [Storefront API](https://andcze.mintlify.site/pl/developers/storefront-api.md), bez sekretów. Na stronach własnych voucher zrealizujesz przez `sf.vouchers.redeem(code, nick)`.

> **Czy szablony są open source?**
>
> Tak, na licencji MIT. Możesz je forkować, przerabiać i używać poza ItemShop. Zobacz [Szablony](https://andcze.mintlify.site/pl/site/templates.md).

> **Czy mogę przypisać własną domenę?**
>
> Tak. Zobacz [Domeny](https://andcze.mintlify.site/pl/shop/domains.md).

## Dla deweloperów

> **Jakie SDK są dostępne?**
>
> TypeScript (referencyjne: Node, przeglądarka, React i CLI), Python, PHP, Java/Kotlin i Go. Każde ma część bez klucza (Storefront) i klienta z kluczem API. SDK pojawiają się z ItemShop 3.0 — do tego czasu działa czyste HTTP. Zacznij od [SDK TypeScript](https://andcze.mintlify.site/pl/developers/sdk/typescript.md) albo [API z kluczem](https://andcze.mintlify.site/pl/developers/api-keys.md).

> **Czy mogę pracować ze sklepem z Claude Code, Cursora albo innego agenta AI?**
>
> Tak — przez hostowany [serwer MCP](https://andcze.mintlify.site/pl/developers/mcp.md) i [skille agentowe](https://andcze.mintlify.site/pl/developers/agent-skills.md).

## Płatności i realizacja

> **Jak podpiąć płatności?**
>
> Dodaj metodę płatności w sklepie i wpisz dane od operatora. Lista obsługiwanych operatorów i wymaganych pól: [Płatności](https://andcze.mintlify.site/pl/shop/payments.md). Operatora spoza listy nie da się bezpiecznie podłączyć — wymaga najpierw zweryfikowanego adaptera w backendzie.

> **Czy potrzebuję działalności gospodarczej, żeby przyjmować płatności?**
>
> To zależy od kraju, Twojej sytuacji i regulaminu operatora. ItemShop tego nie rozstrzyga — sprawdź wymogi u operatora, a w razie wątpliwości u księgowego lub prawnika.

> **Dostaję pieniądze, a gracz nie otrzymuje zakupu — dlaczego?**
>
> Najczęściej to plugin albo webhook: zły klucz (musi być typu `plugin` z `orders:write`), `serverId` z innego sklepu, źle skonfigurowany webhook operatora albo błędne lub zablokowane komendy produktu. Zobacz [Plugin na serwerze](https://andcze.mintlify.site/pl/shop/plugin.md).

> **Jak wgrać plugin na serwer?**
>
> Pełna instrukcja: [Plugin na serwerze](https://andcze.mintlify.site/pl/shop/plugin.md). Jeśli piszesz własny plugin, zobacz [Protokół pluginu](https://andcze.mintlify.site/pl/developers/plugin-protocol.md).

> **Jak przetestować, czy zamówienia się realizują?**
>
> Złóż darmowe zamówienie (rabat 100%) albo zrealizuj voucher i sprawdź, czy status przechodzi z `paid` na `completed`. Zobacz [Zamówienia](https://andcze.mintlify.site/pl/shop/orders.md).

> **Jak dodać zdjęcia produktów?**
>
> Wgraj pliki w formularzu produktu — zostaną skompresowane do WebP i zapisane w magazynie sklepu. Integracje API mogą też podać publiczny adres HTTPS. Zobacz [Produkty](https://andcze.mintlify.site/pl/shop/products.md).

## Dalej

> **[Szybki start](https://andcze.mintlify.site/pl/start/quickstart.md)**
>
> Sklep i pierwsza strona w kilka minut.

> **[Strona jako kod](https://andcze.mintlify.site/pl/site/overview.md)**
>
> Szablony, AI edytor i własny upload.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.