InPost Pay - PrestaShop (Widget 2.0)

InPost Pay - PrestaShop (Widget 2.0)

Wstęp

Niniejsza instrukcja przedstawia proces instalacji oraz konfiguracji wtyczki, umożliwiającej wprowadzenie InPost Pay w sklepie PrestaShop z obsługą Widget 2.0.


Wtyczka

Wersja 2.4.0 (21.11.2025):

 

Changelog

Wersja 2.4.0: (21.11.2025)

  • Wprowadzono nowe opcje określające sposób działania ograniczeń produktów. Nowe możliwości: ukrycie widgetu, blokada zamówienia lub wybranych metod dostawy (kurier, Paczkomat). Zastąpiono poprzedni przełącznik „Nie zezwalaj na zamówienia”.

  • Dodano możliwość wyboru domyślnego rodzaju galerii zdjęć w konfiguracji modułu

Wersja 2.3.0: (25.09.2025)

  • dodano obsługę opcji pakowania prezentowego w module InPost Pay

  • zmieniono format przesyłania danych z koszyka do API InPost – uwzględnienie danych personalizacyjnych

  • poprawiono wyświetlanie i obsługa zamówień z personalizacją po stronie PrestaShop i aplikacji InPost Pay

  • dodano obsługę przekazywania punktu odbioru (inpost_point) w zasobie inpost_orders

  • zmieniono strukturę danych zamówienia generowanych przez moduł InPost Pay

  • umożliwiono automatyczne przekazywanie zamówień do systemu Fulfillment po stronie InPost

  • dodano obsługę produktów cyfrowych (DIGITAL) w module InPost Pay

  • wprowadzono nową metodę dostawy DIGITAL w koszykach i zamówieniach

  • rozszerzono dane produktów i produktów powiązanych o pole product_type (PRODUCT / DIGITAL)

  • dodano pole digital_delivery_email w zamówieniach – adres e-mail do wysyłki produktów cyfrowych

  • dostosowano logikę wysyłki wiadomości: jedna wiadomość, gdy adresy są takie same; dwie, gdy różne

  • zaktualizowano obsługiwane endpointy API koszyka i zamówienia o nowe pola

Wersja 2.2.3 (04.08.2025)

  • poprawka dla rozszerzenia listy możliwych wartości metod płatności

Wersja 2.2.2 (16.07.2025)

  • poprawiono błąd powodujący brak możliwości ukończenia zakupu przez klientów korzystających z urządzeń mobilnych w przypadku zmiany wariantu produktu przed dodaniem do koszyka

  • poprawiono mechanizm łączenia koszyka aplikacji z koszykiem sklepu w sytuacjach, gdy koszyk zawierał produkty o zmienionej dostępności lub wariantach

  • poprawiono pobieranie i prezentację dostępnych metod płatności – metody zawsze są widoczne, nawet jeśli backend zwraca pustą listę

  • poprawiono zgodność przesyłanych danych płatności z aktualnym schematem, także dla metod opłaconych z góry lub testowych

  • poprawiono przekazywanie linku do karty produktu dla pozycji typu hot product w celu poprawnego przekierowania z aplikacji

  • poprawiono walidację danych w przypadku hot produktów – EAN jest wymagany i jego brak uniemożliwia dodanie produktu do listy polecanych

Wersja 2.2.1 (11.06.2025)

  • poprawiono błąd 500 występujący w panelu administracyjnym PrestaShop po aktualizacji modułu

  • poprawiono problem z błędem „duplicate key displayHeader” wynikający z błędnej deklaracji w pliku YAML

  • poprawiono działanie hooka displayHeader, który uniemożliwiał aktywację modułu po aktualizacji

  • poprawiono błąd PHP związany z nieobsługiwanym typem w klasie ErrorException po stronie frontu sklepu

  • poprawiono problem błędu 500 pojawiający się po aktualizacji modułu z wersji 1.10.0 do 2.2.0

  • poprawiono nieprawidłowości w strukturze plików konfiguracyjnych YAML, które powodowały przerwanie instalacji lub aktualizacji

