Wdrożenie InPost Pay w sklepie – WooCommerce, Shoper i inne platformy

Wdrożenie w WooCommerce krok po kroku

Według dokumentacji wtyczki WooCommerce instalacja wygląda standardowo: pobierasz spakowaną wtyczkę ze strony InPost, w panelu WordPress wybierasz dodanie nowej wtyczki, wysyłasz plik na serwer, instalujesz i włączasz. Przy aktualizacji ustawienia nie są kasowane. Dokumentacja zaznacza, że przy pierwszej instalacji na PHP 8.x trzeba po aktywacji wejść w ustawienia, wybrać środowisko i zapisać zmiany.

1. Środowisko i widoczność – Sandbox oraz wyświetlanie widgetu tylko testerom; widget zobaczysz po dodaniu do adresu sklepu parametru showIzi=true.

2. Dane dostępowe – Client ID, Client Secret, POS ID i Merchant ID otrzymane od InPost.

3. Płatności i statusy – włączenie płatności i wybór statusów dla zamówień opłaconych oraz za pobraniem.

4. Produkty sugerowane i zgody – liczba produktów sugerowanych w aplikacji i zgody wymagane w sklepie.

5. Metody dostawy – powiązanie kuriera i Paczkomatu w aplikacji z metodami wysyłki w sklepie, żeby obowiązywały te same reguły dostępności i ceny.

6. Miejsca wyświetlania – karta produktu i koszyk, z wyborem, dokąd prowadzi przycisk.

Po testach przełączasz środowisko na produkcyjne, widoczność widgetu na wszystkich klientów i wpisujesz dane dostępowe z panelu merchanta. Dokumentacja WooCommerce zawiera też instrukcję konfiguracji ciasteczek funkcjonalnych dla popularnych wtyczek do zarządzania zgodami – jeśli sklep blokuje ciasteczka do czasu zgody, InPost Pay może nie działać poprawnie bez tej konfiguracji. Integrację wysyłkową InPost w WooCommerce opisujemy osobno w poradniku InPost w WooCommerce.

Metody dostawy i ceny w aplikacji

Najwięcej uwagi przy konfiguracji wymaga powiązanie metod dostawy. Według dokumentacji WooCommerce kuriera i Paczkomat w aplikacji InPost łączysz z metodami wysyłki skonfigurowanymi w sklepie – wtedy w aplikacji obowiązują te same reguły dostępności i cen. Osobno ustawiasz ceny opcji dodatkowych: dla Paczkomatu Paczkę w Weekend i płatność przy odbiorze wraz z dniami i godzinami dostępności, dla kuriera – dodatkowe opcje kurierskie. Jeśli w sklepie masz darmową dostawę od progu, sprawdź w testach, czy aplikacja pokazuje tę samą cenę co koszyk.

Zasady samych usług opisujemy w artykułach Paczka w Weekend InPost i pobranie w InPost. Rozbieżność cen dostawy między koszykiem a aplikacją to jeden z najczęstszych powodów pytań od klientów po uruchomieniu InPost Pay.

Wdrożenie w PrestaShop

Według dokumentacji moduł PrestaShop instalujesz przez Menedżer modułów, ładując spakowaną paczkę. Dokumentacja ostrzega, żeby nie aktualizować modułu przez odinstalowanie i ponowną instalację, bo wtedy nie uruchamia się mechanizm aktualizacji, co może skutkować błędami. W konfiguracji ustawiasz środowisko, widoczność widgetu (wszystkim albo testerom z parametrem showIzi=true w adresie) i cztery pola danych dostępowych.

Dokumentacja wskazuje, że od wersji 3.4.0 modułu konfiguracja metod płatności nie jest już dostępna w module. Moduł w wersji 3.5.0 z października 2026 r. dodaje konfigurację szacowanego czasu dostawy. Integrację wysyłkową w PrestaShop opisujemy w poradniku InPost w PrestaShop.

