Wdrożenie modułu płatności eservice dla systemu Drupal Commerce 7.x-1.9 - dokumentacja techniczna Wer. 01 Warszawa, wrzesień 2014 1
Spis treści: 1 Wstęp... 3 1.1 Przeznaczenie dokumentu... 3 1.2 Przygotowanie do integracji... 3 2 Instalacja modułu dla Drupal Commerce... 3 2.1 Instalacja plików źródłowych... 3 2.2 Konfiguracja modułu płatności... 4 3 Informacje o transakcjach... 6 4 Kontakt... 7 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 Drupal Commerce w wersji 7.x. 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 Drupal Commerce oraz pobrać najnowszą wersję modułu płatności eservice dla tejże wersji. Moduły dostępne są na stronie http://eserviceonline.pl 2 Instalacja modułu dla Drupal Commerce 2.1 Instalacja plików źródłowych Moduł płatności eservice instalujemy tak samo, jak każdy inny moduł w systemie Drupal. W panelu administracyjnym z menu głównego (belki górnej) wybieramy opcję Moduły, a następnie klikamy Instalacja nowego modułu. Rysunek 1: Instalacja modułu panel sklepu Następnie w opcji Wyślij archiwum modułu lub skórki do instalacji wskazujemy na dostarczony plik commerce_eservice.zip i klikamy Instaluj. 3
Rysunek 2: Wskazanie pliku z modułem panel sklepu Gdy moduł płatności eservice zostanie pomyślnie zainstalowany należy go włączyć. W tym celu z menu głównego (belki górnej) wybieramy opcję Moduły i na liście modułów odnajdujemy eservice w sekcji Płatności Commerce. Zaznaczamy moduł do włączenia i klikamy Zapisz konfigurację. Rysunek 3: Zainstalowany moduł na liście modułów panel sklepu 2.2 Konfiguracja modułu płatności Moduł płatności eservice do poprawnego obsługiwania transakcji wymaga konfiguracji. Należy w tym celu udać się do listy metod płatności w Drupal Commerce. Z menu głównego (belki górnej) wybieramy opcję Sklep, a następnie Konfiguracja Metody płatności. Na liście Wyłączone reguły metod płatności odnajdujemy eservice i klikamy edytuj. Rysunek 4: Moduł eservice w Drupal Commerce panel sklepu Na liście Akcje znajduje się tylko jeden element eservice klikamy edytuj w kolumnie Operacje. Teraz należy skonfigurować metodę płatności eservice wprowadzając dane dostarczone przez eservice oraz wybierając preferowane ustawienia. 4
Rysunek 5: Konfiguracja modułu płatności eservice panel sklepu Merchant ID W polu tym proszę wprowadzić MID sprzedawcy otrzymany z eservice. Hasło Merchanta W polu tym należy wprowadzić hasło sprzedawcy otrzymane z eservice. Store Key W polu tym należy wprowadzić poufny parametr StoreKey otrzymany z eservice. Typ sprzedawcy Należy wybrać typ sprzedawcy otrzymany z eservice. Domyślna waluta Należy wybrać domyślną walutę dla transakcji przeprowadzanych za pomocą płatności eservice. Wszystkie transakcje korzystające z tej metody płatności będą konwertowane do domyślnej waluty. Jeśli sklep korzysta z różnych walut, należy wcześniej odpowiednio skonfigurować sklep Drupal Commerce do obsługi przewalutowań. Włączenie opcji Zezwól na korzystanie ze wszystkich walut z listy powyżej będzie skutkować korzystaniem przez moduł płatności z oryginalnej waluty zamówienia, jeśli waluta ta znajduje się na liście obsługiwanych walut. W przeciwnym razie takie transakcje nadal będą konwertowane do domyślnej waluty. Domyślny język formatki płatniczej Należy wybrać język formatki płatniczej, jaki będzie wyświetlany konsumentowi, jeżeli język przez niego wybrany nie jest wspierany. 5
Typ transakcji Należy wybrać typ transakcji obsługiwanych przez sklep (domyślnie Auth). Środowisko eservice Należy wybrać w jakim środowisku ma pracować moduł płatności. Dla testowania usługi płatności należy wybrać Testowe, natomiast w momencie uruchamiania usługi dla konsumentów należy przełączyć na Produkcyjne. Zmień status zamówienia na Płatność eservice Włączenie tej opcji będzie skutkować ustawianiem statusów zamówień opłaconych za pomocą płatności eservice na Płatność eservice, zamiast domyślnego statusu Oczekuje. Po Zapisaniu konfiguracji należy powrócić do listy metod płatności (Sklep Konfiguracja Metody płatności). Na liście Wyłączone reguły metod płatności odnajdujemy eservice i klikamy włącz oraz potwierdzamy chęć włączenia metody płatności. 3 Informacje o transakcjach Wszystkie informacje o transakcjach przeprowadzanych za pomocą metody płatności eservice są zapisywane na liście transakcji pod dotyczącymi ich zamówieniami. Aby zobaczyć szczegółowe informacje o transakcji należy przejść na listę zamówień (Sklep Zamówienia) i przy właściwym zamówieniu kliknąć płatność. Transakcje dokonane za pomocą eservice są oznaczone jako eservice w kolumnie Metoda. Po kliknięciu pokaż zostaną wyświetlone szczegóły transakcji. Rysunek 6: Podgląd transakcji eservice panel sklepu 6
Zdalne ID - ID transakcji eservice. Zdalny status - obecny status płatności eservice. Ładunek - lista danych przekazywanych przez eservice wraz z informacją o statusie płatności. 4 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 7