Wersja 2.2.0: (03.06.2025)

  • dodano opcję przekazywania w danych zamówienia identyfikatorów klientów Google/Facebook celem umożliwienia propagacji do narzędzi analitycznych informacji o zdarzeniach dotyczących zamówień (Szczegółowy opis w artykule: https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/1107722241)

  • dodano wyświetlanie w widoku szczegółów zamówienia w panelu administracyjnym informacji, czy klient wyraził prośbę o wystawienie faktury VAT

  • dodano obsługę adresów email przeznaczonych do komunikacji dotyczącej realizacji zamówienia

  • poprawiono obsługę grup sklepów współdzielących koszyki klientów

  • poprawiono błąd mogący powodować niedostępność zakładki "ustawienia GUI" strony konfiguracji

Wersja 2.1.0: (29.04.2025)

  • dodano obsługę funkcjonalności produktów promowanych

  • dodano przekazywanie do aplikacji mobilnej informacji o dostępnych promocjach w oparciu o kody rabatowe z włączoną opcją "wyświetl w koszyku" 

  • dodano możliwość ograniczenia wyświetlania widgetu wiązania koszyka na kartach produktów w zależności od cech produktu

  • dodano opcję wyłączenia możliwości zakupu przez InPost Pay produktów nie spełniających warunków widoczności widgetu na karcie produktu

Wersja 2.0.2 (22.04.2025):

  • [!] Brak wsparcia dla Widgetu 1.0 [!] – Od tej wersji wsparcie dla Widgetu 1.0 zostało zakończone.

  • [!] Brak wsparcia dla PrestaShop 1.7.0 [!] – Od tej wersji PrestaShop w wersji 1.7.0 i niższej nie jest już wspierana.

  • dodano obsługę Widgetu InPost Pay w wersji 2.0*
    *Konieczne zmiany w konfiguracji modułu:

  • dodano możliwość oznaczania kodów rabatowych jako podlegających Dyrektywie Omnibus oraz przekazywanie do aplikacji mobilnej tej informacji w danych kodów rabatowych znajdujących się w koszyku

  • dodano integrację z modułem x13pricehistory w zakresie przekazywania w danych koszyka informacji o najniższych cenach przed rozpoczęciem promocji w przypadku produktów o obniżonych cenach

  • poprawiono przypadki, w których znaki dwukropku lub pauzy w nazwach atrybutów produktów znajdujących się w koszyku mogły uniemożliwiać przekazanie danych koszyka lub zamówienia do aplikacji mobilnej

  • poprawiono błąd powodujący, że w niektórych przypadkach w przekazywanych do aplikacji mobilnej informacjach o dostępności metod dostawy dla poszczególnych produktów nie było brane pod uwagę ustawione dla danego przewoźnika ograniczenie maksymalnej wagi paczki

 

Na tej stronie:

 

Wymagania

Do poprawnego działania wymagana jest instalacja PrestaShop w wersji nie niższej niż 1.7.1 oraz PHP w wersji nie niższej niż 7.1.

Uwaga: Instalacja na wersji PrestaShop 9.x nie jest rekomendowana.


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.


 

 

 

Aktualizacja

Uwaga: Nie należy aktualizować modułu poprzez jego odinstalowanie i ponowną instalację, ponieważ w takim przypadku nie zostanie uruchomiony mechanizm upgrade, co może skutkować błędami działania modułu lub utratą danych konfiguracyjnych. Aktualizacja powinna być zawsze wykonywana przez funkcję „Aktualizuj” w panelu lub poprzez nadpisanie plików modułu.


 

Instalacja

W celu instalacji wtyczki postępuj zgodnie z poniższymi krokami:

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

  2. Zaloguj się do sekcji administracyjnej swojego sklepu

  3. Z menu po lewej stronie wybierz “Moduły” a następnie “Menedżer modułów”.

  4. Na górze strony kliknij “Załaduj moduł”.

    Image_220224_14_55.png

  5. Do otwartego okna przeciągnij uprzednio pobrany moduł.

    image-20240216-153609.png

 


 

 

Konfiguracja modułu

W celu wstępnej konfiguracji przejdź do listy modułów i kliknij “Konfiguruj” obok modułu InPost Pay. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki.

 

konfiguracja.gif

 

Ustawienia podstawowe

[!] Brak wsparcia dla Widgetu 1.0 [!] – Od tej wersji wsparcie dla Widgetu 1.0 zostało zakończone.

Zakładka “Ustawienia” w konfiguracji modułu zawiera podstawowe ustawienia konfiguracyjne modułu.

