禮品卡模組

附註

Dynamics 365 Commerce 的零售興趣群組已從 Yammer 移至 Viva Engage。如果您無法存取新的Viva Engage社群，請填寫此表單（https://aka.ms/JoinD365commerceVivaEngageCommunity）以新增，並繼續參與最新的討論。

本文介紹禮品卡模組，並說明如何將其新增至 Microsoft Dynamics 365 Commerce 的網站頁面。

禮品卡模組可用於結帳模組中以接受禮品卡，這是電子商務交易常見的付款方式。禮品卡模組支援 Dynamics 365、SVS 和 Givex 禮品卡。 SVS 和 Givex 禮品卡透過 Adyen 支付提供者兌換。如需有關支援 SVS 和 Givex 等外部禮品卡的更多資訊，請參閱支援外部禮品卡。

附註

在 Dynamics 365 Commerce 10.0.11 版本中，支援於結帳流程中兌換 SVS 和 Givex 禮品卡。

目前提供兩種禮品卡模組：

禮品卡 - 此模組可用於結帳頁面上，以禮品卡作為付款方式進行兌換。
禮品卡餘額查詢 - 此模組可用於任何頁面上，以查詢禮品卡餘額。此模組自 Commerce 10.0.14 版本起提供。

附註

禮品卡餘額查詢模組的支援於 Dynamics 365 Commerce 10.0.14 版本提供。

下圖顯示結帳頁面上禮品卡模組的範例。

禮品卡模組範例。

模組屬性

顯示其他欄位 - 此屬性定義除了禮品卡號碼 (預設總是顯示) 外，還應顯示哪些欄位。例如，某些禮品卡支援顯示個人識別碼 (PIN)，其他則支援顯示 PIN 和到期日。或者，此屬性可設為「無」，僅顯示禮品卡號碼，不顯示其他欄位。

支援的值如下：
- PIN
- 到期日
- PIN 和到期日
- 沒有任何
啟用訪客使用者 - 啟用此屬性後，訪客使用者可兌換或查詢外部禮品卡的餘額。此屬性需在 Commerce headquarters 啟用外部禮品卡的匿名 (訪客) 存取。 啟用訪客使用者設定僅適用於外部禮品卡。如需更多資訊，請參閱啟用訪客結帳的禮品卡付款。

重要

啟用訪客使用者屬性自 Commerce 版本 10.0.21 起提供。它要求安裝 Commerce 模組庫套裝版本 9.31。

禮品卡模組的網站設定

在 Commerce 網站建立器的網站設定 > 擴充功能中，有一項名為支援的禮品卡類型的禮品卡模組設定。此設定支援三種值：

Dynamics 365 禮品卡 - 套用此設定時，禮品卡模組僅允許兌換 Dynamics 365 禮品卡。此設定僅支援已登入的電子商務網站使用者。禮品卡餘額查詢功能僅支援已登入使用者。
SVS 和 Givex 禮品卡 - 套用此設定時，禮品卡模組僅允許兌換 Givex 和 SVS 禮品卡。此設定支援電子商務網站上的登入與匿名使用者。
Dynamics 365，SVS，和 Givex 禮物卡 – 當套用此設定時，禮物卡模組會允許兌換 Dynamics 365、Givex 和 SVS 禮物卡。此設定僅支援已登入的電子商務網站使用者。由於包含內部禮物卡，查詢禮物卡餘額功能僅支援已登入的使用者。

重要

這些設定可於 Dynamics 365 Commerce 10.0.11 版本中使用，且僅在需要支援 SVS 或 Givex 禮物卡時才需要設定。若您從舊版 Dynamics 365 Commerce 更新，必須手動更新 appsettings.json 檔案。有關更新 appsettings.json 檔案的指引，請參閱 SDK 與模組庫更新。

擴充內部禮物卡以用於電子商務網站

預設情況下，內部禮物卡未針對電子商務網站最佳化。因此，在允許內部禮物卡用於付款之前，您應該透過擴充功能來設定它們，以提升安全性。以下是您在允許內部禮物卡投入正式使用前應該擴充的禮物卡項目：

禮物卡號碼 – 內部禮物卡的號碼序列用於產生禮物卡號碼。由於號碼序列容易預測，您應該擴充禮物卡號碼的產生方式，改用隨機且具密碼學安全性的字串來作為發行的禮物卡號碼。
GetBalance – GetBalance API 用於查詢禮物卡餘額。預設情況下，此 API 是公開的。如果查詢禮物卡餘額不需要 PIN，則存在暴力破解攻擊可能利用 GetBalance API 嘗試查詢有餘額的禮物卡號碼的風險。透過同時實作內部禮物卡的 PIN 要求和 API 限流，可以幫助降低風險。
PIN – 預設情況下，內部禮物卡不支援 PIN。您應該擴充內部禮物卡，使查詢餘額時需要輸入 PIN。此功能也可以用來在連續輸入錯誤 PIN 後鎖定禮物卡。