Wymagania
Aby korzystać z modułu płatności tpay.com dla skryptu Magento niezbędne jest, by środowisko uruchomieniowe posiadało następujące elementy:
- System Magento wersja min. 2.x z dostępną walutą "PLN"
- Pliki instalacyjne modułu pobrane z: https://tpay.com/integracja-w-sklepach lub program composer na serwerze
- Serwer PHP w wersji minimum 5.6
Moduł był testowany na systemie zbudowanym z wersji angielskiej Magento 2.2
Ręczna instalacja modułu
- Rozpakuj zawartość archiwum na dysk. Po rozpakowaniu powinien powstać folder „tpaycom”.
- Wyślij folder "tpaycom" i całą jego zawartość do katalogu app/code na Twoim serwerze, gdzie znajduje się sklep Magento. Jeśli folder „code” nie istnieje to należy go utworzyć.
- Po wgraniu plików instalację należy dokończyć z poziomu konsoli wpisując następujące polecenia
php bin/magento module:enable tpaycom_magento2basic php bin/magento setup:upgrade
Instalacja modułu przez composer
W głównym folderze Magento wpisz następującą komendę aby pobrać moduł:
composer require tpaycom/magento2basic
Wpisz następujące komendy aby włączyć moduł:
php bin/magento module:enable tpaycom_magento2basic php bin/magento setup:upgrade
Konfiguracja modułu
- Przejdź do ustawień modułu w zakładce Stores->Configuration.
- Następnie przejdź do modułów płatności Sales -> Payment Methods.
- Wybierz z listy tpay.com i przejdź do konfiguracji.
- Skonfiguruj następujące opcje:
- Aktywny – Należy wybrać ‘Yes’
- Opis – Opis jaki będzie wyświetlany przy bramce płatności na liście dostępnych metod
- ID sprzedawcy – pole obowiązkowe, ID otrzymany od tpay.com, służący do logowania na konto.
- Kod bezpieczeństwa – należy wpisać Kod bezpieczeństwa, który znajduje się w Panelu Odbiorcy Płatności tpay.com (Menu->Ustawienia->Powiadomienia->Kod bezpieczeństwa).
- API Key – W panelu odbiorcy płatności, w zakładce ustawienia->api, należy wygenerować dostęp z uprawnieniami „transakcja” oraz „zwroty”, a następnie w tym polu wprowadzić wygenerowany klucz api. Opis wygenerowania dostępu API znajduje się w tym artykule
- API Password – hasło do klucza API
- Pokaż kanały płatności na stronie – po wybraniu tej opcji, lista płatności będzie widoczna na stronie sklepu. Klient zostanie przekierowany bezpośrednio do wybranej metody płatności. W innym przypadku klient dokona wyboru metody płatności po przekierowaniu na tpay.com. (Opcja ta jest wymagana jeżeli chcesz znać tytuł transakcji jeszcze przed jej opłaceniem.)
- Dostępne tylko płatności online - wybranie tej opcji powoduje, że klient dokona wyboru sposobu płatności, spośród tych, które zapewniają bieżące księgowanie.
- BLIK level zero (opcjonalnie) – pozwala na dokonanie płatności BLIK na stronie sklepu bez jego opuszczania. Klient wpisuje kod BLIK na stronie koszyka.
- Dostępność z ograniczeniem państw – pozwala włączyć bramkę płatności tylko dla wybranych państw.
- Dostępny od minimalnej kwoty zamówienia - minimalna kwota zmówienia w PLN dla jakiej będzie dostępna bramka tpay.com
- Dostępny do maksymalnej kwoty zamówienia – maksymalna kwota zmówienia w PLN dla jakiej będzie dostępna bramka tpay.com
- Po zakończonej konfiguracji należy zapisać zmiany przyciskiem "Save Config" w prawym górnym rogu strony
Czyszczenie pamięci podręcznej
Po zapisaniu ustawień należy wyczyścić pamięć podręczną sklepu. W tym celu należy przejść do zakładki System->Cache Management i wybrać "flush static files cache".
Następnie w prawym górnym rogu należy wybrać Flush Magento Cache
Wykonywanie zwrotów (tylko tryb produkcyjny)
Jeżeli klucz API został poprawnie skonfigurowany, możesz wykonywać zwroty częściowe lub całkowite z poziomu zamówienia w panelu administracyjnym Magento.
W tym celu, w szczegółach zamówienia:
- Przejdź do zakładki "faktury" i kliknij w szczegóły faktury wygenerowanej automatycznie dla zamówienia
- Wybierz z opcji "Credit Memo"
- Uzupełnij dane zwrotu i zatwierdź klikając w "Refund".