image-2025-6-25_13-38-53.png

 

Ustawienia środowiska i klucze API

 

Konfiguracja środowiska zawiera wymagane pola, które trzeba uzupełnić jako pierwsze przy konfiguracji wtyczki.

Środowisko

image-20240216-154304.png

Konfiguracja środowiska zawiera trzy typy środowiska:

  • UAT - testowe środowisko przeznaczone dla developerów

  • Sandbox - testowe środowisko przeznaczone dla merchantów w celu testów wtyczki przed uruchomieniem produkcyjnym

  • Produkcja - środowisko produkcyjne, używaj tylko i wyłącznie jeśli przetestowałeś już wtyczkę na środowisku sandbox

Wyświetlanie widgetu

W konfiguracji modułu możesz ustawić widoczność widgetu.

image-20240216-154600.png

Dostępne są dwie opcje:

  • wszystkim - widget widoczny jest dla każdego kto dokonuje zakupy na sklepie, uruchamiaj tylko gdy wtyczka jest już skonfigurowana produkcyjnie i przetestowana

  • testerom - widget widoczny jest tylko po dodaniu parametru showIzi=true do url strony. Przykład https://mojsklep.pl?showIzi=true

Client ID

Wymagane pole konfiguracyjne.

image-20240216-154714.png

Client ID różni w zależności od wybranego środowiska. Aby uzyskać sandboxowe Client ID skontaktuj się z nami przez formularz kontaktowy. Aby uzyskać produkcyjne Client ID zaloguj się do panelu merchanta InPost i uzupełnij dane sklepu.

Client secret

image-20240216-154856.png

Client Secret różni się w zależności od wybranego środowiska. Aby uzyskać sandboxowe Client Secret skontaktuj się z nami przez formularz kontaktowy. Aby uzyskać produkcyjne Client Secret zaloguj się do panelu merchanta InPost i uzupełnij dane sklepu.

POS ID

Wymagane pole konfiguracyjne.

image-20240216-154959.png

W przypadku środowiska sandbox otrzymasz tą wartość razem z Client Id i Client Secret po uzupełnieniu formularza. W przypadku środowiska produkcyjnego zaloguj się do panelu merchanta InPost i pobierz POS ID.

Merchant Client ID

image-20250219-072342.png

Merchant Client ID jest wartością nadawaną przez InPost. W przypadku środowiska sandbox otrzymasz tą wartość razem z Client ID i Client Secret po uzupełnieniu formularza. W przypadku środowiska produkcyjnego zaloguj się do panelu merchanta InPost i pobierz Merchant Client ID.

Konfiguracja metod płatności

Konfiguracja dotycząca metod płatności jakimi będzie można dokonać płatność aplikacji InPost.

image-20250716-133808.png

Włącz wszystkie dostępne metody płatności

image-20250716-133905.png

Przełącznik umożliwiający aktywację wszystkich dostępnych metod płatności bez konieczności ich ręcznego wyboru z listy. Po ustawieniu na „Tak”, aplikacja InPost Pay wyświetli wszystkie metody dostępne po stronie konfiguracji konta Merchant InPost (zgodnie z umową).

 

Włączone metody płatności

image-20250716-134502.png

 

Rozwijana lista umożliwiająca ręczny wybór konkretnych metod płatności, które mają być widoczne w aplikacji InPost Pay.
Lista jest aktywna tylko wtedy, gdy przełącznik „Włącz wszystkie dostępne metody płatności” jest ustawiony na „Nie”.
Wybrane tutaj metody zostaną udostępnione użytkownikowi końcowemu w aplikacji mobilnej podczas finalizacji zamówienia.

 

Konfiguracja statusów zamówień

Gdy zamówienie zostanie utworzone z użyciem InPostPay możesz przypisać dla nich odpowiednie statusu zamówienia w swoim sklepie PrestaShop.

Początkowy status zamówienia utworzonego przez InPost Pay

Początkowy status dla zamówienia utworzonego poprzez aplikację InPost. Status możesz dowolnie zmieniać tworząc swój status zamówienia w panelu PrestaShop.

image-20240216-155351.png

Status zamówienia utworzonego przez InPost Pay (płatność za pobraniem)

