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

# Zamówienia

> Statusy zamówień, ręczne akcje, ponowna płatność i dostawa, blacklista, dziennik błędów i analityka.

Każdy zakup w sklepie to zamówienie: kto kupił, co, za ile, jaką metodą i na jakim etapie jest dostawa. W typowej sprzedaży wszystko dzieje się samo — gracz płaci, operator potwierdza wpłatę, plugin wydaje produkt. Ręcznie działasz tylko w wyjątkowych sytuacjach.

## Statusy

| Status | Znaczenie |
| - | - |
| **Oczekuje** | zamówienie złożone, płatność jeszcze nie dotarła |
| **Opłacone** | płatność potwierdzona, zamówienie czeka na plugin |
| **Przetwarzanie** | plugin rozpoczął realizację |
| **Zrealizowane** | plugin potwierdził wykonanie komend |
| **Anulowane** | zamówienie wycofane (przez Ciebie albo nieukończone przez klienta) |
| **Nieudane** | płatność odrzucona lub przerwana — gracz nic nie zapłacił |
| **Spór** | klient zakwestionował płatność — zajmij się tym w pierwszej kolejności |

Sesja płatności wygasa po 30 minutach dla płatności natychmiastowych (BLIK, karta, SMS) i po 14 dniach dla tradycyjnego przelewu.

## Zamówienia z kilku pozycji

Kupujący może włożyć do koszyka do **20 pozycji** i zapłacić raz. Takie zakupy to **grupa płatności**: u operatora jest jedna transakcja na sumę, a w ItemShop każda pozycja jest zwykłym osobnym zamówieniem (z własną dostawą na swój serwer, statusem i statystyką). Kod rabatowy jest liczony raz na cały koszyk i rozkładany proporcjonalnie na pozycje. Minimalna i maksymalna kwota metody płatności dotyczą sumy koszyka.

Zbiorczy status grupy może mieć wartość „częściowo zwrócone”, gdy zwrot dotyczy tylko części pozycji. Kupujący śledzi zamówienie na stronie statusu pod adresem z numerem i kluczem statusu — samo odgadnięcie numeru nie wystarcza.

## Znajdź zamówienie

Szukaj po nicku gracza albo filtruj po statusie. Dodatkowe filtry: e-mail, numer zamówienia, zakres kwot i dat — filtry działają łącznie. Szczegóły zamówienia pokazują:

* produkt, ilość, serwer i użyty kod rabatowy,
* nick, e-mail i adres IP klienta,
* metodę płatności, kwotę, prowizję operatora, kwotę netto i — jeśli jest włączony — VAT.

## Utwórz zamówienie ręcznie

Przydaje się, gdy ktoś zamawia przez Discorda albo chcesz komuś wysłać gotowy link do zapłaty.

**1. Wybierz serwer, produkt i ilość**

Lista produktów zawęża się do wybranego serwera.

**2. Wybierz metodę płatności i podaj nick**

Nick jest wymagany, e-mail opcjonalny.

**3. Wyślij link**

Po utworzeniu dostajesz link do płatności. Zamówienie ma status **Oczekuje**, dopóki gracz nie zapłaci; potem produkt trafia do niego automatycznie.

> [!NOTE]
>
> Każdy, kto ma ten link, może dokończyć płatność — wysyłaj go tylko właściwej osobie.

## Akcje na zamówieniu

