次の方法で共有

Dynamics 365 支払データの使用

メモ

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

この記事では、Microsoft Dynamics 365 の支払いコネクタによって管理されるデータの概要について説明します。

重要な用語

用語 説明
カードあり カードあり という語は、販売時点管理 (POS) レジスターにおいてなど、物理的なカードが存在するトランザクションを処理するために支払コネクタを使用することを指します。
カードなし カードなし という語は、コール センターや E コマースにおいてなど、物理的なカードが存在しないトランザクションを処理するために支払コネクタを使用することを指します。

概要

この記事では、支払いコネクタによって管理されるデータに関して、次の領域に関する具体的な詳細について説明します。

カード提示シナリオで使用されるデータ

このセクションでは、カード提示のシナリオで支払いコネクタが受け取るすべてのデータ ポイントについて説明します。 支払いコネクタでは、データが使用されない場合があります。

支払コネクタ要求固有のデータ

BeginTransactionPaymentTerminalDeviceRequest (トランザクション開始支払い端末デバイスリクエスト)

フィールド 説明
商店情報 財務および運用クライアントの POS ハードウェア プロファイル ページで定義するマーチャント情報。
インボイス番号 POS が販売トランザクションを追跡するために生成する一意の請求書番号。

UpdateLineItemsPaymentTerminalDeviceRequest

フィールド 説明
合計金額 現在の販売トランザクションでの合計金額。
税額 現在の販売トランザクションでの税金額。
割引金額 現在の販売トランザクションでの割引金額。
小計金額 現在の販売トランザクションでの小計金額。
アイテム 製品名、数量、または計量単位など、製品に固有の詳細の一覧。

オーソライズペイメントターミナルデバイスリクエスト

フィールド 説明
金額 承認する金額。
通貨 承認する金額の通貨。
音声認証 音声承認が必要な場合に POS が送信する音声承認コード。

決済端末デバイス要求のキャプチャ

フィールド 説明
金額 キャプチャする金額。
通貨 取得する金額の通貨。
paymentPropertiesXml AuthorizePaymentTerminalDeviceRequest または RefundPaymentTerminalDeviceRequest が返す PaymentSdkData オブジェクトの内容。 このコンテンツは、要求間のステートフル プロパティをサポートします。 詳細については、この記事の後半の 「Payment SDK データ 」セクションを参照してください。

VoidPaymentTerminalDeviceRequest

フィールド 説明
金額 支払いが無効になる金額。
通貨 支払いを無効にするための通貨。
paymentPropertiesXml AuthorizePaymentTerminalDeviceRequest または RefundPaymentTerminalDeviceRequest が返す PaymentSdkData オブジェクトの内容。 このコンテンツは、要求間のステートフル プロパティをサポートします。 詳細については、この記事の後半の 「Payment SDK データ 」セクションを参照してください。

返金支払い端末デバイスリクエスト

フィールド 説明
金額 払い戻す金額。
通貨 払い戻す金額の通貨。

ActivateGiftCardPaymentTerminalRequest (ギフトカードペイメントターミナルリクエストをアクティベート)

フィールド 説明
金額 有効化中にギフト カードに追加する初期金額。
通貨 有効化中にギフト カードに追加する初期金額の通貨。

ギフトカード支払い端末残高追加リクエスト

フィールド 説明
金額 ギフト カード残高に追加される金額。
通貨 ギフト カード残高に追加する金額の通貨。

ギフトカード残高取得決済端末リクエスト

フィールド 説明
通貨 ギフト カード残高を取得するための通貨。

プライベート入札支払い端末デバイス要求取得

フィールド 説明
金額 POS で設定した金額。 通常、この変数を使用して、カード番号を取得するときに支払いターミナルの金額を表示します。

共有データ

SDK支払データ

フィールド 説明
承認された金額 トランザクションに対して承認する金額。
AvailableBalance カードの使用可能な残高。
承認コード トランザクションの承認コード。
プロバイダー取引ID (ProviderTransactionId) 支払いプロバイダーのトランザクション識別子。
認可結果 権限呼び出しの結果。
外部レシート 支払プロバイダーからの外部レシート データ。
TerminalId 支払を処理した端末の一意の識別子。

カードなしシナリオで使用されるデータ

