BluePayment to moduł płatności umożliwiający realizację transakcji bezgotówkowych w sklepie opartym na platformie Shopware. Jeżeli jeszcze nie masz wtyczki, możesz ją pobrać tutaj.
Wymagania
Instalacja modułu
- Pobierz i zainstaluj najnowszą wersję wtyczki. Żeby to zrobić – rozpakuj kod wtyczki do katalogu /custom/plugins

-
Z linii komend (będąc w katalogu głównym projektu) odśwież listę pluginów:
bin/console plugin:refresh
-
Sprawdź czy plugin pojawił się poprawnie na liście:
bin/console plugin:list

Aktywacja
Aktywuj wtyczkę wpisując polecenie:
bin/console plugin:install --activate --clearCache BluePayment
Konfiguracja
Konfiguracja podstawowych pól wtyczki
- Zaloguj się do panelu administracyjnego i wybierz z bocznego menu Blue Media Settings

- Uzupełnij wszystkie pola w formularzu

- Service ID – ma wartość liczbową i jest unikalny dla każdego sklepu (otrzymasz go od Blue Media).
- Shared Key (klucz współdzielony) – unikalny klucz przypisany do danego sklepu (otrzymasz go od Blue Media).
- Transaction Life Hours – możesz podać dowolną cyfrę od 0 wzwyż.
- Test Most Enabled (tryb testowy) – wybierając YES aktywujesz tryb testowy płatności; po zakończonych testach – wybierz NO, żeby aktywować tryb produkcyjny i móc przyjmować płatności.
- Dodatkowo możesz wybrać również automatyczny status zamówienia dla płatności oczekującej oraz zakończonej.

- Adres powrotu do płatności: blue-payment/finalize-transaction
- Adresu, na który jest wysyłany ITN: adres_sklep/blue-payment/status
- Dodaj Blue Media do listy dostępnych form płatności dla danego kanału sprzedaży (tutaj: Storefront)

💡 Ważne, żeby kod waluty w sklepie (np. PLN) był taki sam jak kod waluty na koncie Blue Media.
- Po zapisaniu zmian płatności będą już dostępne w Twoim sklepie.

Dodanie bramek na checkoucie
- Wejdź do zakładki Blue Media Gateway list i kliknij Reload gateways

- Wybrane bramki powinny być już dostępne w procesie zamawiania.

Konfiguracja bramek
- Pola stałe – pobierane z serwisu Blue Media – nie możesz ich edytować z poziomu panelu Shopware:
- Gateway status – informuje o tym, czy bramka płatności jest aktywna
- Currency – informuje o walutach obsługiwanych przez bramkę
- Gateway ID – numer identyfikacyjny bramki
- Bank name – nazwa banku
- Gateway type – typ bramki
- Gateway logo URL – domyślne logo dla bramki
- Pola możliwe do edycji:
- Gateway name – nazwa bramki wyświetlana w procesie zamawiania
- Gateway description – opis bramki wyświetlany w procesie zamawiania
- Use own logo – zaznacz tę opcję, jeżeli chcesz wgrać własne logo, które zastąpi domyślne logo bramki
- Force gateway disable –zaznacz tę opcję, jeżeli chcesz wyłączyć wyświetlanie bramki w procesie zamawiania
- Is separated method – zaznacz tę opcję, jeżeli chcesz dodać nową opcję płatności obsługującej tylko tę bramkę
Wydzielenie bramki jako osobnej metody płatności
- Zaznacz opcję Is separated method podczas edycji bramki i zapisz zmiany klikając Save. Wówczas automatycznie utworzy się nowa opcja płatności o takiej samej nazwie jak aktualnie edytowana bramka.
Żeby przejść do opcji płatności wybierz Settings Payment z rozwijanego menu Blue Media i kliknij Payment list.

- Analogicznie do instalacji wtyczki – dodaj płatność do dostępnych form płatności dla danego kanału sprzedaży (tutaj: Storefront).

- Bramka powinna być już dostępna jako osobna metoda płatności w procesie zamawiania.

Informacje dodatkowe
-
Podczas edycji bramki, która jest osobną metodą płatności, nazwa i własne logo są aktualizowane w przypisanej metodzie płatności.
-
W przypadku wyłączenia bramki, która jest osobną metodą płatności, przypisana metoda jest usuwana jeżeli nie była użyta w żadnym zamówieniu. W przeciwnym wypadku jest wyłączana i staje się niewidoczna na procesie zamawiania.
-
Bramki dostępne w metodach płatności, można dowolnie konfigurować tak jak pozostałe płatności. Włączając w to opcje: ustawiania kolejności, domyślnej formy płatności oraz Availability rule, która pozwala na własne ustawienia warunków pokazywania danej metody. Przykładowo dla zamówień o wartości powyżej 100 PLN lub wybranych krajów.
-
Do prawidłowego działania wtyczka potrzebuje poprawnej konfiguracji dla Scheduled Tasks:
https://docs.shopware.com/en/shopware-platform-dev-en/references-internals/core/module/tasks
Aktualizacja
Zaktualizuj wtyczkę wpisując polecenie:
bin/console plugin:update --clearCache BluePayment
