Instrukcja instalacji oraz obsługi wtyczki „BluePayment” dla platformy Sylius

Podstawowe informacje

BluePayment to moduł płatności umożliwiający realizację transakcji bezgotówkowych w sklepie opartym na platformie Sylius. Jeżeli jeszcze nie masz wtyczki, możesz ją pobrać tutaj.

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)
  • przekierowanie na paywall/bramkę Blue media, gdzie są dostępne wszystkie formy płatności

Wymagania

  • PHP w wersji 7.3 lub nowszej
  • Sylius w wersji 1.7.4 lub nowszej

Opis zmian

Wersja 1.0.0

  • Pierwsza wersja dokumentu

Instalacja

  1. Pobierz wtyczkę tutaj.
  2. Wykonaj polecenie:
    composer require bluepayment-plugin/sylius-plugin
    
  3. Zweryfikuj, czy w pliku bundles.php znajduje się wpis:
    Bluemedia\SyliusBluepaymentPlugin\BluemediaSyliusBluepaymentPlugin::class => ['all' => true],
    
  4. W config/routes.yaml dodaj wpis:
    bluemedia_sylius_bluepayment_payment:
     resource: "@BluemediaSyliusBluepaymentPlugin/Resources/config/payment_routing.yml"
     prefix: /bluepayment
    
  5. Wykonaj polecenia:
    mkdir -p templates/bundles/SyliusAdminBundle/
    

cp -R vendor/bluepayment-plugin/sylius-plugin/src/Resources/views/* templates/bundles/

6. Przejdź do zakładki Metody płatności
7. Dodaj nową metodę płatności klikając Utwórz i wybierz metodę Blue Media płatności online
8. Przejdź do konfiguracji modułu

## Konfiguracja
### Konfiguracja podstawowych pól wtyczki

1. Kod – nazwa własna wtyczki, np. Płatności Blue Media
2. Aktywna? – wybierz TAK lub NIE, żeby określić czy kanał płatności ma być widoczny przy składaniu zamówienia
3. Kanały – wybierz kanały, dla których powinna się pojawić płatność za pomocą bramki Blue Media
4. Użyj środowiska testowego – wybierając opcję TAK, sprawisz, że wszystkie płatności będą przekierowywane na testową bramkę płatniczą, która znajduje się pod adresem https://oplacasie-accept.bm.pl. Jeżeli tego nie zrobisz, automatycznie zostanie ustawiona produkcyjna wersja bramki płatniczej, a wszystkie płatności zostaną przekierowane na adres https://oplacasie.bm.pl.

    Jeżeli wybierzesz środowisko testowe, moduł nie będzie przetwarzał żadnych faktycznych płatności.

5. Identyfikator serwisu partnera – ma wartość liczbową i jest unikalny dla każdego sklepu (otrzymasz go od Blue Media).
6. Klucz współdzielony – unikalny klucz przypisany do danego sklepu (otrzymasz go od Blue Media).
7. Żeby wyświetlić waluty – zdefiniuj je w zakładce Konfiguracja ➝ Waluty 
8. Dla wybranych języków dodaj nazwę oraz opis płatności – zostaną one wyświetlone przy składaniu zamówienia.

### Konfiguracja adresów URL

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

-	adres powrotu do płatności
	https://domena-sklepu.pl/bluepayment/payment/back
-	adres, na który jest wysyłany ITN
	https://domena-sklepu.pl/bluepayment/process-itn