この記事では、Adyen にサインアップし、Adyen 用 Microsoft Dynamics 365 Payment Connector を設定する方法について説明します。 Adyen 向け Dynamics 365 Payment Connector の概要については Adyen 向け Dynamics 365 Payment Connector の概要を参照してください。
Adyen でサインアップ
Adyen 向け Dynamics 365 Payment Connector を使用するには、Adyen を使用する別の契約を保有している必要があります。 Adyen のサービスの詳細について、またはテスト商業アカウントを作成するには、Adyen Web サイトを参照してください。
設定およびコンフィギュレーション
Note
以下の手順では、Adyen を使用してマーチャント アカウントに既にサインアップしていること、および Adyen 販売者ダッシュボードにアクセスできるものとします。
Important
Adyen は、2022 年 10 月現在 ホスト型決済ページ をサポートしていません。 Adyen用Dynamics 365 Payment Connectorを設定すると、バージョンV001はAdyenのホスティング決済ページを使用するため、コールセンターおよびCommerce eコマースではサポートされていません。 代わりに、V002 (オリジン キー付き) またはバージョン V003 (クライアント キー付き) を使用します。 Microsoft では、Commerce バージョン 10.0.29 以降で利用可能なバージョン V003 の使用を推奨しています。 Adyenの設定で 許可された発信元 を設定し、サイト(eコマース用)またはCommerce本社(コールセンター用)の完全なURL(例: https://www.adventure-works.com)を追加してください。 Adyenの決済端末に接続する場合、デバイス名は依然として「MicrosoftAdyenDeviceV001」です。
前提条件
どのチャネルで支払いを設定する前に、以下の前提条件を満たしてください。
Dynamics 365 Commerceの Adyen アカウント設定を構成する
以下の指示に加えて、Dynamics 365 CommerceのAdyenアカウント設定も設定してください。 Dynamics 365 Commerce用に Adyen を設定する手順については、「
新しいクレジット カードのプロセッサの設定
商務本部でAdyenコネクター経由で決済を処理するには、Adyenコネクタを設定し、新規クレジットカードのデフォルト決済プロセッサーとして設定してください。
既定の支払いプロセッサを構成するには、次の手順に従います。
商務本部にサインインし、「 売掛金>支払い設定>決済サービス」へ進みます。
アクションペインで「新」を選択します。 セットアップタブで以下の情報を入力します。
フィールド Description サンプル値 支払サービス 構成する支払サービスの名前を入力します。 Adyen 決済サービス 支払コネクタ 新しいクレジット カードの支払に使用する支払コネクタを選択します。 Adyen 向け Dynamics 365 Payment Connector テスト モード Adyenコネクタの場合、本番環境およびテスト環境では、このフィールドを falseに設定してください。 false クレジット カードの既定のプロセッサ この支払プロセッサが新しいクレジット カードで使用される既定のプロセッサであるかを指定します。 イエス ゼロ トランザクションの支払プロセッサをバイパスする 0(0)の取引に対してこの決済処理業者をスキップするかどうかを指定します。 イエス 支払サービス アカウント タブで、以下の情報を入力します。
フィールド Description 必須 自動セット サンプル値 アセンブリ名 Adyen 向け Dynamics 365 Payment Connector の自動入力されたアセンブリ名。 イエス イエス バイナリ名 サービス アカウント ID 商社のプロパティの設定のための自動入力された一意の識別子。 この識別子は支払トランザクションで記録され、下位のプロセス (請求など) が使用する商業プロパティを識別します。 イエス イエス Guid バージョン 使用する Adyen 向け Dynamics 365 Payment Connector のバージョンを入力します。 すべての新しい実装にはバージョン "V003" を使用する必要があります。 Adyen がオリジン キーの機能をサポートしている間は、バージョン 「V002」 は引き続きご利用いただけます。 バージョン "V001" はサポートされていません。 イエス イエス "V002"/"V003" ゲートウェイ環境 マッピング先の Adyen ゲートウェイ環境を入力します。 可能な値は テスト および ライブ です。 このフィールドは、実稼働デバイスとトランザクションに対してのみ Live に設定します。 イエス イエス リアルタイム オプション ドメイン オプションドメインはライブ環境には必要であり、Adyenに連絡して取得してください。 このドメインは、[random]-[company name] という形式の、ライブ環境固有の一意の識別子です。これは、Adyen Customer Area ポータルの貴社のライブアカウントにある Account>API URLs 配下の API URL 内で、接頭辞として表示されます。 詳細については ライブ エンドポイント を参照してください。 ライブのみ いいえ Adyen に連絡する マーチャント口座 ID 一意の Adyen 商業識別子を入力します。 この値は、Adyen でサインアップ セクションで説明されているように、Adyen でサインアップするときに提供されます。 イエス いいえ MerchantIdentifier ターミナル アーキテクチャ このフィールドを Payment service account用にクラウドに設定してください。イエス イエス 雲 ローカル パスワード フレーズ このフィールドは、POS 支払端末統合に対してのみ使用され、空白のままにする必要があります。 いいえ イエス このフィールドは空白のままにします。 ローカル キー識別子 このフィールドは、POS 支払端末統合に対してのみ使用され、空白のままにする必要があります。 いいえ イエス このフィールドは空白のままにします。 ローカル キー バージョン このフィールドは、POS 支払端末統合に対してのみ使用され、空白のままにする必要があります。 いいえ イエス このフィールドは空白のままにします。 ローカル Cryptor バージョン Adyen ゲートウェイとやり取りするときに使用する Adyen cryptor バージョンを入力します。 このフィールドを 1に設定します。 イエス イエス 1 クラウド API キー Adyen クラウド API キーを入力します。 このキーは、Adyenウェブサイトの「 APIキー生成 」ページの指示に従って入手してください。 イエス いいえ abcdefg サポートされている通貨 コネクタが処理する必要がある通貨を入力します。 カードありのシナリオでは、トランザクション要求が支払端末に送信された後、Adyen は動的通過換算 を使用した追加通過をすることができます。 サポートされている通貨の一覧を取得するには、Adyen サポートに問い合わせてください。 イエス イエス USD;EUR サポートされている支払/入金タイプ コネクタが処理する必要がある支払/入金タイプを入力します。 イエス イエス Visa;MasterCard;Amex;Discover;Debit ギフト カード プロバイダー ギフト カードの処理にコネクタが使用する必要があるギフト カード プロバイダーを入力します。 このフィールドは、大文字小文字を区別します。 いいえ いいえ 「svs」 または 「givex」 ターミナル ギフト カード エントリ (POS のみ) 顧客は手動または機械に通すのどちらかを選択できます。 イエス イエス 真/偽 E コマースでの支払情報の保存を許可します (コマース e コマースのみ)サインインしているユーザーに、今後のオンライン購入のために支払いの詳細を保存するオプションを提供します。 イエス イエス 真/偽 承認失効期間 (日数) (POS のみ) 承認が失効していると見なされ、取得のためにプロセッサにアクセスする前に拒否されるまでの日数。 イエス イエス "7" オリジン キー ("V002") またはクライアント キー ("V003") "V002" が指定されたバージョンの場合は、オリジン キーの値が必要です。 このキーを取得する手順については、オリジン キーを取得する方法 を参照してください。 "V003" が指定されたバージョンの場合は、クライアント キーの値が必要です。 このキーを取得する手順については、クライアント キーへの移行 を参照してください。 イエス いいえ 完全なオリジン キーまたはクライアント キー EnableRequestProtection 「カードなし」支払呼び出しに再試行ロジックを追加し、相関する ID を使用した呼び出しの潜在的な重複を減少させます。 True に設定した場合、プロバイダー要求に相関する ID が追加され、重複を防ぎます。 False に設定した場合、呼び出しは相関する ID または重複保護ロジックなしでプロバイダーに送信されます。 いいえ いいえ 真/偽 増分取得以外の支払方法 承認応答で増分取得をサポートしないカードの種類を識別するために Adyen が使用する支払方法バリアントまたはカードの種類の名前。 Adyen PaymentMethodVariant に記載されているように、入力された値は、Adyen で参照するために使用される支払方法バリアントまたはカードの種類の文字列と一致している必要があります 。 いいえ いいえ "amexcommercial" 端末回線の表示を無効化する 顧客が支払いの前にプレビューに使用する端末インターフェースから、品目別のデジタル レシートの明細行を削除します。 重要 : Store Commerce アプリが Castles S1F2 などの携帯端末で動作している場合、端末がライン表示モードで停止してしまうことを防ぐため、このプロパティを False に設定する必要があります。 いいえ いいえ 真/偽 除外された支払方法 (eコマースとコールセンターのみ) このフィールドを使用して、マーチャント アカウントに対して設定された支払いに対して iFrame の要素が表示される構成から、支払い方法を省略することができます。 複数の値をセミコロンで区切ります。 文字列は、Adyon ポータルで使用されているラベルと一致する必要があります。 一部の決済方法のセキュリティ基準がiFrame要素のレンダリングに干渉する可能性があるため、構成から相反するセキュリティ基準を省略することが望ましい場合があります。 いいえ いいえ "applepay;googlepay" カードの検証値タブで、カードの検証値を行うはそのままで、カードの検証値を空白とするをいいえに設定します。
POS 支払端末
Adyen 支払端末のオンボードおよび構成
Note
次の手順では、Adyen 支払端末へのアクセス権を保持していると仮定します。
Adyen の決済端末を接続するには、対面決済 | Adyen Docs にアクセスし、指示に従ってください。 Adyen 固有のアプリのダウンロードを指示するステップをスキップします。 オンボード プロセス中、各支払端末のための以下の情報を書き留めてください。 この情報は「 決済端末のIPアドレスおよびEFT POSレジスター番号の設定 」セクションで必要です。
- 支払端末の IP アドレス。
- POIID(POIIDはデバイスのシリアル番号と型番で構成され、デバイスを一意に識別します。)
支払端末のオンボード後、Adyen の顧客領域にサインインして、構成対称の端末に移動し、各支払端末のための以下の情報を書き留めてください。 この情報は ローカルネットワーク通信のためのEFTサービス セクションで必要です。
- キー識別子
- キー パスフレーズ
- キーのバージョン
専用または共有ハードウェア ステーションを有効にする
専用のハードウェアステーションを有効にするには、決済端末を設定したい各店舗のCommerce本部で以下の手順に従ってください。
- 小売および商業>チャネル設定>ストアに行き、決済端末を設定している店舗を選択してください。
- ハードウエア ステーション クイック タブで、追加を選択します。
- ハードウェア ステーションの種類 では、専用 を選択します。
- 店舗の変更を保存し、1070 (チャネル) ジョブを実行します。
共有ハードウェア ステーションを有効にする手順については、小売ハードウェア ステーションを新規構成する を参照してください。
Dynamics 365 POS ハードウェア プロファイルの設定
- 商務本部にサインインし、小売および商>チャネル設定>POS設定>POSプロファイル>ハードウェアプロファイルに進みます。
- Adyen 向け Dynamics 365 Payment Connector を追加するためのハードウェア プロファイルを選択します。
- EFT サービス、および続く PIN パッド セクションの手順に従います。
EFT サービス
Adyenの決済コネクターは、ローカルネットワークやAdyenのクラウドバックエンド経由でデバイスと通信するように設定できます。 インターネットサービスが不安定な環境やオフラインモードが必要な場合は、ローカルアーキテクチャ構成を使用します。 強いインターネット接続環境や、決済端末に静的IPアドレスを割り当てられない場合、クラウドアーキテクチャの設定が最も適しているかもしれません。
Important
Adyen の Dynamics 365 Payment Connector では、現在、ローカル ネットワークまたはクラウド アーキテクチャ構成を使用した iOS 向け Store Commerce はサポートされていません。
ローカル ネットワーク通信用の EFT サービス
EFT サービス クイックタブの、EFT サービス フィールドで、支払コネクタ を選択します。
コネクタ タブで、新規 を選択してから、コネクタ フィールドで、Adyen 向け Dynamics 365 Payment Connector を選択します。 シーケンス番号フィールドの値が他のすべてのコネクタの値より小さいことを確認してください。
コネクタ プロパティ セクションで、以下の情報を入力します。
フィールド Description 必須 自動セット サンプル値 アセンブリ名 Adyen 向け Dynamics 365 Payment Connector の自動入力されたアセンブリ名。 イエス イエス バイナリ名 サービス アカウント ID 商社のプロパティの設定のための自動入力された一意の識別子。 この識別子は支払トランザクションで記録され、下位のプロセス (請求など) が使用する商業プロパティを識別します。 イエス イエス Guid バージョン ハードウェア プロファイルの EFT 設定を、V003 に設定します。 V002 は、コール センターとストアフロントにのみ必要です。 バージョン V001 はサポートされていません。 イエス イエス "V003" ゲートウェイ環境 マッピング先の Adyen ゲートウェイ環境を入力します。 可能な値は テスト および ライブ です。 このフィールドは、実稼働デバイスとトランザクションに対してのみ Live に設定します。 イエス イエス リアルタイム オプション ドメイン オプションドメインはライブ環境には必要であり、Adyenに連絡して取得してください。 このドメインは、[random]-[company name] 形式のライブ環境用の一意の識別子であり、Adyen Customer Area ポータルにある貴社のライブアカウントの Account>API URLs に表示される API URL 内で、プレフィックスとして使われます。 詳細については ライブ エンドポイント を参照してください。 ライブのみ いいえ Adyen に連絡する マーチャント口座 ID 一意の Adyen 商業識別子を入力します。 Adyenは「 Adyenでサインアップ 」セクションに記載されている通り、サインアップ時にこの価値を提供します。 イエス いいえ MerchantIdenfier ターミナル アーキテクチャ ローカル通信の場合、このフィールドはローカルに設定してください。 イエス イエス Local ローカル パスワード フレーズ 支払端末の Adyen キー パスフレーズを入力します。 Adyenは「 Adyenでサインアップ 」セクションに記載されている通り、サインアップ時にこの価値を提供します。 イエス いいえ keypassphrase123 ローカル キー識別子 支払端末の Adyen キー識別子を入力します。 Adyenは「 Adyenでサインアップ 」セクションに記載されている通り、サインアップ時にこの価値を提供します。 イエス いいえ mykey ローカル キー バージョン 支払端末の Adyen キー バージョンを入力します。 Adyenは「 Adyenでサインアップ 」セクションに記載されている通り、サインアップ時にこの価値を提供します。 イエス いいえ 0 ローカル Cryptor バージョン Adyen ゲートウェイとやり取りするときに使用する Adyen cryptor バージョンを入力します。 このフィールドを 1に設定します。 イエス イエス 1 クラウド API キー Adyen クラウド API キーを入力します。 このキーは、Adyenのウェブサイトにある「 APIキーの生成 」ページの指示に従って入手してください。 ローカル ターミナルの設定でも、このフィールドは必須です。 イエス いいえ abcdefg サポートされている通貨 コネクタが処理する必要がある通貨を入力します。 カードありのシナリオでは、トランザクション要求が支払端末に送信された後、Adyen は動的通過換算 を使用した追加通過をすることができます。 サポートされている通貨の一覧を取得するには、Adyen サポートに問い合わせてください。 イエス イエス USD;EUR サポートされている支払/入金タイプ コネクタが処理する必要がある支払/入金タイプを入力します。 これらの値は大文字と小文字を区別します。 イエス イエス Visa;MasterCard;Amex;Discover;Debit ギフト カード プロバイダー ギフト カードの処理にコネクタが使用する必要があるギフト カード プロバイダーを入力します。 このフィールドは、大文字小文字を区別します。 いいえ いいえ 「svs」 または 「givex」 ターミナル ギフト カード エントリ (POS のみ) 顧客は手動または機械に通すのどちらかを選択できます。 イエス イエス 真/偽 E コマースでの支払情報の保存を許可します (電子商取引のみ) サインインしたユーザーに、将来のオンライン購入の支払詳細を保存するためのオプションを提供します。 イエス イエス 真/偽 承認失効期間 (日数) (POS のみ) 承認が失効していると見なされ、取得のためにプロセッサにアクセスする前に拒否されるまでの日数。 イエス イエス "7" 発生元キー (カードは存在しません) EnableRequestProtection 「カードなし」支払呼び出しに再試行ロジックを追加し、相関する ID を使用した呼び出しの潜在的な重複を減少させます。 True に設定した場合、プロバイダー要求に相関する ID が追加され、重複を防ぎます。 False に設定した場合、呼び出しは相関する ID または重複保護ロジックなしでプロバイダーに送信されます。 いいえ いいえ 真/偽 増分取得以外の支払方法 承認応答で増分取得をサポートしないカードの種類を識別するために Adyen が使用する支払方法バリアントまたはカードの種類の名前。 Adyen PaymentMethodVariant に記載されているように、入力された値は、Adyen で参照するために使用される支払方法バリアントまたはカードの種類の文字列と一致している必要があります 。 いいえ いいえ "amexcommercial" 端末回線の表示を無効化する 決済前に買い物客に確認してもらう端末のインターフェースから、レシートの明細行を削除する。 端末の明細行表示を無効にすることは、小型のハンドヘルド端末デバイスに有効です。 いいえ いいえ 真/偽 除外された支払方法 (eコマース サイトとコール センターのみ) アクション ウィンドウで、保存を選択します。
Note
ローカルPOSインスタンスを設定する場合でも、「カードが存在しない」シナリオに対応する Cloud API キーフィールドを提供する必要があります。 このようなシナリオには、POS で作成されたオムニチャネル支払の顧客注文、リンクされた払戻、注文集荷での支払認証トークン参照などがあります。
クラウド通信用 EFT サービス
EFT サービス クイックタブの、EFT サービス フィールドで、支払コネクタ を選択します。
コネクタタブで、新規を選択してから、コネクタフィールドで、Adyen 向け Dynamics 365 Payment Connector を選択します。 シーケンス番号フィールドの値が他のすべてのコネクタの値より小さいことを確認してください。
コネクタ プロパティ セクションで、以下の情報を入力します。
フィールド Description 必須 自動セット サンプル値 アセンブリ名 Adyen 向け Dynamics 365 Payment Connector の自動入力されたアセンブリ名。 イエス イエス バイナリ名 サービス アカウント ID 商社のプロパティの設定のための自動入力された一意の識別子。 この識別子は支払トランザクションで記録され、下位のプロセス (請求など) が使用する商業プロパティを識別します。 イエス イエス Guid バージョン ハードウェア プロファイルの EFT 設定を、V003 に設定します。 V002 は、コール センターとストアフロントにのみ必要です。 バージョン V001 はサポートされていません。 イエス イエス "V003" ゲートウェイ環境 マッピング先の Adyen ゲートウェイ環境を入力します。 可能な値は テスト および ライブ です。 このフィールドは、実稼働デバイスとトランザクションに対してのみ Live に設定します。 イエス イエス リアルタイム オプション ドメイン オプションドメインはライブ環境には必要であり、Adyenに連絡して取得してください。 このドメインは、[random]-[company name] の形式のライブ環境用の一意の識別子で、Adyenカスタマーエリアポータルの貴社のライブアカウントにある Account>API URLs の API URL 内のプレフィックスとして表示されます。 詳細については ライブ エンドポイント を参照してください。 ライブのみ いいえ Adyen に連絡する マーチャント口座 ID 一意の Adyen 商業識別子を入力します。 Adyenは「 Adyenでサインアップ 」セクションに記載されている通り、サインアップ時にこの価値を提供します。 イエス いいえ MerchantIdenfier ターミナル アーキテクチャ このフィールドは クラウドに設定 し、決済端末とのクラウド通信を行ってください。 イエス イエス 雲 ローカル パスワード フレーズ この設定は、ローカル支払ターミナル通信にのみ使用されます。 いいえ いいえ 空白のままにする ローカル キー識別子 この設定は、ローカル支払ターミナル通信にのみ使用されます。 いいえ いいえ 空白のままにする ローカル キー バージョン この設定は、ローカル支払ターミナル通信にのみ使用されます。 いいえ いいえ 空白のままにする ローカル Cryptor バージョン この設定は、ローカル支払ターミナル通信にのみ使用されます。 既定値は、1 のままにできます。 イエス イエス 1 クラウド API キー Adyen クラウド API キーを入力します。 このキーは、Adyenウェブサイトの「 APIキー生成 」ページの指示に従って入手してください。 イエス いいえ abcdefg サポートされている通貨 コネクタが処理する必要がある通貨を入力します。 カードありのシナリオでは、トランザクション要求が支払端末に送信された後、Adyen は動的通過換算 を使用した追加通過をすることができます。 サポートされている通貨の一覧を取得するには、Adyen サポートに問い合わせてください。 イエス イエス USD;EUR サポートされている支払/入金タイプ コネクタが処理する必要がある支払/入金タイプを入力します。 これらの値では大文字と小文字が区別されます。 イエス イエス Visa;MasterCard;Amex;Discover;Debit ギフト カード プロバイダー ギフト カードの処理にコネクタが使用する必要があるギフト カード プロバイダーを入力します。 このフィールドは、大文字小文字を区別します。 いいえ いいえ 「svs」 または 「givex」 ターミナル ギフト カード エントリ (POS のみ) 顧客は手動または機械に通すのどちらかを選択できます。 イエス イエス 真/偽 E コマースでの支払情報の保存を許可します (電子商取引のみ) サインインしたユーザーに、将来のオンライン購入の支払詳細を保存するためのオプションを提供します。 イエス イエス 真/偽 承認失効期間 (日数) (POS のみ) 承認が失効していると見なされ、取得のためにプロセッサにアクセスする前に拒否されるまでの日数。 イエス イエス "7" 発生元キー (カードは存在しません) EnableRequestProtection 「カードなし」支払呼び出しに再試行ロジックを追加し、相関する ID を使用した呼び出しの潜在的な重複を減少させます。 True に設定した場合、プロバイダー要求に相関する ID が追加され、重複を防ぎます。 False に設定した場合、呼び出しは相関する ID または重複保護ロジックなしでプロバイダーに送信されます。 いいえ いいえ 真/偽 増分取得以外の支払方法 承認応答で増分取得をサポートしないカードの種類を識別するために Adyen が使用する支払方法バリアントまたはカードの種類の名前。 Adyen PaymentMethodVariant に記載されているように、入力された値は、Adyen で参照するために使用される支払方法バリアントまたはカードの種類の文字列と一致している必要があります 。 いいえ いいえ "amexcommercial" 端末回線の表示を無効化する 決済前に買い物客に確認してもらう端末のインターフェースから、レシートの明細行を削除する。 端末の明細行表示を無効にすることは、小型のハンドヘルド端末デバイスに有効です。 いいえ いいえ 真/偽 除外された支払方法 (eコマース サイトとコール センターのみ) アクション ウィンドウで、保存を選択します。
PIN パッドの構成
PIN パッドを構成するには、次の手順に従います。
- PIN パッド クイックタブの、PIN パッド フィールドで、ネットワーク を選択します。
- デバイス名 フィールドに、MicrosoftAdyenDeviceV001 と入力します。
Note
地域固有のエンドポイントへのルーティングについては、「 地域別Adyenエンドポイントへのルート」を参照してください。
Dynamics 365 レジスターの設定
Note
これらの手順では、POS レジスタと Adyen 支払いターミナルの間に専用のマッピングがあることを前提としています。 Microsoft インターネット インフォメーション サービス (IIS) に基づくハードウェア ステーションの場合は、小売および商取引 > チャネル > ストア > すべてのストア に移動し、設定するストアを選択します。 次に、その店舗のページの、ハードウェア ステーション クイック タブで、同じ手順を実行します。
複数のハードウェア ステーションで支払端末を使用することはできません。 複数のPOSデバイスで決済端末が共有されている場合、IISハードウェアステーションを導入して決済端末との通信を管理する必要があります。
支払端末の IP アドレスおよび EFT POS レジスター番号の構成
- コマース本社で、 Retail and Commerce>Channel setup>POS setup>Registers に移動します。
- Adyen 支払端末にリンクするレジスターを選択します。
- POSレジスターのページ、General FastTabのEFTセクションで、EFT POSレジスタ番号フィールドに固有の番号を入力します。
- プロファイルセクションで、先に設定したハードウェアプロファイルをハードウェアプロファイルのフィールドで選択してください。
- 変更を保存。
-
ハードウェアグループのレジスタータブで「IPアドレスの設定」を選択してください。
1. 「ローカル」アーキテクチャを使用する場合、 IPアドレス設定 ページの PINパッド FastTabで、IP アドレス 欄に端末のIPアドレスを以下の形式で入力します:
https://<IP address>:8443/nexo/<POIID>。IP addressPOIIDはAdyen決済端末のオンボーディング時に確認した数値(例:https://192.168.1.3:8443/nexo/MX925-123456789)です。 この URL の値は、大文字と小文字を区別します。 1. 「クラウド」アーキテクチャを使用している場合、 IPアドレス設定 ページの PINパッド FastTabで、Adyen決済端末のオンボーディング時に確認した POIID 値をIP アドレス 欄に入力してください(例:MX925-123456789)。 このフィールドの値は、大文字と小文字を区別します。 - 決済端末に内蔵プリンターが搭載されていて、そのプリンターを使ってプロセッサーから領収書を印刷したい場合は、FastTabのPINパッドのIPアドレス欄とは別のポート欄に123を入力してください。
Store Commerce アプリまたは IIS ハードウェア ステーションのコンフィギュレーションの更新
Commerce SDKを使って自社版のStore Commerceアプリをパッケージ化する場合は、インストーラーをパッケージングする前にSDKコードの手順を一度だけ踏みます。 それ以外の場合は、標準のStore CommerceアプリやIIS Hardware Stationをインストールした後に以下の手順に従ってください。
dllhost.exe.config ファイル (Store Commerce の場合) または web.config ファイル (IIS ハードウェア ステーションの場合) を開きます。
レガシー決済デバイスアダプターから標準決済デバイスアダプターに切り替えるには、 PreloadedComposition セクションをこちらのように更新してください。
<PreloadedComposition> <composition> <add source="assembly" value="Microsoft.Dynamics.Commerce.HardwareStation.Peripherals.PaymentDeviceAdapter" /> <!-- Switch from legacy to standard Payment Device Adapter. <add source="assembly" value="Microsoft.Dynamics.Commerce.HardwareStation.Peripherals.Legacy.PaymentDeviceAdapter" /> --> </composition> </PreloadedComposition>appSettings 変数の "PrintReceiptsOnCardDeclineOrVoid" 値を True に更新して、プロセッサからの応答を印刷拒否または印刷無効にします。
コール センター支払用のコネクタの構成
コール センターの支払のために Adyen 向け Dynamics 365 Payment Connector を構成するには、この記事の前半の新しいクレジット カードのプロセッサの設定セクションの指示に従います。
本社の Accounts reseivable>Payments setup>Payment service の設定をコールセンターのコネクター設定として使ってください。 コールセンターは3Dセキュア(3DS)認証をサポートしていません。 また、コールセンターはユーザーのサインインが必要なデジタルウォレットの現代的な決済方法をサポートしていません。なぜなら、コールセンターの担当者が顧客の代わりにパスワードを収集・使用できないからです。
Note
加盟店は、機密データ漏洩のリスクを減らすために、コールセンター利用者にクレジットカードとデビットカードの情報をiFrameの支払いフォームにのみ入力するよう教育すべきです。
オンライン ストア用の Adyen コネクタを構成する
オンライン ストア用に Adyen コネクタを構成するには、次の手順に従います。
Retail and Commerce>Channels>Online stores に移動します。
Adyen 向け Dynamics 365 Payment Connector を追加するオンライン店舗を選択します。
オンライン店舗ページの、支払口座 クイック タブで、追加 を選択します。
コネクタ フィールドで、Adyen 向け Dynamics 365 Payment Connector を選択します。
次の情報を入力します。
フィールド Description 必須 自動セット サンプル値 アセンブリ名 Adyen 向け Dynamics 365 Payment Connector の自動入力されたアセンブリ名。 イエス イエス バイナリ名 サービス アカウント ID 商社のプロパティの設定のための自動入力された一意の識別子。 この識別子は支払トランザクションで記録され、下位のプロセス (請求など) が使用する商業プロパティを識別します。 イエス イエス Guid バージョン 使用する Adyen 向け Dynamics 365 Payment Connector のバージョンを入力します。 すべての新しい実装にはバージョン "V003" を使用する必要があります。 バージョン "V002" は使用可能で、オリジン キー機能は引き続き Adyen によってサポートされています。 バージョン "V001" はサポートされていません。 イエス イエス "V002"/"V003" ゲートウェイ環境 マッピング先の Adyen ゲートウェイ環境を入力します。 可能な値は テスト および ライブ です。 イエス イエス リアルタイム オプション ドメイン 支払要求が Adyen に実行されるときに使用するドメインを入力します。 このドメインは、[random]-[company name] の形式のライブ環境用の一意の識別子であり、Adyen Customer Area ポータルの会社のライブアカウントの Account>API URLs にある API URL 内のプレフィックスとして表示されます。 詳細については ライブ エンドポイント を参照してください。 ライブのみ いいえ Adyen に連絡する マーチャント口座 ID 一意の Adyen 商業識別子を入力します。 Adyenは「 Adyenでサインアップ 」セクションに記載されている通り、サインアップ時にこの価値を提供します。 イエス いいえ MerchantIdenfier ターミナル アーキテクチャ このフィールドは、POS 支払端末統合に対してのみ使用され、空白のままにする必要があります。 いいえ イエス このフィールドは空白のままにします。 ローカル パスワード フレーズ このフィールドは、POS 支払端末統合に対してのみ使用され、空白のままにする必要があります。 いいえ イエス このフィールドは空白のままにします。 ローカル キー識別子 このフィールドは、POS 支払端末統合に対してのみ使用され、空白のままにする必要があります。 いいえ イエス このフィールドは空白のままにします。 ローカル キー バージョン このフィールドは、POS 支払端末統合に対してのみ使用され、空白のままにする必要があります。 いいえ イエス このフィールドは空白のままにします。 ローカル Cryptor バージョン Adyen ゲートウェイとやり取りするときに使用する Adyen cryptor バージョンを入力します。 このフィールドは 1 にセットする必要があります。 イエス いいえ 1 クラウド API キー Adyen クラウド API キーを入力します。 このキーは Adyen Web サイトの API キーの生成 ページの指示に従い取得することができます。 イエス いいえ 完全なクラウド API キー サポートされている通貨 コネクタが処理する必要がある通貨を入力します。 イエス イエス USD;EUR サポートされている支払/入金タイプ コネクタが処理する必要がある支払/入金タイプを入力します。 イエス イエス Visa;MasterCard;Amex;Discover;Debit ギフト カード プロバイダー ギフト カードの処理にコネクタが使用する必要があるギフト カード プロバイダーを入力します。 可能な値は SVS および GIVEX です。 いいえ いいえ SVS ターミナル ギフト カード エントリ (POS のみ*) 顧客は手動または機械に通すのどちらかを選択できます。 イエス イエス 真/偽 E コマースでの支払情報の保存を許可します (電子商取引のみ) サインインしたユーザーに、将来のオンライン購入の支払詳細を保存するためのオプションを提供します。 イエス イエス 真/偽 承認失効期間 (日数) (POS のみ) 承認が失効していると見なされ、取得のためにプロセッサにアクセスする前に拒否されるまでの日数。 イエス イエス "7" オリジン キー ("V002") またはクライアント キー ("V003") (eコマースのみ) '"V002" が指定されたバージョンの場合は、オリジン キーの値が必要です。 このキーを取得する手順については、オリジン キーを取得する方法 を参照してください。 "V003" が指定されたバージョンの場合は、クライアント キーの値が必要です。 このキーを取得する手順については、クライアント キーへの移行 を参照してください。 イエス いいえ 完全なオリジン キーまたはクライアント キー EnableRequestProtection 「カードなし」支払呼び出しに再試行ロジックを追加し、相関する ID を使用した呼び出しの潜在的な重複を減少させます。 True に設定した場合、プロバイダー要求に相関する ID が追加され、重複を防ぎます。 False に設定した場合、呼び出しは相関する ID または重複保護ロジックなしでプロバイダーに送信されます。 いいえ いいえ 真/偽 増分取得以外の支払方法 承認応答で増分取得をサポートしないカードの種類を識別するために Adyen が使用する支払方法バリアントまたはカードの種類の名前。 Adyen PaymentMethodVariant に記載されているように、入力された値は、Adyen で参照するために使用される支払方法バリアントまたはカードの種類の文字列と一致している必要があります 。 いいえ いいえ "amexcommercial" 端末回線の表示を無効化する 支払う前に顧客に表示されるターミナル インターフェイスから、明細化されたデジタルレシート行を削除します。 ターミナルラインディスプレイを無効にすると、小型のハンドヘルド端末デバイスを使用するユーザーに役立ちます。 いいえ いいえ 真/偽 除外された支払方法 (eコマースとコールセンターのみ) このフィールドを使用して、マーチャント アカウントに対して設定された支払いに対して iFrame の要素が表示される構成から、支払い方法を省略することができます。 複数の値をセミコロンで区切ります。 文字列は、Adyon ポータルで使用されているラベルと一致する必要があります。 一部の決済方法のセキュリティ基準がiFrameレンダリングに干渉する可能性があるため、設定から相反するセキュリティ基準を省略するのが望ましい場合があります。 いいえ いいえ "applepay;googlepay" アクション ウィンドウで、保存を選択します。
Important
- Adyen で 3D セキュア (3DS) が有効になっている場合、次の必須手順を実行する必要があります (設定に該当する場合)。
- 商務本部でCommerceのバージョン10.0.40、10.0.41、または10.0.42を使用している場合は、あなたのeコマースウェブサイトにマッピングされたオンラインチャネルにアクセスしてください。
- Adyen 支払コネクタ設定セクションを展開し、支払コネクタの カスタム設定 プロパティで、次のキー値ペアを追加します:
{"D365PaymentsIsCheckoutThreeDS1AuthorisationBehaviorEnabled": "true"}。 - 1070 および 1110 の配布スケジュール ジョブを実行します。 これらの作業が終わったら、Adyenカスタマーサポートに連絡して、加盟店アカウントの checkoutThreeDS1AuthorisationBehavior パラメータを Manual に設定する必要があります。
- Commerce バージョン 10.0.43 から、既定で有効になっているので、Commerce headquarters で カスタム設定 プロパティを更新する必要はありません。 ただし、Adyen の顧客サポートに連絡して、マーチャント アカウントの checkoutThreeDS1AuthorisationBehavior パラメーターを 手動 に設定する必要はあります。
地域固有のAdyenエンドポイントにルーティングする
次の表に、リージョン固有の Adyen エンドポイントを使用するために必要な最小コンポーネント バージョンを示します。
| コンポーネント | 10.0.44 | 10.0.45 | 10.0.46 |
|---|---|---|---|
| クラウド POS | 9.54.25283.4 | 9.55.25283.6 | 既定で有効 |
| Store Commerce アプリ | 9.54.25290.2 | 9.55.25283.5 | 既定で有効 |
| ハードウェア ステーション | 9.54.25283.3 | 9.55.25289.8 | 既定で有効 |
| 商務本部 | 10.0.2263.95 | 10.0.2345.19 | 既定で有効 |
支払い端末を使用して対人支払いを設定する
Commerce バージョン 10.0.44 以降では、Adyen エンドポイントにリージョン固有のエンドポイントを使用できます。 POSレジスタが使用するハードウェアプロファイルの決済コネクタの ゲートウェイ環境 プロパティに、以下のサポート値を入力します。
- テスト
- ライブ
- live-us
- live-au
- ライブアプス
Note
POS 使用のために支払いコネクタの オプションドメイン プロパティ値は空欄のままにしてください。 システムは指定した値を無視します。
この機能は UseNewGatewayMappingForTerminalというフライトの背後にあります。 以下のリストは各バージョンの状況を示しています:
- コマース バージョン 10.0.46: 既定で有効になっています。
- コマース バージョン 10.0.45 および 10.0.44: 既定では無効になっています。
Commerce バージョン 10.0.44 および 10.0.45 では、コネクタの"UseNewGatewayMappingForTerminal": true, "UseNewGatewayMapping": trueプロパティに文字列を追加することで、この機能を有効にすることができます。
コールセンターやオンラインストアを通じてカード・ノット・プレゼント決済を設定しましょう
Commerce バージョン 10.0.44 以降では、Adyen エンドポイントにリージョン固有のエンドポイントを使用できます。 決済サービスフォーム(コールセンター用)またはオンラインストアフォーム(eコマース用)のPayment ConnectorのGateway Environmentプロパティに、以下のサポート値を入力してください:
- テスト
- ライブ
- live-us
- live-au
- ライブアプス
live-で始まるものを含むすべてのライブゲートウェイは、すべてのリクエストが正しいサーバーにルーティングされることを確認するためにプレフィックスが必要です。 プレフィックス値を見つけるには、Adyenポータルの Developers>API URLにアクセスし、地域に応じて適切なデータセンターを選択し、プレフィックス値をコピーしてください。 この変更を行うチャネルに応じて、[支払いサービス] フォームまたは [オンライン ストア] フォームの支払いコネクタの [省略可能なドメイン] プロパティ フィールドにプレフィックスを貼り付けます。 Adyenは、インフラが展開されている地域に地理的に近いエンドポイントの使用を推奨しています。 場所ベースのライブ エンドポイントを使用するには、Adyen サポート チームにお問い合わせください。
Important
オプションドメインの値を指定していない場合、決済処理の問題はチェックアウトゲートウェイが誤ったエンドポイントを使用しているためです。
この変更は UseNewGatewayMapping という名前のフライトの背後にあり、さまざまなバージョンの状態は次のとおりです。
- コマース バージョン 10.0.46: 既定で有効
- コマース バージョン 10.0.45 および 10.0.44: 既定では無効
Commerce バージョン 10.0.44 および 10.0.45 の場合、お客様は文字列 "UseNewGatewayMapping": true をコネクタの カスタム設定 プロパティに追加することで、この機能自体を有効にすることができます。
次のステップ
Dynamics 365 Payment Connector for Adyenに関するよくある質問への回答については、「Dynamics 365 Payment Connector for Adyen FAQ」をご覧ください。