Skip to main content
Aby klienci mogli kupować przedmioty w Twoim sklepie, musisz podłączyć przynajmniej jednego operatora płatności (czyli bramkę, która przyjmuje pieniądze — np. BLIK, kartę czy przelew). Na tej stronie konfigurujesz, kto obsługuje płatności i jakie metody widzi kupujący przy finalizacji zamówienia.
Lista operatorów płatności

Lista operatorów płatności w panelu

Sekcję tę znajdziesz w menu bocznym w grupie INTEGRACJE, pod nazwą Operatorzy płatności. W samym panelu nagłówek strony brzmi „Metody płatności” — to ta sama rzecz.

​
Lista operatorów

Twoi operatorzy wyświetlają się jako siatka kart — każda karta to jeden operator. Na karcie od razu widzisz najważniejsze informacje:
  • Logo operatora na jasnym pasku u góry (jeśli operator nie ma logo, w jego miejscu pojawia się sama nazwa).
  • Plakietkę statusu w prawym górnym rogu karty — Aktywna (zielona), Nieaktywna (szara) albo Wyłączona (gdy ręcznie wyłączyłeś bramę).
  • Nazwę wyświetlaną oraz pod nią kategorię operatora (np. „Przelewy Online”, „BLIK”, „Karty płatnicze”) z małą kolorową kropką.
  • Plakietki dodatkowe: Tryb testowy (gdy jest włączony), walutę (np. PLN) oraz Prowizja X% (jeśli ustawiłeś prowizję sklepu).
Operator może być Aktywny, Nieaktywny albo Wyłączony. „Aktywny” znaczy, że klienci mogą nim płacić. „Nieaktywny” pojawia się, gdy wyłączysz go przełącznikiem na liście. „Wyłączona” to stan, gdy w ustawieniach operatora włączysz opcję „Wyłącz bramę płatności”.

​
Przyciski na karcie operatora

Na dole każdej karty znajdziesz zestaw przycisków:

Zarządzaj

Otwiera pełny ekran konfiguracji operatora (z zakładkami opisanymi niżej), gdzie zmienisz wszystkie ustawienia.

Sprawdź konfigurację

Przycisk z ikoną tarczy. Sprawdza, czy podałeś wszystkie wymagane pola. Nie potwierdza poprawności danych u operatora ani dostępności kanałów — to zweryfikujesz dopiero w sandboxie i podczas testu podpisanego webhooka.

Włącz / Wyłącz

Jednym kliknięciem aktywujesz lub czasowo dezaktywujesz operatora, bez usuwania go z listy.

Usuń

Ikona kosza. Pojawi się pytanie z potwierdzeniem — operator zostanie skasowany dopiero po kliknięciu Usuń. Operacji nie da się cofnąć.
Po każdej zmianie kluczy warto kliknąć Sprawdź konfigurację. Jeśli zobaczysz komunikat „Brakujące pola konfiguracji” wraz z listą pól — wróć do zakładki Konfiguracja i uzupełnij te dane. To eliminuje najczęstszą przyczynę niedziałających płatności.

​
Zmiana kolejności operatorów

Gdy masz więcej niż jednego operatora, możesz ustawić ich kolejność. Kolejność kart = kolejność, w jakiej operatorzy pojawią się u klienta przy finalizacji zamówienia. Nad listą zobaczysz podpowiedź o tym samym. Kolejność zmieniasz strzałkami w lewym górnym rogu karty (w lewo = wcześniej, w prawo = później). Zmiana zapisuje się od razu.
Najpopularniejszego operatora (np. obsługującego BLIK) ustaw jako pierwszego — klient szybciej go zauważy, a Ty zwiększysz szansę na sfinalizowanie zakupu.

​
Gdy nie masz jeszcze operatorów

Jeśli nie dodałeś jeszcze żadnego operatora, zobaczysz komunikat „Brak metod płatności” z zachętą, by dodać pierwszego operatora. To normalne na starcie — wystarczy kliknąć Dodaj operatora i przejść przez konfigurację.
Jeśli pracujesz w zespole, przyciski dodawania, zarządzania i usuwania zobaczą tylko osoby z odpowiednimi uprawnieniami. Współpracownik bez uprawnień zobaczy listę, ale jej nie zmieni.

​
Dodawanie operatora

