---
title: "Klarna dla PrestaShop – instalacja i konfiguracja"
url: https://dh-pomoc.redzioch.pl/baza-wiedzy/klarna-dla-prestashop-instalacja-i-konfiguracja/
modified: 2025-10-26
group: "WordPress i sklepy"
category: "PrestaShop"
type: "Instrukcja"
description: "Spis treści Co daje integracja Klarna z PrestaShopWymagania i przygotowanieInstalacja modułu Klarna w PrestaShopTryb Sandbox i pierwsze połączenieWybór trybu integracji: Klarna Payments czy Klarna CheckoutKonfiguracja metod płatności i krajówOn-site Messaging na stronie produktu i w koszykuWebhooki, statusy zamówień i przepływ…"
language: pl
---

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