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

Wersja 3.3.0 (14.10.2026)

 

Changelog

14.10.2026 -3.3.0 Poprawki aktualizacji koszyka na stronie checkoutu po zmianie w aplikacji Obsługa opłat dodatkowych z koszyka ( Flexible Product Fields)  Obsługa kuponów na dostawę - rabat uwzględniany w cenach dostawy przekazywanych do aplikacji Nagłówki wyłączające cache w endpointach REST wtyczki (również dla odpowiedzi 401). Poprawne mapowanie pól atrybucji zamówienia (session_start_time, session_pages, utm_medium, utm_term). Usunięto wielokrotną przebudowę tabeli izi_cart_session podczas migracji bazy danych. Anulowanie zamówienia jest poprawnie przekazywane do InPost; anulowane i zwrócone zamówienia nie wracają do realizacji po spóźnionym webhooku. Zestawy Extendons są przekazywane jako jedna pozycja z poprawną ceną, bez wielokrotnego naliczania rabatu składników. Filtr blokujący zmianę ilości wybranych produktów w aplikacji (np. „Życzenia/Dedykacja”). Maskowanie adresu e-mail rozszerzone na zamówienia z wirtualną bramką płatności. Kwota koszyka przy zamówieniach z InPost Plus jest zgodna z oczekiwaniami InPost. 30.09.2026 -3.2.0 Rozwiązano problem narastania tabel wtyczki: naprawiono przyczynę (sesje koszyka zapisywane ścieżką awaryjną nie dostawały daty wygaśnięcia, więc cron nigdy ich nie usuwał), czyszczenie usuwa teraz powiązania koszyka kaskadowo razem z wygasłymi sesjami, a w ustawieniach dodano sekcję "Stan bazy danych" z rozmiarami tabel, licznikami rekordów do usunięcia i statusem crona oraz włączanym ręcznie usuwaniem zaległości i przebudową tabel odzyskującą miejsce na dysku - obie operacje pracują w tle, bez blokowania sklepu. Naprawiono znikanie widgetu InPost Pay dodanego przez Elementor przy wyłączonych wszystkich standardowych miejscach wyświetlania - skrypty i style ładowane są także poza nimi (dotyczy również bloku Gutenberga). 22.09.2026 -3.1.3 Naprawiono okno dostępności PWW (strefa czasowa sklepu, obsługa niedzieli, godzina końcowa wyłączna). Naprawiono zapisywanie cookie waluty przy każdym żądaniu – nie blokuje już cache pełnostronicowego. Ograniczono zapytania do bazy przy renderowaniu widgetu (stan sprawdzany po cookie/sesji, gdy klient nie używał InPost Pay). Usunięto losowy parametr wersji ze skryptu widgetu – poprawne cache'owanie przez CDN. Czyszczenie cache obiektowego ograniczone do grupy wtyczki (bez czyszczenia całego Redis/Memcached/LiteSpeed). Poprawiono obsługę PLN i strefy wysyłki dla sklepów z bazą poza Polską – widget i koszyk korzystają z jednego źródła strefy; rozszerzono wykrywanie wtyczek walutowych (filtr woocommerce_currency). Zabezpieczono odczyt danych zamówienia przed wstrzyknięciem obiektu (unserialize z ograniczeniami). Wymuszono TLS 1.2 w połączeniach z API InPost. Uodporniono warstwę HPOS na brakujące/niewczytywalne zamówienia. Dodano indeks bazodanowy na wc_cart_session – eliminuje pełne skanowanie tabeli koszyków. 02.09.2026 -3.1.2 Usunięcie wyboru metod płatności z panelu admina - metody płatności zarządzane wyłącznie przez bank. Refaktoryzacja synchronizacji koszyka: zamiast listy znanych akcji AJAX (whitelisty) - uniwersalny hook wykrywający każdą zmianę koszyka. 21.08.2026 - 3.1.1 Rozszerzono obsługę synchronizacji koszyka o niestandardowe akcje AJAX (woocommerce_add_to_cart, mfnchangeqtyproduct, mfnremovewooproduct) oraz zrefaktoryzowano ich obsługę do dedykowanej klasy KnownAjaxCartActionType, obejmującej dodawanie, zmianę ilości i usuwanie produktów z koszyka. 19.08.2026 - 3.1.0 Mechanizm rabatów sterowanych przez InPost - 10.08.2026r - 3.0.2 Rozszerzono obsługę niestandardowych akcji AJAX dodawania produktów do koszyka o akcję woocommerce_ajax_add_to_cart Poprawiono wykrywanie trwałego Object Cache o wtyczkę Object Cache Pro Poprawiono całkowite usuwanie cache przy błędnym rozpoznaniu backendu Object Cache  Usunięto zbędne logi generowane przez wtyczkę, poprawiono zapisywanie logów pomimo wyłączonej opcji w panelu administracyjnym Usunięto zbędne console logi Ulepszono wersjonowanie wewnętrznych plików JS i CSS Przesunięto inicjalizację kolejki cron przy aktywacji pluginu 21.07.2026r - 3.0.1 Zoptymalizowano kod wtyczki w celu poprawy wydajności. 07.07.2026r - 2.0.9.3 Rozszerzono obsługę niestandardowych akcji AJAX dodawania produktów do koszyka o akcję Kadence Pro. Dodano filtr umożliwiający zewnętrznym wtyczkom zablokowanie zmiany ilości wybranych produktów w koszyku InPost Pay. Usprawniono odświeżanie cache, ograniczając zbędne operacje czyszczenia kluczy dla Redis, Memcached i LiteSpeed. Usprawniono działanie popupu InPost Pay z motywem WoodMart, eliminując problemy z focusem i zamykaniem popupu podczas parowania. Usprawniono wyszukiwanie użytkownika po numerze telefonu w historii zamówień, ograniczając zakres zapytań i dodając możliwość wyłączenia tej funkcji. Dodano opcję zgodności wymuszającą odświeżenie minicarta po zmianie ilości produktu z aplikacji InPost Pay. Usprawniono wykrywanie Object Cache Pro, zapobiegając zbędnemu pełnemu czyszczeniu cache podczas operacji repozytorium. Naprawiono podwójne wywołanie hooka zmiany statusu zamówienia WooCommerce po aktualizacji statusu przez InPost Pay. Naprawiono obsługę anulowania zamówień InPost Pay w kontekstach REST API i WP-Cron oraz zabezpieczono webhook przed reaktywacją zamówień w statusach końcowych. 15.06.2026r - 2.0.9.2 Naprawiono błąd typu podczas tworzenia zamówienia, gdy numer zamówienia nie był zwracany jako string. Rozszerzono obsługę niestandardowych akcji AJAX motywu WoodMart o aktualizację ilości produktów w koszyku. 11.06.2026r - 2.0.9.1 Naprawiono błąd krytyczny (TypeError) podczas wysyłki e-maili WooCommerce, gdy filtr odbiorcy otrzymywał wartość null (m.in. przy współpracy z TranslatePress) - metody nadpisujące odbiorcę zwracają teraz poprawny typ string. Dodano obsługę Extendons Composite Products dla produktów typu per_item_pricing = “no”. Usprawniono inicjalizację przycisku InPost Pay w minicart przy pierwszym pojawieniu się placeholdera po niestandardowym AJAXowym dodaniu produktu do koszyka. Naprawiono obsługę widgetu InPost Pay na karcie produktu, gdy przycisk dodania do koszyka jest renderowany jako link. Rozszerzono obsługę niestandardowych akcji AJAX dodawania produktów do koszyka dla popularnych motywów i builderów. Naprawiono zwracanie niestandardowego numeru zamówienia przy ponownej próbie złożenia zamówienia przez InPost Pay. 29.05.2026r - 2.0.9 Naprawiono błąd w nazwie tabeli w zapytaniu SQL dla HPOS - zmieniono wc_order_meta na wc_orders_meta w metodzie wyszukiwania użytkownika po numerze telefonu. Naprawiono renderowanie przycisku InPost Pay w minicart po dynamicznym odświeżeniu koszyka przez WooCommerce. Dodano opcję awaryjnego buforowania wyjścia podczas tworzenia zamówienia, która odrzuca nieoczekiwany output z zewnętrznych wtyczek przed wysłaniem odpowiedzi JSON. Dodano możliwość konfiguracji statusu początkowego dla nowych zamówień nieopłaconych w ustawieniach wtyczki, z domyślną wartością "Wstrzymane (oczekujące na płatność)". Naprawiono obsługę zmiany statusu zamówienia przy zapytaniach REST API. Dostosowano style panelu administracyjnego do WP 7.0, naprawiając widoczność przycisku zapisu, radio buttonów i checkboxów. Usprawniono kompatybilność eventu WooCommerce added_to_cart z motywami oczekującymi poprawnych danych fragmentów koszyka, naprawiając dodawanie produktu przez przycisk InPost Pay. Usprawniono synchronizację koszyka InPost Pay po dodaniu produktu przez niestandardowe mechanizmy AJAX popularnych motywów WooCommerce. Naprawiono meta title widoków konfiguracji InPost Pay w panelu administracyjnym. Naprawiono naliczanie VAT dla dostawy przy klasie podatkowej dziedziczonej z produktów w koszyku, uwzględniając dodatkowe klasy podatkowe WooCommerce i poprawną kwotę netto. Naprawiono rozpoznawanie zamówień przy użyciu własnych numerów zamówień, aby aktualizacje statusu InPost Pay trafiały do właściwego zamówienia. Naprawiono przełączanie zakładek w panelu administracyjnym InPost Pay, aby aktywna sekcja była visible mimo konfliktów z inline display:none. 04.05.2026r - 2.0.8 Naprawiono dostępność metod dostawy APM i Kurier dla niezalogowanych użytkowników po powiązaniu koszyka, potwierdzeniu i zmianach w koszyku oraz doliczanie kosztu dostawy w zamówieniach WooCommerce. Naprawiono brak przekazywania basketBindingApiKey przy pierwszym dodaniu produktu do pustego koszyka. Usprawniono obsługę dodawania produktów do koszyka przez endpoint InPost Pay, aby przechwytywać odpowiedź WooCommerce i nie przerywać zwracania basketBindingApiKey. Dodano walidację wymaganych pól dla produktów z dodatkowymi opcjami (Flexible Product Fields) przed połączeniem z aplikacją. Naprawiono synchronizację koszyka po jego opróżnieniu, dzięki czemu ponowne dodanie produktu w sklepie natychmiast aktualizuje koszyk w aplikacji. Usprawniono mechanizm zapisu i wykrywania zmian koszyka, eliminując nadpisywanie aktualnych danych oraz problemy z cache i persistent cart. Poprawiono dostępne hooki dla minicart, zapewniając prawidłowe wyświetlanie widgetu InPost Pay we wszystkich opcjach umiejscowienia. Naprawiono klasyfikację produktów z opcją "Do pobrania", uwzględniając rzeczywistą potrzebę wysyłki zamiast samej flagi downloadable. Naprawiono działanie wykluczeń dla produktów z opcją "Do pobrania", które wcześniej były ignorowane. Usunięto zbędne logi związane z odnawianiem tokenu, które zaśmiecały logi wtyczki. Usprawniono przekazywanie atrybutów produktów, odczytując wartość z pola value zamiast display, co eliminuje niepożądane elementy HTML w danych. Poprawiono prezentację atrybutów w zamówieniach poprzez normalizację znaków NBSP do zwykłej spacji. Usprawniono obsługę maksymalnej ilości produktu, traktując wartości ujemne jako brak ograniczenia i zastępując je wartością domyślną. Naprawiono błąd krytyczny przy parowaniu koszyka dla metod dostawy z kosztami liczonymi per klasa produktu. Usprawniono obsługę zestawów WPC, wykluczając ich pozycje z koszyka i zamówienia. Naprawiono błąd krytyczny podczas parowania koszyka przy brakującej konfiguracji metod wysyłki na sklepach z PHP 8. Usprawniono inicjalizację widgetu InPost Pay w koszyku po zmianie metody dostawy. Dodano obsługę ponownej inicjalizacji widgetu tylko dla umiejscowień odświeżanych przez WooCommerce. Usprawniono wykrywanie przycisku add to cart na stronie produktu poprzez zmianę selektora na bardziej uniwersalny. Usunięto zbędne odświeżanie strony po wybraniu opcji połączenia koszyka z innym numerem telefonu. Zsynchronizowano izi_full_cost z finalnym kosztem dostawy po zastosowaniu filtrów, aby ceny w aplikacji były zgodne z koszykiem sklepu. Dodano walidację dostępności produktów przed utworzeniem zamówienia z aplikacji, blokując zapis zamówienia przy nieaktualnym stanie magazynowym. 08.04.2026r - 2.0.7.2 Usprawniono obsługę cache poprzez eliminację globalnego flush i ujednolicenie logiki ścieżek wykonania. Naprawiono endpointy AJAX w JS, zastępując hardkodowane URL-e wartościami z backendu. 26.03.2026r - 2.0.7.1 Naprawiono błąd kompatybilności z PHP 8, w którym niepowodzenie połączenia curl powodowało TypeError w json_decode z powodu przekazania wartości false (bool) zamiast ciągu znaków Dodano mechanizm automatycznej dezaktywacji wtyczki przy błędach fatalnych PHP. Wtyczka dezaktywuje się samoczynnie w przypadku wystąpienia błędu fatalnego podczas standardowego ładowania strony; żądania AJAX, REST API oraz WP-Cron są wyłączone z tego zachowania Naprawiono sanityzację ustawienia środowiska. Nieprawidłowe wartości są teraz walidowane i zastępowane środowiskiem deweloperskim zamiast być zapisywane bez kontroli 20.03.2026r - 2.0.7 Naprawiono niespójność domyślnego wariantu przycisku, przez którą po instalacji widget wyświetlał czarny wariant mimo ustawionego w panelu wariantu żółtego Poprawiono listę sugerowanych produktów przekazywanych do aplikacji - produkty wariantowe są pomijane, dzięki czemu przekazywane są wyłącznie produkty proste Poprawiono synchronizację danych koszyka z sesją WooCommerce, ograniczając przypadki rollbacku ilości produktów przy przejściu do zamówienia Poprawiono obsługę sesji i checkoutu dla użytkowników składających zamówienie jako gość, aby zapobiec niespójnościom między koszykiem a tworzonym zamówieniem Usunięto sprawdzanie dostępnych metod dostawy przed wyświetleniem widgetu Zmieniono sposób inicjacji sesji WooCommerce - sesja i cookie koszyka są tworzone dopiero po dodaniu produktu do koszyka, zamiast przy samym wejściu na stronę Ograniczono problemy z błędnym przypisaniem koszyka i sesji podczas checkoutu, poprawiając spójność danych zamówienia Poprawiono synchronizację danych koszyka między sklepem a aplikacją, aby zmniejszyć ryzyko niespójności produktów w trakcie składania zamówienia Zoptymalizowano działanie wtyczki pod kątem cache i wydajności, ograniczając niepotrzebne inicjowanie sesji oraz zbędne operacje zapisu Dodano opcję wcześniejszego zwracania odpowiedzi dla aktualizacji koszyka z aplikacji mobilnej w celu poprawy kompatybilności w środowiskach, gdzie standardowa odpowiedź jest wysyłana zbyt późno Ograniczono nadmiarowe odpytywanie API o metody płatności poprzez zastąpienie cache opartego o WordPress Transients trwalszym mechanizmem przechowywania danych Zmieniono sposób cache’owania metod płatności, aby poprawić wydajność i stabilność działania sklepu 09.03.2026r - 2.0.6.1 Naprawiono problem z ostrzeżeniem PHP dotyczącym brakującego basket binding API key w odpowiedzi AJAX podczas dodawania produktu do koszyka Usprawniono obsługę modala InPost Pay na urządzeniach mobilnych w motywie Flatsome, aby popup koszyka nie przejmował focusu z pola telefonu Naprawiono błąd krytyczny podczas przetwarzania atrybutów produktów w koszyku, zapewniając poprawną obsługę pustych etykiet atrybutów. Dodano filtr zapobiegający przekierowaniu endpointu wc_ajax_inpost_add_product do strony koszyka 26.02.2026 - 2.0.6 Poprawka JS: Zapobieganie błędowi w zdarzeniu added_to_cart, gdy element inpost-izi-button lub jego shadowRoot nie istnieje. Metody wysyłki: Naprawiono sprawdzanie dostępności metod dostawy dla konkretnego produktu. Metody płatności: Zapewniono przekazywanie wszystkich metod płatności w przypadku braku wyboru w konfiguracji. Obsługa PPOM: Usprawniono obsługę dopłat i opcji produktów – ceny oraz atrybuty są teraz przekazywane do aplikacji w spójny sposób. Błąd 500 (Parowanie koszyka): Zmieniono typ kolumny ID w tabeli sesji na większy, aby uniknąć błędów „Out of range”. Kategorie wykluczone: Usunięto zbędne linki z listy wykluczeń, które mogły prowadzić do nieprawidłowych adresów. Filtr ID zamówienia: Rozszerzono filtr inpost_pay_custom_order_id o parametry oid oraz order, umożliwiając pobieranie niestandardowych numerów zamówień z WooCommerce. Narzędzie dostępności: Poprawiono działanie narzędzia sprawdzającego dostępność metod dostawy. Mapowanie dostaw: Naprawiono błąd, przez który ukryte lub niedostępne metody były zwracane do aplikacji z ceną „0 zł”. Baza danych: Zwiększono pojemność zapisu koszyka (zmiana z TEXT na MEDIUMTEXT). Zarządzanie sesją: Dodano metody pomocnicze dla sesji WooCommerce oraz funkcję czyszczenia sesji. Pliki cookie: Naprawiono obsługę ciasteczek dla klucza API powiązania koszyka oraz daty wygaśnięcia. Weryfikacja: Naprawiono brak walidacji sesji koszyka dla żądań potwierdzenia (confirmation requests). Synchronizacja kuponów: Zapewniono przeliczanie sum koszyka przed wysyłką danych do API InPost. Obliczanie VAT: Poprawiono wyliczanie podatku VAT dla przesyłek w przypadku kwot netto z precyzją powyżej dwóch miejsc po przecinku. 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: 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ę.

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

 

  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.

 


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.

