Dokumentacja techniczna

1. Wstęp  

 

Ważne! Wybór między Drop-in UI a HPP jest dostępny w konfiguracji wtyczki i zależy od preferencji użytkownika.

1.1 Przeznaczenie dokumentu  

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  

• bezpośrednio z panelu WordPress 
• korzystając z linku: https://wordpress.org/plugins/global-paymentswoocommerce/

1.4 Bezpieczna komunikacja 

2. Instalacja modułu GlobalPayments WooCommerce 

2.1 Instalacja sposób pierwszy (pobranie bezpośrednio przez panelu wordpress) 

 

2.2 Instalacja sposób drugi (pobranie za pośrednictwem linku). 

   

(plik global-payments-woocommerce.zip). 

2.3 Konfiguracja modułu płatności  

• 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. 

 

• 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.
• Należy uzupełnić pole Title, wpisując preferowaną przez siebie nazwę wyświetlaną np eService
  • Enable/Disable – czyli włączono (Enable) lub wyłączono (Disable) - Gateway.  
  • Title – nazwa metody płatności, jaka będzie się wyświetlać na stronie Zamówienia.  
    

  

• Live mode – ustawienie określające, czy bramka płatności działa w środowisku produkcyjnym czy testowym (na podstawie zaznaczenia checkboxa).  
• Live App Id – unikalny identyfikatora 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. Domyślnie dla każdego klienta wartość do wyboru powinna zaczynać się od „ECOM…”
• 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ą zapisanych kart (domyślnie opcja wyłączona).
• Payment Interface – wybór między użyciem technologii Drop-in UI a Hosted Payment Pages na stronie sklepu:
  
  • Drop-in UI – nowoczesne rozwiązanie, w którym pola do wpisania danych karty pojawiają się bezpośrednio na stronie zamówienia.
  • Hosted Payment Pages – bazuje na bezpiecznym przekierowaniu na zewnętrzną stronę płatności.

• Enable Logging – opcja domyślnie wyłączona. Włączenie jej pozwala na zapisywanie wszystkich logów na serwerze sklepu.
• Contact Url – adres url sklepu z danymi kontaktowymi, np: “https://www.przykład.sklep.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ść (domyślnie włączona).
  • 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).
• Order Transaction Descriptor – domyślnie wyłączone (pole puste).
• Check AVS CVN / CVN Reject Conditions – domyślnie zaznaczone opcje (bezpieczeństwo).
• Enable Blik Payment – włączenie płatności BLIK na bramce.
• Enable Open Banking Payment – włączenie płatności Przelewy bankowe na bramce. 

5. 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. 

2.4 Konfiguracja modułu płatności dla Hosted Payment Pages (HPP)

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 (Unified Payments). 
   
   Aby skonfigurować wybraną metodę płatności, należy: 
   
   a). Włączyć moduł Unified Payments – klikając przycisk Włącz, znajdujący się po prawej stronie obok opcji Zarządzaj.  
   
   b). Po włączeniu modułu przejść do jego konfiguracji, wybierając przycisk Zarządzaj. 
   
   

   

3. Uzupełnij dane w sekcji „Unified Payments – Connect to the Unified Payments Gateway”, aby skonfigurować Hosted Payment Pages (HPP).
   
   a). 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. 
   
   b). Należy uzupełnić pole Title, wpisując preferowaną przez siebie nazwę wyświetlaną np eService.
   • Enable/Disable – czyli włączono (Enable) lub wyłączono (Disable) - Gateway.  
   • Title – nazwa metody płatności, jaka będzie się wyświetlać na stronie Zamówienia.  
     
     
     

      

4. Aby możliwe było przyjmowanie płatności od klientów, należy zaznaczyć pole wyboru (checkbox) Live Mode (środowisko produkcyjne). Następnie, 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.  Warto dodać, że dane do nowej wersji bramki płatniczej są wysyłane e-mailem w bezpiecznej, zaszyfrowanej formie.
   
   • Live mode – ustawienie określające, czy bramka płatności działa w środowisku produkcyjnym czy testowym (na podstawie zaznaczenia checkboxa).  
   • Live App Id – unikalny identyfikatora 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. Domyślnie dla każdego klienta wartość do wyboru powinna zaczynać się od „ECOM…”
   • 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! 
     
     
     
     
     Ważne! Widok pola „Live Account Name” (podczas wybierania właściwego konta i wykonywania sprawdzenia poświadczeń – Credentials check).
     
     
     
   • 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ą zapisanych kart (domyślnie opcja wyłączona). 
   • Payment Interface – wybór między użyciem technologii Drop-in UI a Hosted Payment Pages na stronie sklepu:
     • Drop-in UI – nowoczesne rozwiązanie, w którym pola do wpisania danych karty pojawiają się bezpośrednio na stronie zamówienia.
     • Hosted Payment Pages – bazuje na bezpiecznym przekierowaniu na zewnętrzną stronę płatności
     
     
     Hosted Payment Settings: 
     
     
   • Hosted Payment Pages Display Text – tekst wyświetlany na hostowanej stronie płatności (HPP). Pole może pozostać puste – w takim przypadku zostanie użyty domyślny tekst wyświetlany.
   • Enable Google Pay for HPP – włączenie płatności Google Pay na bramce.
   • Enable Apple Pay for HPP – włączenie płatności Apple Pay na bramce.
   • Enable BLIK for HPP – włączenie płatności Blik na bramce.
   • Enable Open Banking for HPP – włączenie płatności Przelewy bankowe na bramce. 
     
     
     
     General Settings:
   • Enable Logging – opcja domyślnie wyłączona. Włączenie jej pozwala na zapisywanie wszystkich logów na serwerze sklepu.
   • Contact Url – adres url sklepu z danymi kontaktowymi, np: “https://www.przykład.sklep.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ść (domyślnie włączona).
     • 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).
   • Order Transaction Descriptor – domyślnie wyłączone (pole puste).
   • Check AVS CVN / CVN Reject Conditions – domyślnie zaznaczone opcje (bezpieczeństwo).
   • Enable Blik Payment – włączenie płatności BLIK na bramce.
   • Enable Open Banking Payment – włączenie płatności Przelewy bankowe na bramce. 
     
     
     
     
5. 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  

• 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  

4.2 Konfiguracja strony z zamówieniami  

• Tryb blokowy jest obsługiwany – widok powinien być zbliżony do standardowego widoku blokowego, który jest włączony domyślnie. Ważne! Jest to pożądana i prawidłowa konfiguracja.
• Tryb blokowy nie jest obsługiwany – widok może różnić się od oczekiwanego, ponieważ tryb blokowy jest wyłączony domyślnie. Ważne! Należy przełączyć stronę na tryb blokowy (włączyć tryb blokowy na stronie).
• Błędy lub inne utrudnienia – W przypadku problemów prosimy zapoznać się z komunikatami na ekranie. Jeśli trudności będą się utrzymywać, prosimy o kontakt mailowy (adres w rozdziale „Kontakt”) z opisem sytuacji i komunikatem błędu.

• [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.

• [Opcjonalnie] Przejdź do zakładki Blok i zaktualizuj ustawienia, aby wykorzystać ten blok jako wiodącą stronę do zamówień. 

 

 

4.3 Wykonanie testowego zamówienia na koncie produkcyjnym.  

1. Dodaj przykładowy produkt do koszyka.
2. Uzupełnij niezbędne informacje do zamówienia.
3. Sfinalizuj płatność. 

• 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