Klarna w WooCommerce - konfiguracja krok po kroku

Przy integracji bezpośredniej sklep korzysta z konta i danych API Klarna. Przy połączeniu przez PSP metoda jest uruchamiana w ramach jego usługi, a część czynności wykonuje się w panelu tego operatora. Nie zakładaj, że instrukcja dotycząca jednej ścieżki zadziała w drugiej.

Sprawdź obsługiwane kraje, waluty, rodzaj asortymentu i dostępne metody finansowania. Oferta widoczna dla kupującego oraz akceptacja zakupu zależą od warunków operatora i konkretnej transakcji. Nie każdy klient otrzyma ten sam wariant płatności. Koszty sprzedawcy wynikają z umowy bezpośredniej lub taryfy PSP; nie ma jednej prowizji właściwej dla wszystkich sklepów.

Dawne porównanie dwóch wtyczek Payments i Checkout wymaga ostrożności. Kustom jest osobną platformą checkout, która integruje płatności Klarna. Nie trzeba zmieniać całego checkoutu WooCommerce, aby rozpatrywać bezpośrednią integrację opisaną poniżej.

Jeżeli porównujesz również innych operatorów, zobacz sposób czytania cennika Tpay. Porównuj konkretną metodę, umowę i obsługę transakcji, zamiast zestawiać sam procent prowizji.

Najpierw wykonaj kopię i przygotuj środowisko do kontrolowanej próby. Zapisz wersje WooCommerce, WordPressa, wtyczki płatności i motywu. Wymagania instalowanego wydania sprawdź w aktualnej dokumentacji; stara lista minimalnych wersji PHP nie jest rekomendacją utrzymania takiego środowiska w 2026 roku.

Instrukcja producenta wtyczki Krokedil wskazuje HTTPS, przyjazne bezpośrednie odnośniki i przypisaną stronę regulaminu. Dla zgodności sum WooCommerce oraz Klarna wymaga wyświetlania cen z dwoma miejscami po przecinku. Sprawdź to również dla podatku, rabatów i kosztu dostawy.

Przy produktach fizycznych potrzebna jest dostępna metoda wysyłki w odpowiedniej strefie. Waluta i kraj muszą odpowiadać obsługiwanemu rynkowi oraz umowie. Jeśli sprzedajesz w kilku krajach, nie wystarczy ustawić wszędzie PLN; potrzebujesz konfiguracji zgodnej z warunkami konta i używanym rozwiązaniem wielowalutowym.

Zmiany w motywie i rozszerzeniach mogą wpływać na checkout. Przy obsłudze WordPressa i WooCommerce warto więc sprawdzić nie tylko sam moduł płatności, lecz również formularz, koszyk i skrypty optymalizacyjne.

Pobierz Klarna for WooCommerce z oficjalnego katalogu wskazanego przez producenta. W panelu WordPress przejdź do wtyczek, zainstaluj właściwy moduł i otwórz jego ustawienia w WooCommerce → Ustawienia → Płatności. Nazwy pól mogą zależeć od wersji językowej i wydania.

Producent wyraźnie zaznacza: "Test and Live accounts are separate." To fragment instrukcji instalacji Krokedil, zaktualizowanej 9 września 2026 roku. Playground i produkcja mają osobne konta, portale oraz dane dostępowe. Przełączenie jednego pola nie zamienia testowych danych API w produkcyjne.

Do integracji płatności potrzebne są API Username/UID i Password. Merchant ID/MID oraz Client ID służą innym celom i nie zastępują tej pary. Wprowadź dane odpowiadające wybranemu środowisku i obsługiwanemu rynkowi, zgodnie z dokumentacją Klarna Payments.

Hasło API pozostaje po stronie serwera. Nie umieszczaj go w kodzie strony, publicznym zgłoszeniu ani zrzucie ekranu. Dostępy do kont powinny mieć wskazanego właściciela, a przekazanie wykonawcy odbywać się bez publikowania sekretów w dokumentacji projektu.

Włącz tryb testowy Klarna i użyj odpowiadających mu danych Playground. To inna konfiguracja niż WooCommerce Site Visibility z etykietą Live albo Coming soon. Widoczność sklepu dla odwiedzających nie rozstrzyga, czy bramka przyjmuje prawdziwe płatności.

Do próby używaj danych testowych wskazanych przez Klarna. Sprawdź koszyk reprezentujący rzeczywiste ustawienia sklepu: produkt, podatek, dostawę, rabat i sumę. Następnie porównaj identyfikator oraz kwotę zamówienia w WooCommerce i testowym portalu operatora. Powrót na stronę podziękowania jest jednym elementem odbioru, a nie samodzielnym dowodem poprawnego rozliczenia.