Początkowy status dla zamówienia utworzonego poprzez aplikację InPost dla płatności za pobraniem. Status możesz dowolnie zmieniać tworząc swój status zamówienia w panelu PrestaShop.

image-20241028-154352.png

Status dla zamówienia opłaconego przez InPost Pay

Status dla zamówienia, które zostało opłacone poprawnie przez klienta w aplikacji InPost. Status możesz dowolnie zmieniać tworząc swój status zamówienia w panelu PrestaShop.

image-20240216-155445.png

Wyświetlanie widgetu na stronie potwierdzenia zamówienia

Widget na stronie potwierdzenia zamówienia możesz wyświetlać przez konfiguracje w trzech hookach. Wybierz ten, który najbardziej odpowiada twojemu szablonowi w sklepie. Widget musi być widoczny na górze strony od razu przy przekierowaniu na stronę potwierdzenia zamówienia.

Dostępne są trzy hooki:

  • displayPaymentReturn - domyślny hook w PrestaShop widoczny na stronie potwierdzenia zamówienia

  • displayOrderConfirmation - domyślny hook w PrestaShop widoczny na stronie potwierdzenia zamówienia

  • displayIziThankYou - hook modułu InPostPay, który umożliwia Ci użycie widgetu na stronie thank you page w dowolnym miejscu, jeśli hooki domyślne nie spełniają poprawnie swojej roli. Wymagana jest ręczna implementacja takiego hooka w pliku templates/checkout/order-confirmation.tpl dodajemy {hook h="displayIziThankYou" order=$order}.

Wyświetlanie widgetu na karcie produktu

Widget na karcie produktu możesz wyświetlać przez konfiguracje w dwóch hookach. Wybierz ten, który najbardziej odpowiada twojemu szablonowi w sklepie.

Dostępne są dwa hooki:

  • displayProductActions - domyślny hook w PrestaShop widoczny na stronie produktu

  • displayProductAdditionaInfo - domyślny hook w PrestaShop widoczny na stronie produktu

 

Wyświetlanie widgetu w checkoucie

Widget w checkoucie możesz wyświetlać przez konfiguracje w dwóch hookach.

Dostępne są dwa hooki:

  • displayCheckoutSummaryTop

  • displayIziCheckoutButton - wymagana jest ręczna implementacja w pliku szablonu {hook h="displayIziCheckoutButton"}.

 

Przesyłanie danych analitycznych

image-20250606-124743.png

Przełącznik umożliwia włączenie funkcji zbierania i przesyłania danych analitycznych do InPost Pay.
Po aktywacji, moduł zapisuje w ciasteczkach wartości parametrów gclid, fbclid oraz identyfikator użytkownika z ciasteczka _ga. Dane te są automatycznie przypisywane do koszyka i przesyłane w strukturze OrderDetails w momencie składania zamówienia.
Umożliwia to integrację z kampaniami Google Ads, Facebook Ads oraz Google Analytics (https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/1107722241).

Statusy zamówień

Nazwy statusów zamówień możesz zmieniać dla zamówień złożonych poprzez aplikację InPost.

Image_220224_14_57.png

Jeśli nie zostanie zmieniony jakiś status zamówienie to będzie wyświetlany nazwa w zależności od konfiguracji danego statusu w PrestaShop.

Komentarz zamówienia

Moduł pozwala na opcjonalne umieszczenie dodatkowych informacji w komentarzu do zamówienia w przypadku, gdy klient wybierze dostawę do Paczkomatu:

image-20240617-135109.png

W szablonie wiadomości dostępne do użycia są następujące parametry:

  • payment_type - kod wybranej przez klienta metody płatności

  • delivery_point - numer wybranego Paczkomatu

  • delivery_codes - lista kodów wybranych przez klienta usług dodatkowych

  • is_pww - czy klient wybrał usługę Paczka w Weekend (prawda/fałsz)

  • is_cod - czy klient wybrał usługę płatności pobraniowej (prawda/fałsz)

Fragmenty odpowiadające nazwie parametru umieszczonej w nawiasach klamrowych (“{ }”) zastępowane są wartością parametru - np. jeżeli klient wybrał dostawę do Paczkomatu “ABC123”, szablon:

Wybrany Paczkomat: {delivery_point}.
poskutkuje wiadomością treści:

