Wymagania

Instrukcja dotyczy instalacji modułu płatności tpay.com dla skryptu Woocommerce w wersjach 2 - 3 działającego w Wordpressie. Moduł był testowany na systemie zbudowanym z wersji Woocommerce 3.2.3 i Wordpress 4.9.2.

Aby korzystać z płatności tpay.com w platformie Woocommerce niezbędne jest:

1. Posiadanie konta w systemie tpay.com
2. Aktywna wtyczka WooCommerce dla Wordpressa.
3. Pobranie plików instalacyjnych modułu z katalogu Wordpress: https://wordpress.org/plugins/woocommerce-tpay-payment-gateway/
4. Wersja serwera PHP minimum 5.3

Instalacja modułu

    Instalacja automatyczna

1. Przejdź do „Wtyczki” następnie „Dodaj nową” i w miejscu „Szukaj wtyczek” wyszukaj „tpay”
2. W „Wynikach wyszukiwania” pojawi się moduł płatności tpay, który należy zainstalować i włączyć.
   

   Instalacja ręczna

1. Rozpakuj zawartość archiwum na dysk. Po rozpakowaniu powinien powstać folder „woocommerce_tpay”.
2. Wyślij cały folder do katalogu wp-content/plugins znajdującego się w Twojej instalacji Wordpress.
3. Przejdź do panelu administracyjnego i otwórz zakładkę „Wtyczki”. Kliknij „Włącz” przy pozycji „tpay.com”.
4. Przejdź do WooCommerce ->Ustawienia i wybierz zakładkę „Zamówienia ” po czym z listy dostępnych metod płatności  wybierz tpay.com.
   
5. Teraz należy dokonać odpowiednich ustawień dla modułu płatności tpay:
   1. Włącz/Wyłącz – należy pozostawić zaznaczone, aby klienci mogli dokonywać płatności przez tpay.
   2. Nazwa – nazwa płatności
   3. Opis - opis bramki płatności tpay, który widzi użytkownik przy tworzeniu zamówienia
   4. ID sprzedawcy – pole obowiązkowe, Twój ID otrzymany podczas zakładania konta com
   5. Kod bezpieczeństwa – należy wpisać kod  ustawiony w Panelu Odbiorcy Płatności  w tpay.com. Menu -> Ustawienia -> Powiadomienia -> Kod Bezpieczeństwa.
   6. Włącz płatność blikiem na stronie sklepu – opcja pozwala włączyć dodatkową opcję szybkich płatności blik (od 1zł), bez przechodzenia do panelu transakcyjnego. Wystarczy wprowadzić 6-cyfrowy kod blik w pole formularza i nacisnąć zapłać, a następnie potwierdzić płatność na urządzeniu mobilnym.
   7. Klucz API – Wymagany do płatności blikiem oraz zwrotów. Należy wygenerować dostęp w panelu odbiorcy płatności w zakładce Ustawienia -> api, z dostępem „transakcja” i „zwroty” oraz opcją „włączony”->”tak”, a następnie wkleić w to pole zawartość api_key.
   8. Hasło API – Należy wprowadzić hasło do wygenerowanego dostępu api, w panelu odbiorcy płatności.
   9. Dopłata doliczana za korzystanie z tpay – opcja ta pozwala doliczyć do kwoty zamówienia, opłatę za korzystanie płatności tpay. Domyślnie wybrana jest opcja NIE. Pozostałe opcje to kwota w PLN lub procent kwoty.
   10. Kwota dopłaty – dla wybranej w poprzednim punkcie opcji:
       PLN- kwota doliczana do zamówienia, liczby dziesiętne należy podać po kropce np.  3.50
       % - procent jaki ma zostać doliczony z danego zamówienia do całkowitej kwoty zamówienia, liczby dziesiętne należy podać po kropce np. 2.75
   11. Mój serwer korzysta z proxy - opcja wyłączająca sprawdzanie adresu IP serwera wysyłającego powiadomienie o wpłacie (niezalecane!)
   12. Automatycznie realizuj zamówienia - opcja zmieniająca status zamówienia automatycznie na "Zrealizowane", po otrzymaniu informacji o wpłacie. Przydatna w sprzedaży produktów cyfrowych.
   13. Włącz wybór banku na stronie sklepu– dostępne opcje:
       TAK – klient będzie dokonywał wyboru kanału płatności na stronie sklepu.
       NIE – klient dokona wyboru kanału płatności po przejściu do Panelu Transakcyjnego tpay.
   14. Widok listy kanałów- pozwala wybrać na jakiej zasadzie mają być wyświetlane kanały płatności na stronie sprzedawcy:
       Lista – rozwijana lista zawierająca kanały płatności.
       Kafelki – kanały płatności wyświetlane w formie ikon z logami banków.
       Opcja brana pod uwagę tylko z aktywną opcją 13.
       
6. Następnie należy kliknąć „Zapisz zmiany”.

Zintegrowana bramka kartowa

1. Skonfiguruj dostęp do API kart płatniczych, zgodnie z tym artykułem, wprowadzając konfigurację uwzględniającą następujące wskazówki:
   W polu „adres URL powiadomień” wpisz link według następującego formatu: https://adressklepu.pl/?wc-api=WC_Gateway_Tpay_Cards&type=sale
   gdzie „adressklepu.pl” należy zamienić na adres konfigurowanego sklepu.
   
   Adresy powrotne są opcjonalne, gdyż moduł płatności przesyła je automatycznie dla każdej transakcji. W tym miejscu można wprowadzić np.
   https://adressklepu.pl/
2. Przejdź do WooCommerce ->Ustawienia i wybierz zakładkę „Zamówienia” po czym z listy dostępnych metod płatności wybierz tpay.com credit cards.
   
3. Włącz opcję płatności oraz wypełnij dane zgodnie z dostępem wygenerowanym w panelu odbiorcy płatności, w zakładce „transakcje kartowe” -> „API”

Konto wielowalutowe: Wybierz typ konta, które posiadasz w Elavon:

• tylko PLN dla kont z włączonym eDCC
• wszystkie obsługiwane waluty dla kont z włączonym multi currency

Konfiguracja płatności kartami – przykłady

• Strona x.pl posiada walutę PLN, natomiast x.com sprzedaje w USD oraz EUR. W takim wypadku można podłączyć jedno konto z EDCC, zaznaczając opcję „tylko PLN” i wpisując w konfiguracji domenę https://x.pl/.
• Strona x.com sprzedaje w walucie USD na podstronie x.com/en oraz w EUR na stronie x.com/de. W takim przypadku można podłączyć jedno konto Multi Currency pozostawiając pole waluty puste, i wpisując dwukrotnie te same dane dostępu jako dwa kolejne MID’y, z tą tylko różnicą, że adres domeny wpisujemy jako: https://x.com/de/ oraz https://x.com/en/

Prosimy zwrócić uwagę na znak / na końcu adresu w większości przypadków jego dodanie jest konieczne do poprawnego wyświetlenia bramki płatności.