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
Wersja 2.0.9 (29.05.2026)
Changelog
Na tej stronie:
- 1.1 Wstęp
- 1.2 Wtyczka
- 1.2.1 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 Buforowanie wyjścia podczas tworzenia zamówienia (tryb awaryjny)
- 2.5.21 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