Wybrany Paczkomat: ABC123.
Wartości logiczne wypisywane są jako “true” lub “false”, listy - ograniczone nawiasami kwadratowymi (“[ ]”).

Podwójne nawiasy klamrowe (“{{ }}“) pozwalają na wypisanie wyliczonej wartości wyrażenia - np. szablon:

Paczka w Weekend: {{ is_pww ? "tak" : "nie" }}.
poskutkuje wiadomością treści:

Paczka w Weekend: tak.
lub

Paczka w Weekend: nie.
w zależności od tego, czy klient wybrał odpowiednią opcjonalną usługę.

Szczegółowe informacje na temat składni wyrażeń można znaleźć w dokumentacji komponentu Expression Language w wersji odpowiedniej dla używanej wersji PrestaShop (2.x dla PS 1.7.0 - 1.7.3, 3.x dla pozostałych wersji 1.7, 4.x dla PS 8.x). Funkcja constant nie jest dostępna.

Konfiguracja zdjęć produktów

Sekcja umożliwia określenie, w jakim rozmiarze oraz w jakim zakresie zdjęcia produktów będą przesyłane do aplikacji InPost Pay.

image-20251121-075328.png

Typ zdjęcia na liście produktów

Określa rozmiar zdjęcia używanego w widokach listowych — np. w koszyku, podsumowaniu zamówienia lub sekcjach z rekomendacjami.
Zalecany jest mniejszy rozmiar, aby przyspieszyć wczytywanie widżetu.

Typ zdjęcia w szczegółach produktu

Definiuje rozmiar zdjęcia wykorzystywanego w podglądzie szczegółowym produktu w aplikacji InPost Pay.
Pozwala zachować spójność z prezentacją produktu w sklepie.

Typ zdjęcia duży

Wskazuje rozmiar zdjęcia wykorzystywanego w widoku powiększenia (np. po kliknięciu w zdjęcie w aplikacji).
Pole przydatne przy produktach posiadających zdjęcia w wysokiej jakości.

Domyślny rodzaj galerii zdjęć

Umożliwia wybór, czy do aplikacji InPost Pay mają być przesyłane tylko główne zdjęcie produktu, czy pełna galeria zdjęć.
Dostępne opcje:

  • Tylko zdjęcie okładkowe – do aplikacji trafia wyłącznie główne zdjęcie produktu.

  • Galeria zdjęć – do aplikacji przesyłane są wszystkie zdjęcia przypisane do produktu.

To ustawienie jest globalne i obowiązuje dla wszystkich produktów, o ile nie zostanie nadpisane indywidualnie w formularzu edycji produktu (zakładka Opcje → Opcje InPost Pay).

Sugerowane produkty

W konfiguracji modułu możesz ustawić maksymalną ilość produktów sugerowanych jakie mają być wyświetlane w aplikacji w podglądzie koszyka.

image-20240216-155726.png

 

Gdy wartość jest pusta ilość produktów będzie wyświetlana bez limitu. Produkty sugerowane są pobierane z produktów powiązanych, które aktualnie są dodane w do koszyka. Produkty powiązane możemy znaleźć na stronie konfiguracji danego produktu w zakładce “Ustawienia podstawowe”. Produkty powiązane są domyślną funkcją PrestaShop.

image-20240216-155803.png

 

produkty-powiazane.gif

Domyślna strona szczegółów promocji

image-20250429-073832.png

Strona, której adres zostanie użyty, jeśli w konfiguracji rabatu nie wskazano innej. W przypadku braku zarówno domyślnej strony, jak i strony przypisanej do rabatu, informacje o promocji nie zostaną przekazane do aplikacji mobilnej.

Uwaga:
W przypadku konfiguracji grupy sklepów z włączonym współdzieleniem koszyków i zamówień (tzw. multistore z funkcją współdzielenia), zaleca się, aby kody rabatowe były dostępne we wszystkich sklepach należących do danej grupy.
Ograniczenie kodu rabatowego wyłącznie do jednego sklepu w takiej konfiguracji może skutkować jego automatycznym usunięciem z koszyka – na przykład podczas aktualizacji zawartości koszyka lub po odwiedzeniu przez klienta innego sklepu z tej samej grupy, w którym dany kod nie jest dostępny.
Może to prowadzić do niespodziewanej utraty rabatu przez klienta tuż przed finalizacją zamówienia.

