Ważne!
Jeśli korzystasz z dotychczasowej wersji modułu: 1.7.4 lub niższej wersji, przed instalacją tej wersji modułu musisz najpierw odinstalować stary moduł, a następnie wgrać nowy.
Wymagania
- Platforma PrestaShop w wersji 1.7.x - 8.x
- Wersja PHP 7.1 - 8.1
- Sklep z ustawioną walutą Polski Złoty (PLN).
- Aktywne konto w Tpay
Uruchomiony dostęp na koncie do Open API, sprawdź, czy w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → jest dostępna sekcja “Klucze do nowego Open Api” jeśli nie, skontaktuj się z Biurem Obsługi Klienta.
Przed instalacją
Przed uruchomieniem płatności sprawdź, czy Twoja platforma ma włączoną obsługę przyjaznych linków Przyjazny adres URL.
Włączysz je na Panelu administratora PrestaShop w menu Preferencje → Ruch → sekcja Ustaw URL-e.
Brak włączonych przyjaznych adresów może powodować niepoprawne działanie modułu.
Instalacja modułu:
- Pobierz wtyczkę na dysk komputera.
- Zaloguj się do panelu administracyjnego PrestaShop.
- W menu wybierz “Marketplace” lub “Menedżer Modułów”.
- Naciśnij “Załaduj moduł”, następnie przejdź do konfiguracji.
Konfiguracja płatności:
- Przejdź do “Menedżer modułów”, wyszukaj modułu Tpay, a następnie kliknij “Konfiguruj”.
Ustawienia podstawowe:
Wypełni pola danymi z konta Tpay według poniższego przykładu:
Client ID - Identyfikator API klienta, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Client ID.
Sekretny kod - kod API, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Secret.
Kod bezpieczeństwa - kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Bezpieczeństwo.
Forma pola CRC - opcja zezwala na zmianę formatu parametru CRC przesyłanego do systemu Tpay.
Użyj konta Sandbox - zaznacz te opcję jeśli chcesz korzystać z modułu w trybie testowym. Do integracji modułu płatności użyj danych z konta Sandbox.
Bezpośrednie przekierowanie do banku - opcja pozwala na bezpośrednie przekierowanie kupującego od razu do strony banku z pominięciem Panelu Transakcyjnego Tpay. Możliwość bezpośredniego przekierowania jest możliwe tylko wtedy, kiedy włączyłeś opcje “Widget przelewów”
Email do powiadomień - w polu możesz wpisać adresy mailowe, na które zostanie wysłany mail od Tpay. Jeśli wpisujesz więcej, niż jeden adres oddziel je przecinkiem. Ustawienie adresu w polu powoduje nadpisanie domyślnych ustawień w Panelu Akceptanta.
Dopłata za korzystanie z płatności - dodatkowa opłata doliczana do wartości zamówienia. Dopłatę możesz pobierać w formie określonej kwoty lub jako procent od wartości zamówienia.
Adres notyfikacji - adres URL, na który system Tpay wysyła powiadomienia dotyczące statusu transakcji. Możesz go ustawić w Panelu Akceptanta w zakładce Ustawienia → Powiadomienia w sekcji URL do powiadomień. Jeśli korzystasz z więcej niż jednego punktu sprzedażowego, zaznacz opcje “Zezwól na nadpisanie adresu URL powiadomienia”.
Ustawienie symulatora rat Pekao:
Symulator rat aktywny - aktywacja widoku symulatora rat. Po uruchomieniu pojawią się dodatkowe opcje konfiguracyjne.
ID merchanta - numer identyfikacyjny Sprzedawcy. Identyfikator ma taką samą wartość login do Panelu Akceptanta.
Symulator rat jest dostępny na karcie produktu - symulator będzie widoczny na stronie produktu.
Symulator rat jest dostępny w koszyku zakupowym - symulator będzie widoczny na stronie koszyka.
Symulator rat jest dostępny na stronie zamówienia - symulator będzie widoczny na stronie zamówienia.
Ustawienia dla płatności standardowej:
Użyj ustawień globalnych - włączenie ustawień globalnych. Użycie ustawień globalnych powoduje, że metoda płatności będzie dostępna we wszystkich sklepach na koncie PrestaShop.
Płatność BLIK aktywne - aktywacja metody BLIK. Włączona opcja spowoduje, że użytkownik zawsze będzie przekierowywany na stronę eBlik, gdzie wpisuje kod.
Widget BLIK - włącznie opcji BLIK LVL 0, zaznacz te opcje jeśli chcesz, aby klient wpisywał kod blik na stronie sklepu. Możliwość wpisania kodu będzie możliwe tylko wtedy, kiedy włączyłeś opcje “Płatność BLIK aktywne”.
Widget przelewów - włącznie widoku kafelków bankowych, zaznacz te opcje jeśli chcesz, aby klient na stronie sklepu miał możliwość wyboru, którą metodą płatności chce sfinalizować zamówienie.
Własna kolejność - funkcja umożliwia zmianę kolejności wyświetlanych się metod płatności, aby móc skorzystać z tej funkcji należy włączyć “Bezpośrednie przekierowanie do banku”.
Funkcja zezwala na wyróżnienie danej metody płatności.
Ustawienia płatności kartą kredytową:
Płatność kartą kredytową - zaznacz tę opcję jeśli chcesz, żeby płatności były włączone/wyłączone.
Widget kart - włącznie opcji kart on-site, zaznacz te opcje jeśli chcesz, aby klient wpisywał dane karty płatniczej na stronie sklepu. Możliwość wpisania danych karty jest możliwe tylko wtedy, kiedy włączyłeś opcje “Płatność kartą”. Dane karty kupującego są szyfrowane.
RSA key - klucz RSA, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Płatności kartami → API → sekcja Klucz publiczny RSA (widoczny po włączeniu metody securesale).
Statusy transakcji:
Moduł daje możliwość skonfigurowania własnych statusów transakcji dla każdego etapu transakcji. Zalecamy ustawienie statusów według zrzutu ekranu prezentowanego powyżej.