Przykładowe wtyczki cookie, które mogą występować na Twoim sklepie:

  1. Cookie Yes

  2. GDPR Cookie Compliance

  3. Cookie Consent Manager for WordPress

  4. CookieBot for GDPR & CCPA Compliance

  5. Cookie Notice for GDPR & CCPA

Konfiguracja ciasteczek funkcjonalnych:

Dla każdej z powyższych wtyczek, należy dodać następujące ciasteczka jako funkcjonalne:

  • basket_binding_api_key - niezbędne do zarządzania koszykiem zakupowym i integracji z systemem InPostPay.

  • inpost_pay_currency_restore_uid - służy do zapisywania preferencji walutowych użytkownika, co jest kluczowe dla prawidłowego działania płatności InPost Pay.

Instrukcja krok po kroku:

  1. Zaloguj się do panelu administracyjnego WooCommerce.

  2. Przejdź do sekcji zarządzania wtyczkami i znajdź swoją wtyczkę do zarządzania ciasteczkami.

  3. Otwórz ustawienia wtyczki cookie i przejdź do sekcji zarządzania ciasteczkami.

  4. Dodaj następujące ciasteczka jako funkcjonalne:

    • basket_binding_api_key

    • inpost_pay_currency_restore_uid

  5. Zapisz zmiany i przetestuj działanie sklepu, aby upewnić się, że ciasteczka są prawidłowo ustawiane.

