Wdrożenie modułu płatności eservice dla systemu PrestaShop 1.3-1.6 - dokumentacja techniczna Wer. 02 Warszawa, lipiec 2014 1
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 Ustalenie początkowego numeru zamówienia eservice... 3 2.2 Instalacja plików źródłowych... 4 2.3 Konfiguracja modułu płatności... 4 3 Kontakt... 6 2
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 http://eserviceonline.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: 3
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. 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). 4
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 płatności. 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. 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 po przekierowaniu po płatności poprawnej Status który zostanie ustawiony po powrocie klienta na stronę sklepu po dokonaniu poprawnej płatności. 5
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 płatności. Status po notyfikacji o porażce Status który zostanie ustawiony po otrzymaniu powiadomienia POST o porażce przeprowadzonej płatności. 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: Wdrożenia_eCommerce@eservice.com.pl Problemy powdrożeniowe występujące na środowisku produkcyjnym prosimy zgłaszać na skrzynkę pocztową Wsparcie_eCommerce@eservice.com.pl 6