Wdrożenie modułu płatności eservice dla systemu Virtuemart 1.1.x - 2.0.x - 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 Virutemart... 3 2.1 Proces instalacji... 3 2.2 Ustalenie początkowego numeru zamówienia eservice... 4 2.3 Tworzenie metody płatności... 5 2.4 Konfiguracja modułu płatności... 6 2.5 Przetwarzanie zamówień... 8 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 Virtuemart w wersji 1.1..x - 2.0.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ęcie procesu implementacji modułu w systemie sklepu, należy sprawdzić wersję wykorzystywanego systemu Virtuemart 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 Virutemart 2.1 Proces instalacji Moduł płatności instalujemy tak, jak każdy komponent Joomla. W panelu administracyjnym z menu głównego wybieramy opcję Rozszerzenia, a następnie Instalacje (Rysunek 1). 3
Rysunek 1: Instalacja modułu płatności eservice Następnie w opcji Instaluj z pakietu wskazujemy aktualny plik modułu eservice ze strony eserviceonline.pl (virtuemart*.zip), klikamy Wczytaj plik i zainstaluj. Gdy moduł jest już zainstalowany należy go włączyć. W tym celu przechodzimy do Rozszerzenia >> Dodatki, w liście dodatków wyszukujemy VM Płatność eservice i włączamy go. 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 jo_virtuemart_payment_plg_eservice AUTO_INCREMENT = 123; gdzie 123 będzie początkowym numerem zamówienia w tej instalacji sklepu Virtuemart. jo_virtuemart_payment_plg_eservice to nazwa tabeli przechowująca informację o płatnościach eservice. W przypadku gdy w Joomla zmodyfikowano domyślną nazwę przedrostka tabel ( jo ) należy odpowiednio zmodyfikować nazwę tej tabeli. 4
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 Tworzenie metody płatności Kolejnym krokiem jest stworzenie metody płatności wykorzystującej zainstalowany moduł. Przechodzimy do komponentu VirtueMart, z menu wybieramy Sklep>>Metody płatności i klikamy Utwórz. Pojawi się formularz tworzenia nowej metody płatności, który wypełniamy np. tak jak na zamieszczonym rysunku (Rysunek 2). Rysunek 2: Tworzenie metody płatności Po wypełnieniu formularza klikamy Zapisz. 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 wybrać Sklep>>Metody płatności, z listy dostępnych metod wybieramy Płatność eservice i przechodzimy do zakładki Konfiguracja, na ekranie pojawi się formularz (Rysunek 3). Rysunek 3: Konfiguracja modułu płatności eservice Na ekranie pokaże się formularz. Znaczenie pól formularza opisano poniżej. Identyfikator merchanta 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. 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 6
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, 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. Status nowego zamówienia Status który zostanie ustawiony po zapoczątkowaniu płatności eservice. Status transakcji oczekujących Status który zostanie ustawiony dla płatności oczekujących Status zamówieni zapłaconego Status który zostanie ustawiony po dokonaniu poprawnej płatności. Status po błędnej płatności Status który zostanie ustawiony dla płatności zakończonych niepowodzeniem Opłata dodatkowa wyporu płatności (stała) Opłata doliczana do zamówienia, wyrażona w stałych wartościach. Np. wartość 5, doda 5 PLN (lub domyślnej waluty) do rachunku za używanie tej metody płatności. Przykładowe wartości: 5, 1.1, -1. Opłata dodatkowa zależna od wartości zamówienia (procent od zamówienia) Opłata doliczana do zamówienia, wyrażona w % wartościach zamówienia. Np. wartość 12, to 12% wartości zamówienia. Przykładowe wartości: 5 (+5% do wartości zam.), 100 (+100% do wartości zam.), -5.5. Podatek Stawka podatkowa dla płatności. 7
2.5 Przetwarzanie zamówień Jeżeli płatność za towar sprzedawany w sklepie nastąpi za pomocą modułu płatności eservice, w module obsługi zamówień sklepu (Sprzedaż >> Zamówienia), na karcie szczegółowego podglądu zamówienia pojawi się informacja pokazana na rysunku (Rysunek 4) Rysunek 4: Informacja o płatności w module obsługi zamówień sklepu Poszczególne pola w tabeli oznaczają: Nazwa płatności informacja że płatności dokonano za pomocą eservice; Identyfikator eservice identyfikator płatności przekazywany do eservice; Status eservice szczegółowe informacje o statusie płatności; Data modyfikacji data modyfikacji danych przedstawionych w tabeli. 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