Wdrożenie wtyczki Tpay do WooCommerce (wersja Open API)

Ostatnia aktualizacja: 21.11.2024

Wymagania:

  • Platforma WordPress z wersją PHP minimum 7.0.
  • Zainstalowana wtyczka WooCommerce.
  • Sklep z ustawioną walutą Polski Złoty (PLN).
  • Aktywne konto w http://tpay.com


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.

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 opcje: Zezwól na nadpisanie adresu URL powiadomienia.

Instalacja modułu: 

Instalacja manualna

  1. Pobierz wtyczkę na dysk komputera.
  2. Zaloguj się do panelu administracyjnego WordPress.
  3. W menu wybierz “Wtyczki”, następnie kliknij “Dodaj nową”.
  4. Naciśnij “Wyślij wtyczkę na serwer”, następnie wybierz pobraną wtyczkę, zainstaluj i włącz ją.



Konfiguracja ustawień globalnych

Przejdź do “WooCommerce” a następnie kliknij zakładkę “Ustawienia Tpay”.

Przykładowa konfiguracja (przykładowe dane należą do konta demo, w swojej konfiguracji użyj danych ze swojego konta):

Użycie ustawień globalnych powoduje, że nie będziemy musieli na nowo wpisywać tych samych danych konfiguracyjnych do każdego sposobu płatności.

Kod bezpieczeństwa - kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Bezpieczeństwo

ID klienta - 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.

Sekret API - hasło API, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Secret.

Środowisko Tpay - wybór środowiska na którym ma działać wtyczka. Do integracji środowiska produkcyjnego użyj danych z Panelu Akceptanta. Do integracji środowiska Sandbox użyj danych z konta Sandbox.

Domyślny status po opłaceniu zamówinia - status płatności Zamówienia po opłaceniu transakcji.

E-mail sprzedawcy - adres mailowy na który mają być wysyłane powiadomienia o transakcjach z systemu Tpay.Domyślny status po utworzeniu zamówienia - status płatności Zamówienia po opłaceniu transakcji.

Dodatkowa kwota - opcja umożliwiająca doliczanie opłaty dodatkowej do kwoty zamówienia za korzystanie z płatności Tpay (opcja nie jest dostępna jeśli korzystasz z WooCommerce Blocks).

Sposób wyświetlania płatności - opcja zmienia sposób widocznych metod płatności w koszyku.

Nazwa pola NIP - opcja zezwala na wysyłanie numeru NIP do systemu Tpay, w tym polu wpisz meta dane pola formularza.

Easy ON-site - opcja zezwala na wyróżnienie danej metody płatności. Włączenie danej metody płatności spowoduje jej pojawienie się w ustwieniach płatności WooCommerce. W celu włączenia kilku metod płatności trzytrzymaj CRTL.

Konfiguracja płatności

  1. Przejdź do “WooCommerce”, wybierz “Ustawienia”, a następnie kliknij zakładkę “Płatności”.

W zakładce “Płatności” pojawi się lista płatności, jakie można uruchomić we wtyczce:

Tpay lista banków — płatności wyświetlają kafelki banków w koszyku sklepu.

Blik — płatności wyświetlają metodę płatności BLIK w koszyku sklepu. Konfiguracja pozwala również włączyć BLIK LVL 0.

Karta kredytowa (strona tpay.com) — płatności wyświetlają metodę płatności kartami w koszyku sklepu. Klient wprowadza dane karty na Panelu Transakcyjnym Tpay*

Karta kredytowa (strona zamówienia) — płatności wyświetlają metodę płatności kartami w koszyku sklepu. Klient wprowadza dane karty na stronie sklepu*

Płatność Google Pay — płatności wyświetlają metodę płatności Google Pay w koszyku sklepu.*

Twisto — płatności wyświetlają metodę płatności Twisto w koszyku sklepu. Płatność będzie widoczna do kwoty 1 500 PLN wartości koszyka.*

Raty Tpay — płatności wyświetlają metodę płatności Rat w koszyku sklepu. Płatność będzie widoczna od kwoty 300 PLN do 9 259 PLN wartości koszyka.*

Raty Pekao — płatności wyświetlają metodę płatności Rat w koszyku sklepu. Płatność będzie widoczna od kwoty 100 PLN do 20 000 PLN wartości koszyka.*

*Włącz tę metodę płatności jeśli twoje konto może przyjmować takie płatności. Jeśli takie metody płatności nie są dostępne na twoim koncie — skontaktuj się z Biurem Obsługi Klienta.

 

2.Wybierz daną płatność, jaką chcesz włączyć na swojej stronie i skonfiguruj ją klikając “Dokończ konfiguracje”.

 

Konfiguracja płatności: lista banków

Przykładowa konfiguracja (przykładowe dane należą do konta demo, w swojej konfiguracji użyj danych ze swojego konta)

Uruchom płatność - zaznacz tę opcję jeśli chcesz, że płatności były włączone włączoną.