Kliknij przycisk Dodaj operatora w prawym górnym rogu. Otworzy się proste przejście: najpierw wybierasz operatora, potem go konfigurujesz.
1

Wybierz operatora

Zobaczysz siatkę operatorów z ich logami. U góry masz wyszukiwarkę („Szukaj operatora…”) oraz filtry kategorii w formie klikalnych plakietek (np. „Wszystkie”, „Przelewy Online”, „BLIK”, „Karty płatnicze”, „Płatności Online”). Przy każdej kategorii widać liczbę operatorów, którzy do niej należą. Kliknij kartę operatora, którego chcesz dodać.
2

Skonfiguruj operatora

Po wybraniu operatora przejdziesz do ekranu z zakładkami. U góry zobaczysz logo i nazwę operatora, a jeśli nie masz jeszcze u niego konta — link „Nie masz konta u tego operatora? Załóż konto”, który otwiera jego stronę w nowej karcie. Obok jest też link „Zmień operatora”, jeśli się rozmyślisz.
3

Zapisz

Po uzupełnieniu wszystkich wymaganych danych kliknij Dodaj operatora. Pojawi się on na liście. Przed udostępnieniem kupującym zweryfikuj dane w sandboxie, podpisany webhook i pełną dostawę testowego produktu.
Zanim zaczniesz, załóż konto u operatora i przygotuj sobie dane dostępowe z jego panelu. Bez nich nie skończysz konfiguracji. Jeśli nie wiesz, gdzie się zarejestrować, skorzystaj z linku „Załóż konto” widocznego na ekranie konfiguracji.
Jeśli żadne wyniki nie pasują do tego, co wpiszesz w wyszukiwarkę, zobaczysz komunikat „Brak wyników”. Wyczyść wyszukiwanie krzyżykiem albo wybierz inną kategorię, aby zobaczyć pełną listę.

​
Zakładki konfiguracji

Ekran konfiguracji operatora (zarówno przy dodawaniu, jak i przy późniejszym Zarządzaj) jest podzielony na sześć zakładek. Możesz między nimi swobodnie przełączać.

Ustawienia ogólne

Ustaw nazwę wyświetlaną oraz domyślną walutę, w której rozliczane są płatności.

Konfiguracja

Wklej klucze i dane dostępowe skopiowane z panelu operatora. To one łączą Twój sklep z bramką.

Kanały

Wybierz, które metody płatności (np. BLIK, karta, Przelewy24) widzi klient, i ustaw ich kolejność.

Notyfikacje

Znajdziesz tu adres powiadomień (webhook), który należy wkleić w panelu operatora, aby informował Twój sklep o opłaconych zamówieniach.

Prowizja

Określ prowizję operatora i prowizję sklepu, ustaw limity kwot i zdecyduj, kto pokrywa koszt płatności.

Opcje

Włącz lub wyłącz tryb testowy, wyłącz całą bramę oraz dodatkowe przełączniki zachowania.
Jeśli przy zapisie pojawi się błąd w którejś zakładce (np. brakuje wymaganego pola), panel automatycznie przeniesie Cię do właściwej zakładki i podświetli pole do poprawienia. Dzięki temu nie musisz szukać, gdzie leży problem.

​
Ustawienia ogólne

To podstawowe informacje o operatorze:
  • Dostawca — wybór bramki. Przy dodawaniu wybierasz go z listy (jeśli nie zrobiłeś tego wcześniej w siatce). Po utworzeniu operatora dostawcy nie da się już zmienić — przy edycji pole jest tylko do odczytu.
  • Nazwa wyświetlana — etykieta operatora, którą widzisz w panelu (np. „Szybki przelew”). Ułatwia rozpoznanie operatora, gdy masz ich kilku. To pole jest wymagane.
  • Domyślna waluta — waluta, w której będą rozliczane płatności. Lista pokazuje tylko waluty obsługiwane przez wybranego operatora. Jeśli operator obsługuje tylko jedną walutę, zobaczysz o tym informację.
Chcesz zmienić operatora na innego? Nie da się tego zrobić w istniejącej konfiguracji — usuń go i dodaj nowego. Dlatego przy dodawaniu warto od razu wybrać właściwą bramkę.

​
Konfiguracja

