# Instrukcja modułu Autopay dla platformy WooCommerce

## Podstawowe informacje

Autopay to moduł płatności umożliwiający realizację transakcji bezgotówkowych w sklepie opartym na platformie WordPress (WooCommerce). Jeżeli jeszcze nie masz wtyczki, możesz ją pobrać [tutaj.](https://github.com/bluepayment-plugin/autopay-payments/releases)

Należy zawsze pobierać najnowsze wydanie oznaczone etykietą "latest" (plik z ikonką paczki, zobacz poniższy screen).

![Instrukcja pobierania archiwum z wtyczką](/assets/img/screenshot_3.png)
<em>Instrukcja pobierania archiwum z wtyczką<em>


### Główne funkcje

Do najważniejszych funkcji modułu zalicza się:
- realizację płatności online poprzez odpowiednie zbudowanie startu transakcji
- obsługę powiadomień o statusie transakcji (notyfikacje XML)
- 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)
- obsługę popularnych metod płatności, które pozwalają Twoim klientom płacić za zakupy w wygodny sposób
- możliwość korzystania z BLIKA
- wybór banku po stronie sklepu i bezpośrednie przekierowanie do płatności w wybranym banku

### Wymagania

- WordPress – przetestowane na wersjach od 6.0 do 6.3.2
- Wtyczka WooCommerce – przetestowano na wersjach od 7.0 do 8.2.1
- PHP minimum 7.3

## Instalacja modułu
1. Pobierz wtyczkę.
2. Zaloguj się do swojego panelu administracyjnego w serwisie WordPress – używając loginu i hasła.
3. W menu po lewej stronie wybierz Wtyczki ➝ Dodaj nową.
4. Zainstaluj wtyczkę wybierając jedną z poniższych metod.

### Instalacja wtyczki

1. Kliknij Wyślij wtyczkę na serwer.
2. Wybierz plik z wtyczką z rozszerzeniem .zip
3. Kliknij Zainstaluj teraz, żeby wgrać wtyczkę do systemu.

## Konfiguracja

1. Przejdź do zakładki WooCommerce ➝ Ustawienia ➝ Płatności.
2. Wybierz Autopay, żeby przejść do konfiguracji.

### Konfiguracja podstawowych pól wtyczki

1.	Przy nazwie Autopay ustaw Włącz, dzięki temu Twoi klienci będą mogli już korzystać z płatności internetowych.
2.	Zaznacz pole: “Pokazuj metody płatności w sklepie”
3. 	W polu “tryb działania” Zaznacz “włącz tryb testowy” aby włączyć tryb sandbox.
4. 	W polu “Testowy identyfikator serwisu” wpisz Twój testowy identyfikator serwisu.
5. 	W polu “Testowy Klucz konfiguracyjny (hash)” wpisz Twój testowy Klucz konfiguracyjny (hash).
6. 	W polu “Identyfikator serwisu” wpisz identyfikator serwisu.
7. 	W polu “Klucz konfiguracyjny (hash)” wpisz Klucz konfiguracyjny (hash).

Powyższe pola uzupełnisz danymi, które otrzymasz od Autopay S.A. Jeśli jeszcze ich nie masz - skontaktuj się z nami.
W momencie, gdy skończysz już sprawdzać, czy wszystko działa prawidłowo – wyłącz tryb testowy, wówczas płatności na Twojej stronie będą w 100% aktywne.
Po uzupełnieniu wszystkich pól – wybierz: Zapisz zmiany i gotowe.

![Widok pól do uzupełnienia](/assets/img/screenshot_12.jpg)
<em>Widok pól do uzupełnienia<em>


![Dostępne metody płatności](/assets/img/screenshot_5.jpg)

<em>Dostępne metody płatności</em>

### Konfiguracja adresów URL

Upewnij się, że w panelach administracyjnych Autopay https://oplacasie.bm.pl oraz https://oplacasie-accept.bm.pl poniższe pola zawierają poprawne adresy sklepu.

●	Konfiguracja adresu powrotu do płatności
{URL Twojego sklepu}/?bm_gateway_return

Przykład: https://mój-sklep.com/?bm_gateway_return

●	Konfiguracja adresu, na który jest wysyłany ITN
{URL Twojego sklepu}/?wc-api=wc_gateway_bluemedia

Przykład: https://mój-sklep.com/?wc-api=wc_gateway_bluemedia

### Rozszerzona Analityka Google Analytics 4

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

### Konfiguracja Google Analytics

Wpisz Klucz śledzący Google Analytics oraz pozostałe dane GA4 we wskazane pola i zapisz zmiany.

![Konfiguracja Google Analytics](/assets/img/screenshot_6.jpg)

### Statusy płatności

Nowa funkcja wyboru i dopasowania statusów płatności pozwala na automatyczną zmianę statusu zamówienia Woocoemmerce w momencie zmiany statusu płatności.

![Konfiguracja statusów](/assets/img/screenshot_4.jpg)