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

# Vouchery

> Twórz kody, które po realizacji przyznają graczom wybrany produkt.

Vouchery to specjalne kody, które po wpisaniu i zrealizowaniu przez gracza przyznają mu konkretny produkt z Twojego sklepu — bez płacenia. Świetnie sprawdzają się jako nagrody w konkursach, prezenty dla aktywnych graczy, rekompensaty za przestoje serwera czy elementy promocji rozdawane na Discordzie.

<Frame caption="Panel tworzenia i lista voucherów">
  <img src="https://mintcdn.com/andcze/6Qp9zwUm8VUzRssf/images/panel/vouchers.png?fit=max&auto=format&n=6Qp9zwUm8VUzRssf&q=85&s=b8854322e9170af4952f9a62d2a82fc1" alt="Ekran voucherów w panelu sklepu" width="1280" height="720" data-path="images/panel/vouchers.png" />
</Frame>

## Jak działają vouchery

Każdy voucher jest powiązany z **jednym produktem**. Gdy gracz zrealizuje kod, otrzymuje dokładnie ten produkt — tak samo, jakby go kupił, a komendy z produktu wykonają się na serwerze automatycznie. Możesz utworzyć jeden indywidualny kod albo od razu całą paczkę losowych kodów do rozdania.

<Note>
  Voucher zawsze przyznaje wybrany produkt. Jeśli chcesz przyznawać różne produkty, utwórz osobne vouchery dla każdego z nich.
</Note>

<Note>
  Serwer, na który trafi nagroda, jest **pobierany automatycznie z produktu** — nie wybierasz go osobno. Wystarczy, że wskażesz produkt, a voucher zadziała na tym samym serwerze, do którego produkt jest przypisany.
</Note>

## Strona „Vouchery" — lista kodów

Po wejściu w sekcję **Vouchery** (kategoria **Marketing** w menu) widzisz **listę wszystkich utworzonych kodów**. To Twój główny widok zarządzania. U góry znajdziesz nagłówek z przyciskiem **Nowy voucher**, który otwiera ekran tworzenia.

Dla każdego vouchera w tabeli zobaczysz cztery kolumny oraz status:

<Columns cols={2}>
  <Card title="Kod" icon="ticket">
    Sam kod do wpisania przez gracza, wyświetlony wyraźną czcionką. To wartość, którą przekazujesz dalej (np. wklejasz na Discordzie).
  </Card>

  <Card title="Produkt" icon="package">
    Nazwa produktu, który zostanie przyznany po zrealizowaniu vouchera.
  </Card>

  <Card title="Serwer" icon="server">
    Serwer, na którym voucher zadziała i zostanie dostarczona nagroda (ten sam, do którego przypisany jest produkt).
  </Card>

  <Card title="Wygasa" icon="calendar">
    Data ważności kodu. Jeśli voucher nie ma terminu, w tym miejscu widnieje kreska (`—`) — wtedy kod jest ważny bezterminowo.
  </Card>
</Columns>

### Status vouchera

W ostatniej widocznej kolumnie każdy voucher ma **kolorową plakietkę statusu**, dzięki której od razu wiesz, w jakim jest stanie:

<Columns cols={3}>
  <Card title="Aktywny" icon="circle-check">
    Voucher jest gotowy do użycia — gracz może wpisać kod i odebrać nagrodę. Plakietka jest zielona.
  </Card>

  <Card title="Wykorzystany" icon="circle-minus">
    Kod został już zrealizowany przez gracza i nie zadziała ponownie. Plakietka jest szara (neutralna).
  </Card>

  <Card title="Nieaktywny" icon="circle-pause">
    Voucher jest chwilowo wyłączony i nie można go zrealizować. Plakietka jest pomarańczowa (ostrzegawcza).
  </Card>
</Columns>

<Note>
  Każdy voucher można zrealizować **tylko raz**. Po realizacji jego status zmienia się na **Wykorzystany** i kod przestaje działać — to zabezpieczenie, dzięki któremu jedna nagroda trafia do jednej osoby.