Zgody

W zakładce “Zgody” możemy dodać zgody, jakie będą wyświetlane w aplikacji InPost na etapie składania zamówienia. Przy dodawaniu zgody jest możliwość aby wskazać dodatkowe linki do wyświetlenia przy niej w aplikacji mobilnej. Nowe zgody możemy dodawać poprzez wybranie przycisku “Dodaj kolejną zgodę”.

image-20240807-141558.png

 

Opis wyświetlany w aplikacji

W polu “Opis wyświetlany w aplikacji” - wpisujemy treść danej zgody jaka ma być wyświetlana w aplikacji InPost. Pole jest wielojęzyczne.

image-20240216-160007.png

Obligacja zgody

Zgoda może być obligatoryjna do złożenia zamówienia lub opcjonalna.

image-20240216-160034.png

Pole przyjmuje wartości:

  • Opcjonalny - zgoda nie jest wymagana na etapie składania zamówienia

  • Zawsze wymagany - zgoda jest wymagana za każdym razem na etapie składania zamówienia

  • Wymagany raz - zgoda jest wymagana tylko raz na etapie składania zamówienia.

Identyfikator

Unikalny identyfikator linku. W opisie zgody fragmenty powstałe przez dodanie do ID przedrostka “#” zostaną zastąpione odpowiadającymi linkami.

image-20240807-142626.png

Adres zgody

W polu “Adres zgody” wybieramy stronę CMS, do której ma linkować dana zgoda w celu przeczytania informacji na temat danej zgody.

image-20240216-155940.png

Tekst na przycisku

Tekst, który zostanie wyświetlony na przycisku linku zgody. W przypadku pozostawienia pola pustego zostanie wyświetlony tekst “link”.

image-20240807-143245.png

 

Cena transportu

Zakładka “Cena transportu” zawiera pola konfiguracje dotyczące mapowania metod dostawy, kosztów oraz dostępności dostawy. Konfiguracje ustawiamy osobno dla usługi “Kurier” oraz “Paczkomat”.

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.

 

image-20240404-094037.png

 

Kurier

Konfiguracja usługi kuriera.

image-20240404-094141.png

Mapowanie metody dostawy - Kurier

Pole Mapowanie przewoźnika jest odpowiedzialne za zmapowanie metody dostawy z PrestaShop dla usługi Kuriera. W przypadku gdy dla usługi Kuriera i opcji płatności za pobraniem występuje osobna metoda dostawy wykonujemy mapowanie tej usługi w polu Mapowanie przewoźnika (Płatność za pobraniem).

image-20240404-094455.png

Kurier pobranie

Pole Płatność za pobraniem (Dodatkowy koszt) zawiera wartość netto kwoty do doliczenia w przypadku gdy usługa zostanie wybrana.

image-20240404-094554.png

Paczkomat

Konfiguracja usługi Paczkomat.

 

image-20240404-094927.png

 

Mapowanie metody dostawy - Paczkomat

Pole Mapowanie przewoźnika jest odpowiedzialne za zmapowanie metod dostawy z PrestaShop dla usługi Paczkomat. W sytuacji gdy dla opcji dodatkowych dostawy do Paczkomatu Płatność za pobraniem i Paczka w weekend występują osobne metody dostawy w PrestaShop wykonujemy mapowanie w odpowiednich polach Mapowanie przewoźnika (Płatność za pobraniem), Mapowanie przewoźnika (Paczka w Weekend), Mapowanie przewoźnika (Płatność za pobraniem + Paczka w Weekend).

image-20240404-095354.png

 

Paczkomat pobranie

Pole Płatność za pobraniem (Dodatkowy koszt) zawiera wartość netto kwoty do doliczenia w przypadku gdy usługa zostanie wybrana.

image-20240404-095814.png

 

Koszt dla usługi Paczkomat paczka w weekend

Pole Paczka w Weekend (Dodatkowy koszt) jest odpowiedzialne za koszt netto usługi Paczkomat w weekend. Stawka VAT pobierana jest z konfiguracji przewoźnika zmapowanego w polu “Paczkomat”.

image-20240404-095851.png

Dostępność usługi Paczkomat paczka w weekend

Za dostępność usługi “Paczkomat paczka w weekend” odpowiadają pola dostępności. “Dostępny od” - “Dostępny do” określa okres czasu od jakiego ma być dostępna usługa paczki w weekend w aplikacji InPost.

