支払モジュール

[アーティクル]
03/12/2024

この記事では、支払いモジュールについて取り上げ、Microsoft Dynamics 365 Commerce での構成方法について説明します。

警告

PayPal および Google Pay Express の支払い動作に関する Dynamics 365 Commerce パターンは、改訂決済サービス指令 (PSD2) 要件を適用する地域では現在推奨されていません。 Commerce 支払いモジュールのエクスプレス決済パターンは、ユーザーの注文の配送先住所を取得したときに、Commerce チェックアウトページで最終注文価格を計算します。 PSD2 では、ユーザーがデジタルウォレットの認証ウィンドウ内で全注文の合計価格を表示することを推奨しています。 Commerce は、配送先住所が選択されたときにウォレット決済ウィンドウで注文詳細を更新することにより、エクスプレスフローをサポートするために PayPal と Google Pay モジュールの動作を更新する今後の作業を追跡します。

支払モジュールにより、顧客はクレジットカードやデビットカードを使用して注文の支払を行うことができます。このモジュールの支払い統合は、 Dynamics 365 Payment Connector によって提供されます。支払いコネクタを設定および構成方法についての詳細は、Adyen 用の Dynamics 365 Payment Connector を参照してください。

Commerce リリース 10.0.14 の時点で、支払いモジュールは PayPal 向け Dynamics 365 Payment Connector と統合されており、顧客は PayPal を使用して注文の支払いを行うことができます。 PayPal 向け Dynamics 365 Payment Connector の設定および構成方法についての詳細は、PayPal 向け Dynamics 365 Payment Connector を参照してください。

Adyen 向け Dynamics 365 Payment Connector

支払いモジュールは、HTML インラインフレーム (iframe) 要素で Adyen 経由で提供される支払情報をホストします。支払モジュールは、Commerce Scale Unit とやり取りして、Adyen 支払情報を取得します。 Commerce Scale Unit のやり取りの一部として、支払いモジュールは、請求先住所情報を Adyen 経由または別のモジュールとして iFrame 要素で提供することができます。 Fabrikam テーマでは、請求先住所が別のモジュールとして有効化されます。この方法を使用すると、住所の行を出荷先住所の行と類似したものに表示することができるので、書式設定上の柔軟性が高まります。

支払モジュールでは、顧客は支払情報を保存することもできます。支払情報と請求先住所は、Adyen 支払コネクタを介して保存および管理されます。

支払モジュールは、ロイヤルティポイントまたはギフトカードで既にカバーされていない注文費用を対象とします。注文の合計がロイヤルティポイントまたはギフトカードクレジットで完全にカバーされている場合、支払いモジュールが非表示になり、顧客は支払いモジュールなしで注文することができます。

Adyen 支払いコネクタは強力な顧客認証 (SCA) もサポートします。欧州連合 (EU) 改訂決済サービス指令 (PSD2) の一部では、オンラインで買い物をする人は電子決済方法で決済する場合、自分たちのオンラインショッピング体験以外で認証を受けることを義務付けています。チェックアウトフローの間、顧客は銀行サイトにリダイレクトされ、認証後に Commerce のチェックアウトフローにリダイレクトされます。このリダイレクトでは、顧客がチェックアウトフロー中に入力した情報 (たとえば、出荷先住所、配送オプション、ギフトカード情報、ロイヤルティ情報など) が維持されます。 Adyen 支払コネクタ機能を有効にする前に、Commerce headquarters の SCA 用に支払コネクタをコンフィギュレーションする必要があります。詳細については、Adyen を使用した強力な顧客認証を参照してください。この機能は、Commerce リリース 10.0.12 で有効になりました。

注記

Adyen 支払いコネクタの場合、サイトの許可リストに Adyen URL を追加した場合にのみ、支払いモジュールの iframe 要素はレンダリングできます。この手順を完了するには、*.adyen.com をサイトのコンテンツセキュリティポリシーの child-src、connect-src、img-src、script-src、style-src の各ディレクティブに追加します。詳細については、コンテンツセキュリティポリシーの管理を参照してください。