[#uwaga] Jeśli Twój szablon PrestaShop jest mocno zmodyfikowany, domyślne haki mogą nie wyświetlać przycisku we właściwym miejscu. Dokumentacja przewiduje dodatkowe haki modułu, które wymagają ręcznego dodania wywołania w plikach szablonu – to zadanie dla osoby, która zna strukturę motywu.

Wdrożenie w Magento i w Shoperze

Dla Magento dokumentacja podaje wymagania: PHP od 8.2, Composer od 2.2 oraz wymagania Adobe dla danej wersji Magento; w historii zmian wskazuje obsługę Magento od 2.4.6. Przy aktualizacjach zmieniających strukturę bazy danych trzeba uruchomić polecenie aktualizacji Magento. Wtyczka pozwala też wysyłać część danych asynchronicznie z użyciem kolejek, co wymaga poprawnej konfiguracji mechanizmu kolejek w sklepie.

W Shoperze wdrożenie jest najprostsze. Według FAQ InPost Pay sklep wypełnia formularz w panelu, InPost Pay weryfikuje zgłoszenie, a następnie integracja zostaje aktywowana – bez instalowania modułu. Jeśli zamówienia z Shopera trafiają do systemu do obsługi sprzedaży, sprawdź, jak wyglądają w nim zamówienia z InPost Pay; integrację opisujemy w artykule BaseLinker Shoper.

Statusy zamówień i dalsza obsługa

Zamówienia z InPost Pay trafiają do sklepu ze statusem, który wybierasz w konfiguracji – osobno dla zamówień opłaconych i za pobraniem, a w PrestaShop także dla statusu początkowego. Dobrze, żeby te statusy pasowały do reszty procesu: jeśli magazyn pakuje zamówienia ze statusem „opłacone”, zamówienia z InPost Pay powinny trafiać dokładnie tam. Dokumentacja WooCommerce zaleca też sprawdzenie, czy słownik statusów jest zgodny z tym, co sklep pokazuje klientom w komunikacji.

Jeśli zamówienia ze sklepu przechodzą dalej do systemu do obsługi sprzedaży, zamówienia z InPost Pay obsługujesz tak samo jak pozostałe – z automatycznym tworzeniem przesyłek i etykiet. Nadawanie InPost z panelu Base opisujemy w poradniku BaseLinker InPost. Ważne, żeby numer utworzonej przesyłki wracał do zamówienia w sklepie – inaczej wtyczka nie przekaże go do InPost Pay.

Przekazywanie numeru paczki

Przekazywanie numeru paczki jest w dokumentacji elementem obowiązkowym, a w praktyce najłatwiej o nim zapomnieć, bo dzieje się już po zakupie. Jeśli przesyłki tworzysz we wtyczce InPost w sklepie, numer zwykle trafia do zamówienia automatycznie. Jeśli tworzysz je poza sklepem – w Managerze Paczek, systemie do obsługi sprzedaży albo własnej integracji z API ShipX – zaplanuj, jak numer wróci do zamówienia. Integrację z API opisujemy w artykule ShipX API InPost.

Zgody, ciasteczka i dane analityczne

InPost Pay działa na styku sklepu i aplikacji, więc zgody i ciasteczka mają znaczenie. W konfiguracji dodajesz zgody wymagane w sklepie, które klient zobaczy w aplikacji. Moduł PrestaShop ma opcjonalny przełącznik przekazywania danych analitycznych – według dokumentacji zapisuje on identyfikatory kampanii i identyfikator użytkownika z narzędzi analitycznych i przypisuje je do koszyka. Przed włączeniem tej opcji sprawdź, czy jest zgodna z polityką prywatności sklepu i ustawieniami zgód.

Testy przed uruchomieniem

Testy warto zaplanować jak scenariusze zakupowe, a nie jedno kliknięcie. Najlepiej spisać je w prostym arkuszu i odhaczać kolejne przypadki na komputerze i telefonie. Każdy scenariusz kończy się zamówieniem w sklepie – z właściwym statusem, metodą dostawy i punktem odbioru.

• Zakup z karty produktu – utworzenie koszyka w aplikacji i finalizacja zakupu.

• Zakup z koszyka – kilka produktów, kod rabatowy, różne warianty.

• Płatność przy odbiorze – jeśli sklep ją oferuje: właściwy status zamówienia.

• Kurier i Paczkomat – ceny i dostępność zgodne z metodami wysyłki w sklepie.

• Strona podziękowania – widget widoczny na górze strony potwierdzenia.

• Numer paczki – po utworzeniu przesyłki numer wraca do zamówienia i trafia do InPost Pay.

[#przyklad] Sklep z akcesoriami na WooCommerce dostał dane do sandboxu, zainstalował wtyczkę i ustawił widget tylko dla testerów. Przez tydzień zespół składał zamówienia testowe przez testową aplikację – z kodami rabatowymi, pobraniem i obiema metodami dostawy. Okazało się, że wtyczka do zgód blokowała ciasteczka InPost Pay, a cena kuriera w aplikacji nie uwzględniała darmowej dostawy od progu. Po poprawkach sklep przełączył środowisko na produkcję i udostępnił przycisk wszystkim.

Kto powinien przeprowadzić wdrożenie

W Shoperze aktywację przeprowadzi właściciel sklepu – to kwestia formularza i weryfikacji. W WooCommerce i PrestaShop podstawową konfigurację zrobi osoba obeznana z panelem, ale przy niestandardowym motywie, ręcznych hakach w szablonie, wtyczkach cache i zgód przyda się programista. W Magento wdrożenie praktycznie zawsze wymaga osoby technicznej – instalacja przez Composer, aktualizacje bazy i konfiguracja kolejek to zadania dla administratora sklepu. Niezależnie od platformy warto wyznaczyć jedną osobę odpowiedzialną za testy i późniejsze aktualizacje wtyczki.

Po uruchomieniu – utrzymanie i zwroty

Wtyczki InPost Pay są często aktualizowane – historia zmian w dokumentacji pokazuje kolejne wersje co kilka tygodni. Aktualizuj je regularnie, ale najpierw na kopii sklepu albo w sandboxie, zwłaszcza przy niestandardowych motywach i dodatkach do koszyka. Dokumentacja ma też osobny rozdział o zwrotach i podglądzie transakcji – według FAQ zwroty obsługuje sklep standardowo, a klient nie anuluje zamówienia w aplikacji. Usługi zwrotów InPost dla sklepów opisujemy w artykule Szybkie Zwroty InPost.

[#checklista] Wdrożenie InPost Pay: współpraca logistyczna z InPost; dane do sandboxu z formularza; testowa aplikacja InPost Mobile; wtyczka zgodna z wersją platformy; środowisko Sandbox i widget tylko dla testerów; statusy zamówień; powiązanie metod dostawy; zgody i ciasteczka; przycisk na karcie produktu i w koszyku; strona podziękowania; przekazywanie numeru paczki; scenariusze testowe; dane produkcyjne z panelu merchanta; plan aktualizacji.

Najczęściej zadawane pytania

Skąd wziąć dane dostępowe do InPost Pay?

Według dokumentacji dane do sandboxu otrzymujesz po wypełnieniu formularza kontaktowego InPost Pay, a dane produkcyjne – Client ID, Client Secret, POS ID i Merchant Client ID – generujesz w panelu merchanta InPost.

Jak testować InPost Pay, żeby klienci nie widzieli przycisku?

Ustaw wyświetlanie widgetu tylko dla testerów. Według dokumentacji widget pojawi się wtedy po dodaniu do adresu sklepu parametru showIzi=true.

Jakie elementy są obowiązkowe?

Dokumentacja wymienia przycisk na stronie produktu, przycisk na stronie koszyka, stronę podziękowania i przekazywanie numeru paczki.

Jakie wersje WooCommerce i PrestaShop są obsługiwane?

Według dokumentacji wtyczki WooCommerce: WooCommerce od 7.0.0 i PHP od 7.4. Moduł PrestaShop 3.x obsługuje wersje 9.x, 8.x i od 1.7.6, a moduł 2.x – od 1.7.1 do 8.x.

Jak uruchomić InPost Pay w Shoperze?

Według FAQ przez formularz w panelu sklepu. InPost Pay weryfikuje zgłoszenie, a następnie integracja jest aktywowana.

Jak aktualizować moduł PrestaShop?

Dokumentacja ostrzega przed aktualizacją przez odinstalowanie i ponowną instalację – wtedy nie uruchamia się mechanizm aktualizacji. Aktualizację wykonuje się przez wgranie nowej wersji modułu.

Czy ceny dostawy w aplikacji mogą różnić się od cen w sklepie?

Nie powinny. Według dokumentacji WooCommerce metody dostawy w aplikacji wiąże się z metodami wysyłki w sklepie, żeby obowiązywały te same reguły dostępności i cen. Warto to sprawdzić w testach, zwłaszcza przy darmowej dostawie od progu.

Podsumowanie

Wdrożenie InPost Pay zaczyna się od danych do sandboxu i testowej aplikacji, a kończy na danych produkcyjnych z panelu merchanta i przycisku widocznym dla wszystkich klientów. W WooCommerce, PrestaShop i Magento instalujesz wtyczkę, w Shoperze aktywujesz natywną integrację. Kluczowe są elementy obowiązkowe – przyciski na stronie produktu i w koszyku, strona podziękowania i przekazywanie numeru paczki – oraz testy pełnych scenariuszy zakupowych. Jeśli dopiero zaczynasz wysyłki, zajrzyj do przewodnika InPost dla firm – jak zacząć.

Wdrażamy i obsługujemy wysyłki InPost – łączymy zamówienia z InPost Pay i pozostałych kanałów w jednym systemie, automatyzujemy tworzenie przesyłek i przekazywanie numerów paczek. Sprawdź naszą usługę wdrożenia Base i automatyzacji wysyłek.