ギフトカードモジュール

[アーティクル]
07/25/2024

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

ギフトカードモジュールは、精算モジュールで使用することができ、電子商取引で使用される一般的な支払い方法であるギフトカードを受け付けることができます。ギフトカードモジュールは Dynamics 365、SVS、Givex ギフトカードをサポートしています。 SVS と Givex のギフトカードは、Adyen の支払プロバイダーで経由で引き換えることができます。 SVS や Givex などの外部ギフトカードのサポートの詳細については、外部ギフトカードのサポートを参照してください。

メモ

精算フロー中の SVS および Givex ギフトカードの引き換えは、Dynamics 365 Commerce のリリースバージョン 10.0.11 で使用可能です。

ギフトカードモジュールは2つ使用できます。

ギフトカード – このモジュールは、精算ページで使用でき、支払/入金としてギフトカードを使用できます。
ギフトカードの残高 – このモジュールは、ギフトカードの残高を確認するために任意のページで使用できます。このモジュールは、コマースのリリース 10.0.14 およびこれ以降でのみ利用できます。

メモ

ギフトカード残高チェックモジュールのサポートは、Dynamics 365 Commerce の営々ースバージョン 10.0.14 で使用可能です。

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

ギフトカードモジュールの例。

モジュールプロパティ

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

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

重要

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

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

コマースサイトビルダーの サイト設定 > 拡張子 には、サポートされているギフトカードタイプ と呼ばれるギフトカードモジュール設定があります。この設定は 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 入力を連続して試行した後でギフトカードをロックすることもできます。