Wdrożenie modułu płatności eservice dla systemu Gekosale 1.4 - dokumentacja techniczna Wer. 01 Warszawa, styczeń 2014 1
Spis treści: 1 Wstęp... 3 1.1 Przeznaczenie dokumentu... 3 1.2 Przygotowanie do integracji... 3 2 Instalacja modułu Gekosale 1.4... 3 2.1 Zawartość archiwum... 3 2.2 Przygotowanie bazy danych... 3 2.3 Ustalenie początkowego numeru zamówienia eservice... 5 2.4 Instalacja plików źródłowych... 5 2.5 Konfiguracja modułu płatności... 5 3 Kontakt... 8 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 Gekosale w wersji 1.4. 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 Gekosale 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 Gekosale 2.1 Zawartość archiwum W pobranym archiwum ZIP znajdują się dwa katalogi: src database Katalog database zawiera krótki skrypt SQL, który należy wykonać za pomocą klienta bazy danych MySQL przed zainstalowaniem plików źródłowych modułu. 2.2 Przygotowanie bazy danych Plik eservice.sql należy skopiować na serwer, na którym zainstalowano klienta mysql bazy danych. 3
W linii poleceń wpisujemy: mysql h host u username p gdzie: host jest numerem IP komputera lub nazwa serwera, na którym zainstalowano serwer bazy danych. username jest nazwą użytkownika bazy danych mającego uprawnienia do tworzenia tabel w bazie danych Gekosale Po podaniu poprawnego hasła należy wpisać: mysql> use database; gdzie database jest nazwą bazy danych, z której korzysta sklep Gekosale. Następnie wykonujemy polecenie mysql> source eservice.sql Na ekranie powinna pojawić się informacja o poprawnym utworzeniu nowej tabeli. Skrypt można wykonać za pomocą innego klienta bazy danych MySQL (np. phpmyadmin). W celu wykonania modyfikacji bazy danych za pomocą narzędzia phpmyadmin, należy zalogować się do serwera bazy danych oraz wybrać właściwą bazę danych, związaną z instalacją systemu Gekosale Następnie w menu wybieramy zakładkę SQL. W polu tekstowym wklejamy kod SQL o zawartości przedstawionej na Listingu 1. Listing 1: Kod SQL dodający tabelę niezbędną do przetwarzania płatności internetowych CREATE TABLE `eservicesettings` ( `ideservicesettings` int(10) unsigned NOT NULL AUTO_INCREMENT, `merchantid` varchar(30) NOT NULL, `password` varchar(50) NOT NULL, `viewid` int(10) unsigned DEFAULT NULL, `dirlog` varchar(255) NOT NULL, `status_init` int(10) unsigned NOT NULL, `status_ok` int(10) unsigned NOT NULL, `status_fail` int(10) unsigned NOT NULL, `status_pending` int(10) unsigned NOT NULL, `environment` int(10) unsigned NOT NULL, PRIMARY KEY (`ideservicesettings`) ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8; Po wykonaniu polecenia w bazie pojawi się pusta tabela o nazwie eservicesettings. 4
2.3 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 `order` AUTO_INCREMENT = 123; gdzie 123 będzie początkowym numerem zamówienia w tej instalacji sklepu Gekosale. 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.4 Instalacja plików źródłowych Pliki źródłowe modułu płatności eservice umieszczone są w katalogu src. Zawartość tego katalogu należy skopiować do katalogu z plikami źródłowymi sklepu Gekosale na serwerze. Po poprawnym skopiowaniu plików można przystąpić do konfigurowania modułu płatności. 2.5 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 Konfiguracja a następnie Moduł płatności. Na ekranie klikamy na przycisk DODAJ METODĘ PŁATNOŚCI. Pojawi się ekran jak na rysunku 1. Formularz ten wypełniamy jak na załączonym rysunku. 5
Rysunek 1: Dodawanie nowej metody płatności W polu Nazwa wpisujemy Płatność eservice, a w Nazwa metody płatności wybieramy eservice. Klikając Dalej przechodzimy do następnego kroku, gdzie wybieramy dla jakich sklepów moduł płatności ma być dostępny. Następnie wciskamy Zapisz. Aby przejść do następnego kroku konfiguracji należy wcześniej wybrać konkretną instancję sklepu, której konfiguracja ma dotyczyć (wybieramy sklep z menu po prawej stronie). Po wyborze sklepu przechodzimy ponownie na listę modułów płatności i klikamy na przycisk Edytuj rekord przy module Płatność eservice. Przechodzimy do zakładki Konfiguracja modułu, na ekranie pokaże się formularz (Rysunek 2). Znaczenie pól formularza opisano poniżej. 6
Rysunek 2: Konfiguracja modułu płatności eservice 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 Identyfikator Merchanta. Bezwzględna ścieżka do katalogu z plikiem logów eservice System ma możliwość zapisywania informacji diagnostycznych. W celu ich zapisywania, w 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. 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. 7
Status nowego zamówienia Status, który zostanie ustawiony po zapoczątkowaniu płatności eservice. Status po poprawnej płatności Status, który zostanie ustawiony po dokonaniu poprawnej płatności. Status transakcji oczekujących Status, który zostanie ustawiony dla płatności oczekujących. Status po błędnej płatności Status, który zostanie ustawiony dla płatności zakończonych 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: 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 8