InPost Pay - PrestaShop

 

 

Wstęp

Niniejsza instrukcja przedstawia proces instalacji oraz konfiguracji wtyczki, umożliwiającej wprowadzenie InPost Pay w sklepie PrestaShop.

 


Wtyczka

Wersja 1.5.7 (27.03.2024):

 

*Wtyczka obecnie jest jeszcze rozwijana, będą pojawiały się nowe wersje wtyczki, śledź changelog i instaluj nowe wersje, jak tylko będą dostępne.

Changelog

 

Wersja 1.5.7 (27.03.2024)

  • poprawiony błąd powodujący w wersjach PS wcześniejszych niż 1.7.5 natychmiastowe przerwanie nasłuchiwania na zdarzenie powiązania koszyka z aplikacją po kliknięciu w przycisk parowania koszyka na karcie produktu.

Wersja 1.5.6 (20.03.2024)

  • poprawiony błąd w formularzu konfiguracyjnym dla wersji PS wcześniejszych niż 1.7.6, gdzie mimo wyboru opcji wyświetlania widgetu jedynie testerom, widget był widoczny dla wszystkich użytkowników

Wersja 1.5.5 (20.03.2024):

  • zaktualizowane deep linki dla środowisk testowych

  • dodana możliwość ustawienia mapowania metod dostawy na różnych przewoźników w zależności od wybranych dodatkowych usług (płatność za pobraniem, Paczka w Weekend)

  • usunięta możliwość konfiguracji dostępności płatności za pobraniem w zależności od dnia tygodnia i czasu

  • usunięta możliwość konfiguracji dostępności Paczki w Weekend dla przesyłki kurierskiej

  • poprawione przypadki, gdzie aktualizacja koszyka mogła skutkować błędem 500 z uwagi na niedostępność używanych przez wtyczkę komponentów

  • usunięte prezentowanie InPost Pay na liście dostępnych metod płatności w widoku zamówienia

  • poprawiona obsługa przypadków, gdzie serwer sklepu nie pozwala na zapytania metodą DELETE

  • poprawiony błąd, gdzie wymagany numer telefonu komórkowego w danych adresowych skutkował brakiem możliwości złożenia zamówienia przez aplikację mobliną

Wersja 1.5.4 (22.02.2024):

  • poprawka błędu z wyłączoną opcją płatności pobraniowej

  • zniesienie ograniczenia instalacji na PrestaShop 8.x

  • zmiany w przekazywaniu opisów produktów

Wersja 1.5.3 (20.02.2024):

  • poprawki dotyczące API PrestaShop

Wersja 1.5.2 (20.02.2024):

  • poprawki konfiguracji zgód oraz opisów statusów zamówień

  • ograniczenie wymagalności tekstu opisu zgody jedynie do języka domyślnego dla sklepu

  • poprawione błędy skutkujące niedostępnością API PrestaShop

Wersja 1.5.1 (20.02.2024):

  • poprawka dotycząca zapisywania zmian w formularzach

Wersja 1.5.0 (16.02.2024):

  • poprawiona obsługa błędów i niezawodność działania wtyczki

  • dodane prezentowanie w aplikacji mobilnej atrybutów produktów posiadających warianty

  • dodana opcja konfiguracyjna pozwalająca wybrać miejsce wyświetlania widgetu "thank you" na stronie potwierdzenia zamówienia

  • poprawiony błąd przy aktualizacji ilości produktu w koszyku w aplikacji mobilnej, gdzie dostępny stan produktu był pomniejszany o ilość już znajdującą się w koszyku

  • poprawione produkty sugerowane prezentowane w aplikacji (nieuwzględnianie produktów niedostępnych)

  • poprawiona cena jednostkowa produktu prezentowana w danych zamówienia w aplikacji mobilnej (uwzględnienie zniżek nie wynikających z zastosowania kodów rabatowych)

  • poprawione przypadki, gdzie znaki specjalne w opisach produktów mogły powodować problem z synchronizacją danych koszyka między aplikacją mobilną a sklepem

  • zmieniony układ strony konfiguracji modułu na PrestaShop w wersji 1.7.6 i późniejszych

 