Podsumowanie

Dodanie odpowiednich ciasteczek funkcjonalnych jest kluczowe dla prawidłowego działania integracji InPostPay w Twoim sklepie WooCommerce. Postępując zgodnie z powyższymi krokami, zapewnisz użytkownikom płynne korzystanie z funkcji zakupowych.


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: [PL] WooCommerce

 

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.

Po instalacji wtyczki w menu po lewej stronie sekcji administracyjnej zobaczysz nowe menu “InPost Pay”. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki.

Ustawienia API

 

W tej sekcji ustawia się dane dostępowe do systemu, rodzaje obsługiwanych metod płatności oraz informacja wymieniane między InPost Pay a sklepem.

Dane dostępowe do środowiska sandbox uzyskasz pisząc maila na skrzynkę integracjapay@inpost.pl lub wypełniając formularz kontaktowy w opcji Dla Biznesu i zakładce Sandbox.

Dane produkcyjne otrzymasz po podpisaniu umowy o usługę InPost Pay i wygenerujesz poprzez panel Merchanta zgodnie z instrukcją.

 

Opis dostępnych opcji:

Środowisko

image-20240301-084540.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa czy sklep wysyła dane do
środowiska testowego czy produkcyjnego

Kiedy testujesz integrację ustaw środowisko Sandbox.
Jeśli testy przebiegły pomyślnie i chcesz włączyć możliwość kupna przez InPost Pay ustaw środowisko Produkcyjne

 

