PHPackages                             bluepayment-plugin/module-bluepayment - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. bluepayment-plugin/module-bluepayment

ActiveMagento2-module[Payment Processing](/categories/payments)

bluepayment-plugin/module-bluepayment
=====================================

Autopay payment gateway for Magento 2.

2.31.2(2mo ago)265.1k—9.9%7[3 PRs](https://github.com/bluepayment-plugin/magento-2.x-plugin/pulls)1PHP

Since Mar 16Pushed 2mo ago4 watchersCompare

[ Source](https://github.com/bluepayment-plugin/magento-2.x-plugin)[ Packagist](https://packagist.org/packages/bluepayment-plugin/module-bluepayment)[ RSS](/packages/bluepayment-plugin-module-bluepayment/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (53)Used By (1)

Instrukcja dla modułu Magento 2: bramka płatności Autopay
=========================================================

[](#instrukcja-dla-modułu-magento-2-bramka-płatności-autopay)

Podstawowe informacje
---------------------

[](#podstawowe-informacje)

Autopay to moduł płatności umożliwiający realizację transakcji bezgotówkowych w sklepie opartym na platformie Magento 2.

### Główne funkcje

[](#główne-funkcje)

Do najważniejszych funkcji modułu zalicza się:

- obsługę wielu sklepów jednocześnie z użyciem jednego modułu
- obsługę zakupów bez rejestracji w serwisie
- obsługę dwóch trybów działania – testowego i produkcyjnego (dla każdego z nich wymagane są osobne dane kont, po które zwróć się do nas)
- realizacja dwóch sposobów wyświetlenia form płatności w sklepie:
    - na stronie Autopay – widok klasyczny lub spersonalizowany (po uzgodnieniu z Autopay),
    - na stronie sklepu – zintegrowany, klient przenoszony jest od razu do banku lub na stronę płatności kartą.

### Wymagania

[](#wymagania)

- Wersja Magento: 2.3.0 – 2.4.8.
- Wersja PHP: 7.4 – 8.4 (zgodna z wymaganiami danej wersji Magento).

### [Co nowego w Autopay?](CHANGELOG.md)

[](#co-nowego-w-autopay)

Instalacja
----------

[](#instalacja)

### Poprzez composera

[](#poprzez-composera)

1. Wykonaj komendę:

```
composer require bluepayment-plugin/module-bluepayment

```

2. Przejdź do aktywacji modułu

### Poprzez paczkę .zip

[](#poprzez-paczkę-zip)

1. Pobierz najnowszą wersję modułu z tej [strony](https://github.com/bluepayment-plugin/magento-2.x-plugin/archive/refs/heads/master.zip).
2. Wgraj plik .zip do katalogu głównego Magento.
3. Będąc w katalogu głównym Magento, wykonaj komendę:

```
unzip -o -d app/code/BlueMedia/BluePayment bm-bluepayment-*.zip && rm bm-bluepayment-*.zip
```

4. Przejdź do aktywacji modułu.

Aktywacja modułu
----------------

[](#aktywacja-modułu)

### Aktywacja za pomocą linii poleceń

[](#aktywacja-za-pomocą-linii-poleceń)

1. Będąc w katalogu głównym Magento, wykonaj następujące polecenia:

- `bin/magento module:enable BlueMedia_BluePayment --clear-static-content`
- `bin/magento setup:upgrade`
- `bin/magento setup:di:compile`
- `bin/magento cache:flush`
    , a moduł zostanie aktywowany.

### Aktywacja za pośrednictwem panelu administracyjnego (tylko do wersji Magento 2.3)

[](#aktywacja-za-pośrednictwem-panelu-administracyjnego-tylko-do-wersji-magento-23)

1. Zaloguj się do panelu administracyjnego Magento.
2. Wybierz z menu głównego **System** -> **Web Setup Wizard**. System poprosi Cię o ponowne zalogowanie się - zrób to, żeby kontynuować aktywację.
3. Przejdź do **Component Manager**, znajdź na liście moduł **BlueMedia/BluePayment**, kliknij **Select** i następnie **Enable**.

    [![install1.png](docs/install1.png "Screenshot")](docs/install1.png)
4. Kliknij **Start Readiness Check**, żeby zainicjować wykonanie weryfikacji zależności, po czym kliknij **Next**.
5. Jeżeli chcesz, możesz w tym momencie utworzyć kopię zapasową kodu, mediów i bazy danych, klikając **Create Backup**. Następnie kliknij **Next**

    [![install2.png](docs/install2.png "Screenshot")](docs/install2.png)
6. Kliknij **Enable**, żeby wyłączyć swój sklep internetowy na czas aktywacji bramki płatności.
7. Aktywacja może potrwać kilka minut. Gdy zakończy się sukcesem, zobaczysz następujący komunikat: [![install3.png](docs/install3.png "Screenshot")](docs/install3.png)

Konfiguracja
------------

[](#konfiguracja)

1. Zaloguj się do panelu administracyjnego w platformie Magento 2.
2. Wybierz z menu: **Sklepy (Store)** -> **Konfiguracja (Configuration)**
3. W kolejnym menu wybierz: **Sprzedaż (Sales)** -> **Metody płatności (Payments methods)**
4. Następnie rozwiń **Inne metody płatności (Other payment methods)** i wybierz **Płatność online Autopay (Online Payment Autopay)**.

### Podstawowa konfiguracja modułu

[](#podstawowa-konfiguracja-modułu)

1. Przejdź do [Konfiguracji modułu](#konfiguracja).
2. Wypełnij obowiązkowe pola:
    1. Przy statusie **Włączony (Enabled)** kliknij **Tak (Yes)**.
    2. Uzupełnij **Tytuł (Title)** – czyli nazwę płatności widoczną dla klientów Twojego sklepu – może brzmieć np. Bezpieczna płatność online.
    3. Ustaw **Tryb testowy (Test Mode)**
3. Uzupełnij dane dotyczące obsługiwanych walut (otrzymasz je od Autopay)
    1. **ID serwisu (Service partner ID)**
    2. **Klucz konfiguracyjny (hash) (Configuration key (hash))** - otrzymasz go od Autopay, możesz go odczytać także w portalu Autopay [Środowisko testowe](https://testportal.autopay.eu/admin), [Środowisko produkcyjne](https://portal.autopay.eu/admin) w szczegółach serwisu, jako **Klucz konfiguracyjny (hash)**[![configuration3.png](docs/configuration3.png "Screenshot")](docs/configuration3.png)
4. [Odśwież pamięć podręczną.](#od%C5%9Bwie%C5%BCenie-pami%C4%99ci-podr%C4%99cznej)

### Konfiguracja kanałów płatności

[](#konfiguracja-kanałów-płatności)

1. Zaloguj się do panelu administracyjnego w platformie Magento 2
2. Wybierz z menu po lewej stronie **BluePayment** -> **Kanały płatności (Gateways)**

#### Wybór kanału płatności w sklepie

[](#wybór-kanału-płatności-w-sklepie)

1. Przejdź do [Konfiguracji modułu](#konfiguracja)
2. Zaznacz **Tak (whitelabel) (YES (whitelabel)** przy polu **Pokaż kanały płatności w sklepie (Show payment gateways in store)**
3. [Odśwież pamięć podręczną.](#od%C5%9Bwie%C5%BCenie-pami%C4%99ci-podr%C4%99cznej)

#### Odświeżenie listy kanałów płatności

[](#odświeżenie-listy-kanałów-płatności)

1. Przejdź do Listy kanałów płatności
2. Kliknij komendę **Synchronizuj kanały płatności (Synchronize Gateways)**, którą znajdziesz po prawej stronie ekranu.

Moduł umożliwia automatyczne odświeżanie kanału płatności co 5 minut. Żeby korzystać z tej możliwości – skonfiguruj CRON-a, zgodnie z dokumentacją Magento dostępną pod [tym linkiem](https://devdocs.magento.com/guides/v2.4/config-guide/cli/config-cli-subcommands-cron.html).

#### Edycja kanałów płatności

[](#edycja-kanałów-płatności)

1. Przejdź do Listy kanałów płatności.
2. Kliknij w nazwę kanału, który chcesz edytować
3. Możesz wyedytować następujące dane:
    1. **Status kanału (Status)** – czy kanał jest aktualnie dostępny (jeżeli CRON jest poprawnie skonfigurowany - odświeżanie kanałów następuje co 5 minut);
    2. (informacyjnie) **Waluta (Currency)**
    3. (informacyjnie) **ID**
    4. (informacyjnie) **Nazwa banku (Bank Name)**
    5. (informacyjnie) **Nazwa (Name)**
    6. (informacyjnie) **Maksymalna kwota płatności (Maximum payment amount)**
    7. (informacyjnie) **Minimalna kwota płatności (Minimum payment amount)**
    8. **Opis (Description)** – wyświetlany klientowi pod nazwą kanału płatności
    9. **Kolejność (Sort Order)** – kolejność sortowania na liście kanałów, gdzie:

        - 1 – pierwsza pozycja na liście,
        - 2 – druga pozycja na liście,
        - ...
        - 0 – ostatnia pozycja na liście.

        *W przypadku oddzielnych metod płatności, zbiorcza metoda **Autopay** (płatność przelewem) posiada domyślnie kolejność 1. Jeśli chcesz ustawić oddzielną metodę nad metodą Autopay - wykorzystaj ujemne wartości (-5, -4, -3 itd.).*
    10. **Rodzaj (Type)**.
    11. **Traktuj jako oddzielną metodę płatności (Is separated method)** – powoduje wyświetlanie danego kanału jako osobnej metody płatności. *BLIK, Karty płatnicze oraz kanały ratalne są zawsze wyświetlane jako osobne metody płatności.*
    12. **Gateway Logo**
    13. **Użyj własnego logo (Use Own Logo)** dla kanału płatności
    14. **Ścieżka do logo (Logo Path)** – adres do własnego logo (widoczne przy zaznaczeniu opcji **Użyj własnego logo (Use Own Logo)**)
    15. (informacyjnie) **Data ostatniego odświeżenia (Status Date)** – data i czas ostatniej aktualizacji danych dotyczących kanału płatności
    16. **Wymuś wyłączenie (Force Disable)** – umożliwia dezaktywację wybranego kanału płatności (bez względu na **Status kanału (Status)**)

### Rozwijalna lista kanałów

[](#rozwijalna-lista-kanałów)

Opcja dostępna od wersji 2.9.0 - **domyślnie włączona**.

[![configuration1.png](docs/configuration1.png "Screenshot")](docs/configuration1.png)

Jeżeli chcesz zawsze wyświetlać pełną listę kanałów płatności:

1. Przejdź do [Konfiguracji modułu](#konfiguracja)
2. Kliknij **Wyłącz (Disabled)** w polu **Zwijalna lista kanałów (Collapsible gateway list)**
3. [Odśwież pamięć podręczną.](#od%C5%9Bwie%C5%BCenie-pami%C4%99ci-podr%C4%99cznej)

### Odświeżenie pamięci podręcznej

[](#odświeżenie-pamięci-podręcznej)

Odśwież pamięć podręczną po każdej edycji konfiguracji. Żeby to zrobić:

1. Przejdź do **System** -> **Pamięć podręczna (Cache Management)**
2. Zaznacz **Konfiguracja (Configuration)**
3. Wybierz **Odśwież (Refresh)** z rowijanego menu
4. Kliknij **Wyślij (Submit)**

    [![configuration2.png](docs/configuration2.png "Screenshot")](docs/configuration2.png)

BLIK 0
------

[](#blik-0)

BLIK "wewnątrz sklepu" cechuje się tym, że kod zabezpieczający transakcję należy wpisać bezpośrednio na stronie sklepu – w ostatnim etapie procesu zakupowego.

[![blik1.png](docs/blik1.png)](docs/blik1.png)

### Aktywacja BLIK 0

[](#aktywacja-blik-0)

1. Przejdź do [Konfiguracji modułu](#konfiguracja)
2. Kliknij **Włącz (Enable)** przy opcji **BLIK 0**.
3. Przejdź do edycji kanału o ID *509* i nazwie kanału *BLIK*.
4. Ustaw opcję **Traktuj jako oddzielną metodę płatności (Is separated method)**.
5. [Odśwież pamięć podręczną.](#od%C5%9Bwie%C5%BCenie-pami%C4%99ci-podr%C4%99cznej)

Google Pay
----------

[](#google-pay)

Opcja umożliwia dokonanie płatności z użyciem Google Pay bezpośrednio na stronie sklepu – w ostatnim etapie procesu zakupowego.

[![gpay.png](docs/gpay.png)](docs/gpay.png)

### Aktywacja Google Pay

[](#aktywacja-google-pay)

Google Pay jest **domyślnie aktywowana i zawsze wyświetlana** jako osobna metoda płatności.

Płatności automatyczne
----------------------

[](#płatności-automatyczne)

Płatności jednym kliknięciem – **One Click Payment** – to kolejny sposób na wygodne płatności z wykorzystaniem kart płatniczych. Pozwalają na realizowanie szybkich płatności, bez konieczności każdorazowego podawania przez klienta wszystkich danych uwierzytelniających kartę. Proces obsługi płatności polega na jednorazowej autoryzacji płatności kartą i przypisaniu danych karty do konkretnego klienta. Pierwsza transakcja zabezpieczona jest protokołem 3D-Secure, natomiast kolejne realizowane są na podstawie przesłanego przez partnera żądania obciążenia karty.

Płatność automatyczna dostępna jest tylko dla zalogowanych klientów Twojego sklepu.

[![automatic1.png](docs/automatic1.png)](docs/automatic1.png)

### Aktywacja płatności automatycznych

[](#aktywacja-płatności-automatycznych)

1. Przejdź do **konfiguracji modułu**.
2. Wypełnij **Autopay Agreement** odpowiednim regulaminem – do akceptacji przez klienta.
3. Przejdź do edycji kanału o ID *1503* i rodzaju *Płatność automatyczna*.
4. Ustaw opcję **Traktuj jako oddzielną metodę płatności (Is separated method)**.
5. [Odśwież pamięć podręczną.](#od%C5%9Bwie%C5%BCenie-pami%C4%99ci-podr%C4%99cznej)

### Zarządzanie kartami

[](#zarządzanie-kartami)

Karta płatnicza zostanie zapamiętana i powiązana z kontem klienta podczas pierwszej poprawnie wykonanej transakcji z wykorzystaniem płatności automatycznej i zaakceptowaniu regulaminu usługi.

Klient może usunąć zapamiętane karty z poziomu swojego konta w Twoim sklepie internetowym – musi jedynie:

1. Zalogować się
2. Wybrać **Moje konto (My account)** z górnego menu
3. Wybrać **Zapisane karty płatnicze (Saved payment cards)** z menu po lewej stronie. Wówczas wyświetli się lista zapisanych kart: [![automatic2.png](docs/automatic2.png)](docs/automatic2.png)
4. Kliknąć **Usuń** i potwierdzić

Generowanie zamówień z poziomu panelu administracyjnego
-------------------------------------------------------

[](#generowanie-zamówień-z-poziomu-panelu-administracyjnego)

Moduł umożliwia wysłanie linka do płatności do klienta w przypadku zamówień utworzonych bezpośrednio w panelu administracyjnym. W tym celu, należy przy tworzeniu zamówienia wybrać kanał płatności Autopay.

[![admin1.png](docs/admin1.png)](docs/admin1.png)

Link do płatności zostanie przesłany przez Autopay na adres mailowy widoczny w danych klienta.

[![admin2.png](docs/admin2.png)](docs/admin2.png)

Szablony e-mail
---------------

[](#szablony-e-mail)

Dla wiadomości:

- email\_creditmemo\_set\_template\_vars\_before
- email\_invoice\_set\_template\_vars\_before
- email\_order\_set\_template\_vars\_before
- email\_shipment\_set\_template\_vars\_before moduł rozszerza listę dostępnych zmiennych o **payment\_channel**. Przykładowe użycie w szablonie: `{{var payment_channel|raw}}`

Strona oczekiwania na przekierowanie
------------------------------------

[](#strona-oczekiwania-na-przekierowanie)

Moduł umożliwia dodanie strony pośredniej, wyświetlanej przed samym przekierowaniem użytkownika do płatności. Funkcję tę można wykorzystać np. do śledzenia e-commerce w Google Analytics.

Wykorzystywany szablon: `view/frontend/template/redirect.phtml`

### Aktywacja

[](#aktywacja)

Żeby aktywować stronę oczekiwania na przekierowanie:

1. Przejdź do [Konfiguracji modułu](#konfiguracja)
2. Ustaw **Włącz (Enable)** przy opcji **Pokaż stronę przekierowania (Show waiting page before redirect)**
3. Ustaw opcję **Sekund oczekiwania przed przekierowaniem (Seconds to wait before redirect)** – w celu określenia jak długo strona ma być wyświetlana.
4. [Odśwież pamięć podręczną.](#od%C5%9Bwie%C5%BCenie-pami%C4%99ci-podr%C4%99cznej)

Zwroty
------

[](#zwroty)

Moduł umożliwia zwrot pieniędzy bezpośrednio na rachunek klienta, z którego została nadana płatność, poprzez fakturę korygującą (**Credit Memo on-line**) oraz bezpośrednio z zamówienia.

Zwroty wykonywane są asynchronicznie — w pierwszej kolejności składane jest zlecenie zwrotu, a następnie jest on realizowany przez system Autopay. Aktualizacja odbywa się poprzez CRON-a.

### Zwrot poprzez fakturę korygującą

[](#zwrot-poprzez-fakturę-korygującą)

Żeby zlecić zwrot w ten sposób:

1. Przejdź do szczegółów **Faktury (Invoice)** dla zamówienia.
2. Naciśnij **Faktura korygująca (Credit Memo)** w górnym menu.
3. Uzupełnij formularz, podając ilość przedmiotów do zwrotu oraz wysokość opłat.
4. Naciśnij **Zwróć (Refund)**, żeby potwierdzić operację.

Zwrot wygeneruje się automatycznie.

### Zwrot bezpośredni

[](#zwrot-bezpośredni)

Opcja umożliwia zwrot pieniędzy bezpośrednio na rachunek klienta, z którego została nadana płatność. Żeby z niej skorzystać:

1. Przejdź do [Konfiguracji modułu](#konfiguracja) i zaznacz **Włącz (Enable)** przy opcji **Pokaż ręczny zwrot Autopay w szczegółach zamówienia (Show manual Autopay refund in order details)**. Dzięki temu opcja ta będzie dostępna dla wszystkich zakończonych zamówień opłaconych poprzez ten moduł.
2. Następnie przejdź do szczegółów zamówienia.
3. Jeżeli zamówienie zostało opłacone z wykorzystaniem metody płatności Autopay, w górnym menu powinien być widoczny przycisk Zwrot Autopay.

    [![refund1.png](docs/refund1.png)](docs/refund1.png)
4. Po jego naciśnięciu zobaczysz okno umożliwiające dokonanie pełnego lub częściowego zwrotu.

    1. W przypadku zwrotu częściowego wpisz kwotę w formacie "000.00" (kropka jako separator dziesiętny)
5. Potwierdź zlecenie zwrotu klikając **OK**, a pojawi się komunikat z potwierdzeniem wykonania zwrotu lub powodem, dla którego się nie powiódł
6. Informacje dot. zwrotu są widoczne:

    1. w komentarzach do zamówienia

        [![refund2.png](docs/refund2.png)](docs/refund2.png)
    2. na liście transakcji

        [![refund3.png](docs/refund3.png)](docs/refund3.png)

### Powiadomienia

[](#powiadomienia)

W przypadku niepowodzenia zwrotu moduł generuje powiadomienie w panelu administracyjnym.
Treść powiadomienia oraz komentarza do zamówienia zawiera szczegółową przyczynę zwrotu, zwracaną przez Autopay (np. brak środków na saldzie Autopay lub przekroczenie kwoty transakcji).
W tym celu wymagane jest uruchomienie i aktywowanie modułu `Magento_AdminNotification`.

[![refund4.png](docs/refund4.png)](docs/refund4.png)

[![refund5.png](docs/refund5.png)](docs/refund5.png)

Dostawa na wiele adresów (multishipping)
----------------------------------------

[](#dostawa-na-wiele-adresów-multishipping)

Moduł umożliwia opłacenie zamówień złożonych z wykorzystaniem funkcjonalności multishipping. Konfiguracja dostawy zgodnie z [instrukcją w dokumentacji](https://docs.magento.com/user-guide/configuration/sales/multishipping-settings.html)

Sam moduł płatności nie wymaga żadnych dodatkowych czynności. Płatności Autopay będą dostępne od razu.

**UWAGA!**

Moduł w trybie multishipping obsługuje TYLKO wyświetlanie dostępnych kanałów płatności na stronie sklepu oraz płatności automatyczne. Nie ma możliwości uruchomienia płatności Google Pay i BLIK 0. Dla zamówień multishipping, OrderID w wiadomościach do klienta oraz w panelu portal.autopay.eu będzie numerem koszyka z przedrostkiem QUOTE\_, nie numerem zamówienia.

Informacje o płatności
----------------------

[](#informacje-o-płatności)

Informacja o wybranym przez klienta kanale płatności jest widoczna z poziomu listy zamówień (Order grid).
W tym celu dodaj do widoku kolumnę **Kanał płatności (Payment Channel)**.
Informacja tekstowa o kanale płatności będzie widoczna w tabeli.

Informacje o wybranym kanale płatności zapisane są w bazie danych:

- w kolumnach **blue\_gateway\_id** (id kanału) i **payment\_channel** (nazwa kanału) w tabeli **sales\_order**,
- w kolumnie **payment\_channel** (nazwa kanału) w tabeli **sales\_order\_grid**.

Rozszerzona Analityka – Google Analytics 4 e-commerce
-----------------------------------------------------

[](#rozszerzona-analityka--google-analytics-4-e-commerce)

Opcja dostępna od wersji 2.19.0.

**Dzięki temu rozwiązaniu, możesz dokładniej analizować ścieżkę zakupową Twoich klientów.**
Po dokonaniu poniższej konfiguracji, **Google Analytics** zacznie zbierać szczegółowe dane na temat zachowań użytkowników.

Moduł dodaje obsługę dodatkowych zdarzeń w Google Analytics 4:

- **view\_item\_list** – użytkownik zobaczył produkt na liście,
- **view\_item** – użytkownik wyświetlił stronę produktu,
- **add\_to\_cart** – użytkownik dodał produkt do koszyka,
- **remove\_from\_cart** – użytkownik usunął produkt z koszyka,
- **begin\_checkout** – użytkownik rozpoczął proces zamówienia (koszyk i/lub wybór metody dostawy),
- **checkout\_progress** – użytkownik przeszedł do drugiego kroku zamówienia (wybór metody płatności),
- **set\_checkout\_option** – użytkownik uzupełnił dane zamówienia,
- **purchase** – użytkownik złożył zamówienie **oraz opłacił je poprzez płatność Autopay** (oznaczenie jako konwersja).

### Utworzenie nowego klucza API Google Analytics

[](#utworzenie-nowego-klucza-api-google-analytics)

1. Przejdź do [Google Analytics](http://analytics.google.com).
2. Przejdź do **Administracja (Admin)**.
3. Wybierz odpowiednie konto oraz usługę.
4. Kliknij **Strumienie danych (Streams)**.
    [![ga1.png](docs/ga1.png "Screenshot")](docs/ga1.png)
5. Kliknij odpowiedni stream, który jest przypisany do Twojego sklepu. [![ga2.png](docs/ga2.png "Screenshot")](docs/ga2.png)i. Jeśli nie utworzyłeś wcześniej streamu, możesz to zrobić klikając w przycisk **Dodaj strumień (Add stream)** -> **Sieć (Web)** -> Uzupełnij adres URL sklepu, nazwę strumienia i następnie kliknij **Utwórz strumień (Create stream)**.
6. Wybierz **Tajne klucze API platformy Measurement Protocol (Measurement Protocol)** (w tabeli **Ustawienia dodatkowe**). [![ga3.png](docs/ga3.png "Screenshot")](docs/ga3.png)
7. Kliknij **Utwórz (Create)**.

### Konfiguracja Google Analytics

[](#konfiguracja-google-analytics)

1. Wybierz z menu **Sklepy (Stores)** -> **Konfiguracja (Configuration)** -> **Sprzedaż (Sales)** -> **Google API**.
    [![analytics1.png](docs/analytics1.png "Screenshot")](docs/analytics1.png)
2. Zaznacz opcję **Włączony (Enabled)** na **Tak (Yes)**.
3. Wprowadź kod śledzenia w polu **Account Number (GA4)** (w formacie G-XXXXXXXXXX).
4. Wprowadź **API Secret** wygenerowany zgodnie z instrukcją powyżej.
    [![analytics2.png](docs/analytics2.png "Screenshot")](docs/analytics2.png)
5. Kliknij **Zapisz konfigurację (Save Config)**.
6. [Odśwież pamięć podręczną.](#od%C5%9Bwie%C5%BCenie-pami%C4%99ci-podr%C4%99cznej)

Wywoływanie eventów
-------------------

[](#wywoływanie-eventów)

Opcja dostępna od wersji 2.19.0.

Po otrzymaniu nowego statusu płatności - wywoływany jest jeden z eventów:

- `bluemedia_payment_failure` – płatność zakończona niepowodzeniem,
- `bluemedia_payment_pending` – płatność oczekująca,
- `bluemedia_payment_success` – płatność zakończona sukcesem.

Eventy uruchamiane są po zapisaniu nowego statusu zamówienia.
W ramach eventu, przekazywane są dane:

- `order` – instancja `\Magento\Sales\Model\Order`
- `payment` – instancja `\Magento\Sales\Model\OrderPayment`
- `transaction_id` – identyfikator transakcji w systemie Autopay (`string`)

Promowanie płatności odroczonych / na raty
------------------------------------------

[](#promowanie-płatności-odroczonych--na-raty)

### Dlaczego warto promować?

[](#dlaczego-warto-promować)

- Większa sprzedaż
- Mniej porzuconych koszyków
- Więcej klientów

Klienci chętniej zdecydują się na zakup produktów, nawet w wyższej cenie, jeśli będą mogli zapłacić później lub rozłożyć spłatę na raty.

Opcja dostępna tylko w przypadku, gdy dla danego serwisu są dostępne płatności **Alior Raty** lub **Kup na dopasowane raty**.
Opcja jest uruchamiana automatycznie tylko dla nowych instalacji modułu – w przypadku aktualizacji, należy przejść do ręcznej konfiguracji.

### Konfiguracja

[](#konfiguracja-1)

1. Przejdź do [Konfiguracji modułu](#konfiguracja).
2. W zakładce **Promowanie płatności (Promoting payments)** określ, w których miejscach promowane płatności mają być wyświetlane. [![cf1.png](docs/cf1.png "Screenshot")](docs/cf1.png)

### Przykładowa wizualizacja

[](#przykładowa-wizualizacja)

**Na górze strony (At the top of the page)**
[![cf2.png](docs/cf2.png "Screenshot")](docs/cf2.png)

**Pod nawigacją (Under the navigation)**
[![cf3.png](docs/cf3.png "Screenshot")](docs/cf3.png)

**Na liście produktów (On the product list)**
[![cf4.png](docs/cf4.png "Screenshot")](docs/cf4.png)

**Na stronie produktu pod przyciskami (On the product page under the buttons)**
[![cf5.png](docs/cf5.png "Screenshot")](docs/cf5.png)

**W koszyku pod produktami (In the shopping cart under the products)**
[![cf6.png](docs/cf6.png "Screenshot")](docs/cf6.png)

Asynchroniczne przetwarzanie ITN
--------------------------------

[](#asynchroniczne-przetwarzanie-itn)

Opcja dostępna od wersji 2.24.0.

Moduł umożliwia asynchroniczne przetwarzanie powiadomień ITN (Instant Transaction Notification) wysyłanych przez system Autopay po zakończeniu transakcji. Włączenie tej opcji oznacza, że powiadomienia ITN będą przetwarzane w tle, co może być przydatne w scenariuszach z większym obciążeniem lub specyficznymi wymaganiami dotyczącymi obsługi powiadomień. Rozwiązuje również problem z "wyścigami statusów". Moduł Autopay domyślnie wykorzystuje kolejkowanie z wykorzystaniem MySQL (connection "db"). W przypadku chęci wykorzystania RabbitMQ — wymagane jest dostosowanie konfiguracji kolejki [zgodnie z instrukcją](https://developer.adobe.com/commerce/php/development/components/message-queues/#change-message-queue-from-mysql-to-amqp).

> W celu skorzystania z tej funkcjonalności, Magento musi posiadać aktywne moduły **Magento\_MessageQueue** oraz **Magento\_MysqlMq** lub **Magento\_Amqp**.
> Musi być również poprawnie skonfigurowany CRON [zgodnie z dokumentacją Magento](https://experienceleague.adobe.com/en/docs/commerce-operations/configuration-guide/cli/configure-cron-jobs).

**UWAGA!**Przy wykorzystaniu standardowej konfiguracji z użyciem CRONa - aktualizacja statusu może zająć do minuty, zgodnie z częstotliwością uruchamiania CRONa. W przypadku potrzeby częstszej aktualizacji, wymagane jest oddzielne uruchomienie konsumera (consumer) kolejki:

```
bin/magento queue:consumers:start autopay.itn.process
```

### Aktywacja

[](#aktywacja-1)

Żeby aktywować stronę oczekiwania na przekierowanie:

1. Przejdź do [Konfiguracji modułu](#konfiguracja)
2. Ustaw **Włącz (Enable)** przy opcji **Asynchroniczne przetwarzanie ITN (Asynchronous process ITN)**
3. [Odśwież pamięć podręczną.](#od%C5%9Bwie%C5%BCenie-pami%C4%99ci-podr%C4%99cznej)

Obsługa GraphQL oraz integracja z Magento PWA
---------------------------------------------

[](#obsługa-graphql-oraz-integracja-z-magento-pwa)

Moduł posiada dedykowane rozszerzenie GraphQL umożliwiające integrację z aplikacjami headless (PWA Studio, Vue Storefront, custom frontends).

### Instalacja modułu GraphQL

[](#instalacja-modułu-graphql)

```
composer require bluepayment-plugin/module-bluepayment-graphql
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
```

### Tabela kompatybilności

[](#tabela-kompatybilności)

BlueMedia\_BluePaymentBlueMedia\_BluePaymentGraphQlMagentoPHP2.31.01.3.02.4.6 - 2.4.88.1 - 8.32.21.21.2.62.4.2 - 2.4.57.4 - 8.1Szczegóły znajdziesz w rozdziale poświęconym [GraphQL](https://developers.autopay.pl/online/wtyczki/magento-2/pwa-studio) oraz [Magento PWA](https://developers.autopay.pl/online/wtyczki/magento-2/graphql).

Aktualizacja
------------

[](#aktualizacja)

### Przez composera

[](#przez-composera)

1. Wykonaj komendę

```
composer update bluepayment-plugin/module-bluepayment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
```

### Przez paczkę .zip

[](#przez-paczkę-zip)

1. Pobierz najnowszą wersję wtyczki z tej [strony](https://github.com/bluepayment-plugin/magento-2.x-plugin/archive/refs/heads/master.zip).
2. Wgraj plik .zip do katalogu głównego Magento
3. Będąc w katalogu głównym Magento, wykonaj następujące komendy:

```
unzip -o -d app/code/BlueMedia/BluePayment bm-bluepayment-*.zip && rm bm-bluepayment-*.zip
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
```

4. Moduł jest już aktywny.

Dezaktywacja modułu
-------------------

[](#dezaktywacja-modułu)

### Dezaktywacja za pomocą linii poleceń

[](#dezaktywacja-za-pomocą-linii-poleceń)

1. Będąc w katalogu głównym Magento, wykonaj następujące polecenia:

```
bin/magento module:disable BlueMedia_BluePayment --clear-static-content
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
```

### Dezaktywacja za pośrednictwem panelu administracyjnego (tylko do wersji Magneto 2.3)

[](#dezaktywacja-za-pośrednictwem-panelu-administracyjnego-tylko-do-wersji-magneto-23)

1. Będąc zalogowanym do panelu administracyjnego, wybierz z menu głównego **System** -> **Web Setup Wizard**. System poprosi Cię o ponowne zalogowanie się.
2. Przejdź do **Menadżera komponentów (Component Manager)** i znajdź na liście moduł **BlueMedia/BluePayment** i kliknij **Select**, a póżniej **Disable**.

    [![dezactivation1.png](docs/dezactivation1.png)](docs/dezactivation1.png)
3. Kliknij **Start Readiness Check**, żeby zainicjować wykonanie weryfikacji zależności, po czym kliknij **Next**.
4. Jeżeli chcesz, możesz w tym momencie utworzyć kopię zapasową kodu, mediów i bazy danych, klikając **Create Backup**.

    [![dezactivation2.png](docs/dezactivation2.png)](docs/dezactivation2.png)
5. Po wykonaniu backupu (lub odznaczeniu tej opcji) – kliknij **Next**, żeby przejść dalej.
6. Kliknij **Disable**, żeby wyłączyć sklep na czas dezaktywacji modułu.
7. Dezaktywacja może potrwać kilka minut. Gdy zakończy się sukcesem, zobaczysz następujący komunikat: [![dezactivation3.png](docs/dezactivation3.png)](docs/dezactivation3.png)

### Czyszczenie plików oraz bazy danych (opcjonalnie)

[](#czyszczenie-plików-oraz-bazy-danych-opcjonalnie)

1. Będąc w katalogu głównym Magento – usuń katalog: `app/code/BlueMedia`
2. Wykonaj następujące zapytania do bazy danych:

```
DROP TABLE blue_card;
DROP TABLE blue_gateway;
DROP TABLE blue_refund;
DROP TABLE blue_transaction;
```

3. Żeby usunąć całą konfigurację modułu - wykonaj następujące zapytanie do bazy danych:

```
DELETE FROM core_config_data WHERE path LIKE 'payment/bluepayment%';
```

### Autopay Checkout dla Magento 2

[](#autopay-checkout-dla-magento-2)

W celu wdrożenia Autopay Checkout odsyłamy do dokumentacji na [Githubie](https://github.com/bluepayment-plugin/magento-2.x-plugin/blob/autopay/AUTOPAY.md).

###  Health Score

54

—

FairBetter than 97% of packages

Maintenance83

Actively maintained with recent releases

Popularity35

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 96.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~39 days

Recently: every ~80 days

Total

47

Last Release

85d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/037a35712d3a6f9a62c93276d02e1bbb89ea69c4dc6c08c46f75635d8adf71a2?d=identicon)[zalazdi](/maintainers/zalazdi)

![](https://www.gravatar.com/avatar/0a6583806fd8fbfbbebdfe826ec140dab433fbc68e103262ba076853dc8fe5c5?d=identicon)[bluemedia](/maintainers/bluemedia)

---

Top Contributors

[![zalazdi](https://avatars.githubusercontent.com/u/603454?v=4)](https://github.com/zalazdi "zalazdi (462 commits)")[![jagozajac](https://avatars.githubusercontent.com/u/87177993?v=4)](https://github.com/jagozajac "jagozajac (12 commits)")[![autopay-rs](https://avatars.githubusercontent.com/u/137280760?v=4)](https://github.com/autopay-rs "autopay-rs (3 commits)")[![piotrmatras](https://avatars.githubusercontent.com/u/11822697?v=4)](https://github.com/piotrmatras "piotrmatras (2 commits)")[![brdx21](https://avatars.githubusercontent.com/u/78686067?v=4)](https://github.com/brdx21 "brdx21 (1 commits)")

### Embed Badge

![Health badge](/badges/bluepayment-plugin-module-bluepayment/health.svg)

```
[![Health](https://phpackages.com/badges/bluepayment-plugin-module-bluepayment/health.svg)](https://phpackages.com/packages/bluepayment-plugin-module-bluepayment)
```

###  Alternatives

[mollie/magento2

Mollie Payment Module for Magento 2

1121.6M10](/packages/mollie-magento2)[dotdigital/dotdigital-magento2-extension

Dotdigital for Magento 2

50374.2k18](/packages/dotdigital-dotdigital-magento2-extension)[amzn/amazon-pay-magento-2-module

Official Magento2 Plugin to integrate with Amazon Pay

109501.7k1](/packages/amzn-amazon-pay-magento-2-module)[paynl/magento2-plugin

Pay. Payment methods for Magento 2

30311.2k5](/packages/paynl-magento2-plugin)[pagbank/payment-magento

PagBank - Payment for Magento and Adobe

2128.3k7](/packages/pagbank-payment-magento)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)