Tutaj wklejasz dane dostępowe (klucze API), które znajdziesz w panelu swojego operatora. To dzięki nim sklep może bezpiecznie współpracować z bramką.
  • Każdy operator ma własny zestaw pól — np. identyfikator sklepu, klucz serwisowy, klucz sekretny. Panel sam pokaże dokładnie te pola, których wymaga wybrany operator.
  • Pola z kluczami i hasłami są zamaskowane (jak hasło), żeby nikt nie podejrzał ich przez ramię.
  • Niektórzy operatorzy mają też przełącznik (np. tryb piaskownicy / „sandbox”) — wtedy zamiast pola tekstowego zobaczysz włącznik.
  • Pola oznaczone gwiazdką są wymagane — bez nich nie zapiszesz operatora.
Dane dostępowe (klucze) trzymaj w tajemnicy. Nikomu ich nie udostępniaj ani nie wysyłaj — pozwalają przyjmować płatności w Twoim imieniu, więc działają jak hasło do Twoich pieniędzy.
Jeśli wybrany operator nie wymaga żadnych dodatkowych kluczy, zobaczysz komunikat „Ten operator nie wymaga dodatkowych kluczy API” — wtedy po prostu pomijasz tę zakładkę. A jeśli jeszcze nie wybrałeś dostawcy, panel poprosi Cię, byś najpierw zrobił to w zakładce „Ustawienia ogólne”.

​
Kanały

W tej zakładce decydujesz, jakie metody płatności zobaczy klient podczas finalizacji zamówienia — na przykład BLIK, kartę czy Przelewy24. Możesz:
  • włączać i wyłączać poszczególne kanały przełącznikiem przy każdym z nich,
  • ustawić ich kolejność, przeciągając uchwyt (symbol ⠿) albo używając strzałek w górę i w dół.
Kolejność na liście odpowiada kolejności, w jakiej kanały pojawią się u klienta.
Najpopularniejsze metody (np. BLIK) ustaw na górze listy — klient szybciej je zauważy, a Ty zwiększysz szansę na sfinalizowanie zakupu.
Jeśli operator udostępnia tylko jeden kanał, zobaczysz informację, że nie ma czego konfigurować. Przy dodawaniu nowego operatora kanały często pojawiają się dopiero po jego zapisaniu — wtedy wracasz do tej zakładki przez Zarządzaj, włączasz wybrane kanały i ustawiasz ich kolejność.

​
Notyfikacje

Niektórzy operatorzy wymagają, byś wkleił w ich panelu specjalny adres powiadomień (webhook). Dzięki niemu operator automatycznie poinformuje Twój sklep, gdy klient opłaci zamówienie — i przedmiot zostanie wydany graczowi.
  • Adres znajdziesz w tej zakładce po dodaniu operatora. Obok niego jest przycisk Kopiuj — kliknij go, skopiuj adres i wklej w ustawieniach powiadomień / webhooków w panelu operatora.
  • Jeśli operator nie korzysta z ręcznie ustawianego adresu, zobaczysz informację, że potwierdzenia płatności działają automatycznie — wtedy nie musisz nic robić.
Adresu powiadomień nie udostępniaj nikomu. Zawiera on tajny element, który pozwala potwierdzać płatności — wklej go wyłącznie w panelu swojego operatora.

​
Prowizja

Ta zakładka pozwala dokładnie ustawić, jak liczone są koszty płatności. Składa się z dwóch części.

​
Prowizja operatora płatności

To opłata, którą operator pobiera od każdej transakcji. Najpierw przełącznikiem włączasz obliczanie prowizji operatora. Gdy go włączysz, pojawią się dodatkowe pola:
  • Źródło prowizji (przy operatorach, którzy to wspierają) — Automatycznie (prowizja jest pobierana wprost od operatora przy każdej transakcji, nie musisz nic wpisywać) albo Ręcznie (sam podajesz wartości poniżej).
  • Prowizja (%) oraz Prowizja (kwota) — przy trybie ręcznym wpisujesz procent i/lub stałą kwotę prowizji.
  • Sposób liczenia prowizji — decydujesz, czy liczyć najpierw procent, potem kwotę, czy najpierw kwotę, potem procent.
  • Liczenie finalnej kwoty dla kupującego — wybierasz, czy prowizja ma być doliczana do ceny dla kupującego (wtedy to klient pokrywa koszt płatności) czy nie powiększać kwoty dla kupującego (koszt potrącany jest z Twojego przychodu). Domyślnie kwota dla kupującego nie jest powiększana.