Pokazuj widget

image-20240301-085216.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Podczas testów nie chcemy, żeby widget InPost Pay wyświetlał się wszystkim klientom. Niezależnie od tego jakie środowisko zostało ustawione możesz tymczasowo ukryć widget i pokazywać go tylko wybranym osobom. W celu wyświetlenia widgetu w trybie tylko dla testerów wejdź na stronę główną sklepu i dodaj na końcu adresu url ?showIzi=true
Na przykład
https://outofthebox.pl?showIzi=true

Kiedy konfigurujesz integrację wybierz
Testerom.
W celu pokazania widgetu wszystkim już po
wykonaniu testów konfiguracji ustaw
Każdemu.

 

 

Client ID

image-20240301-085518.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Dana dostępowa do API umożliwiająca działanie wtyczki.

Zgodnie z danymi otrzymanymi od InPost.

Client Secret

image-20240301-085719.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Dana dostępowa do API umożliwiająca działanie wtyczki.

Zgodnie z danymi otrzymanymi od InPost.

 

POS ID

image-20240301-090043.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Dana dostępowa do API

Zgodnie z danymi otrzymanymi od InPost.

 

Merchant ID

image-20250320-084758.png

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Dana dostępowa do API umożliwiająca działanie wtyczki.

Zaloguj się do panelu InPost i pobierz Merchant Client ID

Włącz płatności zgodne z podpisaną umową z bankiem

