/
InPost Pay - Woocommerce (Widget 2.0)

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: 10.02.2026r - 2.0.5.3

 

Changelog

  • 10.02.2026 - 2.0.5.3

    • Poprawa tworzenia sesji dla koszyka InPostPay. Wdrożenie zmian w procesie generowania sesji, zapewniających poprawne funkcjonowanie koszyka.

    • Poprawa odczytywania form dostawy dla Flexible Shipping (w przypadku braku koszyka). Optymalizacja logiki odczytu form dostawy, aby system poprawnie działał w scenariuszu braku aktywnego koszyka.

    • Dodano filtr przesyłek dla InPost Pay

  • 18.12.2025 - 2.0.5.1

    • Naprawiono emisję zdarzeń koszyka i poprawiono stabilność integracji

    • Naprawiono konflikt z Breakdance Builderem poprzez wyłączenie inicjalizacji InPost Pay w trybie edycji

    • Naprawiono rejestrację bloków (nieprawidłowe ścieżki oraz brak block.json)

    • Usunięto ostrzeżenia PHP

    • Sprawdzenie czy email jest włączony/wyłączony w ustawieniach Woocommerce

    • Usunięto ostrzeżenie "Array to string conversion" na stronie produktu

  • 27.11.2025 - 2.0.5

    • Przebudowano obsługę sesji użytkownika w celu eliminacji błędu zapamiętywania danych z poprzednich sesji

    • Wdrożono nowy mechanizm zarządzania identyfikatorami koszyka z pełnym resetem po zakończeniu sesji

    • Ujednolicono logikę przechowywania danych sesyjnych między środowiskami, co zapobiega przenoszeniu koszyków między użytkownikami

    • Wprowadzono trwałe mapowanie danych sesyjnych w bazie, aby poprawić stabilność i bezpieczeństwo działania widgetu

    • Dodano obsługę race condition przy równoległych zapisach i aktualizacjach koszyka

    • Zintegrowano obsługę z centralnym kontenerem usług (Pimple), zapewniając spójność działania modułu

    • Zoptymalizowano logikę sesyjną i mechanizmy cache’owania, ograniczając liczbę zapytań do bazy danych do minimum

    • Naprawiono błąd 404 w konsoli - usunięto przestarzałe ładowanie skryptu odwołujące się do nieistniejącego pliku.

    • Naprawiono błąd powodujący znikanie widżetu po AJAX-owej aktualizacji koszyka.

    • Naprawiono błąd, w którym widget InPost Pay nie wyświetlał się na stronie produktu z powodu nieaktualnej logiki sprawdzania dostępności metod dostawy.

    • Naprawiono obsługę aliasów zamówień, zapisując zawsze prawdziwy identyfikator order_id, co eliminuje problem blokowania realizacji zamówień w aplikacji.

    • Naprawiono kalkulację podsumowania zamówienia WooCommerce, dodając uwzględnianie dopłat z delivery_options (w tym opłaty COD) w finalnej cenie zamówienia.

    • Usunięto ostrzeżenie Undefined array key 0 w WooDeliveryPrice, które pojawiało się w stopce koszyka przy zmapowanych metodach wysyłki.

    • Naprawiono mechanizm naliczania kosztów dostawy, który w określonych konfiguracjach powodował błędne uznawanie dostawy za darmową po zastosowaniu kodu rabatowego.

    • Dodano obsługę atrybutów produktu w formacie string, eliminując błąd 500 przy dodawaniu do koszyka.

    • Naprawiono błąd powodujący brak automatycznego rozparowania koszyka po złożeniu zamówienia w sklepie WooCommerce.

    • Dodano pełną obsługę REST requestów w API wtyczki, aby uniemożliwić wstrzykiwanie kodu HTML/CSS przez inne wtyczki i zapewnić zwracanie poprawnych odpowiedzi JSON.

    • Usunięcie zduplikowanej konfiguracji miejsca wyświetlania przycisku z ustawień "Strona zamawiania"

    • Dodanie wirtualnej metody płatności

    • Naprawa wysyłki email dla zamówień realizowanym za pośrednictwem InPost Pay

  • 05.11.2025 - 2.0.4.1

    • Dodano mechanizm automatycznego rozłączania koszyka z aplikacją InPost Pay podczas wylogowania użytkownika

    • Dodano kompletny moduł zbierania i eksportu logów z wtyczki

    • Wprowadzono możliwość pobrania pełnych danych diagnostycznych w formie archiwum ZIP bezpośrednio z panelu administracyjnego

    • Dodano zbieranie logów WooCommerce z wybranego dnia

    • Dodano eksport pełnej konfiguracji wtyczki do raportu diagnostycznego

    • Dodano zbieranie informacji o środowisku systemowym (WordPress, PHP, WooCommerce)

    • Rozszerzono zakres raportu o listę zainstalowanych i aktywnych wtyczek, aby ułatwić analizę środowisk w przypadku błędów z integracją

    • Dodano awaryjny shortcode [inpost_thank_you] umożliwiający wyświetlenie strony podziękowania bez konieczności modyfikacji motywu

    • Dodano w ustawieniach InPost Pay pole wyboru strony, która ma być renderowana po złożeniu zamówienia

    • Poprawiono logikę rozpoznawania produktów cyfrowych w koszyku

    • Naprawiono błąd blokujący metody dostawy APM i COURIER przy produktach fizycznych w koszyku z produktami cyfrowymi

    • Zmodyfikowano kalkulację kosztów dostawy - produkty cyfrowe nie wpływają na ceny metod fizycznych

  • 01.10.2025 - 2.0.4

    • Dodano obsługę blockowego checkoutu WooCommerce - pełna kompatybilność z koszykiem i checkoutem w wersji blokowej oraz klasycznej

    • Dodano obsługę bloków Gutenberga - przycisk InPost Pay dostępny jako blok do wstawienia na stronie

    • Dodano obsługę błędów w przypadku powiązania koszyka z produktami martwymi (upsell/cross-sell)

    • Dodano nową opcję w ustawieniach: “Odśwież stronę po dodaniu produktu do koszyka” - domyślnie włączoną; umożliwia konfigurację przeładowania strony po dodaniu produktu do koszyka poprzez widget

    • Poprawiono działanie przycisku “Usuń wszystkie” na widoku z Hot Produktami - w przypadku braku danych w API usuwa także dane wewnętrzne, co zapobiega błędom

    • Uproszczono walidację pola EAN - usunięto weryfikację sumy kontrolnej, pozostawiono sprawdzenie długości (12-13 cyfr) i formatu numerycznego

    • Naprawiono błąd u zalogowanych użytkowników - wtyczka mogła tworzyć nowy identyfikator koszyka zamiast używać istniejącego, co powodowało rozjazd i puste koszyki

    • Naprawiono błąd wykrywania metod dostawy - znormalizowano identyfikatory stawek, co eliminuje problemy z sufiksami

    • Zmieniono sposób przygotowania paczki do kalkulacji wysyłki - przekazywane są pełne dane (wartość, koszty, kupony, użytkownik, adres), co zapewnia zgodność z Flexible Shipping i innymi wtyczkami

    • Rozwiązano konflikt nazw globalnych obiektów JavaScript, aby uniknąć nadpisywania przez inne wtyczki

    • Poprawiono wszystkie tłumaczenia w panelu ustawień oraz błąd związany ze zbyt szybkim ładowaniem tłumaczeń

    • Naprawiono błąd zapisu podatku od wysyłki - tax_rate_id jest teraz prawidłowo przypisywane, co umożliwia poprawne mapowanie VAT

  • 01.09.2025 - 2.0.3

    • Dodano sekcje per strefa w panelu admina oraz osobne selecty z metodami tylko z danej strefy.

    • Dodano zakładki “Unavailable Products” i “Unavailable Categories” działające na tej samej zasadzie co Hot Products, natomiast służące do wykluczania produktów i kategorii

    • Dodano mechanizm wykrywania zmiany waluty

    • Dodano obsługę produktów cyfrowych i dostaw elektronicznych, wraz z wykrywaniem produktów cyfrowych w zamówieniach mieszanych

    • Dodano obsługę pola EAN w starszych wersjach WooCommerce (< 9.1) poprzez fallback do popularnych metapól EAN, co umożliwia działanie InPost Pay także w starszych sklepach

    • Dodano możliwość blokowania automatycznego ładowania widgetu InPost Pay przed wyrażeniem zgody - ładowanie skryptów przeniesiono do nazwanej metody podłączonej pod wp_enqueue_scripts, co pozwala merchantom łatwo wyłączyć inicjalizację widgetu np. w zależności od systemu zgód.

    • Dodano przełącznik Używaj nowoczesnego formatu odpowiedzi (zalecane), umożliwiający powrót do poprzedniego trybu; domyślnie włączony.

    • Dodano obsługę nowych typów kuponów: fixed_cart (rabat kwotowy na koszyk), fixed_product (kwotowy na produkt) oraz percent_product (procentowy na produkt - wstecznie kompatybilny).

    • Dodano obsługę darmowej wysyłki aktywowanej przez kupon (free_shipping)

    • Zmieniono sposób przygotowywania odpowiedzi w koszyku i podczas tworzenia zamówienia - nowoczesny, zgodny ze standardami WooCommerce format, lepsza kompatybilność z funkcjami sklepu.

    • Uporządkowano strukturę danych i ujednolicono proces ich przekształcania (mapowanie), co zwiększa spójność i jakość odpowiedzi.

    • Naprawiono błąd: obecność produktu innego niż prosty powodowała brak zapisu całej puli; teraz produkty proste są dodawane, a wariantowe/grupowe trafiają do listy rejected.

    • Po przełączeniu na walutę inną niż PLN następuje rozparowanie koszyka z aplikacją: ukrycie widgetu i odłączenie bez trwałego nadpisywania identyfikatorów.

    • Wprowadzono automatyczne przywracanie powiązania koszyka po powrocie do PLN oraz wysyłki zaktualizowanych danych do aplikacji.

    • Zablokowano możliwość nadpisania koszyka w aplikacji, gdy sklep działa w walucie ≠ PLN

    • Naprawiono znikanie metod po zalogowaniu (różne ID tej samej metody w różnych strefach) - zwracana jest wyłącznie metoda zmapowana dla bieżącej strefy.

    • Uporządkowano przeliczanie dostaw i cen - spójna lista metod oraz kosztów także przy wywołaniach z aplikacji mobilnej (bez aktywnej sesji).

    • Poprawiono warunek sprawdzający nagłówek HTTP_ACCEPT podczas ładowania skryptów widgetu, dodając isset() w celu uniknięcia błędu Undefined array key w integracjach REST/API bez tego nagłówka.

    • Zmieniono logikę walidacji produktów dodawanych do koszyka - usunięto ograniczenie wynikające z ustawień widoczności katalogowej.

    • Naprawiono błąd zawyżania kwoty VAT w zamówieniach, gdy metoda dostawy była ustawiona jako nieopodatkowana

    • Poprawiono nazwę kolumny w cart_session

    • Ujednolicono logikę wyliczania progów darmowej dostawy w obiektach delivery i delivery_related_products

    • Dodano tymczasowe obejście błędu po stronie Elementor Pro, który powodował wyświetlanie alertu undefined po dodaniu produktu do koszyka

    • Usunięto logi związane z rejestracją wirtualnej strony “Thank You Page”.

  • 17.07.2025 - 2.0.2.1

    • Dodano domyślne dane adresowe. W przypadku ich braku zostaną zawsze uzupełnione aby poprawnie zbudować odpowiedź

    • Usunięto limit liczby produktów Hot Products po stronie wtyczki - walidacja odbywa się teraz wyłącznie po stronie aplikacji InPost Pay, a limit jest ustawiony po stronie aplikacji mobilnej InPost Pay.

    • Dodano walidację EAN-13 przy dodawaniu produktów do listy Hot Products - produkty bez poprawnego EAN są automatycznie usuwane lub nie mogą zostać dodane; usuwane są także powiązane metadane

    • Dodano obsługę niestandardowego nonce wymaganego przez wtyczkę BLPaczka, co eliminuje błąd „Security check failed” podczas tworzenia zamówienia w InPost Pay

    • Zmieniono sposób obsługi błędów - produkty nie są zapisywane lokalnie, jeśli wystąpi przekroczenie limitu

    • Poprawiono listowanie Hot Products

    • Poprawiono sposób filtrowania metod dostawy - zamiast sprawdzania pełnego ID, identyfikujemy typ dostawy na podstawie prefixu

    • Dodano integrację z wtyczkami Polylang oraz WPML – „InPost Thank You Page” jest teraz poprawnie rejestrowana we wszystkich wersjach językowych

    • Poprawiono rejestrację „InPost Thank You Page” w przypadkach, gdy sklep korzysta z niestandardowej ścieżki URL

    • Naprawiono błąd umożliwiający wielokrotne powiązanie tego samego koszyka i zamówienia (basket_id i order_id) w aplikacji mobilnej

    • Naprawiono błąd podwójnego naliczania VAT dla dostawy - dodano tolerancję 0.5 pp przy dopasowywaniu stawek VAT, co zapobiega błędnemu przeliczaniu kosztu wysyłki

    • Poprawiono przypisywanie VAT do kosztów wysyłki

    • Naprawiono błąd powodujący nieprawidłowe działanie metod płatności - usunięto duplikowanie opcji CASH_ON_DELIVERY, co mogło blokować wyświetlanie lub finalizację płatności w aplikacji

    • Dodano obsługę product_link w API /v1/izi/products - link do produktu jest teraz przekazywany i aktualizowany automatycznie po zmianie w WooCommerce

    • Naprawiono błąd „smallSize is marked non-null but is null” - do additional_product_images trafiają teraz tylko kompletne dane obrazów, puste wpisy są pomijane

    • Dodano obsługę produktów typu grouped – rozwiązano problem błędu „Produkt nie może zostać zakupiony” przy próbie dodania zestawu do koszyka z aplikacji

  • 18.06.2025r - 2.0.2.1

  • 03.06.2025 -2.0.2

    • Dodano obsługę analityki reklamowej dla `gclid`, `fbclid` oraz `client_id` (GA4) do zamówień tworzonych w InPost Pay.
      Szczegółowy opis w artykule: https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/1107361815

    • Dodano przekazywanie do aplikacji InPost Pay informacji o ograniczeniach metod dostawy dla poszczególnych produktów w koszyku - umożliwia to identyfikację, które produkty blokują konkretne opcje (np. paczkomat)

    • Dodano możliwość informowania aplikacji, czy dodanie produktu powiązanego odblokuje darmową dostawę

    • Dodano możliwość modyfikacji wyglądu widgetu InPost Pay w Elementorze - dostępne są opcje zmiany koloru tła i przycisku bezpośrednio w edytorze

    • Dodano możliwość ręcznego uruchamiania wybranych hooków WooCommerce po utworzeniu zamówienia (np. dla wtyczek afiliacyjnych)

    • Dodano wsparcie dla aliasów numerów zamówień (np. Custom Order Numbers) w komunikacji z InPost Pay

    • Naprawiono błąd uniemożliwiający wyświetlenie widgetu na stronie koszyka zbudowanej w oparciu o bloki Gutenberga - dodano obsługę nowych klas CSS

    • Naprawiono błąd uniemożliwiający złożenie zamówienia na produkt typu HotProduct bezpośrednio z aplikacji InPost Pay - poprawa nieprawidłowego cache’owania opisu, pustą atrybucję i błędy związane z sesją WooCommerce

    • Poprawiono wykorzystywanie zamaskowanego adresu e-mail podczas tworzenia przesyłki

    • Poprawiono wysyłkę wiadomości e-mail - klient otrzymuje teraz tylko jedno potwierdzenie zamówienia

    • Usunięto zbędny komponent, który obniżał poziom bezpieczeństwa

    • Zoptymalizowano komunikację z API InPost w celu zmniejszenia obciążenia stron

  • 15.05.2025 - 2.0.1.2

    • Naprawiono identyfikator koszyka (basket_id) podczas tworzenia nowego koszyka z Produktami promowanymi

  • 14.05.2025 - 2.0.1.1

    • Dodano możliwość wyboru konkretnych kuponów do przekazywania do aplikacji InPost Pay

    • Poprawiono błąd “dzielenia przez 0” podczas tworzenia zamówienia. Błąd pojawiał się, gdy w zamówieniu występowała darmowa wysyłka

    • Poprawiono formatowanie strony z podziękowaniem za zamówienie na wybranych szablonach. Dodano obsługę układu grid oraz integrację z motywami Astra

    • Zoptymalizowano i ustandaryzowano mechanizm uruchamiania sesji koszyka

    • Zablokowano możliwość ponownego złożenia zamówienia przy użyciu tego samego koszyka

    • Dodano obsługę odczytu istniejącego zamówienia w przypadku błędu przekazania go do aplikacji InPost Pay

    • Naprawiono błąd uniemożliwiający zwiększenie ilości produktu w aplikacji InPost Pay po aktualizacji do wersji 2.0.1

  • 29.04.2025 - 2.0.1

    • Dodano nową funkcjonalność „Hot Products” umożliwiającą wyróżnianie produktów w aplikacji mobilnej InPost Pay

    • Rozbudowano obsługę kuponów - dynamiczna widoczność kuponów w aplikacji Inpost Pay zależna od zawartości koszyka i warunków kuponu

    • Dodano integrację z wtyczką Elementor - widget Inpost Pay jest teraz dostępny w edytorze Elementor i umożliwia łatwe dodawanie przycisku

    • Dodano obsługę wtyczki LiteSpeed - wprowadzono odpowiednie atrybuty zapobiegające optymalizacji i cache’owaniu krytycznych skryptów Javascript, aby zapewnić prawidłowe działanie aplikacji Inpost Pay

    • Poprawiono formatowanie strony z podziękowaniem za zamówienie na wybranych szablonach. Dodano obsługę układu grid oraz integrację z motywami Astra

    • Dodano własny komunikat błędu w ustawieniach wtyczki Inpost Pay, wyświetlany nad przyciskiem “Zapisz” na każdej zakładce ustawień, w przypadku błędnie uzupełnionego formularza

    • Naprawiono nieprawidłowe wartości cenowe w mailach potwierdzających zamówienie - domyślna wysyłka maili WooCommerce została zablokowana dla zamówień z aplikacji Inpost Pay, a wysyłka następuje dopiero po pełnym zapisaniu zamówienia i odświeżeniu danych

    • Poprawiono obsługę błędów podczas finalizacji zamówienia

    • Poprawiono dostępność przycisku “Kup z Inpost Pay” - dodano obsługę screen readerów i nawigacji klawiaturą poprzez automatyczne nadawanie atrybutów ARIA

    • Wprowadzono walidację danych koszyka przy przywracaniu z cache

    • Poprawiono obsługę błędów podczas dodawania produktu do koszyka

  • 02.04.2025r - 2.0.0.1

  • 20.03.2025r - 2.0.0

    • Dodano integrację Widget 2.0

    • Wprowadzono obsługę dyrektywy Omnibus

    • Dodano nowe mapowanie metod wysyłki i wyliczanie kosztów dostawy

    • Dodano nowe pole "Merchant ID" w ustawieniach wtyczki dla poprawnego połączenia z API

    • Rozwiązano problemy z parowaniem widgetu z innym numerem telefonu

    • Naprawiono problem, w którym widget był w innym języku niż strona sklepu

    • Poprawiono walidację przycisku InPostPay na karcie produktu

    • Poprawiono logikę, która powodowała błędne wyświetlanie komunikatu „Produkt został dodany do koszyka” po usunięciu produktu

    • Przeprowadzono refactor obsługi kuponów – zgłoszone błędy oraz ujednolicenie kwot

    • Usunięto zduplikowane linki do zgód w aplikacji po aktualizacji ze starszej wersji wtyczki

    • Naprawiono błąd, przez który przycisk InPostPay znikał po kliknięciu na karcie koszyka

    • Ograniczono odświeżanie stron do minimum

    • Naprawiono błędy związane z dodawaniem kodu rabatowego

    • Usunięto pole "Czas opóźnienia SSE" - funkcja została zastąpiona bezpośrednią komunikacją nowego widgetu v2 z API Inpost

    • Usunięto pola "Szerokość przycisku", oraz "Wysokość przycisku" z zakładki "Wygląd przycisków"

    • Wprowadzono predefiniowane rozmiary widgetu, które zastępują ręczne ustawienia - możliwe do edycji za pomocą pola "Widget size" w zakładce "Wygląd przycisków"

