Wymagania
Aby korzystać z modułu płatności kartami tpay.com dla skryptu Magento niezbędne jest, by środowisko uruchomieniowe posiadało następujące elementy:
- System Magento wersja min. 2.x
- 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
Aktywacja płatności kartami
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/magento2cards/tpaycards/notification
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/magento2cards/tpaycards/success
oraz
https://adressklepu.pl/magento2cards/tpaycards/error
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_magento2cards 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/magento2cards
- Wpisz następujące komendy aby włączyć moduł:
php bin/magento module:enable tpaycom_magento2cards 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 credit cards i przejdź do konfiguracji.
- Skonfiguruj następujące opcje:
- Active – Należy wybrać ‘Yes’
- Description – Opis jaki będzie wyświetlany przy bramce płatności
- API key – klucz dostępu do API kartowego.
- API password – hasło dostępu do API kartowego.
- Verification code – Wygenerowany kod weryfikacyjny.
- RSA key – Klucz publiczny RSA wygenerowany dla dostępu do API kartowego.
- Multi-Currency MID type – określa czy MID jest typu EDCC lub Multi-Currency. Jeśli MID jest EDCC, to bramka kartowa będzie dostępna tylko dla zamówień w PLN.
- Hash type – algorytm podpisu wygenerowanego dostępu do API kartowego
- Enable credit card saving - umożliwia zapisywanie tokenów kart płatniczych dla przyszłych zakupów w sklepie (tylko zalogowani użytkownicy)
- 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".