Przejdź do głównej treści
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 (darmowe do założenia)
1

Uzyskaj klucz API Paddle

  1. Zaloguj się do swojego panelu Paddle
  2. Przejdź do Narzędzia deweloperskie → Uwierzytelnianie
  3. Kliknij Wygeneruj klucz API
  4. Skopiuj klucz — zaczyna się od pdl_live_
Chcesz najpierw przetestować? Użyj zamiast tego panelu Sandbox. Klucze sandbox zaczynają się od pdl_test_ i nie pobierane są żadne prawdziwe opłaty.
2

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

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
Jeśli status pokazuje Nieaktywny, sprawdź dokładnie, czy Twój klucz API zaczyna się od pdl_live_ (lub pdl_test_ dla sandbox).

​
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
  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

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