Część operatorów potrafi sama zgłosić swoją realną prowizję — przy nich dostępne jest źródło „Automatycznie”. Przy pozostałych prowizję wpisujesz ręcznie.

​
Prowizja sklepu i limity

Druga część zakładki to dodatkowe ustawienia rozliczeń:
  • Prowizja sklepu (%) — procentowa prowizja doliczana do płatności po Twojej stronie. Zostaw 0, jeśli nie chcesz nic doliczać.
  • Minimalna kwota i Maksymalna kwota — opcjonalne limity pojedynczej płatności u tego operatora. Zostaw puste, jeśli nie chcesz ich ograniczać.
Doliczanie prowizji do ceny kupującego przydaje się, gdy któryś operator pobiera wyższą opłatę (np. płatności SMS). Możesz wtedy ustawić, by to klient pokrył ten koszt — Twój przychód pozostaje bez zmian.

​
Opcje

Tu znajdziesz dodatkowe przełączniki sterujące zachowaniem operatora:

Zapisuj błędy

„Zapisuj błędy przy generowaniu/odbieraniu płatności” — gdy włączone, ewentualne problemy z tym operatorem trafią do sekcji Błędy, gdzie możesz je przejrzeć i naprawić. Warto trzymać włączone.

Wyłącz bramę płatności

Tymczasowo wstrzymuje przyjmowanie płatności przez tego operatora, bez usuwania go z listy. Na liście dostanie wtedy plakietkę Wyłączona.

Przewalutowania

„Zezwalaj na automatyczne przewalutowania” — pozwala operatorowi przeliczać waluty, gdy klient płaci w innej walucie niż domyślna.

Zablokuj promocje

„Zablokuj działanie promocji na tej bramie” — wyłącza obniżki cen przy płatności tym operatorem (np. gdy ta metoda jest droga w obsłudze).

Zablokuj kody promocyjne

„Zablokuj działanie kodów promocyjnych na tej bramie” — przy tej metodzie klient nie wykorzysta kodów rabatowych.

Tryb testowy

Używa środowiska sandbox operatora bez prawdziwego rozliczenia. Taka metoda ma plakietkę Tryb testowy i nie jest pokazywana w publicznym checkoutcie. Uwierzytelniony pracownik może testować sesje przez administracyjne API płatności.
Poprawny callback sandbox może uruchomić proces dostawy dla zamówienia testowego. Testuj na osobnym produkcie i serwerze, a przed startem wyłącz tryb testowy oraz wykonaj nowy zakup małej wartości w środowisku produkcyjnym operatora.
Przy dodawaniu nowego operatora w zakładce „Opcje” znajdziesz dodatkowo przełącznik „Dodaj do wszystkich produktów po standardowej cenie”. Włączony (domyślnie) sprawia, że nowa metoda od razu staje się dostępna przy wszystkich Twoich produktach w cenie podstawowej. Czego dla którego produktu używać, doprecyzujesz później w ustawieniach produktu (sekcja „Metody płatności”).

​
Sprawdzanie konfiguracji

Na liście operatorów każda karta ma przycisk Sprawdź konfigurację (ikona tarczy). Po kliknięciu panel weryfikuje wyłącznie, czy podałeś wszystkie wymagane pola:
  • Jeśli pola są kompletne — zobaczysz komunikat „Konfiguracja jest poprawna”. Nie oznacza to, że operator zaakceptował dane.
  • Jeśli czegoś brakuje — pojawi się komunikat „Brakujące pola konfiguracji” wraz z listą brakujących pól. Wejdź wtedy w Zarządzaj → Konfiguracja i uzupełnij wskazane dane.
Sprawdzaj konfigurację za każdym razem po dodaniu operatora lub zmianie kluczy. To kilkusekundowe kliknięcie, które ratuje przed sytuacją, w której klient płaci, a płatność nie przechodzi.

​
Zarządzanie listą operatorów