image-20251106-162345.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa, czy Twoi klienci będą mogli dokonywać płatności przez bramki płatnicze, które są zawarte w Twojej umowie takie jak Blik, Apple Pay, płatność kartą.

Zaznacz Tak jeśli metody mają być dostępne. Jeśli nie zaznaczysz żadnej metody, domyślnie dostępne będą wszystkie formy płatności zgodne z Twoją umową z bankiem.

 

Włącz płatność przy odbiorze zgodnie z podpisaną umową z InPost

image-20240603-162457.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa, czy Twoi klienci będą mogli dokonywać płatności przy odbiorze zgodnie z umową z InPost

Zaznacz Tak jeśli metoda ma być dostępna.

 

Wybierz dostępne metody płatności w aplikacji

Konfiguracja niedostępna od wersji v3.1.2.

image-20240603-162551.png

 

Uwaga:

Opcja ta pojawi się dopiero po wprowadzeniu danych dostępowych do API i zapisaniu ustawień.

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa, jakie metody płatności będą widoczne dla klienta w aplikacji InPost.

Wybierz z listy dostępne metody płatności.

 

Wirtualna metoda płatności

Możesz włączyć wirtualną metodę płatności, która będzie przypisywana do zamówień z InPost Pay. Ta metoda jest niewidoczna w zwykłym koszyku.

image-20251127-110651.png

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Po włączeniu możesz rozpoznawać płatność InPost Pay w kodzie oraz w zewnętrznych wtyczkach, które wymagają zarejestrowanej metody płatności w systemie.

Aby włączyć, przejdź do zakładki InPost Pay, potem do Ustawień. Niżej, w opcjach metody płatności, zaznacz Wirtualna bramka płatności.

Rozpoznanie poprzez klasę:
Ilabs\Inpost_Pay\Lib\PaymentInpost_Pay_Virtual_Payment_Gateway

lub poprzez id:
inpost_pay_virtual_payment_gateway

 

Status zamówienia dla zamówienia opłaconego przez InPost Pay

image-20240301-090801.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa jaki status mają mieć zamówienia, które zostaną opłacone przez InPost Pay

Wybierz z listy status jakie mają mieć zamówienia opłacone.

 

Status zamówień

image-20240301-091010.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa jakie nazwy statusów mają pojawić się w aplikacji InPost Pay (kolumna po prawej) dla zamówień w Twoim sklepie (kolumna po prawej)

Zweryfikuj czy poniższe statusy odpowiadają statusom, które Twój klient otrzymuje w komunikacji dotyczącej zamówienia.

 

Maksymalna liczba produktów sugerowanych

image-20240301-091231.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa maksymalną liczbę produktów, jakie zostaną zasugerowane Twojemu klientowi w aplikacji InPost do produktów jakie już ma w koszyku. Produkty sugerowane pobierane są ze standardowego mechanizmu WooCommerce.

Wpisz maksymalną liczbę produktów.

 

Niestandardowa strona podziękowania (opcjonalne)

W tej sekcji możesz skonfigurować alternatywny sposób renderowania strony podziękowania (Thank You Page) po zakończeniu zakupów z InPost Pay.  

Funkcja pozwala wybrać własną stronę WordPress zawierającą shortcode [inpost_thank_you], dzięki czemu komunikat podziękowania może być wyświetlany w pełnym układzie motywu, bez użycia wirtualnej strony generowanej przez wtyczkę.  

Opcja jest szczególnie przydatna w motywach, które nie obsługują stron wirtualnych.

image-20251105-104311.png

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Umożliwia zastąpienie domyślnej wirtualnej strony podziękowania własną stroną WordPress z osadzonym shortcode [inpost_thank_you]. Dzięki temu treść strony może być wyświetlana w kontekście aktywnego motywu, wraz z jego szablonem, nagłówkiem i stopką.

  1. Utwórz nową stronę w WordPress (Strony -> Dodaj nową). W treści wklej shortcode [inpost_thank_you] i opublikuj stronę.

  2. W ustawieniach wtyczki InPost Pay wybierz utworzoną stronę z listy w polu “Niestandardowa strona podziękowania (opcjonalnie)”.

  3. Zapisz zmiany. Jeśli nie wybierzesz żadnej strony, wtyczka automatycznie użyje domyślnej wirtualnej strony podziękowania.

 

Ustawienia przekazywanych opisów

image-20240606-130438.png

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa czy ma być pobierany pełny opis czy opis skrócony

Wybierz “Pełny opis” lub “Krótki Opis”

 


Odśwież stronę po dodaniu produktu do koszyka

Steruje przeładowaniem strony po zmianach w koszyku. Włączona opcja zapewnia, że komunikaty o dodaniu lub usunięciu produktu wyświetlają się poprawnie w sklepach, w których działają tylko po odświeżeniu strony.

Domyślnie opcja jest włączona.

image-20251001-121220.png

Uwaga: Wyłącz tę opcję, jeżeli komunikaty w Twoim sklepie nie wymagają przeładowania strony (np. gdy komunikat o dodaniu produktu do koszyka pojawia się od razu bez odświeżania).

Format odpowiedzi

Włącza nowy, ujednolicony sposób budowania odpowiedzi dla koszyka i tworzenia zamówienia. Lepsza zgodność ze standardami WooCommerce i większa kompatybilność z innymi wtyczkami.

image-20250910-114017.png

Uwaga: Włączaj tylko, jeśli to konieczne. Część wtyczek oczekuje danych z $_POST i wymuszenie akcji może powodować konflikty.

