5. Kontakt
1. Wstęp
Rozwiązanie, z którego obecnie Państwo korzystają, będzie stopniowo zastępowane nowszymi i ulepszonymi wersjami. Dlatego już teraz zachęcamy do aktualizacji, aby korzystać z pełnej funkcjonalności.
Nowe proponowane przez nas rozwiązanie techniczne oparte jest na Drop-In-UI – gotowym widoku użytkownika łatwym do osadzenia w aplikacji, które:
- spełnia wszystkie wymogi bezpieczeństwa – w tym standardy PCI DSS,
- zwiększa wygodę korzystania ze strony, m.in. pozwalając dostosować jej wygląd,
- zostało zaprojektowane zgodnie z najnowszymi trendami rynkowymi w obszarze digital.
Rozwiązanie Drop-In UI obsługuje najpopularniejsze metody płatności, takie jak:
- BLIK,
- płatność kartami,
- płatność przez przelewy bankowe,
- płatności portfelami elektronicznymi (typu „wallet” jak Apple Pay, Google Pay).
1.1 Przeznaczenie dokumentu
Niniejszy dokument przedstawia kroki niezbędne do uruchomienia płatności eService przy użyciu modułu GlobalPayments WooCommerce, przeznaczonego dla systemu WooCommerce.
1.2 Wymagania systemowe
- WordPress w wersji: 6.0 lub nowszej
- PHP w wersji: 8.0 lub nowszej
- Obsługa trybu blokowego: wymagana
1.3 Przygotowanie do integracji
Przed rozpoczęciem implementacji modułu w systemie sklepu należy zweryfikować wersję używanego WooCommerce oraz pobrać najnowszą wersję modułu płatności Global Payments WooCommerce.
Moduł możesz pobrać na dwa sposoby:
- bezpośrednio z panelu WordPress,
- korzystając z linku: https://wordpress.org/plugins/global-paymentswoocommerce/
1.4 Bezpieczna komunikacja
ecom_upgrades@eservice.com.pl – adres kontaktowy do zespołu odpowiedzialnego za aktualizacje i wsparcie przy przejściu na nową wersję. Z tego adresu otrzymają Państwo również dane do nowej wersji bramki płatniczej.
login@eservice.com.pl – adres systemowy do otrzymania danych logowania do back office (RealControl), gdzie można w pełni zarządzać transakcjami. Podczas logowania możliwe jest ustawienie języka polskiego w lewym dolnym rogu ekranu.
Mail dotyczący back office (RealControl) może zostać wysłany w języku polskim lub angielskim – poniżej przykładowa wiadomość.
2. Instalacja modułu GlobalPayments WooCommerce
2.1 Instalacja sposób pierwszy (pobranie bezpośrednio przez panel wordpress)
1. W panelu administracyjnym W menu znajdującym się po lewej stronie należy wybrać Wtyczki, a następnie Dodaj wtyczkę.
2. W polu szukaj wtyczek wpisujemy GlobalPayments WooCommerce a następnie instalujemy wtyczkę.
3. Włączamy wtyczkę.
4. Po zainstalowaniu wtyczki, możemy przejść do jej konfiguracji.
2.2 Instalacja sposób drugi (pobranie za pośrednictwem linku).
Po pobraniu najnowszej wersji wtyczki GlobalPayments WooCommerce z linku (https://wordpress.org/plugins/global-payments-woocommerce/), należy zainstalować ją w systemie sklepu WooCommerce zgodnie z dalszymi instrukcjami.
1. W pierwszej kolejności, należy zalogować się do panelu administracyjnego Wordpress.
2. W panelu administracyjnym, w menu znajdującym się po lewej stronie należy wybrać Wtyczki, a następnie Zainstalowane wtyczki.
3. Następnie klikamy Wyślij wtyczkę na serwer.
4. W kolejnym kroku należy kliknąć przycisk Wybierz plik, a następnie wskazać wcześniej pobrany plik instalacyjny. Po wybraniu pliku należy nacisnąć przycisk Zainstaluj.
Ważne! Jeżeli użytkownik nie wybrał folderu zapisu w momencie pobierania pliku instalacyjnego, domyślnym miejscem zapisu jest folder "Pobrane"
(plik global-payments-woocommerce.zip).
5. W następnym kroku WooCommerce wykona instalację wtyczki, która zakończy się komunikatem Wtyczka została zainstalowana. Teraz należy, nacisnąć przycisk Włącz wtyczkę i przejść do konfiguracji płatności.
2.3 Konfiguracja modułu płatności
1. W panelu administracyjnym WordPress, z menu po lewej stronie należy wybrać opcję Płatności. System przekieruje nas do ustawień WooCommerce. Następnie należy przejść do zakładki Ustawienia, a potem do sekcji Płatności.
2. W zakładce Płatności dostępna jest lista różnych metod płatności. Każda z nich wymaga konfiguracji – w zależności od tego, z których rozwiązań użytkownik zamierza korzystać. W ramach niniejszej instrukcji skupiamy się wyłącznie na konfiguracji metod płatności eService.
Aby skonfigurować wybraną metodę płatności, należy:
- Włączyć moduł Unified Payments – klikając przycisk Włącz, znajdujący się po prawej stronie obok opcji Zarządzaj.
- Po włączeniu modułu przejść do jego konfiguracji, wybierając przycisk Zarządzaj.
3. Rozpoczynamy uzupełnienie danych w sekcji Unified Payments – Connect to the Unified Payments Gateway. W ustawieniach płatności należy upewnić się, że dana metoda płatności jest aktywna. W tym celu należy zaznaczyć pole wyboru (check box) Enable Gateway. Dodatkowo należy uzupełnić pole Title, wpisując wartość eService.
- Opcja Enable/Disable – czyli włączono (Enable) lub wyłączono (Disable).
- Title – nazwa metody płatności, jaka będzie się wyświetlać na stronie Zamówienia (należy zmienić ją na eService).
4. Aby możliwe było przyjmowanie płatności od klientów, należy zaznaczyć pole wyboru (check box) Live Mode (środowisko produkcyjne).
- Live mode – konfiguracja określająca czy bramka będzie działać na środowisku produkcyjnym czy testowym. Checkbox powinien być zaznaczony.
5. W kolejnym kroku należy uzupełnić dane uwierzytelniające do bramki płatniczej (Live App Id oraz Live App Key) oraz wprowadzić dodatkowe ustawienia opisane poniżej.
Ważne! Dane do nowej wersji bramki płatniczej są wysyłane e-mailem.
- Live App Id – unikalny identyfikator sklepu w bramce płatniczej (przekazany przez eService w odrębnej komunikacji).
- Live App Key – hasło do bramki płatniczej (przekazany przez eService w odrębnej komunikacji).
- Live Account Name – subkonto dla sklepu, w bramce płatniczej, wartość ta wybierana jest z listy, która pojawi się po sprawdzeniu prawidłowego wprowadzenia danych i kliknięciu przycisku Credentials check.
- Credentials check – po wprowadzeniu danych App Key oraz App ID, klikamy “Credentials check” w celu weryfikacji poprawności wprowadzonych danych. Przy udanej próbie komunikacji z bramką pojawi się komunikat Your credentials were successfully confirmed!
- Allow Card Saving – pozwala zapisać kartę w bramce płatniczej, aby w przyszłych transakcjach klient nie musiał ponownie wpisywać danych karty, tylko mógł wybrać ją z zapisanych kart (domyślnie opcja wyłączona).
Poniżej widok z pola Live Account Name (po wykonaniu Credentials check)
General Settings:
- Contact Url – adres url sklepu z danymi kontaktowymi (np. html:///www.example.com/kontakt).
- Enable 3D Secure – opcja musi być obowiązkowo włączona, jest ona odpowiedzialna za włączenie uwierzytelniania klienta w trakcie płatności kartą.
- Payment Action – konfiguruje, jak bramka ma zachować się w momencie płatności kartą.
- Authorize + Capture – klient od razu jest obciążany, za płatność.
- Authorize only – klient ma tylko zablokowane środki na koncie, wymagane wysłanie obciążenia na finalną kwotę (równą lub mniejszą, niż w pierwotnej autoryzacji).
- Check AVS CVN – opcję należy włączyć (bezpieczeństwo).
- Enable Blik Payment – włącza płatność BLIK-iem na bramce.
- Enable Open Banking Payment – włącza płatność przelewami bankowymi na bramce.
6. Po zakończeniu konfiguracji należy zapisać wprowadzone zmiany. Od tego momentu bramka płatnicza będzie widoczna wraz z włączonymi metodami płatności w sklepie, w podsumowaniu zamówienia.
3. Tryb testowy
Uwaga! Środowiska testowe są tworzone na specjalne życzenie klienta.
Aby przełączyć się na tryb testowy w konfiguracji metody płatności Unified Payments, należy:
- Odznaczyć pole wyboru (checkbox) „LIVE Mode”.
- Wprowadzić dane dedykowane dla środowiska testowego (inne niż produkcyjne) udostępnione przez eService: Sandbox App Id, Sandbox App Key oraz Sandbox Account Name.
4. Bezpieczny upgrade do nowej wtyczki GlobalPayments WooCommerce
4.1 Instalacja & konfiguracja nowej wtyczki
1. Nową wtyczkę należy zainstalować wybraną przez użytkownika metodą, zgodnie z instrukcjami opisanymi w rozdziale Instalacja modułu GlobalPayments WooCommerce (punkt 2).
2. Nową wtyczkę należy skonfigurować zgodnie z instrukcjami zawartymi w rozdziale Konfiguracja modułu płatności (punkt 2.3).
3. Na tym etapie w systemie sklepu są już zainstalowane i skonfigurowane dwie wtyczki – zarówno starsza, jak i nowa.
4.2 Konfiguracja strony z zamówieniami
1. W celu skonfigurowania strony odpowiedzialnej za zamówienia zaleca się wykonanie konfiguracji na nowej, dedykowanej stronie. Proces konfiguracji można również powtórzyć na głównej stronie zamówień. Nowo utworzona strona może zostać ustawiona jako domyślna strona zamówień – finalny wybór należy do użytkownika.
Ze względów bezpieczeństwa rekomenduje się, aby nowa strona była tymczasowo niepubliczna lub zabezpieczona hasłem do czasu zakończenia konfiguracji, testów i wprowadzenia wszystkich ustawień.
Docelowym rozwiązaniem jest upewnienie się, że po włączeniu wtyczki i jej konfiguracji strona zamówień wspiera tryb blokowy – wówczas wtyczka będzie widoczna i będzie działać prawidłowo. Konfigurację można przeprowadzić na kilka sposobów, w tym bezpośrednio na istniejącej stronie, jednak dla bezpieczeństwa rekomendujemy konfigurację na nowej, dedykowanej stronie zamówień.
2. Aby utworzyć nową stronę, należy przejść do Strony → Dodaj stronę i stworzyć nową stronę, np. „Zamówienia_nowe_01”.
3. Na nowo utworzonej stronie należy dodać nowy blok Zamówienie.
4. Po dodaniu bloku Zamówienie i jego zaznaczeniu mogą wystąpić trzy sytuacje:
- Tryb blokowy jest obsługiwany – widok powinien być zbliżony do standardowego widoku blokowego, który jest włączony domyślnie.
- Tryb blokowy nie jest obsługiwany – widok może różnić się od oczekiwanego, ponieważ tryb blokowy jest wyłączony domyślnie.
- Błędy lub inne utrudnienia – w przypadku problemów należy skontaktować się z nami, wysyłając wiadomość na adres e-mail podany w rozdziale Kontakt, wraz z opisem zaistniałej sytuacji oraz komunikatem błędu.
5.
- Poniższy widok prezentuje włączoną obsługę trybu blokowego. Blok Zamówienie wyświetla się poprawnie, wizualnie prezentując całe zamówienie wraz z płatnościami, w tym metodami, które są aktywne.
Mogą pojawiać się komunikaty ostrzegawcze, ponieważ starsza wtyczka jest nadal włączona, a nie obsługuje trybu blokowego.
- Poniższy widok prezentuje sytuację, gdy obsługa trybu blokowego jest wyłączona. Blok Zamówienie może nie wyświetlać pełnej wizualizacji zamówienia ani aktywnych metod płatności w taki sam sposób, jak przy włączonym trybie blokowym.
W tym przypadku mogą pojawić się komunikaty informujące o konieczności włączenia trybu blokowego, np. z opcją Przekształć na bloki.
6. Po przełączeniu strony na tryb blokowy możemy [opcjonalnie] przejść do zakładki Strona, w której możliwa jest m.in.: zmiana statusu widoczności strony lub zabezpieczenie strony hasłem. W zależności od preferencji użytkownika, możemy to ustawić w prosty i szybki sposób:
a. [Opcjonalnie] Zmianę statusu widoczności strony wykonujemy w następujący sposób: przejdź do zakładki Strona, gdzie możesz np. zmienić status widoczności lub zabezpieczyć stronę hasłem, w zależności od swoich preferencji.
b. [Opcjonalnie] Przejdź do zakładki Blok i zaktualizuj ustawienia, aby wykorzystać ten blok jako wiodącą stronę do zamówień.
7. Zapisz ustawienia. Jest to bardzo ważny krok – pozwala zachować wszystkie wprowadzone zmiany i konfiguracje. Nie można go pominąć.
8. Jeśli wtyczka została poprawnie skonfigurowana, a tryb blokowy jest włączony, nowa metoda płatności będzie widoczna podczas finalizacji zamówienia w koszyku, w sekcji Opcje płatności.
Poniżej przedstawiono przykładowy widok z jednego z naszych sklepów testowych.
4.3 Wykonanie testowego zamówienia na koncie produkcyjnym.
Rekomendujemy wykonanie testowego zamówienia w swoim sklepie (czyli dokonanie rzeczywistej płatności), aby ostatecznie sprawdzić, czy wszystkie mechanizmy działają poprawnie.
W tym celu:
- Dodaj przykładowy produkt do koszyka.
- Uzupełnij niezbędne informacje do zamówienia.
- Sfinalizuj płatność.
Na tym etapie nowa bramka płatnicza będzie już widoczna i powinna funkcjonować prawidłowo.
- Po opłaceniu zamówienia i braku komunikatów o błędzie test uznaje się za pozytywny.
- W przypadku problemów lub błędów prosimy o kontakt pod adresem podanym w sekcji Kontakt.
- Po dokonaniu płatności możliwe jest dokonanie zwrotu z poziomu nowego backoffice, do którego również otrzymają Państwo dane logowania.
5. Kontakt
W razie jakichkolwiek pytań podczas wdrożenia prosimy o kontakt z Zespołem Wdrożeniowym eService: email: ecom_upgrades@eservice.com.pl
