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

# Rabaty i vouchery

> Kody rabatowe obniżające cenę i jednorazowe vouchery wymieniane na produkt.

Sklep ma dwa mechanizmy promocyjne: **kody rabatowe**, które obniżają cenę zakupu, i **vouchery**, które gracz wymienia na konkretny produkt bez płacenia. Kody sprawdzają się w akcjach promocyjnych, vouchery — jako nagrody w konkursach, prezenty i rekompensaty.

| | Kod rabatowy | Voucher |
| - | - | - |
| Działanie | obniża cenę o procent lub kwotę | daje jeden konkretny produkt za darmo |
| Użycia | wielokrotne, do ustalonego limitu | jednorazowy |
| Gdzie gracz go wpisuje | w kasie, przy zakupie | na stronie realizacji vouchera w sklepie |
| Edycja po utworzeniu | tak (poza samym kodem) | nie — usuń i utwórz nowy |

## Utwórz kod rabatowy

**1. Wpisz kod**

Wielkie litery, cyfry, `_` i `-`, do 50 znaków — np. `LATO10`. Kodu nie da się później zmienić.

**2. Wybierz zakres**

**Cały sklep**, **Wybrane serwery** albo **Wybrane produkty** (wtedy zaznacz co najmniej jedną pozycję).

**3. Ustaw rabat**

**Procentowy** (maks. 100) albo **kwotowy** (stała kwota odejmowana od ceny).

**4. Ustaw ważność i limit**

**Data wygaśnięcia** i **limit użyć** są wymagane — chronią przed nadużyciami.

**5. Dodaj warunki (opcjonalnie)**

**Min. wartość zamówienia** i **maks. kwota rabatu**. Opis kodu to notatka wewnętrzna — gracze jej nie widzą.

**6. Przetestuj w walidatorze**

Wpisz kod i przykładową wartość koszyka. Walidator pokaże rabat i cenę końcową albo powód odrzucenia (wygasł, limit wyczerpany, za niska kwota).

### Przykład: letnia promocja

| Pole | Wartość |
| - | - |
| Kod | `LATO10` |
| Zakres | Cały sklep |
| Rabat | 10% |
| Wygasa | 2026-08-31 |
| Limit użyć | 200 |
| Min. wartość zamówienia | 20 zł |
| Maks. kwota rabatu | 30 zł |

Efekt: koszyk za 15 zł — kod nie działa (poniżej minimum); 100 zł — rabat 10 zł, gracz płaci 90 zł; 500 zł — rabat zatrzymuje się na 30 zł, gracz płaci 470 zł.

### Wstrzymanie i edycja

Żeby czasowo zatrzymać promocję, wyłącz w edycji przełącznik **Aktywny** — ustawienia i licznik użyć zostają. Zakres, wartość, daty, limity i warunki możesz zmieniać; sam kod nie. Usunięcie kodu jest nieodwracalne.

> [!NOTE]
>
> Kod może nie zadziałać, mimo że jest aktywny, jeśli serwer produktu ma wyłączone **Zezwól na kody rabatowe** (zobacz [Serwery](https://andcze.mintlify.site/pl/shop/servers.md)) albo wybrana metoda płatności ma włączone **Zablokuj kody promocyjne** (zobacz [Płatności](https://andcze.mintlify.site/pl/shop/payments.md)).

> [!TIP]
>
> Kod 100% obniża kwotę do zera — zamówienie omija bramkę płatności i od razu trafia do pluginu. To najprostszy sposób na testowy zakup bez operatora płatności.

## Utwórz vouchery

Voucher jest zawsze powiązany z **jednym produktem**. Serwer, na który trafi nagroda, wynika z produktu. Gracz dostaje produkt tak, jakby go kupił — wykonują się te same komendy.

**1. Wybierz produkt**

Musi istnieć co najmniej jeden produkt z poprawnymi komendami.

**2. Wybierz tryb**

**Pojedynczy voucher** — jeden kod, własny lub wygenerowany. **Partia** — od 1 do 100 losowych kodów naraz.

**3. Ustaw datę wygaśnięcia (opcjonalnie)**

Bez daty voucher jest ważny bezterminowo. W partii data dotyczy wszystkich kodów.

**4. Rozdaj kody z linkiem**

Razem z kodem podaj graczom link do strony realizacji vouchera w Twoim sklepie.

Własny kod pojedynczego vouchera: 4–12 znaków, tylko wielkie litery A–Z i cyfry 0–9, unikalny w sklepie — np. `NAGRODA2026`. W partii kody są zawsze losowe; potrzebujesz więcej niż 100 — wygeneruj kolejną partię.

| Status | Znaczenie |
| - | - |
| **Aktywny** | gotowy do realizacji |
| **Wykorzystany** | już zrealizowany, nie zadziała ponownie |
| **Nieaktywny** | wyłączony, nie da się go zrealizować |

### Jak gracz realizuje voucher

Gracz wchodzi na stronę realizacji w sklepie, wpisuje swój nick i kod, a po zatwierdzeniu dostaje numer zamówienia. W panelu pojawia się zwykłe zamówienie z ceną 0, które plugin realizuje jak każde inne. Takie zamówienia **nie są wliczane** do przychodu ani statystyk sprzedaży.

> [!NOTE]
>
> Vouchery działają tylko na serwerach z włączonym **Zezwól na vouchery**. Jeśli gracz zgłasza, że kod nie działa, sprawdź jego status, datę wygaśnięcia i ten przełącznik.

## Dalej

> **[Produkty](https://andcze.mintlify.site/pl/shop/products.md)**
>
> Komendy, które wykonują się po realizacji vouchera.

> **[Zamówienia](https://andcze.mintlify.site/pl/shop/orders.md)**
>
> Gdzie zobaczysz zrealizowane vouchery i darmowe zamówienia.


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