支払コネクタの配置
開始する
この記事では、IT プロフェッショナルまたは付加価値再販業者 (VAR) が支払コネクタを適切なコンポーネントに展開するプロセスについて説明します。 支払コネクタが支払プロバイダーまたは支払独立系ソフトウェア ベンダー (ISV) によって実装されてテスト済みであり、また顧客環境での検証とそれに続く運用配置の準備ができていると仮定します。
この記事には、Retail ソフトウェア開発キット (SDK) を使用して支払コネクタをパッケージ化する方法に関する情報は含まれていません。 SDK のダウンロード方法に関する詳細は、 Retail ソフトウエア開発キット (SDK) アーキテクチャ を参照してください。 支払コネクタをパッケージ化する方法のガイドラインについては、ダウンロードした SDK の Retail SDK パッケージ ドキュメントを参照してください。
この記事には、支払 Web アプリケーション、支払フロントエンド プロセッサ、または支払バックエンド プロセッサの配置方法に関する情報も含まれています。それは、これらのアプリケーションが支払プロバイダーまたは支払 ISV によって管理されているためです。 Microsoft Dynamics AX 7.0 (2016 年 2 月) を使用している場合は、コマース配置可能パッケージを作成する前に KB 3183058 を適用する必要があります。
支払パッケージ フォルダ
支払プロバイダーまたは支払 ISV は、支払コネクタを作成します。 支払コネクターには、次のフォルダーの一部または全部が含まれます。
メモ
これらのフォルダーは \RetailSDK\PaymentExternals で検索することができます。
- IPaymentProcessor Assemblies – このフォルダーには、IPaymentProcessor インターフェイスを実装するアセンブリとその依存アセンブリが含まれています。
- 支払 Web ファイル – このフォルダには、支払受け入れページを有効にするために必要なコールバック HTML、JavaScript、または CSS ファイルが含まれています。 支払い受付ページで求められる場合、支払コネクタ開発者がこれらの Web ファイルを提供します。
- IPaymentDevice Assemblies – このフォルダーには、IPaymentDevice インターフェイスを実装するアセンブリと支払要求ハンドラー、およびインターフェイス依存アセンブリが含まれています。 これらのアセンブリは、VeriFone MX925 などの決済端末デバイスと通信するために、ハードウェア ステーションおよび Store Commerce アプリで使用されます。 支払のターミナル デバイスがない場合は、これらのファイルは必要ありません。
支払コネクタ ファイルをパッケージ化するには、\RetailSDK\ PaymentExternals のフォルダへ支払アセンブリをコピーする必要があります。 支払アセンブリがコピーされた後、Retail SDK フォルダーのルートから msbuild を使用し、配置可能なパッケージを生成します。 msbuild 操作が完了した後、\RetailSDK\Packages\ RetailDeployablePackage で配置可能パッケージを検索できます。
配置可能小売パッケージ – このパッケージには、支払およびその他のすべてのチャネル拡張コンポーネントが含まれています。 これは、すべての拡張コンポーネントの結合されたパッケージです。 RetailDeployablePackage には、次のコンポーネントの支払コネクタが含まれています。
- Commerce Scale Unit (CSU)
- 次のインストールを可能にするセルフ サービス インストーラー:
- Hardware Station
- Store Commerce アプリ
- Commerce Scale Unit (自己ホスト)
メモ
10.0.10 以前のリリースでは、AOS および CSU の両方に RetailDeployablePackage を配置できます。 その後のリリースでは、RetailDeployablePackage は CSU にのみ配置できます。 支払コネクタを AOS アプリケーション バージョン 10.0.10 以降に配置するには、セルフサービス配置のアプリケーション エクスプローラー用支払パッケージの作成 の情報に従ってください。
展開可能なパッケージのアップロードと展開
LCS プロジェクト ページを開きます。
追加ツール セクションで、アセット ライブラリをクリックします。
ソフトウェア パッケージ を選択し、プラス記号をクリックします (+)。
名前と説明を入力し、次の表に示すように、適切なパッケージ タイプを選択します。
配置可能パッケージ LCS の配置可能パッケージ タイプ RetailDeployablePackage.zip 結合されたコマース パッケージ アップロード をクリックします。
圧縮済みのパッケージを選択してアップロードし、確定 をクリックします。
配置可能パッケージを LCS 資産ライブラリにアップロードした後、LCS ポータルを通じて環境に配置することができます。 サンドボックス環境内の配置を検証した後は、運用環境を配置するサービス要求を作成できます。 詳細については、配置可能パッケージの適用 を参照してください。
クライアント コンピューターでインストーラーをダウンロードして実行
セルフサービス パッケージには、ハードウェア ステーションと Store Commerce アプリの両方のインストーラーが含まれています。 配置可能パッケージが環境に適用された後、更新されたハードウェア ステーションと Store Commerce アプリ インストーラーをダウンロードすることができます。
手動での配置
このセクションでは、支払コネクタを手動で展開する方法について説明します。 手動による展開を使用して、開発環境でローカルにテストすることができます。 この開発環境は、クラウドホスト型でも、ダウンロード可能な仮想ハード ディスク (VHD) 上でも構いません。 これらの手順は、サンドボックスまたは運用環境には適用されません。
支払コネクタ アセンブリとファイルを正しい場所に配置
支払コネクタはプラグ可能です。 開発環境では、サーバーの適切な場所に適切なファイルを配置できます。 次のテーブルは、どのファイルをどの場所に置くべきかを示しています。
| コネクタ | IPaymentProcessor Assemblies フォルダーのコンテンツ | 支払い Web ファイル フォルダーのコンテンツ | IPaymentDevice Assemblies フォルダーのコンテンツ |
|---|---|---|---|
| Commerce Scale Unit | <RS.WebRoot>/bin/ | 該当なし | 該当なし |
| Web 向け Store Commerce | 該当なし | <CPOS.WebRoot>/Connectors/ | 該当なし |
| リモート ハードウェア ステーション (インターネット インフォメーション サービス [IIS]) | <HWS.WebRoot>/bin/ | 該当なし | <HWS.WebRoot>/bin/ |
| Store Commerce アプリのローカル ハード ステーション (情報の保護とコントロール [IPC]) | <MPOS.AppRoot>/ClientBroker/ | 該当なし | <MPOS.AppRoot>/ClientBroker/ |
| E コマース | 該当なし | <ECOM.WebRoot>/Connectors/ | 適用できません |
上記のテーブルへのキーを次に示します。
- <RS.WebRoot> は、Commerce Scale Unit の Web アプリケーション ルートです。
- <HWS.WebRoot> は、リモート ハードウェア ステーションの Web アプリケーション ルートです。
- <MPOS.AppRoot> は Modern POS のアプリ インストール フォルダーです (例: C:\Program Files\Microsoft Dynamics 365\Store Commerce)。
- <ECOM.WebRoot> は、eコマース Web サイト の Web アプリケーション ルートです。
支払 Web ファイル フォルダーには通常、サブフォルダーが含まれます。 サブフォルダー全体をターゲットの場所にコピーしてください。
電子商取引サイトで支払コネクタを使用
E コマース サイトは、LCS の管理された環境では配置されていません。 パートナーと連携して、電子商取引サイトをホストする方法を決定する必要があります。 支払コネクタに支払 Web ファイルが必要とされる場合は、電子商取引にこれらの Web ファイルを配置する必要があります。 支払コネクタが、支払 Web ファイルを必要としない場合、追加の手順は必要ありません。 支払 Web ファイルを電子商取引サイトに配置する方法については、この記事の前半にある支払コネクタ アセンブリとファイルを正しい場所に配置するを参照してください。