Na tej stronie:

 

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:

  1. Pobierz spakowaną wtyczkę Woocommerce ze strony InPost i nie rozpakowuj jej

  2. Zaloguj się do sekcji administracyjnej swojego sklepu

  3. Z menu po lewej stronie wybierz “Wtyczki” a następnie “Dodaj nową”

  4. Na górze strony wybierz “Wyślij wtyczkę na serwer” następnie “Wybierz plik” i odszukaj spakowaną wtyczkę pobraną w punkcie 1

  5. Kliknij “Zainstaluj”

  6. 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ę.

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ą:

 

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

image-20240301-080218.png

 

  1. Wypełnij dane dostępowe do API, które otrzymałeś od InPost w polach
    a. Client ID
    b. Client Secret

image-20240301-080259.png

 

  1. Pole POS ID wypełnij zgodnie z wartością otrzymaną od InPost

image-20240301-080350.png

  1. Pole Merchant ID wypełnij zgodnie z wartością otrzymaną od InPost

    image-20250320-084348.png

  2. Włącz możliwość płatności

image-20240301-080424.png

  1. Wybierz status zamówienia, jakie zostanie nadane zamówieniom opłaconym poprzez InPost Pay oraz jakie zostanie nadane zamówieniom za pobraniem.

    image-20251105-103854.png

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