次の図は、チェックアウトページのギフトカード、ロイヤルティポイント、Adyen 支払モジュールの例を示しています。

チェックアウトページのギフトカード、ロイヤルティポイント、Adyen 支払モジュールの例。

PayPal 向け Dynamics 365 Payment Connector

Commerce リリース 10.0.14 の時点で、支払モジュールは PayPal 向け Dynamics 365 Payment Connector とも統合されています。この支払コネクタを設定および構成方法についての詳細は、PayPal 向け Dynamics 365 Payment Connector を参照してください。

チェックアウトページでは、Adyen と PayPal の両方のコネクタをコンフィギュレーションすることができます。支払いモジュールには、どのコネクタを使用する必要があるかを識別するためのプロパティがあります。詳細については、次の表の サポートされている支払 / 入金タイプ および 基本支払い モジュールのプロパティを参照してください。

PayPal 支払コネクタを使用するように支払モジュールがコンフィギュレーションされている場合、チェックアウトページに PayPal ボタンが表示されます。顧客から呼び出された場合、支払いモジュールは PayPal 情報を含む iFrame 要素をレンダリングします。顧客はサインインして、この iFrame 要素に PayPal 情報を提供することで、トランザクションを完了できます。顧客が PayPal での支払いを選択した場合、注文の残りの残高は PayPal 経由で請求されます。

PayPal 支払いコネクタには、PayPal がすべての請求書関連情報をその iFrame 要素内で処理するため、請求先住所モジュールは必要ありません。ただし、送付先住所と配送オプションの各モジュールが必要です。

次の図は、チェックアウトページにある 2 つの支払モジュール (Adyen コネクタと PayPal 支払コネクタで構成された支払方法の例) を示しています。チェックアウトページのAdyen 支払モジュールと PayPal モジュールの例。

次の図は、PayPal ボタンを使用して起動された PayPal iFrame 要素の例を示しています。チェックアウトページの Paypal iFrame 要素の例。

支払モジュールのプロパティ

プロパティ名	値	説明
ヘッダー	ヘッダーテキスト	支払いモジュールのオプションヘッダー。
iframe 要素の高さ	ピクセル	ピクセル単位での iframe 要素の高さ。高さは必要に応じて調整できます。
請求先住所の表示	True または False	このプロパティが True に設定されている場合、請求先住所は、支払いモジュール iframe 要素内の Adyen で処理されます。 False に設定すると、請求先住所は Adyen によって処理されず、チェックアウトページに請求先住所を表示するようにモジュールをコンフィギュレーションする必要があります。請求先住所は PayPal によって処理されるため、このフィールドは PayPal 支払いコネクタには影響しません。
支払スタイルの上書き	カスケードスタイルシート (CSS) コード	支払いモジュールは iframe 要素でホストされるため、スタイル機能は制限されます。このプロパティを使用すると、何らかのスタイルを実現できます。サイトスタイルをオーバーライドするには、CSS コードをこのプロパティの値として貼り付ける必要があります。サイトビルダー CSS が上書きし、スタイルはこのモジュールには適用されません。
サポートされている支払/入金タイプ	文字列	複数の支払コネクタが構成されている場合は、サポートされている支払/入金タイプ文字列を Commerce 本社支払コネクタコンフィギュレーションで定義されているとおりに提供する必要があります (次の画像を参照)。空白の場合、既定では Adyen 支払コネクタになります。 Commerce リリース 10.0.14 に追加されました。
基本支払	True または False	True の場合、すべてのエラーメッセージは、チェックアウトページの基本支払いコネクタから生成されます。 Adyen と PayPal の両方の支払いコネクタを構成する場合、Adyen を True に設定します。
コネクタ ID を使用する	True または False	サイトに複数の支払コネクタが構成されている場合、このプロパティを使用します。 True の場合、コネクタはコネクタ ID を支払相関関係に使用する必要があります。
iframe 要素のブラウザーセット言語コードの使用	True または False	(Adyen のみ) True の場合、Adyen iframe 要素はサイトに対して構成された Commerce チャンネルの言語コードを使用するのではなく、サイトユーザーのブラウザーコンテキストに基づいて言語を表示します。