このセクションでは、カードが存在しないシナリオで支払いコネクタに送信するデータについて説明します。 各コネクタが処理する特定のデータは異なり、指定されたコネクタでは、指定したすべてのデータが使用されない場合があります。

支払コネクタ方法固有のデータ

認証

名前空間 フィールド 説明
マーチャントアカウント MerchantId 財務および運用クライアントの POS ハードウェア プロファイル ページで定義されているマーチャント情報。
PaymentCard Last4Digits 支払いに使用されるカードの最後の 4 桁。
PaymentCard UniqueCardId 支払いに使用されるカードの一意のランダム化された識別子。
PaymentCard 有効期限年 支払いに使用されるカードの有効期限。
PaymentCard 有効期限月 支払いに使用されるカードの有効期限月。
PaymentCard 住所 支払いに使用されるカードに関連付けられている請求先住所の番地。
PaymentCard 市町村 支払いに使用されるカードに関連付けられている請求先住所の市区町村。
PaymentCard 状態 支払いに使用されるカードに関連付けられている請求先住所の州または都道府県。
PaymentCard 郵便番号 支払いに使用されるカードに関連付けられている請求先住所の郵便番号。
取引データ 業界タイプ 支払が発生したチャネルのタイプ (たとえば、小売、ダイレクト マーケティング、または電子商取引)。
取引データ AllowPartialAuthorization（部分的承認を許可） 部分的な承認がサポートされているかどうかを示す値。
取引データ 金額 トランザクションの合計金額。
取引データ 通貨コード トランザクションの通貨コード。
取引データ TerminalId トランザクションが発生した端末の一意の識別子。
PurchaseLevelData L2Data "レベル 2" データの一覧。 詳細については、この記事の後半の 「L2 データ 」セクションを参照してください。
PurchaseLevelData L3Data "レベル 3" データの一覧。 詳細については、この記事の後半の 「L3 データ 」セクションを参照してください。

Capture

名前空間 フィールド 説明
マーチャントアカウント MerchantId 財務および運用クライアントの POS ハードウェア プロファイル ページで定義されているマーチャント情報。
取引データ 金額 トランザクションの合計金額。
取引データ 通貨コード トランザクションの通貨コード。
購入レベルデータ L2Data "レベル 2" データの一覧。 詳細については、この記事の後半の 「L2 データ 」セクションを参照してください。
購入レベルデータ L3Data "レベル 3" データの一覧。 詳細については、この記事の後半の 「L3 データ 」セクションを参照してください。

無効

名前空間 フィールド 説明
マーチャントアカウント MerchantId 財務および運用クライアントの POS ハードウェア プロファイル ページで定義されているマーチャント情報。
取引データ 金額 トランザクションの合計金額。
トランザクションデータ 通貨コード トランザクションの通貨コード。

払戻

名前空間 フィールド 説明
マーチャントアカウント MerchantId 財務および運用クライアントの POS ハードウェア プロファイル ページで定義されているマーチャント情報。
PaymentCard Last4Digits 支払いに使用されるカードの最後の 4 桁。
PaymentCard UniqueCardId 支払いに使用されるカードの一意のランダム化された識別子。
PaymentCard 有効期限年 支払いに使用されるカードの有効期限。
PaymentCard 有効期限月 支払いに使用されるカードの有効期限月。
PaymentCard 住所 支払いに使用されるカードに関連付けられている請求先住所の番地。
PaymentCard 市町村 支払いに使用されるカードに関連付けられている請求先住所の市区町村。
PaymentCard 状態 支払いに使用されるカードに関連付けられている請求先住所の州または都道府県。
PaymentCard 郵便番号 支払いに使用されるカードに関連付けられている請求先住所の郵便番号。
トランザクションデータ 業界タイプ 支払が発生したチャネルのタイプ (たとえば、小売、ダイレクト マーケティング、または電子商取引)。
トランザクションデータ AllowPartialAuthorization（部分的承認を許可） 部分的な承認がサポートされているかどうかを示す値。
処理データ 金額 トランザクションの合計金額。
トランザクションデータ 通貨コード トランザクションの通貨コード。
取引データ TerminalId トランザクションが発生した端末の一意の識別子。
PurchaseLevelData L2Data "レベル 2" データの一覧。 詳細については、この記事の後半の 「L2 データ 」セクションを参照してください。
PurchaseLevelData L3Data "レベル 3" データの一覧。 詳細については、この記事の後半の 「L3 データ 」セクションを参照してください。