image-20240404-100039.png

 

Ustawienia GUI

Zakładka “Ustawienia GUI” jest odpowiedzialna za konfiguracja wyświetlania widgetu przycisku na stronie produktu oraz koszyka. Przyciski poglądowe są odświeżane dynamicznie aby zaprezentować aktualny wygląd przycisku z danymi ustawieniami. Trzeba pamiętać o kliknięciu w przycisk “Zapisz” aby zapisać aktualne zmiany dokonane w konfiguracji.

image-20250219-101324.png

Pamiętaj!
Ustawienia wyświetlania oraz układ przycisków należy skonfigurować zgodnie ze Standardami Implementacji InPost Pay.

Strona koszyka

Widget przycisku wyświetlany jest na stronie koszyka i umożliwia połączenie koszyka z aplikacją InPost oraz jego realizację z poziomu aplikacji.

Strona produktu

Widget przycisku wyświetlany jest na karcie produktu i umożliwia on połączenie koszyka z aplikacją InPost. Wybranie przycisku jednoczenie dodaje produkt do koszyka. Pozwala także na ograniczenie wyświetlania widgetu parowania koszyka na stronach produktów w zależności od typu, domyślnej kategorii, producenta lub atrybutów produktu.

Strona logowania

Widget przycisku wyświetlany jest na stronie logowania pod formularzem logowania.

Strona rejestracji

Widget wyświetlany jest na stronie rejestracji nad formularzem rejestracji.

Strona zamówienia

Widget przycisku wyświetlany jest na stronie realizacji zamówienia powyżej podsumowania zamówienia.

Podgląd koszyka

  • Widget przycisku wyświetlany jest na podglądzie koszyka. Wymaga użycia niestandardowego hooku – należy zaimplementować w szablonie {hook h="displayIziCartPreviewButton"}.

 

Konfiguracja widgetu

Pola dla konfiguracji widgetu na stronie koszyka oraz produktu są takie same. Jednak wygląd każdego przycisku może się różnić i moduł daje możliwość konfiguracji tych pól osobno dla każdego umiejscowienia.

Wyświetlanie widgetu

Moduł umożliwia wyłączenie wyświetlania takiego przycisku dla strony produktu oraz koszyka. Zalecane jest w celu zwiększenia konwersji by widget był widoczny na stronie koszyka, zarówno jak na karcie produktu.

image-20240216-161537.png

Wyrównanie widgetu

Określa orientację widżetu w dostępnej dla niego przestrzeni. Jeśli szablon przydziela wąską przestrzeń dla widżetu, ustawienie to nie wpłynie na jego wygląd.

image-20240216-161609.png

 

Dostępne opcje wyrównania:

  • Do lewej - powoduje przesunięcie widgetu do lewej strony

  • Wyśrodkowane - powoduje wyśrodkowanie widgetu

  • Do prawej - powoduje przesunięcie widgetu do prawej strony

Tło widgetu

Określa czy widget znajduje się na jasnym czy ciemnym tle w Twoim sklepie. Ustawienie ma wpływ na kolor czcionki, zadbaj o to, aby była widoczna.

image-20240216-161730.png

Tło widget zawiera dwie opcje:

  • Jasne - wybierz tą opcję jeśli przycisk jest wyświetlany na jasnym tle

  • Ciemne - wybierz tą opcję jeśli przycisk jest wyświetlany na ciemnym tle

Wariant widgetu

Widget dostępny jest w 2 wariantach kolorystycznych. Wybierz ten, bardziej odpowiadający kolorystyce Twojego sklepu.

image-20240216-161857.png

Wariant widgetu zawiera dwie opcje do wyboru:

  • Żółty - wybierz tą opcję jeśli chcesz by przycisk miał kolor żółty

  • Czarny - wybierz tą opcję jeśli chcesz by przycisk miał kolor czarny

Styl ramki widgetu

Pole konfiguracyjne określa w jakim stylu powinien być wyświetlony przycisk na stronie sklepu.

image-20240216-162014.png

Konfiguracja stylu ramki zawiera trzy warianty:

  • Kwadratowe - wybierz tą opcję jeśli chcesz by przycisk nie miał zaokrąglonych rogów