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

# Operatorzy płatności

> Dodaj i skonfiguruj bramki płatności, aby klienci mogli płacić w Twoim sklepie.

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.

<Frame caption="Lista operatorów płatności w panelu">
  <img src="https://mintcdn.com/andcze/6Qp9zwUm8VUzRssf/images/panel/payment-methods.png?fit=max&auto=format&n=6Qp9zwUm8VUzRssf&q=85&s=8891846ea15c77764faa974f82bca808" alt="Lista operatorów płatności" width="1280" height="720" data-path="images/panel/payment-methods.png" />
</Frame>

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

<Note>
  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".
</Note>

### Przyciski na karcie operatora

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

<Columns cols={2}>
  <Card title="Zarządzaj" icon="settings">
    Otwiera pełny ekran konfiguracji operatora (z zakładkami opisanymi niżej), gdzie zmienisz wszystkie ustawienia.
  </Card>

  <Card title="Sprawdź konfigurację" icon="shield-check">
    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.
  </Card>

  <Card title="Włącz / Wyłącz" icon="power">
    Jednym kliknięciem aktywujesz lub czasowo dezaktywujesz operatora, bez usuwania go z listy.
  </Card>

  <Card title="Usuń" icon="trash">
    Ikona kosza. Pojawi się pytanie z potwierdzeniem — operator zostanie skasowany dopiero po kliknięciu **Usuń**. Operacji nie da się cofnąć.
  </Card>
</Columns>

<Tip>
  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.
</Tip>

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

<Tip>
  Najpopularniejszego operatora (np. obsługującego BLIK) ustaw jako pierwszego — klient szybciej go zauważy, a Ty zwiększysz szansę na sfinalizowanie zakupu.
</Tip>

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

<Note>
  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.
</Note>

## Dodawanie operatora

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

<Steps>
  <Step title="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ć.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Tip>
  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.
</Tip>

<Note>
  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ę.
</Note>

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

<Columns cols={2}>
  <Card title="Ustawienia ogólne">
    Ustaw **nazwę wyświetlaną** oraz **domyślną walutę**, w której rozliczane są płatności.
  </Card>

  <Card title="Konfiguracja">
    Wklej **klucze i dane dostępowe** skopiowane z panelu operatora. To one łączą Twój sklep z bramką.
  </Card>

  <Card title="Kanały">
    Wybierz, które **metody płatności** (np. BLIK, karta, Przelewy24) widzi klient, i ustaw ich **kolejność**.
  </Card>

  <Card title="Notyfikacje">
    Znajdziesz tu **adres powiadomień (webhook)**, który należy wkleić w panelu operatora, aby informował Twój sklep o opłaconych zamówieniach.
  </Card>

  <Card title="Prowizja">
    Określ **prowizję operatora** i **prowizję sklepu**, ustaw limity kwot i zdecyduj, kto pokrywa koszt płatności.
  </Card>

  <Card title="Opcje">
    Włącz lub wyłącz **tryb testowy**, **wyłącz całą bramę** oraz dodatkowe przełączniki zachowania.
  </Card>
</Columns>

<Note>
  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.
</Note>

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

<Note>
  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ę.
</Note>

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

<Warning>
  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.
</Warning>

<Note>
  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".
</Note>

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

<Tip>
  Najpopularniejsze metody (np. BLIK) ustaw na górze listy — klient szybciej je zauważy, a Ty zwiększysz szansę na sfinalizowanie zakupu.
</Tip>

<Note>
  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ść.
</Note>

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

<Warning>
  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.
</Warning>

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

<Note>
  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.
</Note>

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

<Tip>
  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.
</Tip>

### Opcje

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

<Columns cols={2}>
  <Card title="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.
  </Card>

  <Card title="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**.
  </Card>

  <Card title="Przewalutowania">
    „Zezwalaj na automatyczne przewalutowania" — pozwala operatorowi przeliczać waluty, gdy klient płaci w innej walucie niż domyślna.
  </Card>

  <Card title="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).
  </Card>

  <Card title="Zablokuj kody promocyjne">
    „Zablokuj działanie kodów promocyjnych na tej bramie" — przy tej metodzie klient nie wykorzysta kodów rabatowych.
  </Card>

  <Card title="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.
  </Card>
</Columns>

<Warning>
  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.
</Warning>

<Note>
  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").
</Note>

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

<Tip>
  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.
</Tip>

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

<Note>
  Kolejność operatorów na liście odpowiada temu, co klient zobaczy jako pierwsze podczas finalizacji zamówienia.
</Note>

## Najczęstsze pytania

<AccordionGroup>
  <Accordion title="Czym różni się „Nieaktywna&#x22; od „Wyłączona&#x22;?">
    „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ś.
  </Accordion>

  <Accordion title="Dodałem operatora, ale klienci nie mogą zapłacić.">
    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.
  </Accordion>

  <Accordion title="Czy mogę zmienić dostawcę istniejącego operatora?">
    Nie — dostawcy nie da się zmienić po utworzeniu. Jeśli chcesz innej bramki, usuń obecnego operatora i dodaj nowego.
  </Accordion>

  <Accordion title="Po co jest „adres powiadomień (webhook)&#x22;?">
    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.
  </Accordion>

  <Accordion title="Kto płaci prowizję operatora — ja czy klient?">
    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.
  </Accordion>
</AccordionGroup>

## Najczęstsze pułapki

<Columns cols={2}>
  <Card title="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ć.
  </Card>

  <Card title="Zapomniany tryb testowy">
    Sprawdź zakładkę **Opcje** i upewnij się, że tryb testowy jest **wyłączony**, zanim ruszysz ze sprzedażą.
  </Card>

  <Card title="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.
  </Card>

  <Card title="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ć.
  </Card>

  <Card title="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ć.
  </Card>

  <Card title="Zbyt ciasne limity">
    Sprawdź pola „Minimalna" i „Maksymalna kwota" w zakładce Prowizja — zbyt wąski zakres może blokować część zamówień.
  </Card>
</Columns>

## Dobre praktyki

<Tip>
  * **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.
</Tip>