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. Tytuł transakcji - W tym polu można dopisać statyczny tekst, który zostanie automatycznie dodany do opisu transakcji i numeru zamówienia, widocznego w panelu transakcyjnym.
    5. ID sprzedawcy – pole obowiązkowe, Twój ID otrzymany podczas zakładania konta com
    6. Kod bezpieczeństwa – należy wpisać kod  ustawiony w Panelu Odbiorcy Płatności  w tpay.com. Menu -> Ustawienia -> Powiadomienia -> Kod Bezpieczeństwa.
    7. 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.
    8. 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.
    9. Hasło API – Należy wprowadzić hasło do wygenerowanego dostępu api, w panelu odbiorcy płatności.
    10. 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.
    11. 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
    12. 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.
    13. 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.
    14. Włącz dla wysyłki - Pozwala sparować wyświetlanie metody płatności z wybraną metodą wysyłki. Opcja ta może być niedostępna jeśli wcześniej zainstalowany był moduł Woocommerce w wersji 2.
    15. Automatycznie oznaczaj zamówienie jako zrealizowane - opcja zmieniająca status zamówienia automatycznie na "Zrealizowane", po otrzymaniu informacji o wpłacie. Przydatna w sprzedaży produktów cyfrowych.
    16. Mój serwer korzysta z proxy - opcja wyłączająca sprawdzanie oryginalnego adresu IP serwera wysyłającego powiadomienie o wpłacie (niezalecane!)
    17. Weryfikuj adres serwera powiadomień (zalecane) - opcja włączająca weryfikację adresu IP serwera wysyłającego powiadomienie o wpłacie.
    18. Pokaż tylko metody płatności księgujące online - Umożliwia wyświetlenie na liście dostępnych metod płatności tylko tych, które w danym momencie księgują wpłaty na bierząco.
  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.

 

Płatności subskrypcyjne

Po skonfigurowaniu zintegrowanej bramki kartowej, wystarczy zainstalować dodatek Woocommerce Subscriptions aby umożliwić w sklepie regularne obciążanie kart klientów za opłaty abonamentowe.

Wtyczka Tpay oferuje zapisanie karty, dzięki czemu klient nie tylko będzie mógł kupować kolejne produkty bez wprowadzania danych karty ale również będzie mógł automatycznie przedłużać subskrypcje wykupionych usług.

Proces jest w pełni automatyczny i nie wymaga od administratora sklepu żadnych działań.

Ze względu na jednorazową weryfikację zabezpieczenia 3D Secure przy zapisywaniu karty klienta, wtyczka nie obsługuje subskrypcji z darmowym okresem próbnym, gdzie zapisanie karty musiało by się odbyć bez dokonania płatności. Wystarczy skonfigurować opłatę aktywującą okres próbny na symboliczne 10 groszy, by funkcjonalność była dostępna.

W przypadku zapisania więcej niż jednej karty płatniczej na koncie klienta, mechanizm obsługi subskrypcji będzie próbował obciążać kolejno każdą kartę po kolei, aż poprawnie pobierze środki.