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).
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
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).
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
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%:
Opcje metody
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ć
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).
Płatność przeszła, ale zamówienie wciąż oczekuje
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
Statusy, ręczne akcje i dostawa.
Produkty
Ceny dla poszczególnych metod płatności.