Zapisz oczekiwany i otrzymany status, czas zdarzenia oraz ewentualny komunikat. Sprawdź callback i sposób aktualizacji zamówienia. Warto uwzględnić także anulowanie, odmowę i przerwanie procesu, żeby obsługa sklepu wiedziała, które zamówienia wymagają działania.

Środowisko próby nie powinno generować prawdziwej wysyłki ani dokumentów księgowych. Jeśli w tle działa ERP, integrator lub automatyzacja, odizoluj te połączenia. Test płatności nie jest zgodą na uruchomienie całego produkcyjnego procesu sprzedaży.

Autoryzacja, przechwycenie płatności i zwrot to różne operacje. Ich pomylenie może spowodować rozbieżność między statusem sklepu a informacją operatora. Najpierw ustal, kiedy sklep uznaje zamówienie za gotowe do realizacji i który system zmienia jego status.

Według dokumentacji Order Management od wersji 4.3.0 obsługa płatności i zamówień znajduje się w jednej wtyczce. Przy odpowiedniej konfiguracji ustawienie zamówienia jako Completed może uruchamiać pełne capture. Ten moduł nie obsługuje obecnie częściowego capture, natomiast dopuszcza pełny i częściowy refund. Nie należy utożsamiać tych dwóch operacji.

Zwrot wykonany lokalnie jako zapis księgowy nie musi oznaczać zwrotu przez operatora. W kontrolowanej próbie sprawdź właściwą funkcję zwrotu, kwotę, podatek i potwierdzenie po obu stronach. Jeśli statusy zmienia ERP, uwzględnij jego wpływ przed włączeniem automatycznych operacji.

Przy błędzie nie ponawiaj zwrotu w ciemno. Najpierw ustal, czy operator przyjął poprzednie żądanie. Zapis identyfikatora operacji pomaga odróżnić brak odpowiedzi w panelu od braku wykonania czynności.

On-site messaging pokazuje informacje o dostępnych sposobach płatności wcześniej niż na końcu checkoutu. Powinno być zgodne z faktyczną ofertą dla danego rynku i produktu. Własny tekst banera nie może obiecywać każdemu kupującemu identycznych warunków finansowania.

Dokumentacja OSM Klarna podaje, że funkcja jest wbudowana od wersji 3.5.0. Konfiguracja korzysta z Client identifier pobranego z Merchant Portal, a nie z hasła API płatności. W ustawieniach wybiera się lokalizację komunikatu i właściwe klucze placementów. Dodatkowa stara wtyczka OSM może więc nie być potrzebna.

Po konfiguracji sprawdź wygląd na telefonie i komputerze, aktualizację przy zmianie wariantu oraz pozycję względem ceny. Jeśli komunikat zasłania ważne informacje albo pokazuje warunki dla innego rynku, nie traktuj samego załadowania skryptu jako sukcesu.

Wpływ na zakupy można ocenić dopiero na danych z poprawnie skonfigurowanego pomiaru. Samo dodanie komunikatu nie gwarantuje wzrostu konwersji ani wartości koszyka. W projekcie sklepu internetowego powinien on wspierać zrozumiały proces zakupu.

Gdy Klarna się nie pokazuje, sprawdź aktywność metody, zgodność konta i środowiska, walutę, rynek oraz warunki dostępności. Następnie przejrzyj błędy checkoutu i logi wtyczki. Do zgłoszenia wystarczą zanonimizowane identyfikatory zdarzeń, czas i opis scenariusza; usuń hasła oraz dane klientów.

Jeżeli kwoty są różne, porównaj pozycje, rabaty, podatek i dostawę. Przy braku aktualizacji statusu sprawdź callbacki, przyjazne odnośniki i blokady komunikacji. Komunikat Purchase not approved może dotyczyć decyzji dotyczącej zakupu, a nie awarii integracji. Nie wyciągaj z niego wniosków o sytuacji finansowej konkretnej osoby.

Konflikty rozszerzeń diagnozuj na zabezpieczonej kopii, zmieniając jeden element naraz. Nie wyłączaj losowo wtyczek w czynnym sklepie. Zachowaj zapis wyniku przed zmianą i po niej, aby wiedzieć, co rzeczywiście wpłynęło na problem.

Po udanych testach przejście na produkcję wymaga właściwego konta, danych API i osobnego odbioru konfiguracji. Zakres pomocy opisujemy przy integracji płatności. W kontakcie podaj adres lub platformę sklepu oraz objaw; nie potrzebujesz kompletnego technicznego briefu, żeby rozpocząć diagnozę.