Wymagania:
- WordPress z wersją PHP minimum 7.0
- Zainstalowana wtyczka WooCommerce w wersji powyżej 6.x.x
- Sklep z ustawioną walutą Polski Złoty (PLN)
- Aktywne konto wTpay
- Uruchomiony dostęp na koncie do Open API:
- Sprawdź, czy w Panelu Akceptanta Tpay w zakładce “Integracja” → “API” → dostępna jest sekcja “Klucze do nowego Open API”.
- Jeśli ich nie ma, skontaktuj się z Biurem Obsługi Klienta: [email protected].
Instalacja manualna:
- Pobierz wtyczkę na dysk komputera.
- Zaloguj się do panelu administracyjnego WordPress.
- W menu wybierz “Wtyczki”, następnie kliknij “Dodaj nową”.
- 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ę “Tpay settings”.
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 trzeba na nowo wpisywać tych samych danych konfiguracyjnych do każdego sposobu płatności.
- Sekretny klucz (w powiadomieniach) - 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.
- Hasło 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.
- Tpay environment - 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.
- Merchant email - 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 do chwili opłacenia transakcji.
- Dodatkowa kwota - opcja umożliwiająca doliczanie opłaty dodatkowej do kwoty zamówienia za korzystanie z płatności Tpay.
Konfiguracja płatności
- 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 - opcja wyświetla płatności w formie kafelków banków w koszyku sklepu.
Blik - opcjawyświetla metodę płatności BLIK w koszyku sklepu. Konfiguracja pozwala również włączyć BLIK LVL 0.
Karta płatnicza (strona tpay.com) - opcja wyświetla metodę płatności kartami w koszyku sklepu.Włącz tę metodę płatności, jeśli Twoje konto może je przyjmować. Jeśli taka metoda płatności nie są dostępna na Twoim koncie - skontaktuj się z Biurem Obsługi Klienta: [email protected].
Karta płatnicza (strona zamówienia) - opcja wyświetla metodę płatności kartami w koszyku sklepu.Włącz tę metodę płatności, jeśli Twoje konto może je przyjmować. Jeśli taka metoda płatności nie są dostępna na Twoim koncie - skontaktuj się z Biurem Obsługi Klienta: [email protected].
Płatność Google Pay - opcja wyświetla metodę płatności Google Pay w koszyku sklepu.Włącz tę metodę płatności, jeśli Twoje konto może je przyjmować. Jeśli taka metoda płatności nie są dostępna na Twoim koncie - skontaktuj się z Biurem Obsługi Klienta: [email protected].
Twisto - opcja wyświetla metodę płatności Twisto w koszyku sklepu. Ta metoda płatności będzie widoczna dla zakupów o maks. wartości 1 500 zł.
Raty Tpay - opcja wyświetla metodę płatności Rat w koszyku sklepu. Płatność będzie widoczna dla zakupów od 300 do 9 259 zł. Włącz tę metodę płatności, jeśli Twoje konto może je przyjmować. Jeśli taka metoda płatności nie są dostępna na Twoim koncie - skontaktuj się z Biurem Obsługi Klienta: [email protected].
2. Wybierz 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)
Włączyć/Wyłączyć - zaznacz tę opcję, jeśli chcesz, żeby płatności były włączone/ wyłączone.
- Nazwa - to tytuł płatności, który zobaczą klienci podczas dokonywania zakupu.
- Użyj ustawień globalnych - zaznacz tę opcję, jeśli chcesz użyć ustawień globalnych.
- Sekretny klucz (w powiadomieniach) - to kod bezpieczeństwa, dostępny w Panelu Akceptanta Tpay w zakładce “Ustawienia” → “Powiadomienia” → sekcja “Bezpieczeństwo”.
- ID klienta - identyfikator API klienta, dostępny w Panelu Akceptanta Tpay w zakładce “Integracja” → “API” → sekcja “Klucze do nowego Open API” w polu “Client ID”.
- Hasło API - hasło API, dostępne w Panelu Akceptanta 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 płatności - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw to pole puste, jeśli ma być dostępna dla wszystkich.
- Własna kolejność - ta funkcja odpowiada za zmianę kolejności wyświetlanych banków. Wpisz grupy bankowe, które mają być wyświetlane w pierwszej kolejności, np. wpisanie “150, 160, 111” powoduje wyświetlanie płatności BLIK, mBank, ING w pierwszej kolejności.
- Pokaż nieaktywne metody płatności - ta funkcja pokazuje wszystkie metody płatności, również te, które nie są aktywne na koncie.
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)
- Włączyć/Wyłączyć - zaznacz tę opcję, jeśli chcesz, że płatności były włączone/wyłączone.
- Nazwa - tytuł płatności, który zobaczą klienci podczas dokonywania zakupu.
- Użyj ustawień globalnych - zaznacz tę opcję, jeśli chcesz użyć ustawień globalnych.
- Sekretny klucz (w powiadomieniach) - kod bezpieczeństwa, dostępny w Panelu Akceptanta Tpay w zakładce “Ustawienia” → “Powiadomienia” → sekcja “Bezpieczeństwo”.
- ID klienta - identyfikator API klienta, dostępny w Panelu Akceptanta Tpay w zakładce “Integracja” → “API” → sekcja “Klucze do nowego Open API” w polu “Client ID”.
- Hasło API - hasło API, dostępne w Panelu Akceptanta 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 płatności - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw to pole puste, jeśli ma być dostępne dla wszystkich.
- Włącz BLIK LVL 0 - zaznacz tę opcję, 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)
- Włączyć/Wyłączyć - zaznacz tę opcję, jeśli chcesz, że płatności były włączone/wyłączone.
- 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.
- Sekretny klucz (w powiadomieniach) - kod bezpieczeństwa, dostępny w Panelu Akceptanta Tpay w zakładce “Ustawienia” → “Powiadomienia” → sekcja “Bezpieczeństwo”.
- ID klienta - identyfikator API klienta, dostępny w Panelu Akceptanta Tpay w zakładce “Integracja” → “API” → sekcja “Klucze do nowego Open API” w polu “Client ID”.
- Hasło API - hasło API, dostępne w Panelu Akceptanta 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 płatności - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw to pole puste, jeśli ma być dostępne 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)
- Włączyć/Wyłączyć - zaznacz tę opcję, jeśli chcesz, że płatności były włączone/wyłączone.
- 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.
- Sekretny klucz (w powiadomieniach) - kod bezpieczeństwa, dostępny w Panelu Akceptanta Tpay w zakładce “Ustawienia” → “Powiadomienia” → sekcja “Bezpieczeństwo”.
- ID klienta - identyfikator API klienta, dostępny w Panelu Akceptanta Tpay w zakładce “Integracja” → “API” → sekcja “Klucze do nowego Open API” w polu “Client ID”.
- Hasło API - hasło API, dostępne w Panelu Akceptanta 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 płatności - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw to pole puste, jeśli ma być dostępne 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 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)
- Włączyć/Wyłączyć - zaznacz tę opcję, jeśli chcesz, że płatności były włączone/wyłączone.
- 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.
- Sekretny klucz (w powiadomieniach) - kod bezpieczeństwa, dostępny w Panelu Akceptanta Tpay w zakładce “Ustawienia” → “Powiadomienia” → sekcja “Bezpieczeństwo”.
- ID klienta - identyfikator API klienta, dostępny w Panelu Akceptanta Tpay w zakładce “Integracja” → “API” → sekcja “Klucze do nowego Open API” w polu “Client ID”.
- Hasło API - hasło API, dostępne w Panelu Akceptanta 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 płatności - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw to pole puste, jeśli ma być dostępne 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)
- Włączyć/Wyłączyć - zaznacz tę opcję, jeśli chcesz, że płatności były włączone/wyłączone.
- 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.
- Sekretny klucz (w powiadomieniach) - kod bezpieczeństwa, dostępny w Panelu Akceptanta Tpay w zakładce “Ustawienia” → “Powiadomienia” → sekcja “Bezpieczeństwo”.
- ID klienta - identyfikator API klienta, dostępny w Panelu Akceptanta Tpay w zakładce “Integracja” → “API” → sekcja “Klucze do nowego Open API” w polu “Client ID”.
- Hasło API - hasło API, dostępne w Panelu Akceptanta 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 płatności - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw to pole puste, jeśli ma być dostępne 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
Przykładowa konfiguracja (przykładowe dane należą do konta demo, w swojej konfiguracji użyj danych ze swojego konta)
- Włączyć/Wyłączyć - zaznacz tę opcję, jeśli chcesz, że płatności były włączone/wyłączone.
- 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.
- Sekretny klucz (w powiadomieniach) - kod bezpieczeństwa, dostępny w Panelu Akceptanta Tpay w zakładce “Ustawienia” → “Powiadomienia” → sekcja “Bezpieczeństwo”.
- ID klienta - identyfikator API klienta, dostępny w Panelu Akceptanta Tpay w zakładce “Integracja” → “API” → sekcja “Klucze do nowego Open API” w polu “Client ID”.
- Hasło API - hasło API, dostępne w Panelu Akceptanta 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 płatności - wybór metod wysyłki, dla jakich ma być dostępna płatność. Zostaw to pole puste, jeśli ma być dostępne dla wszystkich.
- 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ź w Panel Akceptanta w zakładkę “Ustawienia” → “Powiadomienia” i w sekcji “URL do powiadomień” wpisz adres z wtyczki i zapisz zmiany. Zaznaczając opcję “Zezwól na nadpisanie adresu URL” powiadomienia na “tak”, platforma sprzedażowa będzie samodzielnie nadpisywała jego wartość - jest to 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ą.
- Zaloguj się do konta administratora w platformie WordPress.
- Przejdź do ustawień wtyczki WooCommerce.
- Wybierz zakładkę “Produkty” → “Magazyn”.
- 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.