Klarna dla PrestaShop – instalacja i konfiguracja

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.