image-20240301-080542.png

  1. Wpisz ile produktów sugerowanych chcesz prezentować w aplikacji InPost. Szczegółowy opis działania tego mechanizmu opisany jest w rozdziale Produkty sugerowane.

image-20240301-080613.png

 

  1. Dodaj zgody, które będą wymagane w Twoim sklepie. Szczegółowy opis każdej z opcji znajdziesz w rozdziale Pełna Konfiguracja.

image-20241127-132602.png

  1. Określ, które wysyłkowe metody bazowe, wspiera proces zakupowy Twojego sklepu.

image-20250210-081109.png

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

image-20250210-082305.png

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

image-20250210-082351.png

 

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

image-20250210-084101.png

 

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

image-20250210-084250.png

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

image-20250210-130109.png

  1. 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”.

image-20240301-081824.png

 

 

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ą:

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

 

image-20240301-082337.png

 

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

 

Produkty promowane

Funkcjonalność wycofana z usługi InPost Pay.

Produkty sugerowane

Aplikacja InPost podczas dokonywania zakupów z InPost Pay sugeruje produkty do dodania do koszyka zgodnie z wbudowanym w WooCommerce systemem Produktów Powiązanych.

Jak wyświetlić produkty sugerowane w aplikacji?

W celu pokazania produktów sugerowanych należy uzupełnić sekcję Produktów Powiązanych w konfiguracji produktu WooCommerce.