次の図は、Commerce headquarters の支払コネクタのコンフィギュレーションで "PayPal" に設定されている、サポートされている支払/入金タイプ の値の例を示しています。 Commerce 本社でサポートされている支払/入金タイプの例。

請求先住所

Adyen 支払いコネクタの請求先住所明細行がサイトの他の部分の外観と十分に一致しない場合は、請求先住所モジュールをチェックアウトページで使用できます。

支払モジュールが Adyen 支払コネクタに統合されているときに、チェックアウトページで請求先住所モジュールを使用するには、請求先住所の表示プロパティを False に設定します。これは、請求先住所モジュールを既定の Adyen 請求先住所の代わりに使用できるようにするためです。この場合、サイトの作成者は、チェックアウトページに請求先住所モジュールを含める必要があります。 Adyen 支払コネクタを使用すると、配送先住所を請求先住所として使用して、サイトユーザーの手順の数を最小限にすることもできます。

サポートされている支払/入金タイプ プロパティは、請求先住所モジュールに存在します。このプロパティの値は、支払モジュールに指定されている値と同じである必要があります。この値は、一緒に動作することを保証するために使用されます。 Adyen 支払コネクタの場合、支払モジュールと請求先住所モジュールの両方でこの値を空白のままにしておく必要があります (既定の状態)。 PayPal コネクタの場合、専用の請求先住所モジュールは必要ありません。その他のタイプの支払コネクタの場合は、その文字列を Commerce headquarters でコンフィギュレーションされているものとして指定する必要があります。

チェックアウトページに支払いモジュールを追加して、必要なプロパティを設定する

支払いモジュールは、チェックアウトモジュールにのみ追加できます。チェックアウトページをコンフィギュレーションする方法の詳細については、チェックアウトモジュールを参照してください。

Adyen と PayPal の支払コネクタを構成する (両方を使用する場合)

Adyen と PayPal の両方の支払いコネクタをサイトで使用する場合は、Commerce サイトビルダの次の手順に従って、各コネクタの支払いモジュールをチェックアウトモジュールに追加し、各モジュールのプロパティを構成します。

PayPal 支払モジュールのプロパティウィンドウで、次の手順に従います。
1. サポートされている支払/入金タイプ プロパティのフィールドに、PayPal と入力します。
2. 基本支払 プロパティのチェックボックスをオフにします。
3. コネクタ ID を使用 プロパティのチェックボックスをオンにします。
Adyen 支払モジュールのプロパティウィンドウで、次の手順に従います。
1. サポートされている支払/入金タイプ プロパティのフィールドを空欄のままにします。
2. 基本支払 プロパティのチェックボックスを選択します。
3. コネクタ ID を使用 プロパティのチェックボックスをオンにします。

メモ

Adyen と PayPal のコネクタをまとめて使用するには、Adyen 向け Dynamics 365 Payment Connector 構成が、Commerce 本社でオンラインチャンネルの 支払アカウント コネクタ構成の最初の位置にある必要があります。コネクタの注文を確認または変更するには、オンラインストア に移動し、サイトのチャンネルを選択します。次に、設定タブの 支払アカウント クイックタブの コネクタ で、Adyen 向け Dynamics 365 Payment Connector 構成が 1 番目の位置 (つまりトップライン) に配置され、PayPal 向け Dynamics 365 Payment Connector 構成が 2 行目に配置されている必要があります。コネクタを再発注するために必要に応じて、コネクタを追加または削除します。