Włącz niestandardową odpowiedź koszyka (tylko do celów diagnostycznych)

  • uruchamia alternatywny (niestandardowy) payload odpowiedzi koszyka, pomocny przy diagnozie konfliktów.

  • domyślnie wyłączone.

  • używaj wyłącznie tymczasowo na środowisku testowym lub przy wsparciu technicznym InPost.

Używaj nowoczesnego formatu odpowiedzi (zalecane)

  • włącza nowy, ujednolicony sposób budowania odpowiedzi dla koszyka i tworzenia zamówienia. Lepsza zgodność ze standardami WooCommerce i większa kompatybilność z innymi wtyczkami.

  • domyślnie włączone od wersji 2.0.3.

  • wyłącz, jeśli po aktualizacji widzisz błędy/niezgodności w koszyku lub podczas składania zamówienia i sprawdź, czy problem ustępuje (tryb zgodny z wcześniejszym działaniem).

Wyszukiwanie użytkownika po numerze telefonu w historii zamówień

Opcja pozwala InPost Pay przeszukiwać wcześniejsze zamówienia w celu identyfikacji klienta na podstawie numeru telefonu, ale tylko wtedy, gdy nie uda się znaleźć dopasowanego adresu e-mail. Mechanizm pomaga powiązać zamówienie składane przez gościa z istniejącym użytkownikiem WordPress, jeśli ten sam numer telefonu był wcześniej użyty w sklepie.

Wyszukiwanie działa w historii zamówień i może obciążać bazę danych w sklepach z bardzo dużą liczbą zamówień. Zakres wyszukiwania jest ograniczony do zamówień z ostatnich 12 miesięcy.

image-20260707-105016.png

Opcja jest domyślnie włączona. W sklepach z dużą historią zamówień, szczególnie powyżej 500 000 zamówień, wyszukiwanie po numerze telefonu może powodować opóźnienia lub timeouty podczas tworzenia zamówienia. Po wyłączeniu opcji goście składający zamówienie bez konta nie będą automatycznie dopasowywani do istniejącego użytkownika WordPress na podstawie numeru telefonu.

Zalecenia:

  • jeśli tworzenie zamówień działa poprawnie - pozostaw opcję włączoną

  • jeśli podczas tworzenia zamówienia występują opóźnienia lub timeouty w sklepie z dużą liczbą zamówień - wyłącz opcję i sprawdź, czy problem ustąpił

  • jeśli sklep korzysta ze standardowych tabel WooCommerce i ma bardzo dużą liczbę zamówień - rozważ migrację do HPOS.

Odśwież fragmenty koszyka WooCommerce po aktualizacji koszyka z aplikacji

Opcja wymusza odświeżenie fragmentów koszyka WooCommerce po każdej zmianie koszyka wykonanej z aplikacji InPost Pay. Standardowo WooCommerce odświeża elementy takie jak liczba produktów w mini koszyku czy zawartość minicarta przez własny mechanizm zdarzeń i AJAX. W niektórych motywach lub konfiguracjach sklepu mechanizm ten może nie zadziałać po każdej zmianie wykonanej z aplikacji, mimo że koszyk po stronie WooCommerce został zaktualizowany poprawnie.

Po włączeniu tej opcji wtyczka wywołuje standardowe zdarzenie WooCommerce wc_fragment_refresh po aktualizacji koszyka z aplikacji InPost Pay. Dzięki temu WooCommerce ponownie ładuje zarejestrowane fragmenty koszyka, np. licznik produktów i zawartość mini koszyka.

image-20260707-105158.png

Opcja działa wyłącznie po aktualizacjach koszyka wykonanych z aplikacji InPost Pay i pełni rolę trybu zgodności dla sklepów, w których elementy koszyka na stronie nie odświeżają się automatycznie po zmianie ilości produktu w aplikacji.

Rekomendacje:

  • jeśli mini koszyk i inne elementy koszyka odświeżają się poprawnie po zmianach z aplikacji - pozostaw opcję wyłączoną

  • jeśli po zmianie ilości produktu w aplikacji mini koszyk nie pokazuje aktualnej liczby produktów lub zawartości - włącz opcję i sprawdź, czy problem ustąpił

  • jeśli problem już nie występuje i elementy koszyka odświeżają się poprawnie bez tej opcji - wyłącz ją permanentnie.

 

Wczesna odpowiedź aktualizacji koszyka (pominięcie hooka shutdown)

Opcja powoduje wcześniejsze zwrócenie odpowiedzi do aplikacji podczas aktualizacji koszyka wykonywanej z aplikacji mobilnej. Standardowo odpowiedź jest wysyłana dopiero na etapie shutdown, co w niektórych środowiskach może skutkować pustym body lub błędem w aplikacji przy zmianie ilości produktów. Po włączeniu tej opcji odpowiedź jest generowana wcześniej, w trakcie obsługi requestu, dzięki czemu aplikacja otrzymuje poprawne dane.

image-20260320-102615.png

Opcja działa wyłącznie dla aktualizacji koszyka wykonywanych przez aplikację mobilną i pełni rolę trybu zgodności dla środowisk, w których standardowy mechanizm odpowiedzi działa zbyt późno.

Zalecenia:

  • jeśli aktualizacja koszyka po stronie aplikacji działa poprawnie - pozostaw opcję wyłączoną

  • jeśli aplikacja zgłasza błąd podczas aktualizacji koszyka - włącz opcję i sprawdź, czy problem ustąpił

Buforowanie wyjścia podczas tworzenia zamówienia (tryb awaryjny)

Opcja umożliwia przechwycenie i odrzucenie nieoczekiwanej treści wyjściowej generowanej przez zewnętrzne wtyczki podczas tworzenia zamówienia przez endpoint /v1/izi/order. Standardowo odpowiedź tego endpointu powinna zawierać wyłącznie poprawne dane JSON. Jeśli inna wtyczka, np. analityczna, wygeneruje dodatkowy output w trakcie obsługi żądania, może to spowodować błąd komunikacji InPost Pay lub niepoprawną odpowiedź zwracaną do aplikacji.

