> ## Documentation Index
> Fetch the complete documentation index at: https://docs.komerza.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Konfiguracja Paddle

> Skonfiguruj płatności Paddle w swoim sklepie Komerza

Akceptuj płatności przez Paddle w swoim sklepie Komerza. Paddle obsługuje interfejs płatności — klienci są przekierowywani na bezpieczną stronę płatności hostowaną przez Paddle, a następnie odsyłani do Twojego sklepu po zakończeniu płatności.

## Wymagania wstępne

* Konto [Paddle](https://www.paddle.com/) (darmowe do założenia)

<Steps>
  <Step title="Uzyskaj klucz API Paddle">
    1. Zaloguj się do swojego [panelu Paddle](https://vendors.paddle.com/)
    2. Przejdź do **Narzędzia deweloperskie → Uwierzytelnianie**
    3. Kliknij **Wygeneruj klucz API**
    4. Skopiuj klucz — zaczyna się od `pdl_live_`

    <Note>
      **Chcesz najpierw przetestować?** Użyj zamiast tego [panelu Sandbox](https://sandbox-vendors.paddle.com/). Klucze sandbox zaczynają się od `pdl_test_` i nie pobierane są żadne prawdziwe opłaty.
    </Note>
  </Step>

  <Step title="Połącz Paddle z Komerza">
    1. W panelu Komerza przejdź do **Metody płatności**
    2. Znajdź **Paddle** i kliknij **Konfiguruj**
    3. Wklej swój **Klucz API** (z Kroku 1)
    4. Kliknij **Zapisz**

    Komerza automatycznie tworzy endpoint webhooka na Twoim koncie Paddle. Nie jest wymagana ręczna konfiguracja webhooka.
  </Step>

  <Step title="Zweryfikuj połączenie">
    Przejdź do **Metody płatności → Paddle** w swoim panelu. Status pokaże:

    * **Aktywny** — Wszystko jest połączone i działa
    * **Nieaktywny** — Sprawdź, czy Twój klucz API jest poprawny

    <Note>
      Jeśli status pokazuje **Nieaktywny**, sprawdź dokładnie, czy Twój klucz API zaczyna się od `pdl_live_` (lub `pdl_test_` dla sandbox).
    </Note>
  </Step>
</Steps>

## Jak to działa

1. Klient wybiera Paddle podczas realizacji zamówienia
2. Jest przekierowywany na bezpieczną stronę płatności hostowaną przez Paddle
3. Po dokonaniu płatności jest odsyłany do Twojego sklepu z potwierdzeniem
4. Komerza otrzymuje webhook od Paddle potwierdzający płatność i automatycznie dostarcza zamówienie

## Zarządzanie płatnościami

* **Zwroty** — Możesz wystawiać pełne zwroty przez Komerza. Zwrot jest przetwarzany przez system Paddle i klient otrzymuje pieniądze z powrotem.
* **Spory** — Jeśli klient otworzy spór w swoim banku, otrzymasz powiadomienie w Komerza. Zamówienie jest oznaczone jako sporne i możesz odpowiedzieć przez panel Paddle.

## Testy sandbox

Jeśli chcesz przetestować przed uruchomieniem produkcyjnym:

1. Utwórz [konto Sandbox](https://sandbox-vendors.paddle.com/)
2. Użyj swojego klucza API sandbox (`pdl_test_...`)
3. Nie są naliczane żadne prawdziwe opłaty — możesz bezpiecznie przetestować pełny przepływ
4. Gdy będziesz gotowy, rozłącz i ponownie połącz klucz API produkcyjny

## Rozłączanie Paddle

Przejdź do **Metody płatności → Paddle** i kliknij **Rozłącz**. Spowoduje to również usunięcie endpointu webhooka z Twojego konta Paddle. Istniejące zamówienia nie są affected — tylko nowe płatności nie będą już oferować Paddle.

## Rozwiązywanie problemów

| Problem                       | Rozwiązanie                                                                                                       |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Płatności nie są finalizowane | Sprawdź, czy Twój klucz API jest ważny i zaczyna się od `pdl_live_` (lub `pdl_test_` dla sandbox)                 |
| Status nieaktywny             | Sprawdź dokładnie swój klucz API w **Metody płatności → Paddle**                                                  |
| Brak powiadomień o sporach    | Skontaktuj się z pomocą techniczną — webhook może wymagać ponownego utworzenia (rozłącz i ponownie połącz Paddle) |