Wdrożenie modułu płatności eService dla systemu PrestaShop

1. Wstęp  

Rozwiązanie, z którego obecnie Państwo korzystają, będzie stopniowo zastępowane nowszymi i ulepszonymi wersjami. Dlatego już teraz zachęcamy do aktualizacji, aby korzystać z pełnej funkcjonalności.  

Nowe proponowane przez nas rozwiązanie techniczne oparte jest na Drop-In-UI  – gotowym widoku użytkownika łatwym do osadzenia w aplikacji, które:

• spełnia wszystkie wymogi bezpieczeństwa – w tym standardy PCI DSS,
• zwiększa wygodę korzystania ze strony, m.in. pozwalając dostosować jej wygląd,
• zostało zaprojektowane zgodnie z najnowszymi trendami rynkowymi w obszarze digital.  

Rozwiązanie Drop-In UI obsługuje najpopularniejsze metody płatności, takie jak:  

• BLIK
• karty płatnicze
• przelewy bankowe
• portfele elektroniczne Apple Pay i Google Pay

1.1 Przeznaczenie dokumentu  

Niniejszy dokument przedstawia kroki niezbędne do uruchomienia płatności eService przy użyciu modułu Global Payments przeznaczonego dla systemu PrestaShop.

1.2 Przygotowanie do integracji  

Przed rozpoczęciem implementacji modułu w systemie należy pobrać najnowszą wersję modułu płatności Global Payments dla PrestaShop.

Moduł można pobrać na dwa sposoby:

• bezpośrednio z Marketplace PrestaShop (metoda ta jest płatna, zgodnie z cennikiem PrestaShop)
• Bezpłatnie - korzystając z linku: https://cloud.evopayments.com/cloud/index.php/s/DLGM1heDX8rDxAw

Dostęp do chmury do pobrania wtyczki zabezpieczony jest hasłem: 15092025

1.3 Wymagania techniczne

• Aktualizacja wykorzystywanych modułów w sklepie internetowym (aktualizacje dostępne w backoffice PrestaShop),
• PrestaShop w wersji 8.x lub wyższej, gdzie:
  • dla wersji 8.x - wymagane PHP w wersji 8.1 lub nowsze,
  • dla wersji 9.x  - wymagane PHP w wersji minimum 8.3

1.4 Bezpieczna komunikacja

ecom_upgrades@eservice.com.pl – adres kontaktowy do zespołu odpowiedzialnego za aktualizacje i wsparcie przy przejściu na nową wersję. Z tego adresu wysłane zostaną również dane dostępowe do nowej wersji bramki płatniczej. 

login@eservice.com.pl – adres systemowy do otrzymania danych logowania do back office (RealControl), gdzie można w pełni zarządzać transakcjami. Podczas logowania możliwe jest ustawienie języka polskiego w lewym dolnym rogu ekranu. 

Mail dotyczący back office (RealControl) może zostać wysłany w języku polskim lub angielskim – poniżej przykładowa wiadomość.

2. Instalacja modułu Global Payments dla PrestaShop

2.1 Instalacja sposób pierwszy (pobranie bezpośrednio z Marketplace PrestaShop)

W panelu administracyjnym w menu znajdującym się po lewej stronie w sekcji ULEPSZANIE należy wybrać Moduły, a następnie Marketplace.  

 
 
 
W polu wyszukiwarki należy wprowadzić frazę Global Payments a następnie, w przypadku wyboru płatnej opcji – Kup teraz, a po dokonaniu płatności przejść do instalacji i włączenia wtyczki. 

Po zainstalowaniu wtyczki, należy przejść do jej konfiguracji.

2.2 Instalacja sposób drugi (pobranie za pośrednictwem linku). 

Po pobraniu najnowszej wersji wtyczki GlobalPayments z linku https://cloud.evopayments.com/cloud/index.php/s/DLGM1heDX8rDxAw, należy zainstalować ją w systemie sklepu PrestaShop zgodnie z dalszymi instrukcjami.

• W pierwszej kolejności, należy zalogować się do panelu administracyjnego PrestaShop.  
• W panelu administracyjnym w menu znajdującym się po lewej stronie w sekcji ULEPSZANIE należy wybrać Moduły, a następnie Menedżer modułów.  Następne należy wybrać przycisk Załaduj moduł znajdujący się w prawym górnym rogu. 

