Wdrożenie modułu płatności eservice dla systemu OpenCart 2 Wersja 02 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 dla OpenCart... 3 2.1. Instalacja plików źródłowych... 3 2.2. Konfiguracja modułu płatności... 3 3. Kontakt... 7 Centrum Elektronicznych Usług Płatniczych eservice Sp. z o.o. Strona 2 z 7
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 OpenCart w wersji 2. 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ęciem procesu implementacji modułu w systemie sklepu, należy sprawdzić wersję wykorzystywanego systemu OpenCart oraz pobrać najnowszą wersję modułu płatności eservice dla tejże wersji. Moduły dostępne są na stronie https://eservice.pl 2. Instalacja modułu dla OpenCart 2.1. Instalacja plików źródłowych Pliki źródłowe modułu płatności eservice umieszczone są w archiwum, które należy skopiować do głównego katalogu sklepu OpenCart. Po poprawnym skopiowaniu plików można przystąpić do konfigurowania modułu płatności. 2.2. 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 z menu po lewej stronie Extensions -> Payments, a następnie na liście wszystkich modułów wyszukujemy moduł eservice i klikamy Install (Rysunek 1). Centrum Elektronicznych Usług Płatniczych eservice Sp. z o.o. Strona 3 z 7
Rysunek 1: Wybór modułu płatności eservice W celu dostosowania parametrów modułu płatności klikamy na przycisk Edit. Na ekranie pokaże się formularz (Rysunek 2). Znaczenie pól formularza opisano poniżej. Centrum Elektronicznych Usług Płatniczych eservice Sp. z o.o. Strona 4 z 7
Rysunek 2: Konfiguracja modułu płatności eservice Centrum Elektronicznych Usług Płatniczych eservice Sp. z o.o. Strona 5 z 7
Merchant ID W polu tym należy wprowadzić identyfikator Merchanta otrzymany z eservice. Merchant password W polu tym należy wprowadzić hasło właściwe dla Merchanta określonego w polu ClientId. Store Key Parametr weryfikacyjny nadany przez eservice. Test mode 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 zaznaczyć Yes. Po przyznaniu własnego, unikalnego numeru Merchant ID należy odznaczyć to pole, co przełączy moduł na płatności produkcyjne. Save to logs Zapisuje do pliku zdarzenia związanie z przeprowadzeniem każdej transakcji. Plik z logami o nazwie eservice.log znajduje się w lokalizacji../system/storage/logs. Logowane są takie informacje o zamówieniu jak token, żądanie, odpowiedź, weryfikacja zgodności parametru HASH. Appearance Możliwość wyboru szablonu wyświetlania metody płatności eservice przy finalizowaniu zamówienia. Dostępne szablony to: Text, Text with logo, Graphic Order initial status: Początkowy status zamówienia ustawiany dla każdego nowego zamówienia. Transaction success status Status zamówienia przy transakcji udanej. Transaction pending status Status zamówienia przy transakcji oczekującej. Występuje w przypadku niektórych transakcji pay-by-link oraz PayPal, wymagających dodatkowego potwierdzenia z systemu banku. Transaction failed status Status zamówienia przy transakcji nieudanej. Module status Określa czy moduł jest włączony. Centrum Elektronicznych Usług Płatniczych eservice Sp. z o.o. Strona 6 z 7
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 7 z 7