Klarna dla PrestaShop – instalacja i konfiguracja

Zaktualizowano
W tym artykule

W tym artykule

  1. Co daje integracja Klarna z PrestaShop
  2. Wymagania i przygotowanie
  3. Instalacja modułu Klarna w PrestaShop
  4. Tryb Sandbox i pierwsze połączenie
  5. Wybór trybu integracji: Klarna Payments czy Klarna Checkout
  6. Konfiguracja metod płatności i krajów
  7. On-site Messaging na stronie produktu i w koszyku
  8. Webhooki, statusy zamówień i przepływ Capture
  9. Podatki, wysyłka i kompatybilność koszyka
  10. Testy end to end w Sandbox
  11. Najczęstsze problemy i szybkie rozwiązania
  12. Rekomendowane ustawienia produkcyjne
  13. Zgodność, bezpieczeństwo i dane klienta
  14. Utrzymanie i skalowanie

Co daje integracja Klarna z PrestaShop

Klarna to bramka płatności z opcjami Pay Now, Pay Later i Financing. W sklepie PrestaShop zwiększa konwersję dzięki odroczonym płatnościom i rozłożeniu na raty, a także przejrzystym kosztom. Moduł udostępnia gotowe metody na stronie koszyka i kasy, obsługuje zwroty i częściowe obciążenia, a poprzez On-site Messaging pokazuje informacyjne badge o ratach i płatnościach już na karcie produktu.

Wymagania i przygotowanie

  • aktywne konto handlowe Klarna i dostęp do Merchant Portal,
  • dane API dla Sandbox i Production: Merchant ID, API Username, API Password,
  • zgodne kraje i waluty w PrestaShop,
  • PrestaShop 1.7 lub 8 z SSL,
  • polityka zwrotów i prywatności oraz dane firmowe.

W multistore przygotuj oddzielne poświadczenia i konfiguracje dla każdego sklepu. Sprawdź stawki VAT i formaty adresów.

Instalacja modułu Klarna w PrestaShop

  1. Z katalogu modułów: Moduły – Katalog – wyszukaj Klarna – Zainstaluj.
  2. Z paczki ZIP: Moduły – Menedżer modułów – Prześlij moduł – wybierz ZIP – Zainstaluj.

Po instalacji wejdź w Konfiguruj, skopiuj adresy webhooków i zachowaj do ustawienia w Merchant Portal.

Tryb Sandbox i pierwsze połączenie

  • włącz Tryb testowy,
  • wprowadź dane Sandbox i zapisz,
  • użyj Test połączenia,
  • włącz metody tylko dla krajów testowych.

Po testach wprowadź dane produkcyjne i wyłącz Sandbox.

Wybór trybu integracji: Klarna Payments czy Klarna Checkout

Klarna Payments dodaje metody na standardowej kasie PrestaShop. Klarna Checkout zastępuje kasę własnym checkoutem Klarna z wbudowanym adresowaniem i wyborem dostawy. Wybierz wariant zgodnie z potrzebami personalizacji i logistyki.

Konfiguracja metod płatności i krajów

  • Pay Now, Pay Later, Pay in 3 lub Pay in 4, Financing,
  • limity koszyka i waluty per kraj,
  • reguły widoczności dla grup klientów i nośników dostawy.

Upewnij się, że waluta w sklepie jest dozwolona dla wybranego kraju Klarna.

On-site Messaging na stronie produktu i w koszyku

  • włącz OSM i wybierz styl badge,
  • zdecyduj o lokalizacjach: listing, PDP, koszyk,
  • sprawdź podgląd i działanie dla różnych wariantów produktu.

OSM informuje o ratach i zwiększa skłonność do finalizacji zakupu.

Webhooki, statusy zamówień i przepływ Capture

  • skonfiguruj webhooki w Merchant Portal według adresów z modułu,
  • zmapuj statusy PrestaShop do zdarzeń Klarna,
  • ustaw automatyczny lub ręczny capture przy wysyłce.

Standardowy przepływ: autoryzacja – oczekujące zamówienie, capture przy wysyłce, refund pełny lub częściowy z poziomu zamówienia.

Podatki, wysyłka i kompatybilność koszyka

  • ujednolić zasady VAT netto lub brutto,
  • sprawdzić zaokrąglenia i koszty dostawy,
  • potwierdzić kompatybilność pól adresowych,
  • w multistore utrzymywać odrębne profile podatków i dostaw.

Różnice w koszyku i autoryzacji to najczęstsza przyczyna odrzuceń.

Testy end to end w Sandbox

  1. Zakup z Pay Now, Pay Later i Pay in 3.
  2. Koszyk z kuponem i różnymi stawkami VAT.
  3. Capture pełny i częściowy, refund pełny i częściowy.
  4. Anulowanie przed wysyłką.
  5. Limity metod i walidacja adresu.

Po każdym scenariuszu sprawdź logi modułu i zgodność kwot w panelu Klarna i w zamówieniu.

Najczęstsze problemy i szybkie rozwiązania

  • Metody niewidoczne: sprawdź kraj, walutę, limity i tryb testowy.
  • Błąd API: zweryfikuj Merchant ID i dane użytkownika API dla właściwego środowiska.
  • Brak aktualizacji statusu: sprawdź webhooki, publiczną dostępność adresu i logi.
  • Rozbieżne kwoty: porównaj reguły podatkowe, dostawę i zaokrąglenia, włącz pełne pozycje koszyka.
  • Capture nie działa: popraw mapowanie statusu wysyłki lub użyj capture ręcznego.

Rekomendowane ustawienia produkcyjne

  • produkcyjne poświadczenia API, sandbox wyłączony,
  • automatyczny capture przy statusie Wysłane,
  • OSM aktywny na PDP i w koszyku,
  • limity metod dopasowane do średniej wartości koszyka,
  • logi ostrzeżeń i ograniczenie dostępu do webhooków,
  • osobne poświadczenia API dla każdego sklepu w multistore.

Zgodność, bezpieczeństwo i dane klienta

  • HTTPS i aktualny certyfikat,
  • komunikaty o przetwarzaniu danych zgodne z RODO,
  • brak przechowywania danych płatniczych w sklepie,
  • regularne aktualizacje modułu i PrestaShop.

Włącz alerty błędów i monitoruj współczynnik autoryzacji, aby szybko reagować.

Utrzymanie i skalowanie

  • aktualizacje po większych wersjach PrestaShop i testy regresyjne w Sandbox,
  • przegląd limitów i dostępności krajów co kwartał,
  • monitoring porzuceń koszyka i pozycjonowania OSM,
  • integracja refundów z ERP,
  • archiwizacja logów i procedura rollback.

Dobrze wdrożony moduł Klarna przyspiesza płatności i zwiększa dokończenia zakupów. Dzięki prawidłowej konfiguracji webhooków, statusów i OSM zyskasz stabilną obsługę zamówień oraz lepszą konwersję na kluczowych rynkach.

Nadal potrzebujesz pomocy? Helpdesk 24h odpowiada przez całą dobę.

Powiązane artykuły

Na blogu