Integracja Magento 2 z płatnościami Przelewy24
Moduł Przelewy24 dodaje do Magento 2 opcję szybkich płatności internetowych. Wtyczka jest dostępna w trzech wersjach:
- Magento GraphQL/PWA/VUE,
- Magento 2.4.0 - 2.4.3,
- Magento 2.4.4 REST API
Wszystkie te wersję są dostępne do pobrania, pod tym linkiem.
Podstawowe funkcje tego modułu płatności to:
- Szybkie płatności: Moduł Przelewy24 umożliwia szybkie i bezpieczne dokonywanie płatności online. Klienci mogą wybierać spośród wielu metod płatności, takich jak przelewy bankowe, karty kredytowe, BLIK, Google Pay, Apple Pay i wiele innych
- Automatyczne potwierdzenie transakcji: Moduł Przelewy24 automatycznie potwierdza transakcje, co pozwala na szybsze przetwarzanie zamówień
- Możliwość anulowania transakcji: Moduł Przelewy24 umożliwia anulowanie transakcji, co jest przydatne w przypadku błędów lub problemów z płatnościami
- Aktualizacja statusu płatności: Moduł Przelewy24 automatycznie aktualizuje status płatności w zamówieniach, co pozwala na łatwe śledzenie płatności
Wprowadzenie
Przelewy24 to firma płatnicza, która oferuje rozwiązania dla e-commerce. Firma ta jest obecna na rynku płatności od 19 lat i zatrudnia ponad 250 ekspertów i specjalistów. System ten umożliwia szybkie i bezpieczne dokonywanie płatności online, a klienci mogą wybierać spośród wielu metod płatności, takich jak przelewy bankowe, karty kredytowe, BLIK, Google Pay, Apple Pay i wiele innych.
Przedsiębiorstwo przygotowało kilka wersji swojego modułu płatności dla systemu Magento 2. Oprócz standardowej wersji dostępne są też zaawansowane rozowiązania wykorzystujące protokół REST API. Firma wspiera również innowacyjne projekty rozbudowujące system Magento o obszerne interfejsy frontend budowane w techonologii PWA czy VUE - proponując przystosowaną i zintegrowaną z tymi rozwiązaniami wtyczkę.
Opis instalacji
Producent modułu udostępnia swoją wtyczkę tylko na stronie internetowej w postaci archiwów zip lub linku do marketpleace'a Adobe. W tym poradniku skorzystamy z uproszczonego sposobu pobrania i instalacji paczki, bez konieczności logowania się do systemu Adobe lub transferu paczki modułu protokołem SFTP. Użyjemy do tej operacji Composera. 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 w wersji v2. Możemy przejść do instalacji modułu płatności Przelewy24. W naszym przykładzie zainstalujemy moduł pod Magento 2.4.x.
Na początek sprawdzimy jakie wersje paczki są dostępne:
user@host:~/magento$ composer show przelewy24/magento2-przelewy24 --all
name : przelewy24/magento2-przelewy24
descrip. : Przelewy24 payment module for Magento 2
keywords : payment, magento, przelewy24, paypro
versions : 1.1.9, 1.1.8, 1.1.7, 1.1.5, 1.1.4, 1.1.3, 1.1.2, 1.1.1, 1.1.0, 1.0.4, 1.0.3, 1.0.2, 1.0.1, 1.0.0
type : magento2-module
license : GNU Lesser General Public License v3.0 only (LGPL-3.0-only) (OSI approved) https://spdx.org/licenses/LGPL-3.0-only.html#licenseText
homepage :
source : []
dist : [zip] https://repo.magento.com/archives/przelewy24/magento2-przelewy24/przelewy24-magento2-przelewy24-1.1.9.0.zip
names : przelewy24/magento2-przelewy24
W tej instrukcji będziemy wybredni i zdecydujemy się na wersję 1.1.7 modułu Przelewy24. Oto komenda której należy użyć, by pozyskać tą konkretną wersję:
user@host:~/magento$ composer require przelewy24/magento2-przelewy24:1.1.7
./composer.json has been updated
Running composer update przelewy24/magento2-przelewy24
Loading composer repositories with package information
In Laminas\DependencyPlugin\DependencyRewriterV2::onPrePoolCreate
Updating dependencies
Lock file operations: 1 install, 0 updates, 0 removals
- Locking przelewy24/magento2-przelewy24 (1.1.7)
Writing lock file
Installing dependencies from lock file (including require-dev)
Package operations: 1 install, 0 updates, 0 removals
- Downloading przelewy24/magento2-przelewy24 (1.1.7)
- Installing przelewy24/magento2-przelewy24 (1.1.7): Extracting archive
Moduł został zainstalowany. Jak już wiemy Composer umieszcza pliki w katalogu: "magento/vendor/".
Aby dowiedzieć się jaką nazwę nosi nowo zainstlowany moduł, możemy sprawdzić listę dostępnych wtyczek komendą:
user@host:~/magento$ bin/magento module:status
...
List of disabled modules:
PayPro_Przelewy24
Następnie wykonujemy kolejno podstawowe komendy, jakich zawsze używamy po instalacji nowego modułu:
user@host:~/magento$ bin/magento module:enable PayPro_Przelewy24
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
Odnajdujemy logo Przelewy24 i klikamy przycisk Configure.
Uzupełniamy niezbędne dane konfiguracji API:
- Merchant ID - ID sprzedawcy z systemu Przelewy24
- Pos ID - ID sklepu z systemu Przelewy24
- CRC key - Klucz CRC z zakładki Moje Dane -> sekcja dane API i konfiguracja w panelu Przelewy24
- API key - Klucz API z zakładki Moje Dane -> sekcja dane API i konfiguracja w panelu Przelewy24
Klucze CRC i API są unikalne zarówno dla konta produkcyjnego jak i sandbox. Generowane są automatycznie podczas tworzenia konta w serwisie Przelewy24.
Moduł umożliwia zdefiniowanie kilku metod płatności. Oprócz domyślnego trybu tzw. bramki płatności, dostępna są dedykowane opcje jak chociażby: BLIK, GooglePay, ApplePay lub płatności kartami kredytowymi.
Niektóre z dostępnych metod wymagają dodatkowej walidacji certyfikatami i kluczami SSL.
Po uzupełnieniu konfiguracji, zapisie danych i odświeżeniu cache magento, na frontend sklepu pojawi się nowa metoda płatności Przelewy24, wraz z określonymi sposobami płatności.