Wymagania

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


 

 

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

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


 

 

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.

Ustawienia podstawowe

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

Ustawienia środowiska i klucze API


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

Środowisko

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.

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.

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 InPost i uzupełnij dane sklepu.

Client secret

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 InPost i uzupełnij dane sklepu.

POS ID

Wymagane pole konfiguracyjne.

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 InPost i pobierz POS ID.

Konfiguracja metod płatności

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

Bramki płatności

Metody płatności zostały określone na umowie o obsługę bramki płatniczej

 

Płatność przy odbiorze

Płatność przy odbiorze będzie dostępna tylko wtedy, kiedy posiadasz podpisaną umowę z InPost na świadczenie tej usługi w Twoim sklepie.

 

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.

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.

Wyświetlanie widgetu na stronie potwierdzenia zamówienia

Widget na stronie potwierdzenia zamówienia możesz wyświetlać przez konfiguracja 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}.

Statusy zamówień

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

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.

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.

 

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.

Zgody

W zakładce “Zgody” możemy dodać zgody jakie będą wyświetlane w aplikacji InPost na etapie składania zamówienia. Nowe zgody możemy dodać poprzez wybranie przycisku “Dodaj kolejną zgodę”.

Adres zgody

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

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.

Obligacja zgody

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

 

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.

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

 

 

Kurier

Konfiguracja usługi kuriera.

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

Kurier pobranie

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

Paczkomat

Konfiguracja usługi Paczkomat.

 

 

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

 

Paczkomat pobranie

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

 

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

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.


 

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.

 

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.

Konfiguracyjne 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 z osoba.

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.

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.

 

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.

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.

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.

Konfiguracja stylu ramki zawiera trzy warianty:

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

  • Zaokrąglone - wybierz tą opcję jeśli chcesz by rogi były nieznacznie zaokrąglone

  • Okrągłe - wybierz tą opcję jeśli chcesz by rogi były mocno zaokrąglone.

Szerokość widgetu

Moduł umożliwia nam ustawienia minimalnej oraz maksymalnej wartości szerokości dla widgetu. Minimalna wartość dla widgetu to 220px, a maksymalna wynosi 600px.

W pole wpisujemy tylko wartości numeryczne bez przyrostka “px”.

Marginesy widgetu

Jeżeli przycisk jest źle ułożony lub “styka” się z innymi elementami UI na stronie sklepu, masz możliwość określenia marginesów dla widgetu.

 

Wszystkie pola marginesów przyjmują wartość numeryczną bez przyrostka “px”.

Zakładka Support

Zakładka “Support” zawiera przydatne informacja min. status wtyczki, który informuje czy wtyczka została poprawnie skonfigurowana. Umożliwia nam włączyć tryb debugowania oraz pobrać logi wraz z przydatnymi informacjami, która mogą pomóc przy rozwiązać problem podczas kontaktu z supportem.

Status wtyczki

Status wtyczki informuje nas czy moduł jest poprawnie skonfigurowany. Jeśli moduł jest poprawnie skonfigurowany wyświetla on status “OK”.

 

Jeśli występują jakieś problemy z konfiguracją wyświetlana jest status “BŁĄD” i moduł dostarcza informacji na temat błędu w konfiguracji.

Pobieranie danych wtyczki oraz logów

Moduł umożliwia pobranie danych na temat wtyczki oraz logów modułu, które pomogą przy rozwiązaniu problemów związanych z wtyczką.

Tryb debugowania

Włącznie trybu debugowania zwiększa zwiększa ilość informacji jaka jest zawarta w logach modułów. Może być przydatne w ramach supportu wtyczki gdzie wszelkie informację zawarte w logach mogą pomóc w rozwiązaniu problemu.