W tym celu:

  1. Przejdź do edycji produktu w Twoim sklepie.

  2. W panelu Dane Produktu wybierz sekcję “Powiązane produkty”.

  3. Wypełnij sekcje “pu-sell” bądź “cross-sell” - produkty z obu sekcji będą widoczne w aplikacji.

 

 

Dlaczego na stronie widzę produkty sugerowane a w aplikacji nie?

Możliwe, że Twój sklep prezentuje produkty powiązane w niestandardowy sposób. Dzieje się tak na przykład przez to jak działa Twój szablon bądź jedna z zainstalowanych wtyczek. Jeśli Twój sklep prezentuje produkty sugerowane a nie widzisz ich w Aplikacji InPost upewnij się, że Produkty Powiązane są skonfigurowane zgodnie z instrukcją zawartą w akapicie powyżej.

Produkty wykluczone

Czym są Unavailable Products oraz Unavailable Categories?

Funkcjonalność produktów wykluczonych w ramach InPost Pay, to nowa zakładka wtyczki, dostępna z poziomu admina. Umożliwia wykluczenie wybranych produktów lub kategorii w celu ograniczenia ich dostępności dostawy w aplikacji mobilnej InPost Pay.

Jak wykluczyć produkty?

Wykluczanie produktów polega na wykluczeniu jego konkretnych metod dostawy.
Aby wykluczyć produkty w aplikacji mobilnej InPost Pay, wykonaj następujące kroki:

  1. Przejdź do zakładki InPost Pay -> Unavailable Products w panelu administracyjnym WooCommerce.

    image-20250901-113653.png

  2. Kliknij przycisk „Wybierz produkty”.

    image-20250901-113623.png

  3. W nowo otwartym oknie wybierz kategorię produktów — po rozwinięciu kategorii zobaczysz dostępne produkty.

    image-20250901-113746.png

  4. Zaznacz metody dostawy dla danego produktu, które chcesz wykluczyć w aplikacji i kliknij „Zapisz”.

    image-20250901-113826.png

  5. Możesz edytować wykluczenie dostawy dla produktu odznaczając je na liście Wykluczonych produktów. Usunięcie wykluczenia dla obu metod dostawy równa się usunięciu produktu z listy Wykluczonych produktów.

    image-20250901-113858.png

