禮品卡模組

發行項
07/25/2024

本文介紹禮品卡模組並介紹如何將它們新增至網站頁面 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 總部啟用外部禮品卡的匿名（來賓）存取。 為訪客使用者啟用 設定僅適用於外部禮品卡。有關詳細信息，請參閱為客人結帳啟用禮品卡付款。

重要

為來賓使用者啟用 屬性自 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 後鎖定禮品卡。