Na głównej liście możesz szybko porządkować swoje bramki:
  • Strzałki — zmieniaj kolejność operatorów strzałkami w rogu karty. Najczęściej wybierane bramki warto trzymać na początku.
  • Włącz / Wyłącz — aktywuj lub czasowo dezaktywuj operatora jednym przyciskiem.
  • Zarządzaj — wejdź w pełną konfigurację, aby zmienić dowolne ustawienie.
  • Usuń — całkowicie usuń operatora, którego już nie używasz (z potwierdzeniem).
Kolejność operatorów na liście odpowiada temu, co klient zobaczy jako pierwsze podczas finalizacji zamówienia.

​
Najczęstsze pytania

„Nieaktywna” pojawia się, gdy wyłączysz operatora przyciskiem Wyłącz na liście. „Wyłączona” oznacza, że w ustawieniach operatora (zakładka „Opcje”) włączyłeś przełącznik „Wyłącz bramę płatności”. W obu przypadkach klient nie zapłaci tym operatorem — różnica jest tylko w tym, gdzie go wyłączyłeś.
Sprawdź po kolei: czy operator jest Aktywny (nie „Nieaktywny” ani „Wyłączona”), czy tryb testowy jest wyłączony, czy w zakładce Kanały masz włączoną przynajmniej jedną metodę, i czy Sprawdź konfigurację nie zgłasza brakujących pól.
Nie — dostawcy nie da się zmienić po utworzeniu. Jeśli chcesz innej bramki, usuń obecnego operatora i dodaj nowego.
To adres, który niektórzy operatorzy wymagają wkleić w swoim panelu. Dzięki niemu operator sam informuje Twój sklep o opłaceniu zamówienia, a przedmiot trafia do gracza automatycznie. Skopiuj go przyciskiem Kopiuj i nikomu nie udostępniaj.
Decydujesz o tym w zakładce Prowizja, w polu „Liczenie finalnej kwoty dla kupującego”. Domyślnie prowizja nie powiększa ceny dla kupującego (pokrywasz ją z przychodu). Jeśli wybierzesz „Doliczaj prowizję do kwoty dla kupującego”, koszt poniesie klient.

​
Najczęstsze pułapki

Niekompletne dane

Uzupełnij wszystkie wymagane pola w zakładce Konfiguracja. Brakujący klucz to najczęstszy powód, dla którego płatności nie działają — kliknij Sprawdź konfigurację, aby to wychwycić.

Zapomniany tryb testowy

Sprawdź zakładkę Opcje i upewnij się, że tryb testowy jest wyłączony, zanim ruszysz ze sprzedażą.

Brak adresu powiadomień

Jeśli operator wymaga webhooka, bez wklejenia adresu powiadomień w jego panelu sklep może nie wiedzieć o opłaconych zamówieniach.

Wszystkie kanały wyłączone

Zostaw w zakładce Kanały przynajmniej jedną włączoną metodę, inaczej klient nie będzie miał czym zapłacić.

Brama wyłączona

Jeśli włączysz „Wyłącz bramę płatności” w „Opcjach”, operator zniknie z checkoutu mimo że jest na liście. Pamiętaj, by go z powrotem włączyć.

Zbyt ciasne limity

Sprawdź pola „Minimalna” i „Maksymalna kwota” w zakładce Prowizja — zbyt wąski zakres może blokować część zamówień.

​
Dobre praktyki

  • Najpierw konto u operatora — załóż je i przygotuj klucze, zanim zaczniesz konfigurację. Skorzystaj z linku „Załóż konto” na ekranie operatora.
  • Zawsze sprawdzaj konfigurację — po dodaniu lub zmianie kluczy kliknij „Sprawdź konfigurację”, by mieć pewność, że nic nie brakuje.
  • Wyłącz tryb testowy przed startem — to najczęstsza pomyłka. Bez tego klienci nie zapłacą naprawdę.
  • Włącz BLIK i ustaw go na górze — to najpopularniejsza metoda w Polsce; kolejność kanałów i operatorów wpływa na to, co klient widzi pierwsze.
  • Przemyśl, kto płaci prowizję — przy droższych metodach (np. SMS) rozważ doliczanie prowizji do ceny kupującego.
  • Trzymaj klucze w tajemnicy — kluczy API ani adresu powiadomień nigdy nikomu nie wysyłaj.
  • Zrób testowy zakup — przed ogłoszeniem sklepu kup coś sam i sprawdź, czy płatność przechodzi, a przedmiot trafia do gry.