Po włączeniu tej opcji nieoczekiwany output zostaje przechwycony, odrzucony przed wysłaniem odpowiedzi JSON i zapisany w logach InPost Pay. Dzięki temu proces tworzenia zamówienia może zakończyć się poprawnie mimo konfliktu z zewnętrzną wtyczką.

image-20260529-063456.png

Opcja działa wyłącznie podczas tworzenia zamówienia przez endpoint /v1/izi/order i pełni rolę awaryjnego trybu zgodności dla środowisk, w których zewnętrzna wtyczka wstrzykuje nieprawidłową treść do odpowiedzi.

Zalecenia:

  • jeśli tworzenie zamówień działa poprawnie - pozostaw opcję wyłączoną

  • jeśli podczas tworzenia zamówienia występują błędy komunikacji InPost Pay spowodowane nieoczekiwanym outputem z innej wtyczki - włącz opcję i sprawdź, czy problem ustąpił

  • jeśli konflikt już nie występuje i tworzenie zamówień działa poprawnie bez tej opcji - wyłącz ją permanentnie

 

Dodatkowe akcje WooCommerce dla zamówień i koszyka

image-20250603-123152.png

Dodatkowe akcje umożliwiają ręczne wywołanie logiki WooCommerce wymaganej przez niektóre wtyczki (np. SalesKing) przy użyciu InPost Pay.

Włączaj dodatkowe akcje tylko jeśli to konieczne. Niektóre wtyczki mogą wymagać dodatkowych danych z $_POST lub powodować konflikty.

Lista dostępnych akcji do zaznaczenia

  • dla zamówień 

    • woocommerce_checkout_order_processed

    • woocommerce_checkout_create_order

    • woocommerce_checkout_update_order_meta

    • woocommerce_checkout_order_created

  • dla koszyka

    • woocommerce_cart_item_set_quantity

Użytkownik może zaznaczyć, które akcje mają być wywoływane po złożeniu zamówienia.
Pozwala to zachować pełną kompatybilność z zewnętrznymi pluginami wymagającymi obecności tych hooków, bez globalnego narzucania ich wykonania.


Zgody

Sekcja służy do ustawienia zgód wyświetlanych klientom w aplikacji InPost podczas zakupów z InPost Pay.

Dodawanie:
Zgody można dodać za pomocą przycisku “+Dodaj zgodę”. Maksymalnie możesz dodać 10 zgód.
Usuwanie:
W celu usunięcia zgody naciśnij przycisk “Usuń” umieszczony przy danej zgodzie.

Dodawanie dodatkowych linków do zgód:
W celu dodania dodatkowego linku do zgody należy nacisnąć przycisk “+Dodaj dodatkowy link”. Maksymalnie w jednej zgodzie mogą być dodane 3 linki. Minimum jeden link jest wymagany.

Opis dostępnych opcji:

Adres zgody

 

image-20241127-133726.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa stronę, na którą zostanie przekierowany Twój klient w celu przeczytania zgody. Strony widoczne na liście to standardowe strony dostępne w Wordpress.

Wybierz jedną ze stron Twojego sklepu z listy rozwijalnej.

Identyfikator linku

image-20241127-133914.png

Do czego służy:

Jak ustawić:

Jest to unikalny identyfikator Twojego odnośnika, który możesz użyć w opisie zgody .

Wprowadź unikalny identyfikator.

Tekst linku

image-20241127-134210.png

Do czego służy:

Jak ustawić:

Określa wyświetlany tekst dla linku.

Wprowadź tekst np. Regulamin, Polityka Prywatności.

Opisy widoczne w aplikacji

image-20241127-134357.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa opis wyświetlany w aplikacji

Wpisz opis, jaki ma zostać wyświetlony. Możesz podać tutaj swoje identyfikatory linków poprzedzone znakiem #, dzięki czemu twoje linki zostaną osadzone w treści zgody.

Czy wymagane

image-20241127-134539.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa czy zgoda jest wymagana

Wpisz wymagalność zgody z listy.

 

Wskazówka:
Jeśli chcesz utworzyć jeden checkbox w aplikacji służący do akceptacji więcej niż jednego dokumentu stwórz stronę, na której umieścisz odnośniki do wszystkich wymaganych zgód.


Kupony InPost Pay

Gdzie zarządzać kuponami?

Przejdź do:
Marketing → Kupony

Tam możesz natywnie tworzyć i edytować kupony, które będą dynamicznie pokazywane klientom w aplikacji InPost Pay, w zależności od warunków ich koszyka.

image-20250429-123948.png

Widoczność kuponów w aplikacji

Aby kupon był widoczny w aplikacji InPost Pay:

  • Musi być aktualnie ważny (nie wygasły),

  • Jeżeli kupon ma ograniczenie do konkretnego maila, to aktualnie zalogowany użytkownik musi mieć e-mail zgodny z restrykcją,

  • Produkty w koszyku muszą spełniać wymagania kuponu (produktowe, kategorie, marki),

  • Wartość koszyka musi spełniać wymagania minimalnej i maksymalnej kwoty, jeśli są ustawione,

  • Kupon nie może być już zastosowany w koszyku,

  • Kupon musi mieć uzupełniony opis.

W zakładce „InPost Pay” musi być zaznaczona opcja „Udostępnij w aplikacji InPost Pay”

Kupon dostępny wyłącznie w aplikacji Inpost Pay

Wtyczka umożliwia utworzenie kuponu, który będzie dostępny wyłącznie w aplikacji InPost Pay. Aby utworzyć taki kupon, należy wybrać typ rabatu InPostPay.

