Instrukcja obsługi Modułu Payu dla Moodle 2.x Wersja z 10 lutego 2015r. Spis treści 1. Wymagania............................................ 1 2. Instalacja............................................. 2 3. Włączenie modułu....................................... 2 4. Konfiguracja po stronie platformy.............................. 2 5. Konfiguracja uprawnień.................................... 3 6. Konfiguracja po stronie Payu.pl............................... 4 7. Konfiguracja kursu....................................... 4 8. Rozwiązywanie problemów.................................. 5 8.1. Użytkownicy nie są zapisywani na kurs.......................... 5 8.2. Przepraszamy, usługa chwilowo niedostępna. Prosimy spróbować później........ 5 8.3. błąd 203........................................... 5 8.4. brak lub błędna wartość parametru sig.......................... 6 8.5. Tryb developerski platformy Moodle............................ 6 9. Jak kupić............................................. 6 9.1. Czy mogę zmienić adres platformy?............................ 6 1. Wymagania Do poprawnej pracy moduł potrzebuje środowiska na które składa się: 1. Interpreter języka php5 wraz z zainstalowanym dekoderem ioncube (do pobrania bezpłatnie ze strony www producenta http://www.ioncube.com/loaders.php). 2. Platformy Moodle w wersji dla której moduł został przygotowany. 3. Poprawnie skonfigurowane przetwarzanie skryptu cron.php znajdującego się w katalogu /admin/ platformy. Zalecamy uruchamianie tego skryptu raz na 10 minut. 1
4. Konta w systemie Payu.pl. Można je otrzymać po rejestracji oraz akceptacji wniosku przez pracownika Payu.pl. Pozostałe formalności w postaci podpisania umowy mogą nastąpić w terminie późniejszym. 2. Instalacja 1. Archiwum zawierające pliki modułu należy rozpakować do katalogu enrol znajdującego się w głównym katalogu platformy Moodle. 2. Następnie należy zalogować się na konto administratora platformy. 3. W menu Administracja Serwisu należy kliknąć na link Powiadomienia znajdujący się u samej góry. 4. Powinna rozpocząć się instalacja modułu płatności. Po jej zakończeniu pojawi się ekran umożliwiający wprowadzenie domyślnych wartości konfiguracyjnych wtyczki. Można zaakceptować domyślne, a ich modyfikacja będzie możliwa w dalszym kroku. Wtyczka jest gotowa do konfiguracji. 3. Włączenie modułu 1. Jak przedstawiono to na Rysunku 1 w menu Administracja Serwisu należy wybrać Moduły Zapisy Zarządzaj wtyczkami zapisów. 2. Następnie, kliknąć w zamknięte oko obok nazwy modułu w kolumnie Włącz (Rysunek 2). 3. Moduł jest włączony. Można przystąpić do modyfikacji ustawień. 4. Konfiguracja po stronie platformy 1. Klikając widoczny na Rysunku 1 link Ustawienia przechodzimy do okna konfiguracji widocznego na Rysunku 4. enrol cost domyślny koszt kursu enrol platnosci posid Identyfikator punktu płatności (pos id, wartość odczytana z panelu administracyjnego Payu.pl) enrol platnosci key1 Pierwszy klucz md5 (wartość odczytana z panelu administracyjnego Payu.pl) enrol platnosci key2 Drugi klucz md5 (wartość odczytana z panelu administracyjnego Payu.pl) enrol platnosci pos auth key Klucz autoryzacji płatności (pos auth key, wartość odczytana z panelu administracyjnego Payu.pl) 2. Jak widać większość głównych parametrów pochodzi bezpośrednio z panelu administracyjnego systemu płatności. Wystarczy je skopiować. 2
Rysunek 1. Włączenie modułu płatności. 3. Pozostałe trzy parametry umożliwiają włączenia powiadomienia e mailem o zapisaniu się na kurs odpowiednich odbiorców: studenta, nauczyciela, administratorów. 4. Po wypełnieniu wszystkich pól należy kliknąć przycisk zapisz zmiany. 5. Konfiguracja uprawnień Konfiguracja uprawnień dotyczących wtyczki płatności.pl przebiega w standardowy sposób w menu administracyjnym: Administracja Serwisu Użytkownicy Zezwolenia Zdefiniuj role. Lista opcji przedstawiona jest na Rysunku 4. Domyślne wartości działają w większości przypadków. 3
6. Konfiguracja po stronie Payu.pl Po otrzymaniu dostępu do systemu płatności, należy utworzyć Punkt Płatności (pos Point Of Sale). Najłatwiej zrobić to przy pomocy kreatora. Dokładna dokumentacja znajduje się na stronie www.payu.pl. Należy zwrócić szczególną uwagę by opcja Kodowanie przesyłanych danych dla danego pos miała ustawioną wartość UTF 8. Konieczne jest również aktywowanie kanału płatności testowych. Do zakończenia konfiguracji konieczne jest jeszcze wskazanie adresu na jaki system Payu.pl ma wysyłać zmiany statusów transakcji. Każdy pos ma możliwość przypisania trzech adresów przedstawionych w Tabeli 1. adresmoodle należy zastąpić adresem swojej platformy. Nazwa pola Wartość Adres powrotu błędnego http://adresmoodle.pl/enrol/platnosci/error.php?errno=%error% Adres powrotu pozytywnego http://adresmoodle.pl/enrol/platnosci/success.php Adres raportów http://adresmoodle.pl/enrol/platnosci/status.php Kodowanie znaków utf 8 Tabela 1. Pola konfiguracyjne w panelu administracyjnym Payu.pl 7. Konfiguracja kursu Kiedy moduł jest zainstalowany i skonfigurowany można przystąpić do konfiguracji kursu, tak by wymagał wniesienia opłaty. Należy się upewnić, że dysponujemy uprawnieniami umożliwiającymi modyfikowanie kursu. W menu administracyjnym kursu należy wybrać: Administracja kursem Użytkownicy Metoda zapisów. Następnie z menu rozwijanego Dodaj metodę zapisu należy wybrać Payu.pl tak jak na Rysunku 5. W formularzu, który się pojawi, należy wpisać nazwę metody zapisów 1, podać cenę oraz ustawić pozostałe standardowe parametry. Po kliknięciu w guzik Dodaj metodę płatności nowa metoda zapisów pojawi się na liście. By przetestować konfigurację proponuję skorzystać z konta z uprawnieniami studenta. Przy próbie zapisu na kurs pojawi się prośba o wniesienie opłaty. 1 Nazwa metody zapisów nie jest widoczna dla użytkownika, ma jedynie na celu łatwiejszą jej identyfikację. 4
8. Rozwiązywanie problemów Jeśli moduł płatności nie działa, najważniejsze dla nas jest odtworzenie warunków, w których błąd zaistniał, tak by można było określić co jest jego przyczyną. Z tego względu do zgłoszenia problemu prosimy dołączać następujące informacje o Państwa systemie: 1. Wersję platformy Moodle, najlepiej całą zawartość pliku version.php z głównego katalogu platformy. 2. Wersję interpretera php. 3. Rodzaj i wersję systemu operacyjnego (np. Linux Debian 6.0, Windows 2003 Server EE) 4. Typ i wersję bazy danych (np. MySQL 5.1, PostgreSQL 8.4) 5. Opis kolejnych kroków prowadzących do powstania błędu tak by można go było odtworzyć w naszym środowisku testowym. 6. Zrzut ekranu (screenshot) z błędem w miarę możliwości. Jeśli problem dotyczy komunikacji z systemem Payu.pl prosimy o dołączenie również historii raportów. Taki zapis można pobrać po zalogowaniu się do panelu administracyjnego Payu.pl. W tym celu po zalogowaniu się do panelu administracyjnego z menu po lewej stronie należy wybrać opcję Transakcje Lista transakcji a następnie kliknąć Szukaj. 2. Przykładowy widok panelu administracyjnego przedstawiony jest na Rysunku 6. Po odszukaniu problematycznej transakcji należy kliknąć w jej opis. Widok szczegółów transakcji przedstawiony jest na Rysunku 7. Następnie należy kliknąć w historię raportów. Na Rysunku 8 widać, że wybrana transakcja przebiegła pomyślnie. Jeśli jest inaczej, prosimy o skopiowanie z tej strony i przesłanie do analizy kompletnej historii raportów. 8.1. Użytkownicy nie są zapisywani na kurs Należy się upewnić, że skrypt cron jest przetwarzany regularnie co 5 10 minut. Jest to niezbędne do poprawnej pracy modułu. 8.2. Przepraszamy, usługa chwilowo niedostępna. Prosimy spróbować później. W przypadku wystąpienia na stronie Payu.pl komunikatu: Przepraszamy, usługa chwilowo niedostępna. Prosimy spróbować później., w pierwszej kolejności proszę sprawdzić czy kanał płatności testowych jest uruchomiony. 8.3. błąd 203 W przypadku wystąpienia błędu treści: niedozwolona wartość pay type dla danego pos id, natychmiast po kliknięciu w przycisk Zapłać poprzez Payu.pl należy sprawdzić: 2 Jeśli problem wystąpił z transakcją testową, należy dodatkowo zaznaczyć checkbox Pokaż testowe. 5
Jeśli moduł znajduje się w trybie testowym, czy w panelu payu.pl włączony jest ten typ płatności. Jeśli jest to pełna wersja modułu, należy się upewnić czy platforma pracuje pod adresem dla którego został przygotowany moduł 8.4. brak lub błędna wartość parametru sig W przypadku wystąpienia błędu treści: brak lub błędna wartość parametru sig, proszę sprawdzić czy kodowanie znaków w wybranym punkcie pos ustawione jest na UTF 8. 8.5. Tryb developerski platformy Moodle Platforma Moodle w codziennej pracy stara się ukrywać przed użytkownikiem komunikaty błędów. W czasie rozwiązywania problemów z platformą tego typu informacje mogą dostarczyć cennych wskazówek. By były widoczne, należy przejść do menu: Administracja serwisu Rozwój Usuwanie błędów, a następnie w pozycji Komunikaty usuwania błędów wybrać opcję Developer. Po rozwiązaniu problemu zaleca się powrócenie do ustawień domyślnych. 9. Jak kupić Jeśli są Państwo zainteresowani zakupem modułu, proszę o kontakt poprzez formularz kontaktowy lub bezpośrednio na adres e mail podany na stronie kontakt. We wiadomości proszę zawrzeć następujące informacje: 1. Dane do wystawienia faktury. 2. Wartość zmiennej CFG->wwwroot z pliku config.php platformy na której ma być zainstalowany moduł. Proszę o wklejenie całej linii. 9.1. Czy mogę zmienić adres platformy? Cena modułu obejmuje jedeną platofmę (jeden adres). W przypadku zmiany adresu należy wykupić nową licencję. 6
Rysunek 2. Włączenie modułu płatności. 7
Rysunek 3. Ekran konfiguracji modułu. 8
Rysunek 4. Uprawnienia związane z modułem płatności. Rysunek 5. Włączenie modułu płatności. 9
Rysunek 6. Lista transakcji w panelu administracyjnym Payu.pl Rysunek 7. Szczegóły płatności. 10
Rysunek 8. Historia raportów. 11