</Note>

### Usuwanie vouchera

Po prawej stronie każdego wiersza znajduje się ikona **kosza**. Po jej kliknięciu pojawia się okno z pytaniem **„Usunąć voucher?"** — kod zostanie skasowany dopiero po potwierdzeniu przyciskiem **Usuń**. Tej operacji nie da się cofnąć.

<Warning>
  Usuwanie jest trwałe. Jeśli usuniesz **aktywny** kod, którym ktoś już się pochwalił (np. w ogłoszeniu), nikt nie będzie mógł go zrealizować. Usuwaj raczej kody **wygasłe** lub omyłkowo utworzone.
</Warning>

<Note>
  Voucherów **nie da się edytować** — nie zmienisz kodu, produktu ani daty wygaśnięcia po utworzeniu. Jeśli coś się nie zgadza, usuń voucher i utwórz nowy. Jeśli pracujesz w zespole, przycisk usuwania i przycisk tworzenia widzą tylko osoby z odpowiednimi uprawnieniami — współpracownik bez nich zobaczy listę, ale nie utworzy ani nie skasuje kodów.
</Note>

### Gdy nie masz jeszcze voucherów

Jeśli lista jest pusta, zobaczysz komunikat **„Brak voucherów"** z podpowiedzią, by utworzyć pojedynczy voucher lub wygenerować całą partię. To normalne na początku — wystarczy kliknąć **Nowy voucher**.

## Tworzenie vouchera krok po kroku

Kliknij **Nowy voucher** w nagłówku listy. Otworzy się osobny ekran kreatora, a u góry znajdziesz przycisk **Wróć do listy**, gdybyś chciał się wycofać.

<Warning>
  Voucher musi przyznawać jakiś produkt. Jeśli nie masz jeszcze **żadnego produktu** w sklepie, zobaczysz komunikat **„Brak produktów"** wraz z przyciskiem **Dodaj produkt**. Najpierw dodaj choć jeden produkt w sekcji **Produkty**, a potem wróć tutaj.
</Warning>

<Steps>
  <Step title="Wybierz produkt">
    Na pełnej szerokości ekranu zobaczysz **siatkę kart z Twoimi produktami** — każda pokazuje nazwę produktu, jego cenę oraz ikonę prezentu. Kliknij kartę produktu, który ma zostać przyznany po zrealizowaniu vouchera. To pierwszy i najważniejszy wybór — od niego zależy, co dostanie gracz (oraz na który serwer trafi nagroda).
  </Step>

  <Step title="Skonfiguruj voucher">
    Po wybraniu produktu na górze pojawi się **podsumowanie wybranego produktu** (z przyciskiem **Zmień produkt**, jeśli się rozmyślisz), a pod nim **przełącznik** z dwiema opcjami: **Pojedynczy voucher** oraz **Partia voucherów**. Wybierz tryb i wypełnij pola.
  </Step>

  <Step title="Zapisz">
    Kliknij przycisk zapisu na dole formularza (**Utwórz voucher** lub **Generuj partię**). Po sukcesie zobaczysz potwierdzenie, a panel przeniesie Cię z powrotem na listę z nowymi kodami.
  </Step>
</Steps>

<Tip>
  Wybranie produktu jest jak otwarcie „szuflady" — produkt i jego serwer zostają **zablokowane** w formularzu, więc nie musisz wskazywać ich po raz drugi. Dzięki temu masz pewność, że nagroda trafi we właściwe miejsce. Chcesz inny produkt? Kliknij **Zmień produkt** u góry.
</Tip>

## Pojedynczy voucher

Wybierz tę opcję, gdy potrzebujesz **jednego konkretnego kodu** — na przykład nagrody dla zwycięzcy konkursu albo rekompensaty dla jednego gracza.