Jest to rabat procentowy naliczany od wartości całego koszyka. Kupony tego typu nie są dostępne w sklepie internetowym ani w innych kanałach sprzedaży.

Uwaga: Kupony typu InPostPay nie obsługują darmowej dostawy.

Wybór kuponów wyświetlanych w aplikacji InPost Pay

W każdej wersji możesz tworzyć kupony widoczne w aplikacji InPost Pay zgodnie z warunkami widoczności. Od wersji 2.0.1.1 dodatkowo możesz samodzielnie wskazać, które kupony mają być widoczne w aplikacji - niezależnie od typu.

udostepnij-w-aplikacji-inpost-pay.png

W tym celu:

  • Przejdź do edycji kuponu

  • Otwórz zakładkę „InPost Pay”

  • Zaznacz opcję „Udostępnij w aplikacji InPost Pay”

Uwaga: W aplikacji InPost Pay może być jednocześnie widocznych maksymalnie 5 kuponów.


Koszt transportu

Ta sekcja odpowiada za mapowanie form transportu oraz definiowanie dostępności i cen opcji dodatkowych transportu dla każdej strefy wysyłki osobno.

Od teraz wszystkie ustawienia dotyczące kosztów dostawy możesz konfigurować niezależnie dla każdej strefy skonfigurowanej w WooCommerce (np. Polska, Kraków, wybrane regiony). Dzięki temu klienci z różnych lokalizacji mogą widzieć różne opcje i ceny dostawy - zgodnie z Twoją polityką wysyłki. Rozwiń lub zwiń konkretne ustawienia kosztów transportu dla strefy, klikając w jej nazwę.

image-20250901-115044.png

W celu zapewnienia transparentności i spójności doświadczenia klienta, koszty dostawy muszą być identyczne w interfejsie sklepu internetowego oraz w aplikacji. Należy skonfigurować oba systemy w taki sposób, aby prezentowały użytkownikom te same wartości opłat za dostawę dla odpowiednich metod.

Opis dostępnych opcji:
Ustawienia tej sekcji są analogiczne dla wszystkich typów wysyłki i dla wszystkich opcji

Pamiętaj!
Poniższe opcje ustaw zgodnie z umową z InPost.

image-20250210-084527.png

Wybierz metody dostawy

Pamiętaj!
Poniższe opcje ustaw zgodnie z umową z InPost.

image-20250901-115335.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa, które z metod dostawy są obsługiwane przez sklep.

Włącz lub wyłącz metody za pomocą przełączników

 

Mapuj z metodą wysyłki

Pamiętaj!
Poniższe opcje ustaw zgodnie z umową z InPost.

image-20250901-120334.png



Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa, która z dostępnych w sklepie metod wysyłki ustala ceny i zasady dla przedpłaconych metod wysyłki. Lista zawiera standardowe, dostępne w Woocommerce metody wysyłki.

Wybierz wysyłkę dostępną w Twoim sklepie z listy rozwijalnej.

 

Włącz lub wyłącz opcje dostawy

image-20250901-120139.png

Pamiętaj!
Poniższe opcje ustaw zgodnie z umową z InPost.

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa, które z dodatkowych opcji dostawy są obsługiwane przez sklep.

Włącz obsługiwane opcje wysyłki za pomocą pola checkbox

 

Sposób obliczania ceny dla dodatkowej opcji dostawy

image-20250901-120504.png

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa, jak będzie obliczana cena dodatkowych opcji dostawy.

Ustaw przycisk opcji obok pola „Mapuj z metodą wysyłki” jeżeli koszt wysyłki z opcją powinna obliczyć metoda wysyłki Woocommerce. 

Ustaw przycisk opcji obok pola „Dodatkowa prowizja” jeżeli chcesz wprowadzić wartość prowizji kwotowej dla opcji dostawy.

 

Mapuj z metodą wysyłki (dla opcji dostawy)

image-20250901-120654.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa, która z dostępnych w sklepie metod wysyłki ustala ceny i zasady dla opcji dostawy. Lista zawiera standardowe, dostępne w Woocommerce metody wysyłki. 

Wybierz wysyłkę dostępną w Twoim sklepie z listy rozwijalnej. 

Pamiętaj!
Jeżeli kupujący wybierze w aplikacji więcej niż 1 opcję (np. Pobranie + Paczka w weekend) wtedy w zamówieniu Woocommerce będzie widoczna metoda bazowa.

Dodatkowa prowizja

image-20250901-120553.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Pole dodatkowej prowizji kwotowej dla opcji dostawy doliczanej do kosztu wysyłki metody bazowej.

Wprowadź kwotę netto. Podatek będzie doliczony w zależności od ustawień zmapowanej metody bazowej.

 

Dostępne od

image-20250901-120747.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa od którego dnia tygodnia, i której godziny opcja APM+PWW (Paczkomat + Paczka w weekend) jest dostępna.

Wybierz dzień i godzinę, od których opcja będzie dostępna dla Twoich klientów.

 

Dostępne do

image-20250901-120825.png

 

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Określa do którego dnia tygodnia i której godziny opcja APM+PWW (Paczkomat + Paczka w weekend) jest dostępna.

Wybierz dzień i godzinę, do których opcja będzie dostępna dla Twoich klientów.

Ograniczenie dostawy Paczkomatem dla paczek powyżej 25kg

Integracja z wtyczką logistyczną InPost

image-20250303-075936.png

Do czego służy:

Jak ustawić:

Do czego służy:

Jak ustawić:

Ogranicza możliwość wyboru opcji dostawy "Paczkomat", jeżeli paczka waży powyżej 25kg

W panelu wtyczki logistycznej InPost zakładka "Ustawienia".