Dostępne dla osób z uprawnieniem do zarządzania zamówieniami (zobacz [Zespół](https://andcze.mintlify.site/pl/shop/team.md)).

| Akcja | Kiedy | Uwagi |
| - | - | - |
| **Zrealizuj** | zamówienie opłacone | oznacza jako zrealizowane i wysyła produkt graczowi |
| **Anuluj** | oczekujące lub opłacone | nieodwracalne — sprawdź numer zamówienia |
| **Zmień status** | dowolny | narzędzie awaryjne, np. ręczne oznaczenie realizacji lub sporu |

Gdy płatność nie powiodła się lub wygasła, nową sesję płatności dla tego samego zamówienia można utworzyć przez [API](https://andcze.mintlify.site/pl/api-reference/overview.md).

Klient może sam zmienić nick w zamówieniu, dopóki nie zostało zrealizowane — potwierdza to 6-cyfrowym kodem wysłanym na e-mail z zamówienia (kod ważny 10 minut). Poprzedni nick zostaje w historii.

## Gdy dostawa utknęła

Zamówienie, które długo stoi na **Opłacone**, zwykle czeka na plugin albo na gracza:

* serwer jest offline lub plugin nie jest połączony — sprawdź status w [Serwerach](https://andcze.mintlify.site/pl/shop/servers.md),
* serwer ma włączone **Wymagaj gracza online**, a gracza nie ma w grze — dostawa nastąpi po jego wejściu,
* gracz jest na trybie wyłączonym z dostaw (np. lobby logowania) albo nick ma literówkę.

Plugin sam nadrabia zaległe dostawy po ponownym połączeniu, więc nie musisz niczego ponawiać ręcznie.

> [!WARNING]
>
> Jeśli serwer padł w trakcie wykonywania komend, zamówienie trafi do **ręcznej weryfikacji** — część komend mogła się już wykonać. Najpierw sprawdź w grze, czy gracz dostał produkt, a dopiero potem wybierz **zrealizowane** (jeśli dostał) albo **ponów** (jeśli nie). System celowo nie powtarza takich komend automatycznie, żeby nie nadać produktu dwa razy.

## Darmowe zamówienia i vouchery

Zamówienie z rabatem 100% omija bramkę płatności i od razu trafia do realizacji przez plugin. Realizacja vouchera też tworzy zwykłe zamówienie — masz pełny ślad, kto i kiedy odebrał nagrodę. Vouchery **nie są wliczane** do przychodu ani statystyk sprzedaży. Zobacz [Rabaty i vouchery](https://andcze.mintlify.site/pl/shop/discounts.md).

## Blacklista

Blacklista blokuje **składanie zamówień** przez wybrane osoby. Kraj gracza jest rozpoznawany automatycznie.

| Typ wpisu | Przykład | Uwagi |
| - | - | - |
| Kraj | `DE` | można zaznaczyć cały kontynent naraz |
| Adres IP | `203.0.113.7` | IPv4 lub IPv6; jeden adres może dzielić kilku graczy |
| ASN | `AS13335` | blokuje całą sieć operatora — używaj ostrożnie |
| Nick | `Steve` | niezależnie od adresu, z którego gracz się łączy |

Nick lub IP z konkretnego zamówienia zablokujesz jednym kliknięciem z listy zamówień (notatka z numerem zamówienia dopisuje się sama). Wpisy można dodawać hurtowo (do 200 naraz, jeden na linię), opisać powodem i czasowo wyłączyć zamiast usuwać. Narzędzie **Sprawdź IP / ASN** pokaże kraj, sieć, dostawcę internetu i przybliżone miasto, zanim kogoś zablokujesz.

## Dziennik błędów

Dziennik błędów zbiera wszystko, co poszło nie tak: płatności, realizację zamówień, powiadomienia (np. Discord), asystenta AI i błędy systemowe. Błędy płatności mają etap: **Inicjacja** (gracz nie został przekierowany do zapłaty), **IPN / Notyfikacja** (sklep nie odebrał potwierdzenia wpłaty) lub **Zwrot**.

Gdy gracz zapłacił, ale nie dostał produktu, filtruj po kategoriach **Zamówienie** i **Płatność** (etap IPN). Wpisy nie znikają po naprawie — to historia. Zgłaszając problem do wsparcia, skopiuj treść błędu, kod odpowiedzi i datę.

## Analityka

Sekcja **Analityka** pokazuje przychód w czasie, ruch i jego źródła, lejek konwersji oraz ranking produktów i serwerów za ostatnie 7, 30 lub 90 dni, z eksportem przychodu do CSV. **Szukaj gracza** (po nicku lub IP) pokazuje liczbę zamówień, łączne wydatki i powiązane adresy IP — przydatne przy weryfikacji podejrzanych klientów.

## Dalej

> **[Plugin](https://andcze.mintlify.site/pl/shop/plugin.md)**
>
> Jak plugin dostarcza zamówienia i co sprawdzić, gdy nie dostarcza.

> **[Płatności](https://andcze.mintlify.site/pl/shop/payments.md)**
>
> Operatorzy, prowizje i test płatności.


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