<Columns cols={2}>
  <Card title="Kod (opcjonalnie)" icon="ticket">
    Możesz wpisać własny, łatwy do zapamiętania kod, np. `NAGRODA2026`. Jeśli zostawisz to pole puste, kod wygeneruje się automatycznie.
  </Card>

  <Card title="Wygasa (opcjonalnie)" icon="calendar">
    Ustaw datę i godzinę, po której voucher przestanie działać. Wybierasz je z wygodnego pola z kalendarzem. Zostaw puste, aby kod był ważny bezterminowo.
  </Card>
</Columns>

### Zasady własnego kodu

Jeśli wpisujesz własny kod, musi on spełniać proste reguły:

* **Od 4 do 12 znaków.**
* Dozwolone są **tylko wielkie litery (A–Z) i cyfry (0–9)** — bez spacji, polskich znaków, myślników czy małych liter.

Przykłady poprawnych kodów: `LATO`, `NAGRODA2026`, `VIP100`. Jeśli wpiszesz coś spoza tych zasad, panel od razu zwróci uwagę i poprosi o poprawkę.

<Tip>
  Własny kod świetnie sprawdza się w kampaniach i ogłoszeniach — graczom łatwiej zapamiętać `LATO` niż przypadkowy ciąg znaków. Wymyślaj kody pasujące do okazji: `HALLOWEEN`, `URODZINY`, `KOMPENSATA`.
</Tip>

<Note>
  Kod musi być **unikalny** w Twoim sklepie. Jeśli spróbujesz utworzyć voucher z kodem, który już istnieje, panel poinformuje Cię o tym i nie zapisze duplikatu. Wtedy wystarczy zmienić kod na inny.
</Note>

## Partia voucherów

Wybierz tę opcję, gdy chcesz wygenerować **wiele kodów naraz** — idealne do rozdawania na Discordzie, w giveaway'ach czy w paczkach nagród dla wielu osób.

<Columns cols={2}>
  <Card title="Liczba voucherów" icon="hash">
    Podaj, ile kodów ma zostać utworzonych — **od 1 do 100**. Każdy z nich będzie unikalny i losowy. W partii nie da się ustawić własnych nazw kodów.
  </Card>

  <Card title="Wygasa (opcjonalnie)" icon="calendar">
    Tak jak przy pojedynczym voucherze — ustaw datę i godzinę, po której **wszystkie** kody z partii przestaną być ważne. Zostaw puste, aby były bezterminowe.
  </Card>
</Columns>

