INSTRUKCJA INSTALACJI MODUŁU PŁATNOŚCI TPAY.COM w QuickCart 6.x Wersja: 2.0 Maj 2017 Tpay.com jest własnością Krajowego Integratora Płatności SA ul. Św. Marcin 73/6 61-808 Poznań info@tpay.com NIP 777-306-15-79 KRS 0000412357 REGON 300878437
1. WYMAGANIA Aby korzystać z modułu płatności Tpay.com dla skryptu QuickCart niezbędne jest, by środowisko posiadało następujące elementy: 1. System QuickCart 6.x (http://opensolution.org/) 2. Wersja serwera PHP minimum 5.4 3. Pliki instalacyjne modułu płatności Tpay.com dostępne są tutaj: http://tpay.com/integracja-w-sklepach.html 4. Ustawiona waluta PLN w sklepie. Uwaga: należy pobrać moduł odpowiedni dla swojej wersji QuickCart! Moduł był testowany na wersji polskiej Quick.Cart 6.5. Sprawdź czy masz ustawiony język polski w: Konfiguracja / Opcje / Domyślny Język 2. INSTALACJA MODUŁU 1. Rozpakuj zawartość archiwum na dysk. Po rozpakowaniu powinien powstać folder tr_quickcart6, w którym znajduje się plik trvalidation.php, oraz folder tpay. 2. Zaloguj się do panelu administracyjnego QuickCart, przejdź do zakładki Strony / Nowa Strona. Następnie utwórz dwie strony. Pierwszą stroną będzie strona na którą zostanie przekierowany klient po poprawnie opłaconej płatności, powinien na niej się pojawić komunikat z podziękowaniem za dokonanie płatności. Druga strona to strona na którą zostanie przekierowany użytkownik po wykonaniu błędnej transakcji, powinna zawierać komunikat o błędzie. Adresy URL tych stron będą potrzebne w modyfikacji pliku konfiguracyjnego QuickCart. 2 Strona Tpay.com KIP SA
3. W katalogu tpay należy edytować plik tpay_config.php (np. za pomocą programu notepad++). W pliku należy podmienić następujące dane: //id sprzedawcy $config['id'] = "1010"; //kod potwierdzajacy $config['kod'] = "demo"; //adres powrotny po wykonaniu transakcji z wynikiem blednym $config['error_url'] = "http://domena.pl/error"; // adres strony z podziekowaniami. $config['back_url'] = "http://domena.pl/success"; //uzupelnij swoja domene w celu lokalizacji pliku trvalidation.php $config['notify_url'] = "http://domena.pl/trvalidation.php"; Pamiętaj, aby uzupełnić Twoje ID sprzedawcy w polu $config['id'], Twój Kod Bezpieczeństwa (dostępny w Panelu Odbiorcy Płatności w zakładce Powiadomienia) oraz adresy stron zwrotnych podanych w pkt 3. Należy szczególnie zwrócić uwagę, aby poprawnie uzupełnić $config['notify_url']. 4. Zapisz zmiany w edytowanym pliku. 5. Wyślij plik trvalidation.php do głównego katalogu Quick.Cart na Twoim serwerze. 6. Wyślij katalog tpay do folderu plugins na Twoim serwerze. 7. Zaloguj się do panelu administracyjnego Quick.Cart, przejdź do zakładki Zamówienia / Nowa Płatność i utwórz nową płatność: Zwróć uwagę, że nazwa płatności musi być dokładnie tpay.com, tak jak na powyższej ilustracji. Zapisz nową płatność, a następnie przejdź do Zamówienia->Sposoby dostawy, wybierz z listy wybranego dostawcę, z którym ma być powiązany moduł Tpay. 3 Strona Tpay.com KIP SA
W Edycji sposobu dostawy zaznacz tpay.com po prawej stronie, ustal kwoty za korzystanie z usługi i zapisz. 6. Teraz należy wybrać sposób w jaki Klient ma zostać przekierowany do systemu płatności tpay.com. Może się to odbyć na trzy sposoby: a) Użytkownik wybiera kanał płatności na stronie sprzedawcy i zostaje bezpośrednio przekierowany do banku, który wybrał (forma kafelków). 4 Strona Tpay.com KIP SA
W tym celu należy w pliku order-step-3.php dodać fragment kodu : <?php require_once DIR_PLUGINS. 'tpay/tpay_checkout.php'; new \tpay\tpaycheckout($aorder, $iorder, $oorder, 1);?> w ok. ¾ długości pliku, w linii pomiędzy znacznikami </table> oraz </div> b) Użytkownik wybiera kanał płatności na stronie sprzedawcy i zostaje bezpośrednio przekierowany do banku, który wybrał (forma listy rozwijanej). W tym celu należy w pliku order-step-3.php dodać fragment kodu : <?php require_once DIR_PLUGINS. 'tpay/tpay_checkout.php'; new \tpay\tpaycheckout($aorder, $iorder, $oorder, 2);?> w ok. ¾ długości pliku, w linii pomiędzy znacznikami </table> oraz </div> 5 Strona Tpay.com KIP SA
c) Użytkownik po wybraniu przycisku zostaje przekierowany do Panelu Transakcyjnego Tpay, gdzie dokonuje wyboru kanału płatności. W tym celu należy w pliku order-step-3.php dodać fragment kodu : <?php require_once DIR_PLUGINS. 'tpay/tpay_checkout.php'; new \tpay\tpaycheckout($aorder, $iorder, $oorder, 3);?> w ok. ¾ długości pliku, w linii pomiędzy znacznikami </table> oraz </div> Od teraz Twoi klienci będą mogli dokonywać szybkich płatności online przez system Tpay.com. 3. KONTAKT W razie potrzeby odpowiedzi na pytania lub szczegółowe wyjaśnienie kwestii technicznych prosimy o kontakt poprzez formularz znajdujący się w Panelu sprzedawcy lub na adres e-mail: pt@tpay.com 4. HISTORIA ZMIAN Wersja 2.0 (Maj 2017): Wydanie modułu opartego o biblioteki tpay.com Wersja 1.0 (Styczeń 2015): Wydanie modułu dla QuickCart 6.5. 6 Strona Tpay.com KIP SA