Nazwa - tytuł płatności, który zobaczą klienci podczas dokonywania zakupu.

Użyj ustawień globalnych - zaznacz tę opcje jeśli chcesz użyć ustawień globalnych.

Kod bezpieczeństwa - kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Bezpieczeństwo.

ID klienta - 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.

Sekret API - hasło API, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Secret.

Opis - opis, który będzie widoczny pod tytułem płatności.

Włącz dla podanych metod dostawy - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw pole puste jeśli ma być dostępna dla wszystkich.

Własna kolejność - funkcja odpowiada za zmianę kolejności wyświetlanych banków, wpisz kanały bankowe, które mają być wyświetlane w pierwszej kolejności np. wpisanie “64, 18, 13” powoduje wyświetlanie płatności blik, mBank, ING w pierwszej kolejności.

Ukryj listę wyboru banku - funkcja ukrywa widoczne metody płatności na stronie sklepu. Kupujący zostanie przekierowany bezpośrednio do Panelu Transakcyjnego Tpay, gdzie dokona wyboru metody płatności.

Adres do notyfikacji - adres powiadomień, na który będą wysyłane notyfikacje dotyczące statusu płatności.*

Konfiguracja płatności: BLIK

Przykładowa konfiguracja (przykładowe dane należą do konta demo, w swojej konfiguracji użyj danych ze swojego konta)

Uruchom płatność - zaznacz tę opcję jeśli chcesz, że płatności były włączone włączoną.

Nazwa - tytuł płatności, który zobaczą klienci podczas dokonywania zakupu.

Użyj ustawień globalnych - zaznacz tę opcje jeśli chcesz użyć ustawień globalnych.

Kod bezpieczeństwa - kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Bezpieczeństwo.

ID klienta - 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.

Sekret API - hasło API, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Secret.

Opis - opis, który będzie widoczny pod tytułem płatności.

Włącz dla podanych metod dostawy - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw pole puste jeśli ma być dostępna dla wszystkich.

BLIK LVL 0- włącznie opcji BLIK LVL 0, zaznacz te opcje jeśli chcesz, aby klient wpisywał kod blik na stronie sklepu. Wyłączona opcja spowoduje że użytkownik zawsze będzie przekierowywany na stronę eBlik, gdzie wpisze kod.

Adres do notyfikacji - adres powiadomień, na który będą wysyłane notyfikacje dotyczące statusu płatności.*

Konfiguracja płatności: Karta płatnicza (tpay.com)

Przykładowa konfiguracja (przykładowe dane należą do konta demo - w swojej konfiguracji użyj danych ze swojego konta)

Uruchom płatność - zaznacz tę opcję jeśli chcesz, że płatności były włączone włączoną.

Nazwa - tytuł płatności, który zobaczą klienci podczas dokonywania zakupu.

Użyj ustawień globalnych - zaznacz tę opcje jeśli chcesz użyć ustawień globalnych.

Kod bezpieczeństwa - kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Bezpieczeństwo.

ID klienta - 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.

Sekret API - hasło API, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Secret.

Opis - opis, który będzie widoczny pod tytułem płatności.

Włącz dla podanych metod dostawy - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw pole puste jeśli ma być dostępna dla wszystkich.

Adres do notyfikacji - adres powiadomień, na który będą wysyłane notyfikacje dotyczące statusu płatności.*

Konfiguracja płatności: karta płatnicza (strona zamówienia)

Przykładowa konfiguracja (przykładowe dane należą do konta demo, w swojej konfiguracji użyj danych ze swojego konta)

Uruchom płatność - zaznacz tę opcję jeśli chcesz, że płatności były włączone włączoną.

Nazwa - tytuł płatności, który zobaczą klienci podczas dokonywania zakupu.

Użyj ustawień globalnych - zaznacz tę opcje jeśli chcesz użyć ustawień globalnych.

Kod bezpieczeństwa - kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Bezpieczeństwo.

ID klienta - 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.

Sekret API - hasło API, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Secret.

Opis - opis, który będzie widoczny pod tytułem płatności.

Włącz dla podanych metod dostawy - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw pole puste jeśli ma być dostępna dla wszystkich.

Adres do notyfikacji - adres powiadomień, na który będą wysyłane notyfikacje dotyczące statusu płatności.*

Klucz RSA - 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).

Konfiguracja płatności: Google Pay

Przykładowa konfiguracja (przykładowe dane należą do konta demo, w swojej konfiguracji użyj danych ze swojego konta)

Uruchom płatność - zaznacz tę opcję jeśli chcesz, że płatności były włączone włączoną.

Nazwa - tytuł płatności, który zobaczą klienci podczas dokonywania zakupu.

Użyj ustawień globalnych - zaznacz tę opcje jeśli chcesz użyć ustawień globalnych.

Kod bezpieczeństwa - kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Bezpieczeństwo.

ID klienta - 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.

Sekret API - hasło API, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Secret.

Opis - opis, który będzie widoczny pod tytułem płatności.

