> ## 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. # Płatności > Podłącz operatora płatności, wybierz kanały, ustaw prowizje i VAT oraz przetestuj płatność przed startem. Gracze płacą przez operatora płatności, z którym masz własną umowę — ItemShop łączy Twój sklep z jego bramką i po potwierdzeniu wpłaty automatycznie realizuje zamówienie. Pieniądze trafiają bezpośrednio na Twoje konto u operatora; ItemShop nie pośredniczy w wypłatach. ## Zanim zaczniesz Umowę o przyjmowanie płatności zawierasz bezpośrednio z operatorem. Sprawdź u niego: * czy może zawrzeć z Tobą umowę (weryfikacja tożsamości, działalność gospodarcza, zgoda opiekuna), * czy akceptuje sprzedaż na serwerach gier i Twój typ produktów, * jakie ma prowizje, minimalne kwoty, rezerwy, chargebacki i terminy wypłat, * czy na Twoim koncie są aktywne potrzebne kanały (BLIK, karta, przelew), waluty i tryb testowy (sandbox). > [!NOTE] > > Kasa sklepu jest zablokowana, dopóki sklep nie ma wymaganych dokumentów prawnych (regulamin, polityka prywatności). Ta strona opisuje działanie produktu i nie jest poradą prawną ani podatkową. ## Obsługiwani operatorzy | Operator | Uwagi | | - | - | | Stripe | karty i inne metody aktywne na koncie Stripe | | PayPal Business | tylko integracja REST | | imoje | | | Przelewy24 | następca Dotpay | | ZEN, Paymentic, CashBill, PayByLink | | | HotPay | kilka rodzajów usług, każda jako osobny operator | | SimPay | | Kanały widoczne dla kupującego zależą od usług aktywnych w Twojej umowie, a nie od samej marki operatora. ItemShop nie publikuje stawek operatorów — potwierdź je w swojej umowie. ## Podłącz operatora **1. Wybierz operatora** W sekcji płatności dodaj operatora z listy. Jeśli nie masz jeszcze u niego konta, załóż je — bez danych dostępowych nie dokończysz konfiguracji. Operatora nie da się później zmienić; żeby przejść na innego, dodaj nową metodę. **2. Nazwa i waluta** Ustaw **nazwę wyświetlaną** (np. „BLIK i przelewy”) i **walutę rozliczeń** — lista pokazuje tylko waluty obsługiwane przez operatora. **3. Wklej klucze** Skopiuj z panelu operatora wymagane dane (np. identyfikator sklepu, klucz serwisowy, klucz sekretny). Panel pokaże dokładnie te pola, których potrzebuje wybrany operator. **4. Wklej adres powiadomień** Jeśli operator tego wymaga, skopiuj z ustawień metody **adres powiadomień (webhook)** i wklej go w panelu operatora. Dzięki niemu sklep dowiaduje się o opłaconych zamówieniach. Nie udostępniaj go nikomu — zawiera tajny element. **5. Włącz kanały** Po zapisaniu wybierz, które kanały widzi kupujący (np. BLIK, karta), i ustaw ich kolejność. Zostaw włączony co najmniej jeden. **6. Sprawdź konfigurację i przetestuj** **Sprawdź konfigurację** potwierdza tylko, że wszystkie wymagane pola są wypełnione — nie, że operator zaakceptował dane. Prawdziwy test to płatność w trybie testowym (niżej). > [!WARNING] > > Klucze operatora działają jak hasło do Twoich pieniędzy. Nie wysyłaj ich nikomu i nie wklejaj w zgłoszeniach pomocy. ## Kilka metod tego samego operatora Możesz dodać ten sam operator kilka razy — np. dwa konta Stripe, „Stripe A” i „Stripe B”, między którymi kupujący wybiera przy kasie. Każda metoda ma własne klucze, własny adres powiadomień i **unikalny w sklepie kod**: pierwsza metoda danego operatora dostaje kod równy jego nazwie (np. `stripe`), kolejne `stripe-2`, `stripe-3` itd. Produkty, kasa i ceny dla metod odwołują się do metody po tym **kodzie**, nie po nazwie wyświetlanej. Nadawaj metodom czytelne nazwy wyświetlane, żeby Ty i kupujący je rozróżniali. ## Prowizje i VAT | Ustawienie | Znaczenie | | - | - | | Prowizja operatora | procent i/lub kwota stała; u części operatorów pobierana automatycznie z każdej transakcji | | Kto płaci prowizję | domyślnie Ty (potrącana z przychodu); możesz ją doliczać do ceny kupującego | | Prowizja sklepu (%) | dodatkowy procent doliczany po Twojej stronie; `0` = brak | | Min. / maks. kwota | limity pojedynczej płatności tą metodą; puste = bez limitu | | VAT | ustawiany dla całego sklepu: włączony/wyłączony, stawka (domyślnie 23%), czy ceny zawierają VAT | VAT liczony jest od ceny po rabacie, a prowizja operatora od kwoty brutto. Przykład dla ceny 100 zł, VAT 23%, ceny z VAT (brutto) i prowizji 2%: ```text theme={null} brutto 100,00 zł (płaci gracz) VAT 18,70 zł prowizja 2,00 zł netto 79,30 zł (Twój przychód) ``` Jeśli ceny są podawane bez VAT, ta sama cena 100 zł oznacza 123 zł do zapłaty dla gracza. Rozbicie brutto / VAT / prowizja / netto widzisz w szczegółach zamówienia, w e-mailu z potwierdzeniem (VAT tylko gdy jest włączony) i w raportach na Discordzie. ## Opcje metody | Opcja | Działanie | | - | - | | Tryb testowy | używa sandboxu operatora; metoda nie jest pokazywana w publicznej kasie | | Wyłącz bramę płatności | czasowo ukrywa metodę bez jej usuwania | | Zablokuj promocje / kody promocyjne | przy tej metodzie nie działają obniżki ani kody rabatowe | | Przewalutowania | pozwala operatorowi przeliczać waluty | | Zapisuj błędy | problemy z tą metodą trafiają do dziennika błędów (zostaw włączone) | | Dodaj do wszystkich produktów | przy dodawaniu: nowa metoda od razu dostępna przy wszystkich produktach w cenie standardowej | Kolejność metod na liście to kolejność, w jakiej kupujący widzi je przy kasie — najpopularniejszą (zwykle BLIK) ustaw na początku. ## Przetestuj przed startem **1. Test w sandboxie** Włącz tryb testowy, kup tani produkt testowy i sprawdź, czy zamówienie przechodzi na **opłacone**, a plugin je realizuje. Poprawne potwierdzenie z sandboxu może uruchomić prawdziwą dostawę — testuj na osobnym produkcie. **2. Wyłącz tryb testowy** To najczęstsza pomyłka przy starcie: z włączonym trybem testowym metoda jest niewidoczna w kasie. **3. Mały zakup produkcyjny** Zrób jeden prawdziwy zakup małej wartości, żeby potwierdzić całą ścieżkę u operatora. > **Dodałem operatora, ale gracze nie mogą zapłacić** > > Sprawdź po kolei: czy metoda jest włączona i nie ma zaznaczonego „Wyłącz bramę płatności”, czy tryb testowy jest wyłączony, czy włączony jest co najmniej jeden kanał, czy limity min./maks. nie odcinają kwoty i czy metoda jest dozwolona dla danego produktu. Szczegóły błędów znajdziesz w dzienniku błędów (opisanym na stronie [Zamówienia](https://andcze.mintlify.site/pl/shop/orders.md)). > **Płatność przeszła, ale zamówienie wciąż oczekuje** > > Najczęściej brakuje adresu powiadomień w panelu operatora albo został wklejony z błędem. Skopiuj go ponownie z ustawień metody. ## Dalej > **[Zamówienia](https://andcze.mintlify.site/pl/shop/orders.md)** > > Statusy, ręczne akcje i dostawa. > **[Produkty](https://andcze.mintlify.site/pl/shop/products.md)** > > Ceny dla poszczególnych metod płatności. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.