• Do okna, które zostanie wyświetlone należy przeciągnąć plik globalpayments.zip pobrany z linku powyżej lub nacisnąć wybierz plik i wskazać lokalizację pobranego pliku globalpayments.zip. 

• Wtyczka rozpocznie instalację. Zasygnalizuje to komunikatem Instalowanie modułu…

 Po skutecznej instalacji modułu wyświetlony zostanie komunikat Moduł zainstalowany!

Po zakończonej instalacji należy wybrać przycisk Konfiguruj, aby przejść do skonfigurowania wtyczki.

2.3 Konfiguracja modułu płatności  

• Jeśli w poprzedniej sekcji wybrano przycisk Konfiguruj zgodnie z instrukcją, użytkownik automatycznie zostanie przeniesiony do konfiguracji wtyczki i podstawowych metod płatności. 
  
  W przypadku, gdy po instalacji zdecydowano się na przełożenie jej konfiguracji, po ponownym zalogowaniu się do backoffice PrestaShop należy przejść do konfiguracji wybierając kolejno w menu znajdującym się z lewej strony panelu PrestaShop w sekcji ULEPSZANIE Moduły, następnie Menedżer modułów. Kolejno odszukaj w tej sekcji wtyczkę Global Payments znajdującą się w module Payments. Z prawej strony nazwy modułu, wybierz Konfiguruj. 

• W obu przypadkach opisanych powyżej użytkownik zostanie przeniesiony do konfiguracji wtyczki. Głównym modułem z którego należy korzystać jest moduł UNIFIED PAYMENTS. Pozwala on na skonfigurowanie podstawowych metod płatności takich jak karty płatnicze, BLIK oraz płatności za pomocą konta bankowego. 

• Aby prawidłowo skonfigurować wtyczkę, należy wykonać kolejno poniżej opisane czynności: 
  • Aby włączyć płatności należy przesunąć suwak opisany jako Enable na wartość Yes

  • Title – nazwa metody płatności, jaka będzie się wyświetlać na stronie Zamówienia - należy uzupełnić tutaj eService

  • Następnie należy włączyć tryb produkcyjny dla procesowania płatności ustawiając suwak na wartość Yes przy pozycji Live Mode 

Powyższe ustawienia powinny prezentować się jak na poniższym zrzucie: 