Włącz dla podanych metod dostawy - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw pole puste jeśli ma być dostępna dla wszystkich.

Adres do notyfikacji - adres powiadomień, na który będą wysyłane notyfikacje dotyczące statusu płatności.*

Konfiguracja płatności: Twisto

Przykładowa konfiguracja (przykładowe dane należą do konta demo, w swojej konfiguracji użyj danych ze swojego konta)

Uruchom płatność - zaznacz tę opcję jeśli chcesz, że płatności były włączone włączoną.

Nazwa - tytuł płatności, który zobaczą klienci podczas dokonywania zakupu.

Użyj ustawień globalnych - zaznacz tę opcje jeśli chcesz użyć ustawień globalnych.

Kod bezpieczeństwa - kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Bezpieczeństwo.

ID klienta - 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.

Sekret API - hasło API, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Secret.

Opis - opis, który będzie widoczny pod tytułem płatności.

Włącz dla podanych metod dostawy - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw pole puste jeśli ma być dostępna dla wszystkich.

Adres do notyfikacji - adres powiadomień, na który będą wysyłane notyfikacje dotyczące statusu płatności.*

Konfiguracja płatności: Raty Tpay

Przykładowa konfiguracja (przykładowe dane należą do konta demo, w swojej konfiguracji użyj danych ze swojego konta)

Uruchom płatność - zaznacz tę opcję jeśli chcesz, że płatności były włączone włączoną.

Nazwa - tytuł płatności, który zobaczą klienci podczas dokonywania zakupu.

Użyj ustawień globalnych - zaznacz tę opcje jeśli chcesz użyć ustawień globalnych.

Kod bezpieczeństwa- kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Bezpieczeństwo.

ID klienta - 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.

Sekret API - hasło API, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Secret.

Opis - opis, który będzie widoczny pod tytułem płatności.

Włącz dla podanych metod dostawy - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw pole puste jeśli ma być dostępna dla wszystkich.

Adres do notyfikacji - adres powiadomień, na który będą wysyłane notyfikacje dotyczące statusu płatności.*

Konfiguracja płatności: Raty Pekao

Przykładowa konfiguracja (przykładowe dane należą do konta demo, w swojej konfiguracji użyj danych ze swojego konta)

Uruchom płatność - zaznacz tę opcję jeśli chcesz, że płatności były włączone włączoną.

Nazwa - tytuł płatności, który zobaczą klienci podczas dokonywania zakupu.

Użyj ustawień globalnych - zaznacz tę opcje jeśli chcesz użyć ustawień globalnych.

Kod bezpieczeństwa - kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Bezpieczeństwo.

ID klienta - 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.

Sekret API - hasło API, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Secret.

Opis - opis, który będzie widoczny pod tytułem płatności.

Włącz dla podanych metod dostawy - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw pole puste jeśli ma być dostępna dla wszystkich. 

Merchant ID - numer identyfikacyjny Sprzedawcy. Identyfikator ma taką samą wartość login do Panelu Akceptanta.

Symulator rat na karcie produktu - symulator będzie widoczny na stronie produktu.

Symulator rat w koszyku zakupowym - symulator będzie widoczny na stronie koszyka.

Symulator rat na stronie zamówienia - symulator będzie widoczny na stronie zamówienia.

Adres do notyfikacji - adres powiadomień, na który będą wysyłane notyfikacje dotyczące statusu płatności.*

* Adres notyfikacji domyślnie jest automatycznie nadpisywany przez platformę sprzedażową, jeśli chcesz na stałe przypisać jego wartość do konta Tpay wejdź na Panel Akceptanta w zakładce Ustawienia → Powiadomienia w sekcji URL do powiadomień wpisz adres ze wtyczki i zapisz zmiany. Zaznaczając opcje Zezwól na nadpisanie adresu URL powiadomienia na tak, platforma sprzedażowa będzie samodzielnie nadpisywała jego wartość - zalecane jeśli na swoim koncie masz więcej niż jeden Punkt Sprzedaży.

Uwaga

WooCommerce automatycznie zmienia status każdego niezrealizowanego zamówienia na “Anulowane”. Aby zmienić czas aktywności takiego zamówienia, postępuj zgodnie z poniższą instrukcją.

  1. Zaloguj się do konta administratora w platformie WordPress.
  2. Przejdź do ustawień wtyczki WooCommerce. 
  3. Wybierz zakładkę “Produkty” → “Magazyn”. 
  4. Następnie w sekcji “Wstrzymuj stan magazynowy” wpisz w minutach, ile czasu towar może być wstrzymany i ma oczekiwać na opłacenie. Po przekroczonym czasie status transakcji zmieni się na “Anulowany”. Jeśli zostawisz puste to okno, zmianę statusu zamówienia trzeba będzie realizować samodzielnie.

Pamiętaj o włączeniu opcji “Włącz zarządzanie stanem magazynowym”.
Domyślny czas to 60 minut.