Integracja Magento 2 z płatnościami PayU

Wprowadzenie

PayU to firma fintechowa, która umożliwia dokonywanie płatności online dla sprzedawców i kupujących na całym świecie. Firma została założona w 2002 roku i ma swoją siedzibę w Hoofddorp w Holandii. PayU oferuje ponad 300 wygodnych i bezpiecznych metod płatności, w tym karty płatnicze, przelewy elektroniczne, płatności mobilne, portfele elektroniczne, płatności cykliczne, płatności odroczone, raty 100% online oraz rozwiązania one-click. PayU działa w 18 krajach na 4 kontynentach i obsługuje ponad 300 000 sprzedawców i miliony kupujących. Firma jest częścią grupy Prosus, jednej z największych grup inwestycyjnych na świecie, a jej właścicielem jest Naspers. PayU jest jednym z operatorów płatności e-commerce obecnych w Polsce.

Opis instalacji

PayU przygotowało kilka repozytoriów z modułami dla Magento 2 w różnych wersjach. Szczegóły zostały przedstawione w krótkim opisie tego modułu. W tej instrukcji przedstawimy opcję instalacji z użyciem Composer'a bezpośrednio z poziomu terminalu serwera, łącząc się z nim połączeniem SSH. W ten sposób system zarządzania pakietami, sam dobierze odpowiednia wersję modułu dla konkretnej wersji Magento której używamy, ponadto w razie potrzeby zainstaluje też niezbędne zależne moduły. Zaczynamy.

Logujemy się po SSH do terminala naszego konta hostingowego, przechodzimy do katalogu głównego magento.

Sprawdzamy na początku, czy i jaką wersję Composera mamy dostępną:

user@host:~/magento$ composer --version
Composer version 2.2.9 2022-03-15 22:13:37

Composer jest zainstalowany i to w wersji v2. Możemy przejść do instalacji modułu płatności PayU. W naszym przykładzie zainstalujemy moduł pod Magento 2.3.x.
Wpisujemy w tym celu komendę:

user@host:~/magento$ composer require payu/magento23-payment-gateway
Using version ^1.1 for payu/magento23-payment-gateway
./composer.json has been updated
Running composer update payu/magento23-payment-gateway
Loading composer repositories with package information
Updating dependencies
Lock file operations: 1 install, 0 updates, 0 removals
  - Locking payu/magento23-payment-gateway (1.1.4)
Writing lock file
Installing dependencies from lock file (including require-dev)
Package operations: 1 install, 0 updates, 0 removals
  - Downloading payu/magento23-payment-gateway (1.1.4)
  - Installing payu/magento23-payment-gateway (1.1.4): Extracting archive

Moduł został zainstalowany. Domyślnym katalogiem w którym umieszczane są pliki instalowane przez Composer jest: "magento/vendor/".

Następnie wykonujemy kolejno podstawowe komendy, domyślnie uruchamiane przy instalacji każdego modułu:

user@host:~/magento$ bin/magento module:enable PayU_PaymentGateway
user@host:~/magento$ bin/magento setup:upgrade
user@host:~/magento$ bin/magento setup:di:compile
user@host:~/magento$ bin/magento setup:static-content:deploy pl_PL
user@host:~/magento$ bin/magento cache:flush

Moduł został zainstalowany, możemy przejść do panelu admina i przystąpić do konfiguracji.

W panelu admina magento przechodzimy do:  Stores -> Configuration -> Sales -> Payments Methods

Uzupełniamy niezbędne dane do nawiązania integracji:

• Id punktu płatności - Identyfikator POS-a z systemu PayU
• Drugi klucz MD5 - Drugi klucz MD5 z systemu PayU
• OAuth - client_id - client_id dla protokołu OAuth z systemu PayU
• OAuth - client_secret - client_secret for OAuth z systemu PayU

Oprócz domyślnej płatności szybkim przelewem, dostępna jest również opcja płatności kartami kredytowymi.
Konfiguracja jest bliźniaczo podobna do wspmnianych powyżej opcji szybkich płatności.

Po uzupełnieniu konfiguracji, zapisie danych i odświeżeniu cache magento, na frontend sklepu pojawi się nowa metoda płatności PayU.