Wdrożenie modułu płatności eservice dla systemu PrestaShop Wersja 04 Wrzesień 2016 Centrum Elektronicznych Usług Płatniczych eservice Sp. z o.o.
Spis treści 1. Wstęp... 3 1.1. Przeznaczenie dokumentu... 3 1.2. Przygotowanie do integracji... 3 2. Instalacja modułu PrestaShop... 3 2.1. Konfiguracja serwera oraz systemu PrestaShop... 3 2.2. Ustalenie początkowego numeru zamówienia eservice... 3 2.3. Instalacja plików źródłowych... 3 2.4. Konfiguracja modułu płatności... 4 3. Kontakt... 5 Centrum Elektronicznych Usług Płatniczych eservice Sp. z o.o. Strona 2 z 5
1. Wstęp 1.1. Przeznaczenie dokumentu Niniejszy dokument opisuje czynności niezbędne do uruchomienia płatności eservice z wykorzystaniem modułu dla systemu PrestaShop w wersji 1.5-1.6. Przed przystąpieniem do wdrożenia zalecamy zapoznać się z ogólną dokumentacją techniczną integracji systemów płatności eservice. 1.2. Przygotowanie do integracji Przed rozpoczęcie procesu implementacji modułu w systemie sklepu, należy sprawdzić wersję wykorzystywanego systemu PrestaShop oraz pobrać najnowszą wersję modułu płatności eservice dla tejże wersji. Moduły dostępne są na stronie https://eservice.pl Serwer powinien posiadać uruchomiony moduł mod_rewrite oraz oprogramowanie Prestashop uruchomiony Friendly URL. 2. Instalacja modułu PrestaShop 2.1. Konfiguracja serwera oraz systemu PrestaShop Do poprawnego funkcjonowania modułu eservice wymagane jest uruchomienie na serwerze www modułu mod_rewrite oraz skonfigurowanie PrestaShop do obsługi skróconych URL. W celu konfiguracji PrestaShop należy w panelu administracyjnym sklepu przejść do zakładki Preferencje, następnie Dane URL i SEO oraz uruchomienie Friendly URL. 2.2. Ustalenie początkowego numeru zamówienia eservice Jeżeli merchantid był wykorzystywany do przeprowadzania transakcji w systemie eservice, może zajść konieczność ustalenia początkowego numeru zamówienia w sklepie. W tym celu należy wykonać polecenie SQL: ALTER TABLE `ps_orders` AUTO_INCREMENT = 123; gdzie 123 będzie początkowym numerem zamówienia w tej instalacji sklepu PrestaShop. Uwaga: Wykonując testy systemu w środowisku testowym płatności może zajść konieczność zmiany początkowego numeru zamówienia. Jest to związane w koniecznym warunkiem unikalności pary MerchantID oraz OrderID dla Akceptanta. (Patrz: ogólna dokumentacja techniczna systemu płatności.) 2.3. Instalacja plików źródłowych Pliki źródłowe modułu płatności eservice umieszczone są w katalogu eservice. Katalog ten należy skopiować do katalogu modules w instalacji sklepu PrestaShop. Po poprawnym skopiowaniu plików można przystąpić do konfigurowania modułu płatności. Centrum Elektronicznych Usług Płatniczych eservice Sp. z o.o. Strona 3 z 5
Moduł można również zainstalować poprzez kliknięcie w menu administracyjnym Modułu > Moduły i usługi, a następnie w przycisk Dodaj nowy moduł. Wybrać plik archiwum dostarczony przez eservice i kilknąć przycisk Prześlij moduł. 2.4. Konfiguracja modułu płatności W celu skonfigurowania modułu płatności należy przejść do panelu administracyjnego sklepu. W menu z panelu administracyjnego wybieramy sekcje Moduły a następnie na liście wszystkich modułów wyszukujemy moduł eservice (Rysunek 1). Rysunek 1: Wybór modułu płatności eservice Klikamy na przycisk Instaluj. Gdy instalacja zakończy się pojawi się komunikat: Moduł(y) zainstalowane poprawnie. W celu dostosowania parametrów modułu płatności klikamy na przycisk Konfiguruj. Na ekranie pokaże się formularz (Rysunek 2). Znaczenie pól formularza opisano poniżej. Merchant ID W polu tym należy wprowadzić identyfikator Akceptanta otrzymany z eservice. Hasło merchanta / Klucz sklepu W polach należy wprowadzić hasło właściwe dla Akceptanta określonego w polu Merchant ID. Połącz z Moduł płatności umożliwia zarówno łączenie ze środowiskiem testowym płatności jak i z systemem produkcyjnym umożliwiającym dokonywanie realnych płatności. W celach testowych należy wybrać opcję Centrum Elektronicznych Usług Płatniczych eservice Sp. z o.o. Strona 4 z 5
Środowisko testowe. Po przyznaniu własnego, unikalnego numeru MerchantID należy wybrać opcję Środowisko produkcyjne. Bezwzględna ścieżka do katalogu z plikiem logów eservice System ma możliwość zapisywania informacji diagnostycznych. W celu ich zapisywania, o polu tekstowym należy podać pełną ścieżkę do pliku, w którym mają być zapisywane logi pracy systemu. Uwaga: system (użytkownik na prawach którego działa serwer Apache) musi mieć uprawnienia do tworzenia i zapisu plików w wybranym katalogu. Sekcja statusy płatności określ statusy płatności jakie będą ustawiane dla poszczególnych etapów płatności. Inicjalny status zamówienia Status który zostanie ustawiony po zapoczątkowaniu płatności eservice. Status transakcji oczekującej Status który zostanie ustawiony po powrocie klienta na stronę sklepu po dokonaniu płatności jednak bez informacji o statusie transakcji z banku. Status zostanie zaktualizowane niezwłocznie po otrzymaniu przez eservice ostatecznego statusu transakcji z banku. Status po poprawnej płatności Status który zostanie ustawiony po powrocie klienta na stronę sklepu w przypadku płatności zakończonej powodzeniem. Status po błędnej płatności Status który zostanie ustawiony po powrocie klienta na stronę sklepu w przypadku płatności zakończonej niepowodzeniem. 3. Kontakt W razie jakichkolwiek pytań podczas wdrożenia prosimy o kontakt z Zespołem Wdrożeniowym eservice: tel.: +48 22 533 22 44 email: Wdrozenia_eCommerce@eservice.com.pl Problemy powdrożeniowe występujące na środowisku produkcyjnym prosimy zgłaszać na skrzynkę pocztową Wsparcie_eCommerce@eservice.com.pl. Centrum Elektronicznych Usług Płatniczych eservice Sp. z o.o. Strona 5 z 5