Moduł płatności Blue Media dla CS-Cart

Podstawowe informacje

Wymagania systemowe

Do prawidłowego działania dodatku potrzebna jest odpowiednia konfiguracja modułów PHP na serwerze, na którym jest zainstalowany CS-Cart. Dodatek wymaga aktywacji następujących rozszerzeń:

• xmlWriter
• xmlReader
• iconv
• mbstring
• hash

Ponadto na serwerze powinien być zainstalowany PHP w wersji co najmniej 5.5. W przypadku, gdy któryś z powyższych warunków nie jest spełniony, instalator poinformuje o tym podczas instalacji oraz nie pozwoli na zainstalowanie dodatku.

Instalacja dodatku

W celu zainstalowania dodatku należy pobrać paczkę instalacyjną dodatku. Następnie w panelu administracyjnym przechodzimy do sekcji „Dodatki/Zarządzanie dodatkami” (górne menu) i klikamy w przycisk oznaczony znakiem [+].

Zostanie wyświetlone nowe okno popup, w którym należy kliknąć w przycisk „Dysk lokalny” i wybrać pobraną wcześniej paczkę instalacyjną dodatku. Po wybraniu paczki klikamy w przycisk „Załaduj i zainstaluj”.

Po zainstalowaniu dodatku odnajdujemy go na liście dostępnych modułów i, wybierając z sekcji narzędzi opcję Ustawienia, konfigurujemy dodatek oraz go aktywujemy.

Konfiguracja dodatku

Ustawienia ogólne dodatku

Wybór kanału płatności podczas składania zamówienia (WhiteLabel): gdy wybierzemy „Tak”, Klient będzie miał możliwość wybrania kanału płatności podczas składania zamówienia, w przeciwnym razie taka funkcjonalność będzie dostępna dopiero po złożeniu zamówienia, gdy Klient zostanie automatycznie przeniesiony na stronę serwisu Blue Media.

Grupuj po typie bramki: przy ustawieniu tej opcji na „Tak” (w przypadku, gdy postanowimy, iż wybór kanału płatności będzie odbywał się podczas składania zamówienia) lista instrumentów płatniczych dostępnych w systemie płatności Blue Media będzie pogrupowana po typie bramki. Przy odznaczonym grupowaniu kanały płatności będą prezentowane bez uporządkowania według typu.

Kolejną zakładką w konfiguracji dodatku jest zakładka „Zamówienia cykliczne”, zwane też „abonamentowymi”. Dotyczy ona ustawień sklepu odnoszących się do zamówień, za których płatność może być pobierana „automatycznie” co jakiś czas.

Pierwsza z opcji umożliwia globalne włączenie bądź wyłączenie funkcjonalności zamówień abonamentowych. Druga opcja („Wyłącz dla zamówień ze zniżkami (promocjami)”) uniemożliwia stworzenie zamówienia cyklicznego na podstawie złożonego już zamówienia, w którym – ze względu np. na reguły zastosowanych promocji – ceny produktów nie są cenami standardowymi.

Istnieje jeszcze jedna metoda zablokowania możliwości utworzenia zamówienia cyklicznego. Jeśli nie chcemy, aby jakiś produkt kupiony przez Klienta mógł być objęty zamówieniem abonamentowym, możemy wykluczyć go z tej możliwości edytując dany produkt. Wystarczy na stronie edycji produktu w zakładce „Dodatki” ustawić w sekcji „Blue Media” wartość pola „Wyklucz produkt z zakupów cyklicznych” na „Tak”. Jeśli ów produkt znajdzie się w dowolnym zamówieniu, nie będzie dostępna opcja stworzenia zamówienia cyklicznego.

Więcej informacji o zamówieniach cyklicznych znajduje się w rozdziale "Działanie dodatku" -> "Zamówienia cykliczne".

Ustawienia metody płatności

Po instalacji dodatku zostaną automatycznie utworzone i wstępnie skonfigurowane trzy nowe metody płatności: „System płatności BlueMedia”, „Apple Pay” oraz „Płatność BLIK”. Aby stały się one dostępne w sklepie, konieczne jest dokończenie ich konfiguracji.

W panelu administracyjnym przechodzimy do sekcji Metody płatności (menu: Administracja / Metody płatności), a następnie klikamy w nazwę metody płatności.

Wyświetli się nowa strona z konfiguracją płatności. Przechodzimy w niej do zakładki „Konfiguruj”, gdzie możemy dokonać szczegółowych ustawień bramki płatności.

Podstawowa konfiguracja, jaką należy wykonać, to wprowadzenie danych dotyczących ustawień konta Blue Media. Zgodnie z danymi jakie otrzymaliśmy wprowadzamy: „ID usługi”, „Klucz”, „Separator” oraz „Algorytm”, jakim jest kodowany hash (domyślnie SHA 256). Dodatkowe opcje, jakie możemy ustawić, to:

• „Tryb pracy”: określa, czy konfigurujemy testowy serwis płatności (a więc możemy dowolnie testować funkcjonalności dodatku), czy serwis produkcyjny.
• W polu „Prefix opisu zamówienia” istnieje możliwość ustawienia tekstu, który będzie wyświetlany przed numerem zamówienia w danych, jakie są wysyłane do serwisu Blue Media.
• „ID bramki” - identyfikator domyślnego kanału płatności (wartość opcjonalna). W metodzie płatności „Apple Pay” wartość tego parametru jest już wstępnie zdefiniowana.

Bardzo ważnym etapem konfiguracji jest przeprowadzenie odpowiedniego mapowania statusów zamówień dostępnych w sklepie CS-Cart na statusy serwisu płatności. Można to wykonać w sekcji „Mapowanie statusów BlueMedia => CS-Cart”. Przykładową konfigurację możemy zobaczyć na poniższym obrazku.