Jak wykluczyć kategorie?

Wykluczanie kategorii polega na wykluczeniu konkretnych metod dostawy dla wszystkich przypisanych produktów
Aby wykluczyć całe kategorie w aplikacji mobilnej InPost Pay, wykonaj następujące kroki:

  1. Przejdź do zakładki InPost Pay -> Unavailable Categories w panelu administracyjnym WooCommerce.

    image-20250901-113931.png

  2. Następnie zobaczysz listę kategorii z paginacją

    image-20250901-114005.png

  3. Zaznacz metody dostawy dla danej kategorii, które chcesz wykluczyć w aplikacji, zapis jest automatyczny.

Wtyczka logistyczna

InPost dostarcza dedykowaną wtyczkę do integracji z InPost dla Klientów WooCommerce. Wtyczka ta pozwala na w pełni zautomatyzowany przebieg procesu zakupowego łącznie z nadaniem numeru przesyłki i wysłaniem go do Twoich klientów przez aplikację InPost w procesie zakupowym InPost Pay.

Pobierz wtyczkę z: InPost PL

Dokumentacja: https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/61833233

 

Jak nadać paczkę jeśli mam wtyczkę logistyczną InPost?

Sposób wysyłki, adres oraz identyfikator paczkomatu automatycznie zostaną przekazane do wtyczki logistycznej. Ty nie musisz znać danych klienta. Musisz nadać paczkę zgodnie z instrukcją wtyczki.

 

