ギフトカードモジュール

メモ

Dynamics 365 Commerce の小売関連グループは、Yammer から Viva Engage に移行しました。新しいViva Engage コミュニティにアクセスできない場合は、追加するフォーム (https://aka.ms/JoinD365commerceVivaEngageCommunity) に入力し、最新のディスカッションに参加してください。

この記事では、ギフトカードモジュールについて説明し、Microsoft Dynamics 365 Commerce のサイトページに追加する方法について説明します。

チェックアウトモジュールでギフトカードモジュールを使用して、e コマーストランザクションの一般的な支払い形式であるギフトカードを受け入れます。ギフトカードモジュールは、Dynamics 365、ストアドバリューソリューション (SVS)、Givex ギフトカードをサポートしています。 Adyen の支払いプロバイダーは、SVS および Givex ギフトカードを引き換えます。 SVS や Givex などの外部ギフトカードのサポートの詳細については、外部ギフトカードのサポートを参照してください。

メモ

チェックアウトフロー中の SVS および Givex ギフトカードの引き換えのサポートは、Dynamics 365 Commerce 10.0.11 リリースで入手できます。

次の 2 つのギフトカードモジュールを利用できます。

ギフトカード – チェックアウトページでこのモジュールを使用して、ギフトカードを入札として引き換えることができます。
ギフトカード残高チェック – このモジュールを任意のページで使用して、ギフトカードの残高を確認します。このモジュールは、コマースのリリース 10.0.14 およびこれ以降でのみ利用できます。

メモ

ギフトカード残高チェックモジュールのサポートは、Dynamics 365 Commerce 10.0.14 リリースで入手できます。

以下の図は、精算ページにおけるギフトカードモジュールの例を示しています。

ギフトカードモジュールのスクリーンショット。

モジュールプロパティ

[追加フィールドの表示 ] – このプロパティは、ギフトカード番号に加えて、ギフトカードに表示するフィールドを定義します。このフィールドは常に既定で表示されます。たとえば、一部のギフトカードでは、個人識別番号 (PIN) の表示をサポートしており、他ののギフトカードでは、PIN と有効期限の表示をサポートしています。または、このプロパティを "None" に設定すると、ギフトカード番号のみが表示され、追加のフィールドは表示されません。

サポートされている値は、次のとおりです :
- PIN
- 有効期限
- PIN と有効期限
- None
ゲストユーザーに対して有効にする – このプロパティを有効にすると、ゲストユーザーは外部ギフトカードの残高を引き換えたり確認したりできます。このプロパティでは、コマース本社で外部ギフトカードを有効にするには、匿名 (ゲスト) アクセスが必要です。 ゲストユーザーに対して有効にする 設定は、外部ギフトカードにのみ適用されます。詳細については、ゲストチェックアウトに対してギフトカード支払を有効にするを参照してください。

重要

ゲストユーザーに対する有効化プロパティは、Commerce Version 10.0.21 リリース版で利用可能です。 Commerce モジュールライブラリパッケージバージョン 9.31 をインストールする必要があります。

ギフトカードモジュールのサイト設定

Commerce サイトビルダーの [サイト設定] > 拡張機能には、[ サポートされているギフト カードの種類] というギフトカードモジュールの設定があります。この設定は 3 つの値をサポートします:

Dynamics 365ギフトカード – この設定を適用すると、ギフトカードモジュールはDynamics 365ギフトカードの引き換えのみを許可します。この設定は、E コマースサイトのサインインユーザーに対してのみサポートされます。ギフトカードの残高確認機能は、サインインユーザーに対してのみサポートされます。
SVS および Givex ギフトカード – この設定を適用すると、ギフトカードモジュールでは Givex および SVS ギフトカードの引き換えのみが許可されます。この設定では、eコマースサイトでのサインインユーザーと匿名ユーザーがサポートされます。
Dynamics 365、SVS、Givex の各ギフトカード – この設定を適用すると、ギフトカードモジュールでDynamics 365、Givex、SVS のギフトカードを利用できます。この設定は、E コマースサイトのサインインユーザーに対してのみサポートされます。内部ギフトカードが含まれるので、ギフトカードの残高確認機能は、サインインユーザーに対してのみサポートされます。

重要

これらの設定は、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 の入力を誤って連続して試行した後に、ギフトカードをロックすることもできます。