支払い受諾ポイントを取得

名前空間 フィールド 説明
マーチャントアカウント MerchantId 財務および運用クライアントの POS ハードウェア プロファイル ページで定義されているマーチャント情報。
PaymentCard Name カード所有者の名前。
PaymentCard 住所 支払いに使用されるカードに関連付けられている請求先住所の番地。
PaymentCard 市町村 支払いに使用されるカードに関連付けられている請求先住所の市区町村。
PaymentCard 状態 支払いに使用されるカードに関連付けられている請求先住所の州または都道府県。
PaymentCard 郵便番号 支払いに使用されるカードに関連付けられている請求先住所の郵便番号。
PaymentCard 国/地域 支払いに使用されるカードに関連付けられている請求先住所の国/地域。
PaymentCard 配送先と同じ住所を表示 請求先住所が出荷先住所と同じかどうかを識別する値。
取引データ 業界タイプ 支払が発生したチャネルのタイプ (たとえば、小売、ダイレクト マーケティング、または電子商取引)。
取引データ AllowPartialAuthorization（部分的承認を許可） 部分的な承認がサポートされているかどうかを示す値。
取引データ 通貨コード トランザクションの通貨コード。
取引データ TerminalId トランザクションが発生した端末の一意の識別子。

共有データ

L2 データ

メモ

この動作がコマース クライアント内の対応するコネクタ構成を通じて明示的に構成されている場合にのみ、L2 データがコネクタに送信されます。

名前空間 フィールド 説明
L2Data OrderDateTime 注文が発生した日時。
L2Data 注文番号 注文に関連付けられている注文番号。
L2Data 請求書日付時間 注文が請求された日時。
L2Data 請求書番号 注文の請求書番号。
L2Data 注文説明 注文の説明。
L2Data 概要商品コード 製品に関連付けられている商品コード。
L2Data MerchantContact 販売者の連絡先情報。
L2Data MerchantTaxId 販売者の一意の税 ID。
L2Data マーチャントタイプ 支払い処理者によって管理される一意のマーチャント識別子。
L2Data 購入者ID 購入者の一意の識別子。
L2Data 購入者税務ID 購入者の一意の税識別子。
L2Data 配送先市区町村 出荷先住所の市町村。
L2Data ShipToCounty 出荷先住所の市区郡。
L2Data ShipToState_Provinceコード 出荷先住所の都道府県コード。
L2Data 配送先郵便番号 出荷先住所の郵便番号。
L2Data 配送先国コード (ShipToCountryCode) 配送先住所の国/地域コード。
L2Data ShipFromCity 注文が出荷される住所の市区町村。
L2Data ShipFromCounty 注文が出荷する住所の郡。
L2Data ShipFromState_ProvinceCode 注文が出荷される住所の州コードまたは都道府県コード。
L2Data ShipFromPostalCode (発送元郵便番号) 注文の発送先住所の郵便番号。
L2Data 発送元国コード 注文が出荷される住所の国/地域コード。
L2Data ディスカウント額 注文の特定の品目部分に適用される割引額。
L2Data MiscCharge 注文の特定の品目部分に適用されるその他の料金。
L2Data 義務金額 注文の特定の品目部分に適用される関税額。
L2Data 輸送額 注文の特定の品目部分に適用される運送料。
L2Data HandlingCharge 注文の特定の品目部分に適用される処理料金。
L2Data 課税対象かどうか 注文の特定の明細行品目の部分が課税対象であるかどうかを識別する値。
L2Data 合計税額 注文の特定の品目部分に適用される合計税額。
L2Data TotalTaxRate 注文の特定の品目部分に適用される税率の合計。
L2Data マーチャント名 販売者の名前。
L2Data MerchantCity 販売者の住所の市町村。
L2Data MerchantState 販売者の住所の都道府県。
L2Data MerchantCounty 販売者の住所の市区郡。
L2Data 加盟店国コード 販売者の住所の国/地域コード。
L2Data MerchantZip 販売者の住所の郵便番号。
L2Data 税率 注文の特定の品目部分に適用される税率。
L2Data 税額 注文の特定の品目部分に適用される税額。
L2Data 税の説明 注文の特定の品目部分に適用される税金の説明。
L2Data 税タイプ識別子 注文の特定の品目部分に適用される税金の型識別子。
L2Data RequesterName 要求者の名前。
L2Data 合計金額 注文の特定明細行の合計金額。
L2Data 購入カードの種類 購入者のカードの種類。
L2Data AmexLegacyDescription1 従来の American Express 用 説明フィールド 1。
L2Data AmexLegacyDescription2 従来の「American Express 説明フィールド 2」。
L2Data AmexLegacyDescription3 レガシー American Express 説明フィールド 3。
L2Data AmexLegacyDescription4 American Express 従来の説明フィールド4。
L2Data TaxDetails[].TaxRate 注文の特定の品目部分に適用される個々の税率の一覧。
L2Data 税詳細[].税の説明 注文の特定の品目部分に適用される税金の個々の説明の一覧。
L2Data TaxDetails[].税額 注文の特定の品目部分に適用される個々の税額の一覧。
L2Data TaxDetails[].税タイプ識別子 注文の特定の品目部分に適用される税金の型識別子の一覧。
L2Data MiscellaneousCharges[].ChargeType 注文の特定の品目部分に適用される請求タイプの一覧。
L2Data MiscellaneousCharges[].ChargeAmount 注文の特定の品目部分に適用される請求金額の一覧。

