Wdrożenie modułu płatności eservice dla systemu PrestaShop 1.3-1.6 Wersja 03 Styczeń 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.3-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 ) 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 Centrum Elektronicznych Usług Płatniczych eservice Sp. z o.o. Strona 3 z 5
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 dla merchanta W polu tym 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 W celach testowych należy wybrać opcję Ś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. Centrum Elektronicznych Usług Płatniczych eservice Sp. z o.o. Strona 4 z 5
Sekcja statusy płatności określ statusy płatności jakie będą ustawiane dla poszczególnych etapów Inicjalny status zamówienia Status który zostanie ustawiony po zapoczątkowaniu płatności eservice. Status po przekierowaniu po płatności poprawnej Status który zostanie ustawiony po powrocie klienta na stronę sklepu po dokonaniu poprawnej Status po przekierowaniu klienta z błędem Status który zostanie ustawiony po powrocie klienta na stronę sklepu w przypadku płatności zakończonej niepowodzeniem. Status po notyfikacji o sukcesie Status który zostanie ustawiony po otrzymaniu powiadomienia POST o sukcesie przeprowadzonej Status po notyfikacji o porażce Status który zostanie ustawiony po otrzymaniu powiadomienia POST o porażce przeprowadzonej 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