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 podarunkowa– Ten moduł może być użyty na stronie kasy, aby zrealizować kartę podarunkową jako środek płatniczy.
- Sprawdzenie salda karty podarunkowej– Ten moduł może być używany na dowolnej stronie do sprawdzania salda na karcie podarunkowej. 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, jakie pola powinny być wyświetlane dla Karty upominkowych oprócz numeru karty upominkowej, który jest zawsze wyświetlany domyślnie. 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 Karty 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 prezentów– Po zastosowaniu tego ustawienia moduł karta prezentów pozwala tylko na realizację Karty prezentów 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ę tylko Karty upominkowych Givex i SVS. To ustawienie jest obsługiwane dla użytkowników anonimowych oraz zalogowanych w witrynie handlu elektronicznego.
- Dynamics 365, SVS i Givex prezent Karty – Po zastosowaniu tego ustawienia moduł karta prezentów umożliwia realizację Karty prezentów Dynamics 365, Givex i SVS. 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 wyszukiwania sald kart podarunkowych. 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ą kodów 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.