L3 データ

メモ

L3 データは、Commerce クライアントの対応するコネクタ構成を使用してこの動作を明示的に構成した場合にのみ、コネクタに送信します。

名前空間 フィールド 説明
L3Data シーケンス番号 注文の品目の順序番号。
L3Data コモディティコード 製品に関連付けられている商品コード。
L3Data プロダクトコード 製品の一意のコード。
L3Data ProductName 製品の名称。
L3Data 製品SKU 製品の在庫管理単位 (SKU)。
L3Data Descriptor 製品の説明。
L3Data 計量単位 製品の測定単位。
L3Data 単価 製品の単価。
L3Data 割引 製品に適用される割引。
L3Data 割引率 製品に適用される割引率。
L3Data 件数 製品の数量。
L3Data MiscCharge 製品の雑費。
L3Data NetTotal 製品の正味合計額。
L3Data 税額 製品の税額。
L3Data 税率 製品の税率。
L3Data 合計金額 製品の合計金額。
L3Data CostCenter 製品のコスト センター。
L3Data 運送料 製品の配送料。
L3Data ハンドリング料 製品の取扱量。
L3Data 運送業者追跡番号 出荷される製品の運送業者追跡番号。
L3Data MerchantTaxID 販売者の一意の税 ID。
L3Data 商品カタログ番号 販売者のカタログ番号。
L3Data 適用された税区分 製品に適用される税カテゴリ。
L3Data 受取先住所 集荷元住所の番地。
L3Data PickupCity 集荷元住所の市町村。
L3Data PickupState 集荷元住所の都道府県。
L3Data PickupCounty 集荷元住所の地区。
L3Data PickupZip 集荷元住所の郵便番号。
L3Data 引取国 集荷先住所の国/地域。
L3Data 受け取り日時 集荷の日時。
L3Data ピックアップ記録番号 集荷の伝票番号。
L3Data 運送業者出荷番号 配送業者の出荷番号。
L3Data UNSPSCコード United Nations Standard Products and Services Code (UNSPSC)。
L2Data TaxDetails[].TaxRate 注文の特定の品目部分に適用される個々の税率の一覧。
L2Data 税詳細[].税の説明 注文の特定の品目部分に適用される税金の個々の説明の一覧。
L2Data TaxDetails[].税額 注文の特定の品目部分に適用される個々の税額の一覧。
L3Data TaxDetails[].TaxTypeIdentifier 注文の特定の品目部分に適用される税金の型識別子の一覧。
L3Data MiscellaneousCharges[].ChargeType 注文の特定の品目部分に適用される請求タイプの一覧。
L3Data MiscellaneousCharges[].ChargeAmount 注文の特定の品目部分に適用される請求金額の一覧。

その他のリソース

支払端末のエンド・ツー・エンド支払統合を作成する

  • Last updated on