Jak nadać paczkę jeśli nie mam wtyczki logistycznej InPost?

Na stronie zamówienia dokonanego przez InPost Pay dostępne są informacje mówiące o sposobie wysyłki oraz numerze paczkomatu w formie okienka. Skopiuj je i postępuj zgodnie z Twoim standardowym procesem nadawania paczek.

Obsługa produktów cyfrowych i dostaw elektronicznych

Wtyczka wspiera obsługę produktów cyfrowych oraz zamówień zawierających produkty do pobrania.

  • Produkty wirtualne:
    W przypadku zamówień zawierających produkty wirtualne (np. kody, dostęp online), nie jest generowany żaden fizyczny sposób dostawy. Merchant powinien samodzielnie obsłużyć wysyłkę (np. ręcznie wysłać kod/licencję na adres e-mail klienta, widoczny w szczegółach zamówienia po prawej stronie panelu administracyjnego WooCommerce).

  • Produkty do pobrania:
    Jeżeli zamówienie zawiera produkty do pobrania, pliki zostaną automatycznie wysłane na adres e-mail podany przez klienta jako adres do dostawy cyfrowej.

  • Zamówienia mieszane:
    W przypadku zamówień mieszanych (produkty fizyczne + cyfrowe) wtyczka automatycznie wykryje obecność produktów cyfrowych i odpowiednio dostosuje sposób realizacji zamówienia.

image-20250901-114341.png

 

Pełna konfiguracja

Konfiguracja została podzielona na sekcje umożliwiające dostosowanie działania wtyczki do potrzeb sklepu.