Moduł karty upominkowej
W tym artykule opisano moduły kart upominkowych i sposób ich dodawania do stron witryny w Microsoft Dynamics 365 Commerce.
Moduły kart upominkowych można używać w module realizacji transakcji w celu przyjmowania kart upominkowych, bardzo popularnej metody płatności w transakcjach handlu elektronicznego. Moduł kart upominkowych wspiera Dynamics 365, SVS i karty upominkowe Givex. Karty upominkowe SVS i Givex są realizowane przez dostawcę płatności Adyen. Aby uzyskać więcej informacji na temat obsługi zewnętrznych kart upominkowych, takich jak SVS i Givex, zajrzyj do Obsługa zewnętrznych kart upominkowych.
Banknot
Obsługa realizowania kart upominkowych SVS i Givex w procesie realizacji transakcji jest dostępna w wydaniu Dynamics 365 Commerce 10.0.11.
Dostępne są dwa moduły karty upominkowej:
- Karta upominkowa — ten moduł może być używany na stronie realizacji transakcji, aby zrealizować kartę upominkową jako ofertę płatności.
- Sprawdzanie salda karty upominkowej — ten moduł może być używany na dowolnej stronie w celu sprawdzenia salda na karcie upominkowej. Ten moduł jest dostępny w Commerce w wersji 10.0.14 i nowszej.
Banknot
Obsługa modułu kontroli salda kart upominkowych jest dostępna w wydaniu Dynamics 365 Commerce 10.0.14.
Poniższy obraz pokazuje przykład modułu karty podarunkowej na stronie realizacji zamówienia.
Właściwości modułu
Pokaż dodatkowe pola — ta właściwość określa pola, które mają być wyświetlane w przypadku kart upominkowych, oprócz numeru karty upominkowej, który jest zawsze domyślnie wyświetlany. Na przykład niektóre karty upominkowe umożliwiają wyświetlanie osobistego numeru identyfikacyjnego (PIN), a inne umożliwiają wyświetlanie numeru PIN i daty ważności. Można również ustawić tę właściwość na „Brak”, co spowoduje wyświetlenie numeru karty upominkowej bez dodatkowych pól.
Obsługiwane są następujące wartości:
- PIN
- Data wygaśnięcia
- Numer PIN i data ważności
- None
Włącz dla użytkowników-gości — gdy ta właściwość jest włączona, użytkownicy-goście mogą realizować lub sprawdzać salda na zewnętrznych kartach upominkowych. Ta właściwość wymaga, aby anonimowy (gość) dostęp do zewnętrznych kart upominkowych był włączony w centrali Commerce headquarters. Ustawienie Włącz dla użytkowników-gości dotyczy wyłącznie zewnętrznych kart upominkowych. Aby uzyskać więcej informacji, zobacz Włączanie płatności kartą upominkową do realizacji transakcji gościa.
Ważne
Właściwość Włącz dla użytkowników-gości jest dostępna w Commerce od wersji 10.0.21. Wymaga, pakietu biblioteki modułów Commerce w wersji 9.31.
Ustawienia witryny dla modułów kart upominkowych
W konstruktorze witryn Commerce w Ustawienia witryny > Rozszerzenia istnieje ustawienie modułu kart upominkowych o nazwie Obsługiwany typ karty upominkowej. To ustawienie obsługuje trzy wartości:
- Dynamics 365 — karta upominkowa — po zastosowaniu tego ustawienia moduł kart upominkowych umożliwia realizację kart upominkowych Dynamics 365. To ustawienie jest obsługiwane tylko dla użytkowników zalogowanych w witrynie handlu elektronicznego. Funkcja sprawdzania salda na karcie upominkowej jest obsługiwana tylko dla zalogowanych użytkowników.
- Karty upominkowe SVS i Givex — po zastosowaniu tego ustawienia moduł kart upominkowych umożliwia realizację kart upominkowych SVS i Givex. To ustawienie jest obsługiwane dla użytkowników anonimowych oraz zalogowanych w witrynie handlu elektronicznego.
- Karty upominkowe Dynamics 365, SVS i Givex — po zastosowaniu tego ustawienia moduł kart upominkowych umożliwia realizację kart upominkowych Dynamics 365, SVS i Givex. To ustawienie jest obsługiwane tylko dla użytkowników zalogowanych w witrynie handlu elektronicznego. Z powodu uwzględnienia wewnętrznych kart upominkowych funkcja sprawdzania salda dla kart upominkowych jest obsługiwana tylko dla zalogowanych użytkowników.
Ważne
Te ustawienia są dostępne w wydaniu Dynamics 365 Commerce 10.0.11 i są wymagane tylko wtedy, gdy potrzebna jest pomoc techniczna dla kart upominkowych SVS i Givex. W przypadku aktualizacji ze starszej wersji Dynamics 365 Commerce należy ręcznie zaktualizować plik appsettings.json. Aby uzyskać instrukcje dotyczące aktualizowania pliku appsettings.json, zajrzyj do Aktualizacje zestawu SDK i biblioteki modułów.
Rozszerzanie wewnętrznych kart upominkowych do użytku w witrynach handlu elektronicznego
Domyślnie wewnętrzne karty upominkowe nie są przystosowane do używania w witrynach handlu elektronicznego. Dlatego zanim zezwolisz na to, aby wewnętrzne karty upominkowe zostały użyte do płatności, musisz je skonfigurować za pomocą rozszerzeń, które ułatwiają ich zabezpieczanie. Oto obszary kart upominkowych, które należy rozszerzyć, zanim zezwolisz na używanie w środowisku produkcyjnym wewnętrznych kart upominkowych:
- Numer karty upominkowej — Sekwencje numerów służą do generowania numerów kart upominkowych dla wewnętrznych kart upominkowych. Ponieważ sekwencje numerów można łatwo przewidzieć, należy rozszerzyć generowanie numerów kart upominkowych, tak aby numery wystawianych kart upominkowych były wybierane losowo, w sposób kryptograficznie bezpieczny.
- GetBalance — Interfejs API GetBalance służy do odczytywania sald karty upominkowej. Domyślnie ten interfejs API jest publiczny. Jeśli do wyszukiwania sald karty upominkowej nie jest wymagany numer PIN, istnieje ryzyko użycia interfejsu API GetBalance do wyszukiwania numerów kart upominkowych z saldami. Wdrożenie zarówno wymagań dotyczących numeru PIN dla wewnętrznych kart upominkowych, jak i dławienie interfejsu API pomaga złagodzić ryzyko.
- PIN — domyślnie wewnętrzne karty upominkowe nie obsługują numeru PIN. Wewnętrzne karty upominkowe należy rozszerzyć o wymóg podania PIN w celu odczytania salda. Ta funkcja umożliwia także blokowanie kart upominkowych po kolejnych niepoprawnych próbach wprowadzenia numeru PIN.
Włączanie płatności kartą upominkową podczas realizacji transakcji przez gościa
Domyślnie płatności kartą upominkową nie są dostępne podczas realizacji transakcji przez gościa (anonimowego). Aby je włączyć, wykonaj następujące kroki.
- W centrali Commerce headquarters przejdź do lokalizacji Retail i Commerce > Ustawienia kanału > Ustawienia punktu sprzedaży > Punkt sprzedaży > Operacje punktu sprzedaży.
- Wybierz i przytrzymaj (lub kliknij prawym przyciskiem myszy) nagłówek siatki, a następnie wybierz polecenie Wstaw kolumny.
- W oknie dialogowym Wstawianie kolumn zaznacz pole wyboru AllowAnonymousAccess.
- Wybierz Aktualizuj.
- W przypadku operacji 520 (saldo na karcie upominkowej) i 214 ustaw wartość AllowAnonymousAccess na 1.
- Wybierz opcję Zapisz.
- Wykonaj zadanie harmonogram 1090, aby zsynchronizować zmiany z bazą danych kanału.
Dodawanie modułu kart upominkowych do strony
Aby uzyskać instrukcje dotyczące dodawania modułu kart upominkowych do strony realizacji transakcji i ustawiania wymaganych właściwości, należy zapoznać się z Moduł realizacji transakcji.