InPost Pay - Woocommerce (Widget 2.0)
Wstęp
Dokumentacja techniczna wtyczki InPost Pay dla Woocommerce z obsługą Widget 2.0.
Wtyczka dodaje do sklepu Woocommerce funkcjonalność dokonywania zamówień przez aplikację InPost przez:
Dodanie tabeli w bazie danych,
Dodanie przycisku “Utwórz koszyk z InPost Pay” na karcie produktu,
Dodanie przycisku “Kup z InPost Pay” na stronie koszyka,
Dodanie przycisku “Kup z InPost Pay” na stronie zamówienia,
Akcji wykonywanych na standardowe hook’i,
Dodaniu pola na stronie zamówienia,
Dodaniu sekcji administracyjnej,
Udostępnienia REST API,
Dołączenia do strony pliku JS serwowanego z webserwera oraz pliku serwowanego z zasobu zewnętrznego.
Wtyczka: 08.04.2026r - 2.0.7.2
Changelog
Na tej stronie:
- 1.1 Wstęp
- 1.2 Changelog
- 1.3 Wymagania
- 1.4 Konfiguracja konta Merchanta - środowisko sandbox
- 1.5 Wymagania techniczne po stronie Merchanta
- 1.6 Konfiguracja konta Merchanta - środowisko produkcyjne
- 1.7 Instalacja / Aktualizacja
- 1.8 Konfiguracja Testowa
- 1.9 Konfiguracja Produkcyjna
- 1.10 Instrukcja konfiguracji ciasteczek funkcjonalnych dla wtyczek cookie w sklepie WooCommerce z InPostPay
- 1.11 Produkty promowane
- 1.12 Produkty sugerowane
- 2 Produkty wykluczone
- 2.2 Jak wykluczyć kategorie?
- 2.3 Wtyczka logistyczna
- 2.4 Obsługa produktów cyfrowych i dostaw elektronicznych
- 2.5 Pełna konfiguracja
- 2.5.1 Ustawienia API
- 2.5.2 Środowisko
- 2.5.3 Pokazuj widget
- 2.5.4 Client ID
- 2.5.5 Client Secret
- 2.5.6 POS ID
- 2.5.7 Merchant ID
- 2.5.8 Włącz płatności zgodne z podpisaną umową z bankiem
- 2.5.9 Włącz płatność przy odbiorze zgodnie z podpisaną umową z InPost
- 2.5.10 Wybierz dostępne metody płatności w aplikacji
- 2.5.11 Wirtualna metoda płatności
- 2.5.12 Status zamówienia dla zamówienia opłaconego przez InPost Pay
- 2.5.13 Status zamówień
- 2.5.14 Maksymalna liczba produktów sugerowanych
- 2.5.15 Niestandardowa strona podziękowania (opcjonalne)
- 2.5.16 Ustawienia przekazywanych opisów
- 2.5.17 Odśwież stronę po dodaniu produktu do koszyka
- 2.5.18 Format odpowiedzi
- 2.5.19 Wczesna odpowiedź aktualizacji koszyka (pominięcie hooka shutdown)
- 2.5.20 Dodatkowe akcje WooCommerce dla zamówień i koszyka
- 2.6 Zgody
- 2.6.1 Adres zgody
- 2.6.2 Identyfikator linku
- 2.6.3 Tekst linku
- 2.6.4 Opisy widoczne w aplikacji
- 2.6.5 Czy wymagane
- 2.7 Kupony InPost Pay
- 2.8 Koszt transportu
- 2.8.1 Wybierz metody dostawy
- 2.8.2 Mapuj z metodą wysyłki
- 2.8.3 Włącz lub wyłącz opcje dostawy
- 2.8.4 Sposób obliczania ceny dla dodatkowej opcji dostawy
- 2.8.4.1 Mapuj z metodą wysyłki (dla opcji dostawy)
- 2.8.4.2 Dodatkowa prowizja
- 2.8.5 Dostępne od
- 2.8.6 Dostępne do
- 2.8.7 Ograniczenie dostawy Paczkomatem dla paczek powyżej 25kg
- 2.9 Wygląd przycisków
- 2.9.1 Tło
- 2.9.2 Wariant
- 2.9.3 Zaokrąglenie
- 2.9.4 Widget size
- 2.9.5 Wyświetlaj
- 2.9.6 Umiejscowienie
- 2.9.7 Położenie
- 2.9.8 Margines
- 2.10 Marketing
- 2.11 Wsparcie
- 2.12 Analityka reklamowa (GA4, Meta Ads, Google Ads)
- 2.13 Wsparcie dla niestandardowych numerów zamówień (aliasów)
- 2.14 Filtr przesyłek dla InPost Pay
- 2.14.1 Przykłady scenariuszy
- 2.14.2 Wskazówki i uwagi
- 2.15 Wyświetlanie w niestandardowym miejscu
- 2.16 Programowalne akcje
- 2.17 Blokowanie ładowania widgetu InPost Pay przed wyrażeniem zgody
- 2.18 Dodawanie widgetu InPost Pay za pomocą Elementora
- 2.19 Dodawanie widgetu InPost Pay za pomocą bloków Gutenberga
- 2.20 Dezinstalacja
Wymagania
Do poprawnego działania wtyczka wymaga:
Woocommerce w wersji nie niższej niż 7.0.0
PHP w wersji nie niższej niż 7.4
Aby uzyskać szczegółowe informacje techniczne dotyczące wtyczki InPost Pay dla WooCommerce, prosimy zapoznać się z artykułem Specyfikacja techniczna - InPost Pay Plugin. Ponadto, dla zapewnienia pełnej kompatybilności zapraszamy do sprawdzenia listy kompatybilnych wtyczek w Kompatybilne wtyczki - InPost Pay WooCommerce.
Konfiguracja konta Merchanta - środowisko sandbox
Aby uzyskać dostęp do środowiska Sandbox uzupełnij i wyślij formularz kontaktowy wybierając opcję “Sklep internetowy” oraz zakładkę “Sandbox”.
Aplikacja testowa InPost Mobile
Aplikację InPost Mobile Sandbox zainstaluj korzystając z instrukcji dostępnej pod linkiem
Aplikacja testowa InPost Mobile.
Chcesz testować na środowisku lokalnym?
W celu zapewnienia zdalnego dostępu do środowiska lokalnego, konieczne jest zastosowanie dodatkowego rozwiązania w postaci tunelowania ruchu z publicznej domeny na lokalny adres. Bez takiego obejścia nie ma możliwości bezpośredniego połączenia się z lokalnym środowiskiem.
Rekomendowane rozwiązanie
Aktualnie zalecanym narzędziem jest ngrok, który umożliwia szybkie skonfigurowanie tunelu między publicznym adresem URL a lokalnym środowiskiem. Wystarczy darmowe konto, które zapewnia jedną stałą domenę publiczną. Ta domena może przekierowywać ruch do lokalnej aplikacji lub zamkniętego środowiska testowego.
Wymagania
Po utworzeniu darmowej domeny publicznej należy przekazać jej adres w formularzu Kontakt -> Sandbox, aby otrzymać credentiale i cały ruch testowy mógł być kierowany na ten adres.
Wymagania techniczne po stronie Merchanta
Ruch wychodzący od InPost do Merchanta dla IP Proxy InPost 34.118.93.24, 34.116.145.216.
Konfiguracja konta Merchanta - środowisko produkcyjne
Aby uzyskać dostęp do środowiska Produkcyjnego, zapoznaj się z instrukcją dostępną pod linkiem
Konfiguracja konta Merchanta - środowisko produkcyjne
Aby wdrożenie przebiegło sprawnie, przygotowaliśmy listę kluczowych kroków, które pomogą Wam szybko rozpocząć integracji swojego sklepu z InPost Pay Checklista implementacji InPost Pay.
Zapoznaj się z przewodnikiem poprawnej implementacji
W przewodniku znajdziesz obowiązkowe standardy oraz dodatkowe miejsca, gdzie InPost Pay może być widoczny. Wybierz te, które najlepiej pasują do Twojego sklepu. Szczegóły znajdziesz w sekcji Standardy implementacji InPost Pay.
Przycisk na stronie produktu (obowiązkowe)
Przycisk na stronie koszyka (obowiązkowe)
Strona podziękowania (obowiązkowe)
Przekazywanie numeru paczki (obowiązkowe)
W rozdziale Zwroty i podgląd transakcji w InPost Pay znajdziesz informacje jak obsługiwać zwroty i jak śledzić transakcje realizowane za pośrednictwem InPost Pay. Znajdziesz tutaj także informacje o integracji z API, które pozwala na pełną automatyzację tych procesów w Twoim systemie.
Instalacja / Aktualizacja
W celu instalacji wtyczki postępuj zgodnie z poniższymi krokami:
Pobierz spakowaną wtyczkę Woocommerce ze strony InPost i nie rozpakowuj jej
Zaloguj się do sekcji administracyjnej swojego sklepu
Z menu po lewej stronie wybierz “Wtyczki” a następnie “Dodaj nową”
Na górze strony wybierz “Wyślij wtyczkę na serwer” następnie “Wybierz plik” i odszukaj spakowaną wtyczkę pobraną w punkcie 1
Kliknij “Zainstaluj”
W następnym oknie kliknij “Włącz wtyczkę”
W celu aktualizacji wtyczki postępuj zgodnie z powyższymi krokami. Przy aktualizacji wtyczki ustawienia nie kasują się.
W przypadku pierwszej instalacji wtyczki na sklepie działającym na PHP 8.x, po jej aktywacji należy przejść do zakładki Ustawienia, wybrać odpowiednie Środowisko, a następnie zapisać zmiany.
Konfiguracja Testowa
W tym rozdziale opisujemy skrócony proces konfiguracji potrzebny do przeprowadzenia testów działania integracji z InPost Pay. W celu wstępnej konfiguracji przejdź do sekcji administracyjnej sklepu i kliknij “InPost Pay” w menu po lewej stronie. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki. Wypełnij pola zgodnie z poniższą listą:
Wybierz środowisko i opcje wyświetlania
a. Środowisko ustaw na “Sandbox” - w ten sposób przetestujesz proces zakupowy na środowisku testowym.
b. Pokazuj widget ustaw na “Testerom” - w ten sposób widget będzie widoczny tylko dla osób, które mają go zobaczyć. Ustawienie innej opcji wyświetli widget działający bądź nie wszystkim osobom odwiedzającym Twój sklep.
W celu wyświetlenia widgetu w przeglądarce internetowej wpisz adres Twojego sklepu z dopiskiem ?showIzi=true
Przykład: https://mojsklep.pl?showIzi=true
Wypełnij dane dostępowe do API, które otrzymałeś od InPost w polach
a. Client ID
b. Client Secret
Pole POS ID wypełnij zgodnie z wartością otrzymaną od InPost
Pole Merchant ID wypełnij zgodnie z wartością otrzymaną od InPost
Włącz możliwość płatności
Wybierz status zamówienia, jakie zostanie nadane zamówieniom opłaconym poprzez InPost Pay oraz jakie zostanie nadane zamówieniom za pobraniem.
Sprawdź czy słownik statusów zamówień jest zgodny z tym, co rzeczywiście prezentujesz w komunikacji klientom. Sekcja ta wykorzystywana jest w sklepach, które mają nietypowy proces zakupowy. Sekcja ta będzie różna w różnych sklepach bo przedstawia statusy w Twoim sklepie.
Wpisz ile produktów sugerowanych chcesz prezentować w aplikacji InPost. Szczegółowy opis działania tego mechanizmu opisany jest w rozdziale Produkty sugerowane.
Dodaj zgody, które będą wymagane w Twoim sklepie. Szczegółowy opis każdej z opcji znajdziesz w rozdziale Pełna Konfiguracja.
Określ, które wysyłkowe metody bazowe, wspiera proces zakupowy Twojego sklepu.
Połącz wysyłkę Kurierem z wysyłką systemową. Po wybraniu z listy rozwijalnej sposobu wysyłki te same reguły dostępności i cen dla wybranej metody będą obowiązywać dla wysyłki Kurierem w aplikacji InPost.
Tę część w podstawowej konfiguracji możesz pominąć. Określa ona ceny dodatkowych opcji wysyłki dla opcji Kurier. Pełny opis znajdziesz w rozdziale Pełna Konfiguracja.
Połącz wysyłkę przez Paczkomat z wysyłką systemową. Po wybraniu z listy rozwijalnej sposobu wysyłki te same reguły dostępności i cen dla wybranej metody będą obowiązywać dla wysyłki Paczkomat w aplikacji InPost.
Tę część w podstawowej konfiguracji możesz pominąć. Określa ona ceny dodatkowych opcji wysyłki dla opcji Paczkomat - Paczka w Weekend oraz płatności przy odbiorze oraz dni i godziny między którymi te opcje będą dostępne dla Twoich klientów. Pełny opis znajdziesz w rozdziale Pełna konfiguracja.
Tę część w podstawowej konfiguracji możesz pominąć. Określa ona czy dostępność metod wysyłki ma być dodatkowo sprawdzana dla produktów w koszyku na podstawie szczegółowych ustawień wtyczki logistycznej InPost. Pozostaw tę opcję wyłączoną, jeżeli nie korzystasz z oficjalnej wtyczki logistycznej InPost.
Określ gdzie widget powinien być dostępny na Twojej stronie. Możesz wyświetlać go na karcie produktu oraz w koszyku. Dla każdego miejsca wyświetlania możesz określić, do której strony przycisk InPost Pay będzie wyrównany. Dla każdego miejsca możesz osobno wybrać, czy tło na stronie jest jasne czy ciemne co zapewnia poprawne wyświetlanie tekstów. Dla każdego miejsca możesz oddzielnie wybrać wariant wyświetlania. Przycisk może być czarny bądź żółty. Całość konfiguruje się w zakładce “Wygląd przycisków”.
Konfiguracja Produkcyjna
Po poprawnej konfiguracji testowej i upewnieniu się, że integracja w środowisku Sandbox działa należy udostępnić InPost Pay wszystkim użytkownikom.
W celu konfiguracji przejdź do listy modułów i kliknij “Konfiguruj” obok modułu InPpost Pay. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki.
Zmień konfigurację zgodnie z poniższą listą:
Wybierz środowisko i opcje wyświetlania
a. Środowisko ustaw na “Produkcyjne” - w ten sposób podczas składania zamówień będą wykonywane produkcyjne płatności
b. Pokazuj widget ustaw na “Każdemu” - w ten sposób widget będzie widoczny dla wszystkich klientów sklepu.
Uzupełnij pola Client ID, Client Secret, POS ID oraz Merchant ID wartościami pobranymi z panelu merchanta. Pełną instrukcję generowania danych dostępowych do API dla środowiska produkcyjnego znajdziesz tutaj.
Instrukcja konfiguracji ciasteczek funkcjonalnych dla wtyczek cookie w sklepie WooCommerce z InPostPay
Jeśli na Twoim sklepie WooCommerce zintegrowanym z InPostPay występują wtyczki do zarządzania ciasteczkami, należy dodać odpowiednie ciasteczka funkcjonalne. Poniższa instrukcja dotyczy konfiguracji popularnych wtyczek cookie.