> ## 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.
# Błędy
> Dziennik wszystkich błędów sklepu — sprawdź tu, gdy płatności lub powiadomienia przestają działać.
Zakładka **Błędy** to centralny dziennik wszystkiego, co poszło nie tak w Twoim sklepie. Znajdziesz ją w panelu w sekcji **Ustawienia** (w menu bocznym oznaczona ikoną ostrzeżenia). To pierwsze miejsce, do którego warto zajrzeć, gdy coś nie działa tak, jak powinno — zanim zaczniesz się denerwować lub pisać do wsparcia.
## Po co Ci ta zakładka
Sklep wykonuje w tle mnóstwo czynności: przyjmuje płatności, realizuje zamówienia, wysyła powiadomienia na Discorda, korzysta z asystenta AI. Jeśli któraś z tych czynności się nie powiedzie, sklep zapisuje to tutaj — razem z informacją, gdzie i kiedy problem wystąpił oraz co dokładnie się stało.
Dzięki temu nie musisz zgadywać. Zamiast pytać „dlaczego klient nie dostał rangi?", wchodzisz do **Błędów** i widzisz dokładny powód.
Zaglądaj tu zawsze, gdy **płatności** lub **powiadomienia** przestają działać. Najczęściej znajdziesz tu gotową odpowiedź, co poszło nie tak i co naprawić.
## Jak zbudowana jest strona
Strona ma dwie części, jedna pod drugą:
Panel u góry z trzema listami wyboru. Służy do zawężania listy, żebyś szybko dotarł do błędów, które Cię interesują.
Lista wpisów poniżej filtrów. Każdy wiersz to jeden zapisany problem — od najnowszych do najstarszych.
## Jakie błędy tu trafiają
Dziennik zbiera problemy z kilku różnych obszarów sklepu. Każdy obszar ma własną, kolorową **odznakę kategorii**, dzięki której od razu widzisz, czego dotyczy wpis:
Problemy przy rozpoczynaniu płatności, odbieraniu potwierdzenia o wpłacie oraz przy zwrotach. To najczęstsza kategoria.
Błędy podczas realizacji zamówienia — np. gdy nie udało się dostarczyć zakupionego przedmiotu do gry.
Sytuacje, w których powiadomienie na zewnątrz — najczęściej wiadomość na Twój serwer Discord — nie zostało wysłane.
Problemy z działaniem asystenta wspierającego Cię w panelu.
Pozostałe błędy techniczne sklepu, które nie pasują do powyższych grup.
Starsze wpisy, zapisane zanim wprowadzono podział na kategorie, traktowane są jako **Płatność**. Dlatego błędy płatności to często najliczniejsza grupa na liście.
## Jak czytać pojedynczy wpis
Każdy błąd na liście to jeden wpis. W górnej linii wpisu, jedna obok drugiej, pojawiają się małe odznaki, a pod nimi pełna treść błędu. Razem mówią Ci wszystko, czego potrzebujesz:
Kolorowa etykieta na początku wiersza — od razu pokazuje, czego dotyczy błąd (np. **Płatność**, **Zamówienie**, **Webhook**, **Asystent AI**, **System**).
Pogrubiony tekst obok kategorii — wskazuje, skąd pochodzi błąd, np. nazwę bramki płatności, która go zgłosiła.
Dla błędów płatności dochodzi druga odznaka z etapem, na którym coś poszło nie tak: **Inicjacja**, **IPN / Notyfikacja** lub **Zwrot** (znaczenie każdego z nich opisujemy niżej).
Jeśli błąd przyszedł z zewnątrz (np. od operatora płatności), zobaczysz dodatkową odznakę z krótkim kodem liczbowym. Pomaga on ustalić, czy problem był po stronie sklepu, czy po stronie partnera — wystarczy podać ten kod wsparciu.
Z prawej strony wiersza widnieje dokładny moment, w którym błąd wystąpił. Przydatne, gdy chcesz powiązać go z konkretnym zamówieniem lub zgłoszeniem klienta.
Pod odznakami, w wyróżnionej ramce, znajdziesz pełny opis tego, co się stało — najważniejszą część wpisu. Jeśli opis jest długi, ramkę można przewinąć. To właśnie tu szukaj wskazówki, co naprawić.
Treść błędu możesz zaznaczyć i skopiować prosto z ramki. Gdy zgłaszasz problem do wsparcia, wklejenie tej treści wraz z kodem odpowiedzi i datą znacznie przyspiesza pomoc.
### Etapy błędu płatności
Gdy wpis dotyczy kategorii **Płatność**, druga odznaka mówi, na którym etapie wystąpił problem. To pozwala szybciej zrozumieć, czego dotyczy błąd:
Coś nie zadziałało już na starcie — przy próbie rozpoczęcia płatności. W praktyce oznacza to, że klient mógł w ogóle nie zostać przekierowany do zapłaty.
Problem z odebraniem potwierdzenia o wpłacie od operatora. To powiadomienie mówi sklepowi „klient zapłacił" — gdy ono zawodzi, zamówienie może nie zostać oznaczone jako opłacone.
Błąd przy próbie zwrotu pieniędzy klientowi.
## Filtrowanie listy
Gdy błędów jest dużo, użyj panelu **Filtrowanie** u góry, aby szybko dotrzeć do tych, które Cię interesują. Masz do dyspozycji trzy listy wyboru:
Pokaż tylko błędy z wybranego obszaru — np. same płatności, same zamówienia albo same powiadomienia (Webhook).
Zawęź płatności do konkretnego etapu: **Inicjacja**, **IPN / Notyfikacja** lub **Zwrot**.
Pokaż błędy zgłoszone przez wybranego operatora płatności. Lista podpowiada operatorów, których masz skonfigurowanych w sklepie.
Każda lista ma na górze opcję „Wszystkie…” (np. **Wszystkie kategorie**, **Wszystkie typy**, **Wszystkie bramki**) — to ustawienie domyślne, które nic nie zawęża. Aby wyczyścić dany filtr, wybierz po prostu tę opcję z powrotem.
Filtry możesz **łączyć**. Na przykład wybierz **Kategoria: Płatność** i **Bramka: Twój operator**, aby zobaczyć wyłącznie problemy z jedną metodą płatności. Każda zmiana filtra od razu odświeża listę poniżej.
Ustawione filtry zapisują się w adresie strony. Jeśli odświeżysz panel albo wrócisz do zakładki później, lista pozostanie zawężona tak samo — a link możesz nawet skopiować i wysłać współpracownikowi, żeby zobaczył dokładnie te same błędy.
## Gdy lista jest pusta
Jeśli na liście nic nie ma, zobaczysz komunikat **„Brak błędów"** z dopiskiem, że dla wybranych filtrów nie odnotowano żadnych problemów. To **dobra wiadomość** — albo Twój sklep działa bez zarzutu, albo po prostu nic nie pasuje do aktualnie ustawionych filtrów.
Jeśli spodziewasz się jakichś błędów, a widzisz „Brak błędów", sprawdź najpierw filtry. Może masz zawężoną listę np. do jednej bramki albo jednego etapu płatności. Ustaw wszędzie opcję „Wszystkie…”, aby zobaczyć pełen dziennik.
## Typowe sytuacje
Sprawdź kategorie **Zamówienie** oraz **Płatność**. Przy płatnościach zwróć uwagę na etap **IPN / Notyfikacja** — to on potwierdza wpłatę. Treść błędu zwykle podpowie, czy problem był z dostarczeniem przedmiotu, czy z odebraniem potwierdzenia o płatności.
Filtruj po kategorii **Webhook**. Jeśli pojawiają się tu wpisy, oznacza to, że wiadomości nie docierają — sprawdź ustawienia połączenia z Discordem.
Wybierz **Typ błędu płatności: Inicjacja** i odpowiednią **Bramkę płatności**, aby zobaczyć, dlaczego klienci nie mogą przejść do zapłaty.
Zajrzyj do kategorii **Asystent AI** — znajdziesz tam powód, dla którego pomoc w panelu chwilowo nie działa.
## Najczęstsze pytania
To kategoria powiadomień wysyłanych na zewnątrz — najczęściej wiadomości na Twój serwer Discord (np. informacja o nowym zamówieniu). Jeśli widzisz tu wpisy, znaczy to, że któreś powiadomienie nie zostało dostarczone. Sprawdź ustawienia połączenia z Discordem.
To kod odpowiedzi od partnera (np. operatora płatności). Sam w sobie nie wymaga działania — najlepiej skopiuj go razem z treścią błędu i przekaż wsparciu. Dzięki niemu szybciej ustalimy, po której stronie był problem.
Nie. Dziennik to historia zdarzeń — wpisy zostają, nawet gdy problem już nie występuje. Najnowsze błędy są zawsze na górze, więc jeśli po naprawie nie pojawiają się nowe wpisy z tym samym powodem, to znak, że wszystko działa.
Z dwóch powodów: płatności to najczęstsze źródło problemów, a dodatkowo starsze wpisy zapisane przed wprowadzeniem podziału na kategorie są traktowane właśnie jako płatności. Użyj filtra kategorii, by to sprawdzić.
Zakładka Błędy dotyczy głównie płatności, więc widzą ją osoby z dostępem do tego obszaru sklepu. Jeśli współpracownik nie ma jej w menu, oznacza to, że nie nadałeś mu odpowiednich uprawnień.
Wpis w dzienniku **nie naprawia się sam** — pokazuje jedynie, co się stało. Jeśli widzisz powtarzające się błędy płatności lub powiadomień, sprawdź ustawienia odpowiedniej bramki lub połączenia z Discordem. Gdy treść błędu jest niejasna, skopiuj ją (razem z kodem odpowiedzi i datą) i prześlij do wsparcia — przyspieszy to pomoc.
## Dobre praktyki
* **Zaglądaj tu regularnie** — sprawdzaj dziennik raz na jakiś czas, nawet gdy wszystko działa. Dzięki temu wcześnie wychwycisz drobne problemy, zanim zauważą je Twoi klienci.
* **Najpierw filtry** — gdy szukasz konkretnego problemu, zawęź listę kategorią, etapem płatności i bramką. Gdy nic nie widać, ustaw wszędzie „Wszystkie…”.
* **Patrz na datę** — porównaj moment błędu ze zgłoszeniem klienta lub numerem zamówienia, żeby mieć pewność, że to ten sam przypadek.
* **Kopiuj całość do wsparcia** — treść błędu, kod odpowiedzi i data razem dają wsparciu komplet informacji i skracają czas pomocy.
* **Reaguj na powtórki** — jeśli ten sam błąd wraca, to nie przypadek. Sprawdź ustawienia danej bramki płatności albo połączenia z Discordem.
* **„Brak błędów" to dobry znak** — pusty dziennik (przy filtrach ustawionych na „Wszystkie…") oznacza, że sklep działa bez zakłóceń.