INSTRUKCJA INSTALACJI MODUŁU PŁATNOŚCI TRANSFERUJ.PL w QuickCart 6.x Wersja: 1.1 Styczeń 2015 Transferuj.pl jest własnością Krajowego Integratora Płatności SA ul. Św. Marcin 73/6 61-808 Poznań kontakt@transferuj.pl NIP 777-306-15-79 KRS 0000412357 REGON 300878437
1. WYMAGANIA Aby korzystać z modułu płatności Transferuj.pl dla skryptu QuickCart niezbędne jest, by środowisko posiadało następujące elementy: 1. System QuickCart 6.x (http://opensolution.org/) 2. Pliki instalacyjne modułu płatności Transferuj.pl dostępne są tutaj: http://transferuj.pl/integracja-w-sklepach.html 3. 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 znajdują się pliki trvalidation.php, transferuj_list.php oraz transferuj_button.php. 2. Wyślij katalog plik trvalidation.php do głównego katalogu Quick.Cart na Twoim serwerze. 3. 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ę 2 Strona Transferuj.pl KIP SA
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. 4. Z katalogu głównego Quick.Cart należy pobrać plik: - general.php z podkatalogu database\config 5. W pliku general.php znajdź linijki: //error_reporting( E_ALL ^ E_DEPRECATED ); unset( $config, $amenutypes, $aphototypes, $lang, $auser ); następnie zaraz po nich wklej następujący kod (dostępny również w pliku kod_general_php.txt w archiwum zip z modułem) : /* * Transferuj.pl */ $config['ids']="0000"; //id sprzedawcy $config['kodp']="twojkod"; //kod potwierdzajacy $config['tekstp']="powrót do sklepu"; //tekst przycisku powrotu $config['tekstp'] = iconv('windows-1250', 'UTF-8', $config['tekstp']); $config['error_url']="http://domena.pl/blad"; //adres powrotny po wykonaniu transakcji z wynikiem blednym $config['back_url']="http://domena.pl/dziekujemy"; // adres strony z podziekowaniami. $config['notify_url']="http://domena.pl/trvalidation.php"; //uzupelnij swoja domene w celu lokalizacji pliku trvalidation.php 3 Strona Transferuj.pl KIP SA
Pamiętaj, aby uzupełnić Twoje ID sprzedawcy w polu $config['ids'] Twój Kod Bezpieczeństwa (dostępny w Panelu Odbiorcy Płatności w zakładce Powiadomienia), adresy stron zwrotnych podanych w pkt 3. oraz inne parametry opisane w komentarzach. Należy szczególnie zwrócić uwagę, aby poprawnie uzupełnić $config['notify_url']. Zapisz plik general.php i nadpisz go na serwerze. 6. Zaloguj się do panelu administracyjnego Quick.Cart, przejdź do zakładki Zamówienia / Nowa Płatność i utwórz nową płatność: 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ł Transferuj. W Edycji sposobu dostawy zaznacz Transferuj.pl po prawej stronie, ustal kwoty za korzystanie z usługi i zapisz. 4 Strona Transferuj.pl KIP SA
7. Teraz należy wybrać sposób w jaki Klient ma zostać przekierowany do systemu płatności Transferuj.pl. Może się to odbyć na dwa sposoby: a) Użytkownik wybiera kanał płatności na stronie sprzedawcy i zostaje bezpośrednio przekierowany do banku, który wybrał. W tym celu należy skopiować plik transferuj_lista.php do folderu templates/default, a następnie w pliku order-step-3.php dodać fragment kodu : <?php require_once DIR_SKIN.'transferuj_list.php';?> w linii 80, pomiędzy znacznikami </table> oraz </div> 5 Strona Transferuj.pl KIP SA
b) Użytkownik po wybraniu przycisku zostaje przekierowany do Panelu Transakcyjnego Transferuj, gdzie dokonuje wyboru kanału płatności. W tym celu należy skopiować plik transferuj_lista.php do folderu templates/default, a następnie w pliku order-step-3.php dodać fragment kodu : <?php require_once DIR_SKIN.'transferuj_button.php';?> w linii 80, pomiędzy znacznikami </table> oraz </div> Od teraz Twoi klienci będą mogli dokonywać szybkich płatności online przez system Transferuj.pl. 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@transferuj.pl 4. HISTORIA ZMIAN Wersja 1.0 (Styczeń 2015): Wydanie modułu dla QuickCart 6.5. 6 Strona Transferuj.pl KIP SA