Po wygenerowaniu zobaczysz potwierdzenie z **dokładną liczbą** utworzonych kodów (np. „Wygenerowano 50 voucherów"), a wszystkie nowe kody pojawią się na liście.

<Warning>
  Przy partii kody są **zawsze losowe**. Jeśli zależy Ci na konkretnej, „ładnej" nazwie kodu, użyj opcji **Pojedynczy voucher**.
</Warning>

<Tip>
  Maksymalnie w jednej partii utworzysz 100 kodów. Potrzebujesz więcej? Po prostu wygeneruj kolejną partię — możesz to powtarzać dowolnie wiele razy.
</Tip>

## Jak gracz realizuje voucher

Kod sam w sobie to dopiero połowa sukcesu — gracz musi mieć **gdzie go wpisać**. Na Twojej stronie sklepu znajduje się **strona realizacji vouchera**, na którą gracz wchodzi, podaje swoje dane i odbiera nagrodę. Wszystko dzieje się automatycznie, bez Twojego udziału.

<Steps>
  <Step title="Gracz wpisuje swój nick">
    W polu **Nick w grze** podaje swoją nazwę z gry (np. `Steve`). Strona od razu pokazuje obok podgląd główki postaci, więc widać, że nick jest poprawny.
  </Step>

  <Step title="Gracz wpisuje kod">
    W polu **Kod vouchera** wkleja otrzymany kod. Pole samo zamienia litery na wielkie i pilnuje formatu (4–12 znaków, litery i cyfry).
  </Step>

  <Step title="Gracz klika „Zrealizuj voucher”">
    Po chwili pojawia się komunikat **„Voucher zrealizowany!"** z informacją, że nagroda została przypisana do gracza, oraz **numerem zamówienia**. Nagroda trafia do gry tak samo, jak przy normalnym zakupie.
  </Step>
</Steps>

<Note>
  Zrealizowane vouchery tworzą **normalne zamówienie** w Twoim sklepie — znajdziesz je w sekcji **Zamówienia**. Dzięki temu masz pełen ślad: kto i kiedy odebrał nagrodę.
</Note>

<Tip>
  Razem z kodem podawaj graczom **link do strony realizacji** — najwygodniej skopiować go ze swojej strony sklepu i wkleić do ogłoszenia. Bez tego gracz może nie wiedzieć, gdzie wpisać kod.
</Tip>

## Najczęstsze pytania

<AccordionGroup>
  <Accordion title="Czy mogę użyć tego samego kodu kilka razy?">
    Nie. Każdy voucher działa **jednorazowo** — po realizacji jego status zmienia się na **Wykorzystany** i kod przestaje działać. Jeśli chcesz nagrodzić wiele osób, wygeneruj **partię** kodów.
  </Accordion>

  <Accordion title="Gracz mówi, że kod nie działa — co sprawdzić?">
    Najpierw spójrz na status vouchera na liście. **Aktywny** znaczy, że kod jest gotowy. **Wykorzystany** — ktoś go już zrealizował. **Nieaktywny** — voucher jest wyłączony. Sprawdź też datę w kolumnie **Wygasa**: po jej upływie kodu nie da się już zrealizować.
  </Accordion>

  <Accordion title="Dlaczego nie mogę wpisać własnego kodu w partii?">
    W partii kody są generowane losowo, żeby było ich łatwo utworzyć wiele naraz i żeby były unikalne. Jeśli zależy Ci na konkretnej nazwie, użyj opcji **Pojedynczy voucher**.
  </Accordion>

  <Accordion title="Czy mogę zmienić produkt albo datę istniejącego vouchera?">
    Nie — voucherów się nie edytuje. Jeśli coś się nie zgadza, usuń stary kod i utwórz nowy z poprawnymi ustawieniami.
  </Accordion>

  <Accordion title="Na który serwer trafi nagroda?">
    Na ten, do którego przypisany jest **wybrany produkt**. Serwer pobiera się automatycznie — nie musisz (i nie możesz) wybierać go osobno przy tworzeniu vouchera z poziomu listy produktów.
  </Accordion>

  <Accordion title="Usunąłem voucher przez pomyłkę — da się go odzyskać?">
    Niestety nie. Usuwanie jest trwałe i nieodwracalne. Jeśli kod był jeszcze niewykorzystany, po prostu utwórz nowy — najlepiej z tym samym, znanym graczom kodem (o ile był to pojedynczy voucher).
  </Accordion>
</AccordionGroup>

## Dobre praktyki

<Tip>
  * **Najpierw produkt, potem voucher** — voucher nie powstanie bez produktu w sklepie. Zadbaj, by produkt miał poprawne komendy (testowy zakup!), bo voucher uruchamia dokładnie te same komendy.
  * **Kody pod okazję** — własny kod jak `LATO` czy `URODZINY` łatwiej zapamiętać i pasuje do ogłoszenia. Losowe kody z partii zostaw na masowe giveawaye.
  * **Ustaw datę wygaśnięcia w akcjach czasowych** — dzięki temu kod sam przestanie działać po promocji i nikt nie wykorzysta go „po czasie".
  * **Rozdawaj partie, nie pojedyncze kody** — gdy nagradzasz wielu graczy naraz, jedna partia 50–100 kodów oszczędza mnóstwo klikania.
  * **Dołączaj link do realizacji** — zawsze podawaj graczom adres strony, na której wpiszą kod. Sam kod bez instrukcji rodzi pytania.
  * **Przetestuj przed akcją** — utwórz jeden testowy voucher i zrealizuj go samodzielnie. Upewnisz się, że właściwy produkt trafia na właściwy serwer.
  * **Sprzątaj wygasłe kody** — od czasu do czasu usuń stare, wykorzystane lub przeterminowane vouchery, żeby lista była czytelna.
</Tip>