禮品卡模組

文章
08/06/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 碼
- 到期日
- 釘選和到期日期
- 無
啟用訪客使用者 - 啟用此屬性後，訪客使用者可以兌換或檢查外部禮品卡片的餘額。此屬性要求在商務總部啟用外部禮物卡片的匿名（來賓）存取。 為訪客使用者啟用 設定僅適用於外部禮物卡片。有關詳細信息，請參閱為客人結帳啟用禮品卡片付款。

重要

為來賓使用者啟用 屬性自 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 Gift 卡片支援時才需要。如果您要從舊版本的 Dynamics 365 Commerce 進行更新，則必須手動更新 appsettings.json 檔案。有關更新 appsettings.json 檔案的說明，請參閱 SDK 和模組庫更新。

擴展內部禮品卡片以在電子商務店面中使用

預設情況下，內部禮品卡片未針對在電子商務店面中使用進行最佳化。因此，在允許使用內部禮物卡片進行付款之前，您應該為它們配置擴充功能以幫助它們更安全。以下是在允許內部禮物卡片用於生產之前應擴展的禮物卡片區域：

禮物卡片編號 – 編號規則用於為內部禮物卡片產生禮物卡片編號。由於數字序列可以輕鬆預測，因此您應該擴展禮物卡片數字的生成，以便將隨機的、加密安全的字串用於頒發的禮物卡片數字。
獲取餘額 - 這 獲取餘額 API 用於尋找禮物卡片餘額。預設情況下，該API是公開的。如果不需要釘選來尋找禮物卡片餘額，則存在暴力攻擊可能使用的風險 獲取餘額 用於嘗試尋找有餘額的禮物卡片號碼的 API。透過實作內部禮品卡片和 API 限制的釘選要求，您可以協助降低風險。
釘選 – 預設情況下，內部禮物卡片不支援 PIN。您應該擴展內部禮物卡片，以便需要釘選來查找餘額。此功能也可用於在連續錯誤嘗試輸入釘選後鎖定禮物卡片。