• W kolejnym kroku należy uzupełnić dane uwierzytelniające do bramki płatniczej (Live App Id oraz Live App Key) oraz wprowadzić dodatkowe ustawienia opisane poniżej. 
  
  Ważne! Dane do nowej wersji bramki płatniczej są wysyłane e-mailem!
   

  • Live App Id – unikalny identyfikator sklepu w bramce płatniczej (przekazany przez eService w odrębnej komunikacji). 

  • Live App Key – hasło do bramki płatniczej (przekazany przez eService  w odrębnej komunikacji). 
  • Live Account Name – subkonto dla sklepu, w bramce płatniczej, wartość ta wybierana jest z listy, która pojawi się dopiero po sprawdzeniu prawidłowego wprowadzenia danych i kliknięciu przycisku Credentials check.
  • Credentials check – po wprowadzeniu danych App Key oraz App ID, należy wybrać przycisk “Credentials check” w celu weryfikacji poprawności wprowadzonych danych. Przy udanej próbie komunikacji z bramką pojawi się komunikat Your credentials were successfully confirmed!
    
    
    Poniżej znajduje się komunikat o prawidłowej weryfikacji danych do bramki:
    
    
    Poniżej natomiast widok z pola Live Account Name (po wykonaniu Credentials check). 
    
    Ważne! W pozycji Account Name wybierz konto rozpoczynające się od ECOM72
    
    
    General Settings:
  •  Enable logging - służy do zapisywania logów, domyślnie opcja powinna zostać wyłączona, a włączyć ją można w przypadku konieczności weryfikacji napotkanych trudności.
  • Contact Url – adres url sklepu z danymi kontaktowymi (np. https://www.przykladowylink.pl/kontakt).
  • Enable 3D Secure – opcja MUSI być obowiązkowo WŁĄCZONA, jest ona odpowiedzialna za włączenie uwierzytelniania klienta w trakcie płatności kartą.
  • Payment Action – konfiguruje, jak bramka ma zachować się w momencie płatności kartą:
    • Authorize + Capture  – klient od razu jest obciążany, za płatność - wartość domyślna. 
    • Authorize only – klient ma tylko zablokowane środki na koncie, wymagane wysłanie obciążenia na finalną kwotę (równą lub  mniejszą, niż w pierwotnej autoryzacji).
  • Allow card saving – opcję należy pozostawić domyślnie wyłączoną, wymaga dodatkowych zgód, konfiguracji i ustaleń biznesowych. W przypadku, zainteresowania tym modułem należy skontaktować się z Opiekunem Biznesowym ze strony eService.
  • Order Transaction Descriptor oraz Sort Order należy pozostawić bez zmian.
  • Enable Blik Payment – włącza płatność BLIK-iem na bramce (jeśli dostępna - zgodnie z umową).
  • Enable Open Banking Payment – włącza płatność przelewami bankowymi na bramce (jeśli dostępna - zgodnie z umową).
    
    

• Po zakończeniu konfiguracji należy zapisać wprowadzone zmiany. Od tego momentu bramka płatnicza będzie widoczna wraz z włączonymi metodami płatności w sklepie, w podsumowaniu zamówienia. 

3. Tryb testowy  

Uwaga! Środowiska testowe są tworzone na specjalne życzenie klienta.

 Aby przełączyć się na tryb testowy w konfiguracji metody płatności Unified Payments, należy:

• Odznaczyć pole wyboru Live Mode (suwak przestawić na pozycję No).
• Wprowadzić dane dedykowane dla środowiska testowego (inne niż produkcyjne) udostępnione przez eService: Sandbox App Id, Sandbox App Key oraz Sandbox Account Name. 

4. Bezpieczna aktualizacja wtyczki Global Payments dla PrestaShop

4.1 Instalacja & konfiguracja aktualizacji

1. Nową wtyczkę należy zainstalować wybraną przez użytkownika metodą, zgodnie z instrukcjami opisanymi w rozdziale2. Instalacja modułu Global Payments dla PrestaShop.
2. Nową wtyczkę należy skonfigurować zgodnie z instrukcjami zawartymi  w rozdziale 2.3 Konfiguracja modułu płatności.
3. Na tym etapie w systemie sklepu są już zainstalowane i skonfigurowane dwie wersje wtyczki – zarówno starsza, jak i nowa.

4.2 Odpięcie poprzedniej wersji wtyczki do płatności

Aby korzystać w pełni z nowej wersji wtyczki, w kolejnym kroku należy odpiąć dotychczas używaną wersję. 
W tym celu w panelu administracyjnym w menu znajdującym się po lewej stronie w sekcji ULEPSZANIE należy wybrać Moduły, a następnie Menedżer modułów.

Kolejno należy odszukać kategorię Payments -  znajdują się tam m.in. wtyczki: eService oraz Global Payments. Nowa nazwa wtyczki to Global Payments, poprzednią wersję, tj. eService należy wyłączyć.

W tym celu obok wtyczki eService należy rozwinąć listę i wybrać Wyłącz jak na poniższym zrzucie ekranu. 

4.3 Wykonanie testowego zamówienia na koncie produkcyjnym  

Rekomendujemy wykonanie testowego zamówienia w swoim sklepie (czyli dokonanie rzeczywistej płatności), aby ostatecznie sprawdzić, czy wszystkie mechanizmy działają poprawnie. 

W tym celu należy:

• Dodać przykładowy produkt do koszyka (proponujemy dodanie dodatkowego produktu w sklepie za np. symboliczną złotówkę).
• Uzupełnić niezbędne informacje do zamówienia.
• Sfinalizować płatność.

Na tym etapie nowa wersja bramki płatniczej będzie już widoczna i powinna funkcjonować prawidłowo.

• Po opłaceniu zamówienia i braku komunikatów o błędzie test uznaje się za pozytywny.
• W przypadku problemów lub błędów prosimy o kontakt pod adresem podanym w sekcji Kontakt.
• Po dokonaniu płatności możliwe jest dokonanie zwrotu z poziomu nowego backoffice, do którego również otrzymają Państwo dane logowania. 
  
  
  Poniżej prezentacja nowej wersji bramki na stronie płatności:

5. Kontakt  

W razie jakichkolwiek pytań podczas wdrożenia prosimy o kontakt z Zespołem Wdrożeniowym eService: email: ecom_upgrades@eservice.com.pl