Prestashop
PrestaShop to rozbudowana platforma open-source dla sklepów internetowych, popularna szczególnie w Europie. Wtyczka Tpay pozwala na prostą konfigurację płatności, obsługując pełną gamę metod, w tym: BLIK, przelewy online, karty, e-wallety oraz płatności ratalne i odroczone. Integracja została zoptymalizowana pod kątem UX klienta oraz automatyzacji obsługi zamówień.
Zanim zaczniesz
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.7.5 - 9.x.
Wersja PHP minimum 7.1.
Sklep z ustawioną walutą Polski Złoty (PLN).
Aktywne konto w Tpay.
W celu poprawnego odbioru powiadomień o statusie transakcji konieczne jest zezwolenie na nadpisywanie adresu URL powiadomień. W Panelu Akceptanta przejdź w menu do Ustawienia → Powiadomienia → w sekcji URL do powiadomień, włącz opcję: Zezwól na nadpisanie adresu URL powiadomienia.

Ustawienia podstawowe

| Pole konfiguracji | Opis pola |
|---|---|
API Client ID | Identyfikator API klienta, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Client ID. |
API Secret | Hasło API, dostępne w Panelu Akceptanta w systemie Tpay w zakładce Integracje → 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 Zabezpieczenia. |
Forma pola CRC | Opcja zezwala na zmianę formatu parametru CRC przesyłanego do systemu Tpay. |
Użyj konta Sandbox | Zaznacz tę 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łączone jest Widget przelewów. |
E-mail 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 powiadomień, na który będą wysyłane notyfikacje dotyczące statusu płatności. |
Symulator rat Pekao
Umożliwia aktywację symulatora płatności ratalnych, który może być wyświetlany w kluczowych miejscach procesu zakupowego: na karcie produktu, w koszyku oraz na stronie zamówienia.

| Pole konfiguracji | Opis pola |
|---|---|
Symulator rat aktywny | Aktywacja widoku symulatora rat. Po uruchomieniu pojawią się dodatkowe opcje konfiguracyjne. |
ID merchanta | Numer identyfikacyjny Sprzedawcy. Inaczej, to numer ID do logowania do Panelu Akceptanta Tpay. Pole wymagane, aby włączyć symulator. |
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. |
Anulowanie transakcji
Funkcja automatycznego anulowania nieopłaconych zamówień. Opcja ta pozwala samodzielnie zdefiniować liczbę dni, po której zamówienie bez zarejestrowanej płatności zostanie anulowane. Po anulowaniu, transakcja nie będzie mogła być opłacona.

| Pole konfiguracji | Opis pola |
|---|---|
Automatyczne anulowanie aktywne | Aktywacja funkcji anulowania transakcji. |
Wykorzystaj front sklepu do uruchamiania zadań harmonogramu | Aktywność dowolnego użytkownika na stronie sklepu uruchomia proces weryfikacji i anulowania przeterminowanych zamówień. |
Anuluj zamówienie i transakcję po upływie wskazanej liczby dni | Liczba dni po ilu ma zostać anulowana transakcja. |
Płatność standardowa
Moduł umożliwia wyświetlenie wszystkich dostępnych metod płatności bezpośrednio na stronie zamówienia, w tym udostępnienie formularza do wpisania kodu BLIK, lub alternatywnie przekierowuje klienta na zewnętrzny serwis, taki jak Panel Transakcyjny Tpay lub dedykowana strona eBLIK.

| Pole konfiguracji | Opis pola |
|---|---|
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 aktywna | Płatności wyświetlają metodę płatności BLIK w koszyku sklepu. Kupujący zawsze będzie przekierowywany na zewnętrzną stronę eBLIK, gdzie wpisuje kod. |
Widget BLIK | Włączenie opcji BLIK LVL 0. Włącz, jeśli chcesz, aby klient wpisywał kod BLIK na stronie sklepu. |
Widget przelewów | Płatności wyświetlają jako kafelki banków w koszyku sklepu. |
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. |
Płatności kartą płatniczą
Przyjmowanie płatności kartą na dwa sposoby: poprzez przekierowanie klienta do bezpiecznego Panelu Transakcyjnego Tpay lub za pomocą formularza udostępnionego bezpośrednio na stronie sklepu. W obu rozwiązaniach dane karty klienta są w pełni szyfrowane.

| Pole konfiguracji | Opis pola |
|---|---|
Płatność kartą płatniczą | Włączenie płatności kartowych na sklepie. |
Widget kart | Włączenie opcji kart on-site, zaznacz te opcje jeśli chcesz, aby klient wpisywał dane karty płatniczej na stronie sklepu. Dane karty kupującego są szyfrowane. |
Klucz RSA | Klucz RSA, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Płatności kartami → API → sekcja Klucz publiczny RSA dla acquirera Elavon (widoczny po włączeniu metody securesale), natomiast dla acquirera Pekao klucz znajduje się w zakładce Integracje → API. |


