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: 08.04.2026r - 2.0.7.2

 

Changelog

  • 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: InPost Pay - Analityka - Woocommerce

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