購入保護スキーマを表示する

  • [アーティクル]

この記事では、Microsoft Dynamics 365 Fraud Protection に一括アップロードされるリアルタイム API と履歴データのスキーマについて説明します。 アップロード手順の詳細については、「履歴データのアップロード」を参照してください。 アプリケーション プログラミング インターフェイス (API) を介してデータが取り込まれる場合は、「Dynamics 365 Fraud Protection リアルタイム API の統合」を参照してください。

次の要件に従います。

  • ファイルは CSV UTF-8 (コンマ、セミコロン、またはタブ区切り) 形式 (*.csv または *.tsv) です。
  • 最大ファイル サイズは 10 ギガバイト (GB) です。
  • コンマ/セミコロン、改行文字、および複数行文字は、すべての列でエスケープされます。
  • 'datetime' 列は ISO 8601 形式です。 たとえば、C# DateTime.UtcNow.ToString("o") の形式 は "2019-03-14T20:18:11.254Z" になります。
  • 'double' (decimal) 列の有効桁数は小数点以下 2 桁です。

トランザクション

評価および保護エクスペリエンスでは、次のスキーマが使用されます。

購入

属性 Type 説明
PurchaseId String トランザクション (または発注書) の識別子。
OriginalOrderId String 月次サブスクリプションの請求など、定期請求の支払いの元の注文識別子。
CustomerLocalDate DateTime 顧客のローカル タイム ゾーンでの購入の作成日。 形式は ISO 8601 です。
MerchantLocalDate DateTime マーチャントのローカル タイム ゾーンでの購入インジェスト日。 形式は ISO 8601 です。
TotalAmount 倍精度浮動小数点型 税金を含む顧客に請求された合計金額。 この情報はマーチャントから提供されます。
SalesTax 倍精度浮動小数点型 トランザクションに対して請求された売上税。 この情報はマーチャントから提供されます。
通貨 String 3 文字の通貨コードとしての元の購入の通貨 (たとえば 、OANDA 通貨コードと一致する USD)。 この情報はマーチャントから提供されます。
DeviceContextId String イベントのセッションのセッション ID (Microsoft Device Fingerprinting によって提供されます) またはセッションが使用できない場合はトランザクション ID。
IPAddress String 顧客の IP アドレス。 この情報は、Microsoft デバイスフィンガープリントによって提供されます。
UserId String 顧客 ID。 この情報はマーチャントから提供されます。 この属性は必須です。
UserFirstName String 顧客が指定した顧客アカウントの名。
UserLastName String 顧客が指定した顧客アカウントの姓。
UserEmail String 顧客のメールアドレス。 この値は大文字と小文字を区別しません。
UserCreationDate DateTime 顧客アカウントの作成日。 形式は ISO 8601 です。
UserUpdateDate DateTime 顧客データが最後に変更された日付。 形式は ISO 8601 です。
UserZipCode String 顧客の郵便番号。
UserCountryCode String 顧客の国または地域。 値は、2 文字の国または地域コード (例: US) である必要があります。
UserTimeZone String 空の文字列。
UserLanguage String 顧客の言語と言語の地域 (例: EN-US)。
User電話Number String 顧客の電話番号。 形式は、国または地域コードの後にハイフン (-) を付け、電話番号 (たとえば、米国の場合は +1-1234567890) にする必要があります。
IsEmailValidated Boolean True/False の値は、顧客が指定した電子メール アドレスが顧客の所有として検証されているかどうかを示します。
ShippingFirstName String アドレスに指定された名。
ShippingLastName String アドレスに指定された姓。
Shipping電話Number String アドレスに指定された電話番号。 形式は、国または地域コードの後にハイフン (-) を付け、電話番号 (たとえば、米国の場合は +1-1234567890) にする必要があります。
Street1 String 住所に提供された最初の行。
Street2 String 住所に提供された 2 番目の行。 (この値を空白にすることはできません。)
Street3 String 住所に提供された 3 番目の行。 (この値を空白にすることはできません。)
City (市) String 住所に提供された都市。
状態 String 住所に提供された都道府県。
ZipCode String 住所に提供された郵便番号。
CountryCode String 住所に指定された国または地域コード。 値は、2 文字の ISO 国または地域コード (例: US) である必要があります。
CustomData Object オプションのユーザー定義 JavaScript Object Notation (JSON) プロパティ バッグ。 これは、API 呼び出しがインスタンス化されるときに入力されます。 この属性は、購買ルールを作成するときに参照できます。

注:

  • サポートされているプリミティブ型は、String (Unicode)、Int32、UInt32、Double、Boolean、DateTime (.NET セマンティクスに準拠した世界協定時刻 (UTC) 単位) です。
  • 文字列データの制限は 256 文字です。
  • ペイロードあたり 100 個のカスタム属性の制限があります。
  • 機密性の高いデータ型や高度に規制されたデータ型を送信しないでください。 次に例をいくつか示します。
    • 保護されたクラス (性別や人種など) またはプライベート/機密性の高いカテゴリ (宗教的見解や性的指向など) を示すデータ
    • 生体認証データまたは正常性に関連するデータ
  • カスタム データ保持ポリシーは、購入イベント (6 か月) のアイテム保持ポリシーと一致します。

Fraud Protection のカスタム データ オブジェクトで購入 API を使用する方法を示すサンプルについては、この記事の最後にある「カスタム データサンプル」セクションを参照してください。
MerchantBusinessType String ビジネスまたは業界の垂直 (ゲーム、小売、ダイニング、ソーシャル ネットワーキングなど)。
MerchantIdentifier String マーチャント ID (MID) は、取引に関係する支払処理システムに、どの資金を送信するかを示す、ビジネスに関連付けられている特定の ID 番号です。 ビジネスの住所と考えることができます。 たとえば、マーチャント ID がない場合、関係するネットワークは送金先を知りません。
MerchantCategoryCode String マーチャント カテゴリ コード (MCC) は、小売金融サービスの ISO 18245 に記載されている 4 桁の番号です。 MCC は、提供する商品またはサービスの種類によってビジネスを分類するために使用されます。
MerchantBusinessSegment String 確立された独立した製品ライン、事業ライン、または子ブランド (Xbox や Surface など) があるマーチャントの全体的な操作のサブセクション。
MerchantProductCategory String マーチャント定義の製品またはサービス カテゴリ。
StoreId String ストアの識別子。
StoreName String ストアの表示名。
StoreAddress String 店舗の完全な住所 (番地、市区町村、都道府県、zip)。
IsTest Boolean トランザクションが運用環境のテストであるかどうかを示す値。
IsFreeProductIncluded Boolean 空き製品がトランザクションに含まれるかどうかを示す値。
IsGuestCheckout Boolean 購入がゲストとして行われたかどうかを示す値。
IsPostAuthCheck Boolean 認証後のチェックがあったかどうかを示す値。
IsRecurringCharge Boolean トランザクションがサブスクリプション/定期的であるかどうかを示す値。
RecurringChargeFrequencyInDays 倍精度浮動小数点型 定期的な購入が請求される頻度 (たとえば、30 日ごと、半期ごと、毎年など)。
RecurringChargeStartDate DateTime 定期的なトランザクションの開始日。
RecurringChargeEndDate DateTime 定期的なトランザクションの終了日。
IsPostpaid Boolean トランザクションが後払いであるかどうかを示す値。
DiscountAmount 倍精度浮動小数点型 トランザクションに適用される割引額。 たとえば、ユーザーが同じ XBOX コントローラーを 10 個購入した場合、この項目は 1 になります。 または、ユーザーが 5 つの異なるゲームと同じ XBOX コントローラーの 10 を購入した場合、このアイテムは 5 + 1 または 6 になります。
TipAmount 倍精度浮動小数点型 トランザクションに適用されるチップの金額。
DistinctItemCount 倍精度浮動小数点型 トランザクションあたりの個別/一意の項目数。
TotalItemCount 倍精度浮動小数点型 トランザクションあたりのアイテム数の合計。 たとえば、ユーザーが同じ XBOX コントローラーを 10 個購入した場合、この項目は 10 になります。 または、ユーザーが 5 つの異なるゲームと同じ XBOX コントローラーの 10 を購入した場合、このアイテムは 5 + 10 または 15 になります。
IsLowLiabilityPIType Boolean 低い負債の支払い方法 (Apple Pay、Alipay、UnionPay など) を示す値。
OrderType String トランザクションの種類 (例: takeout)。
IsRetryOrder Boolean 注文が再試行されたかどうかを示す値。
AttemptId String 各トランザクション再試行の識別子。
ShippingDate DateTime 注文が出荷された日付。
OrderInitiatedChannel String トランザクションが作成されたチャネル (例: 'AppStore'、'Web'、MobileWeb、'App'、'InGamePurchase')。
OrderInitiatedChannelName String トランザクションが作成されたアプリ名または Web URL。
OrderInitiatedChannelRegionORCountry String トランザクションが作成された市場 (例: アプリ 市場)。
MerchantBusinessSubSegmentL2 String 第 2 レベル (L2) のビジネスまたは業界セグメント。
MidName String MID (マーチャント ID) に関連付けられたマーチャント名。
TransactionProcessingOrder String トランザクション フロー中に不正評価が行われた順序。
RecurringSubscriptionId String 定期料金の一意の ID
RecurringChargeSequence Int32 この顧客に対して定期的な請求が発生した n 回目 (1、2、3...)。
TransactionDescription String トランザクション処理の種類
OrganizationLevel1 Object 組織階層の最上位レベル。
OrganizationLevel2 Object 組織階層の中間レベル。
OrganizationLevel3 Object 組織階層の最下位レベル。
ThreeDS Object ThreeDS セクションを参照してください。
RecipientUser Object 「ユーザー」セクションを参照してください。
TravelOverview Object 垂直固有の属性 TravelOverview セクションを参照してください。
CloudBusiness Object 「CloudBusiness」セクションの「垂直方向固有の属性」を参照してください。
MembershipType String 顧客のメンバーシップ ステータスまたはタイプ。 プレミアムやエグゼクティブなど、さまざまなレベルを指定できます。
AuthenticationMethod String 購入前/購入中に顧客が認証された方法。
LoginInputMethod String 顧客が自分の資格情報を入力する方法。
LastPasswordUpdatedDate DateTimeOffset 顧客のパスワードが最後に更新された日時。
FirstPurchaseDate DateTimeOffset 顧客が最初に購入した時点
LoginChallengeType String 開始されたチャレンジ/レスポンス テストのタイプ。
HttpSignature String HTTP メッセージのデジタル署名。
HttpUserAgent String アプリケーション、オペレーティング システム、ベンダー、バージョンを識別するために使用される要求ヘッダー。
BrowserHeader String ブラウザによって送信された要求ヘッダーの完全なリスト。
BrowserResolution String ブラウザーの解像度。
BrowserLanguage String ブラウザーの既定の言語設定。
TcpSignature String TCP アプリケーション署名。
SslSignature String SSL 署名。
EnabledCookies Boolean Cookie が有効かどうかを示す True/False 値。
EnabledFlash Boolean Flash が有効かどうかを示す True/False 値。
EnabledJavaScript Boolean JavaScript が有効かどうかを示す True/False 値。
ScreenAspectRatio String ブラウザーの縦横比。
ScreenColorDepth String 画面の色深度。
ScreenResolution String ピクセル単位のデバイス画面の解像度
SiteHostName String サイトのホスト名。
OS String デバイスのオペレーティング システム。
OSFonts String オペレーティング システムの既定フォント。
DeviceProcessor String デバイス プロセッサ。
SessionId String 一意のセッション ID。
TrueIp String デバイスフィンガープリントによって識別されるデバイスの真の IP アドレス
ProxyIp String プロキシ デバイスの IP アドレス。
DeviceId String デバイスのフィンガープリントによって生成されたデバイスごとの一意の GUID
TimeZone String GMT に関するローカル タイムゾーンのオフセット (時間単位)
UserAgentDetails String 追加のユーザー エージェントまたはブラウザーの詳細。
AppVersion String アプリケーションのバージョン。
BrowserPackagesList String デバイスにインストールされているパッケージのリスト。
BuildManufacturer String デバイスの製造元。
BuildModel String エンド プロダクトのユーザー表示名。
BuildSdkVersion String ビルド バージョン。
DataNetworkType String モバイル データ ネットワークのタイプ。
DeviceModelName String デバイス モデル。
DeviceSystemName String マシンのデバイス名。
DeviceSystemVersion String デバイスのバージョン。
IsBluetoothEnabled Boolean Bluetooth が有効になっているかどうかを示す True/False 値。
SimNetworkCountryISO String モバイル サービス プロバイダーの ISO 国コード。
SimNetworkType String モバイル ネットワーク タイプ。
SystemUpTime String デバイスが動作していて利用可能である期間。
PaymentMethod String トップレベルの支払い方法のカテゴリ。
IsLowLiabilityPIType Boolean 支払い方法が低責任であるかどうかを示す True/False 値。
HolderCompanyName Boolean ビジネス カードまたは会社カードを提供している組織の名前 (ビジネス購入の場合のみ)。
SettlementApprovalRequired Boolean Standard Edition PA トランザクションに承認が必要かどうかを示す True/False 値です。
PaymentCheckoutProvider String eWallet チェックアウト プロバイダー。
BinName String BIN 表示名。
BinCountryISO String BIN に関連付けられている ISO 国コード。
BinCardType String BIN カードのタイプ。
BinCardAssociation String BIN カードの関連付け。
BinBankGroup String BIN 銀行グループ。
通貨 String 選択した支払い方法の通貨コード。
IsInternationalMoneyTransfer Boolean 国際送金が行われたかどうかを示す True/False 値。
BankIdentifierCode String 銀行識別コード (BIC または SWIFT コード)
BankName String 銀行名。
BankZipCode String 銀行の郵便番号。
BankState String 銀行の状態。
BankCountryISO String 銀行 ISO の国。
PaymentCollectionDate DateTimeOffset 支払い回収の予定日 (主に支払いサービス プロバイダーに使用されます)。
InstantPaymentSettlement Boolean 銀行のリダイレクトを示す True/False 値 (CSV 支払いをサポートするために使用)。
AutoCaptureEnabled Boolean カード支払いのために支払いが自動的に取得されたかどうかを示す True/False 値。 リダイレクト支払いの場合、これは単に、資金を自動的に引き出すかどうかをパートナー銀行に示すものです。
[AccountType] String トランザクションに対して請求するアカウントのタイプを示します。 既定値は UNSPECIFIED です。 CHEQUE_ACCOUNT は、カードをデビット カードとして使用します。 CREDIT_FACILITY は、カードをクレジット カードとして使用します。
AuthorizationType String 承認タイプ。 Mastercard と Visa は、承認の試行を事前承認または最終承認のいずれかとして定義することを加盟店に要求するようになりました。
AuthorizationResultCode String 認証決定からの銀行の応答。
AuthorizationResultText String 承認決定の理由 (特に、拒否されたトランザクションまたは保留中のトランザクションの場合)。
AcquirerId String 機関識別コードの取得。
AcquirerCountryISO String 教育機関の国コードを取得する。
CvvVerify String CVV 検証が使用可能かどうか、または正常に検証されたかどうかを示します。
  • Y = 正常に検証されました
  • N = 正常に検証されませんでした
  • U = 使用不可
  • A = 使用可能ですが、検証なし
AvsVerify String アドレスの検証が使用可能かどうか、または正常に検証されたかどうかを示します。
  • Y = 正常に検証されました
  • N = 正常に検証されませんでした
  • U = 使用不可
  • A = 使用可能ですが、検証なし
CavVerify String カード所有者認証の検証が使用可能であるか、正常に検証されたかを示します。
  • Y = 正常に検証されました
  • N = 正常に検証されませんでした
  • U = 使用不可
  • A = 使用可能ですが、検証なし
EncryptedCreditCardNumber String ハッシュまたは暗号化されたクレジット カード番号。
OrganizationId String マーチャントまたは組織の一意識別子。
名前 String 組織の名前です。
ZipCode String 組織が配置されている郵便番号。
状態 String 組織が配置されている状態。
CountryISO String 組織が配置されている国の ISO コード。
ProductBrand String 製品のブランド名。
BuyItAgainOrder Boolean ユーザーが (その注文の製品だけでなく) 前の注文を再注文する場合は True。
PreOrderAvailabilityDate DateTimeOffset 製品が最初に予約注文に使用できるようになったとき。
TerminalId String 販売時点管理ターミナルの一意識別子。
TerminalName String 販売時点管理ターミナル名。
IsThreeDSAuth Boolean このトランザクションが 3DS を介して認証されているかどうかを示す True/False 値。
MessageCategory String 特定のユース ケースのメッセージのカテゴリを識別します。
DeviceChannel String トランザクションの開始に使用されているチャネル インターフェイスのタイプを示します。
ThreeDSServerTransId String 単一のトランザクションを識別するために 3DS サーバーによって割り当てられた普遍的に一意のトランザクション識別子。
ThreeDSRequestorAuthenticationInd String 認証要求の種類を示します。
ThreeRIInd String 3RI リクエストのタイプを示します。
ThreeDSReqPriorAuthMethod String カード所有者が以前に 3DS リクエスターに対して認証するために使用したメカニズム。
TransStatus String トランザクションが認証済みトランザクションまたはアカウント検証のどちらとして適格かを示します。
TransStatusReason String [トランザクション ステータス] フィールドに指定された値がある理由に関する情報を提供します。
ThreeDSCompInd String 3DS メソッドが正常に完了したかどうかを示します。
AcsChallengeMandated String ローカル/地域の委任またはその他の変数により、トランザクションを承認するためにチャレンジが必要かどうかを示します。
ThreeDSRequestorChallengeInd String このトランザクションに対してチャレンジが要求されているかどうかを示します。
ChallengeCompletionInd String ACS チャレンジ サイクルの状態、およびチャレンジが完了したか、追加のメッセージが必要かどうかを示すインジケータ。
受け入れられる値:
Eci String 電子商取引インジケーター (ECI)。 カード所有者の認証の試みの結果を示すために ACS または DS によって提供される支払いシステム固有の値。
ShipNameIndicator String アカウントのカード所有者名が、このトランザクションに使用された配送名と同じかどうかを示します。
SuspiciousAccActivity String 3DS 要求者が、カード所有者アカウントで不審なアクティビティ (以前の不正行為を含む) を経験したかどうかを示します。
ChAccPwChangeInd String 3DS リクエスタを持つカード所有者のアカウントがパスワードの変更またはアカウントのリセットを行ってからの時間を示します。
ChAccAgeInd String カード所有者が 3DS リクエスタとのアカウントを持っていた時間の長さ。
ProvisionAttemptsDay String 過去 24 時間のカードの追加試行回数。
長さ: 最大 3 文字。

値の例:
  • 2
  • 02
  • 002
ExemptionRaised String

PSD2 除外要求。

  • Y - 除外
  • N- 適用除外なし

PaymentInstruments

属性 Type 説明
PurchaseId String トランザクション (または発注書) の識別子。
MerchantPaymentInstrumentId String 支払い方法の ID。 この情報はマーチャントから提供されます。 これは必須の属性です。
種類 String 支払いのタイプ。 詳細については、「Dynamics 365 Fraud Protection API」を参照してください。
PurchaseAmount 倍精度浮動小数点型 トランザクションにこの支払方法を使用する合計購入金額。
CreationDate DateTime マーチャントのシステムでの支払い方法の最初のエントリの日付。 形式は ISO 8601 です。
UpdateDate DateTime マーチャントのシステムでの支払い方法の前回の更新の日付。 形式は ISO 8601 です。
CardType String この属性は、クレジットカードタイプの支払いに対してのみ使用されます。
HolderName String 支払い方法の顧客の名前。 この属性は、クレジットカードタイプの支払いに対してのみ使用されます。
BIN String この属性は、クレジットカードタイプの支払いに対してのみ使用されます。
ExpirationDate String マーチャントのシステムでの支払い方法の有効期限。 形式は ISO 8601 です。 この属性は、クレジットカードタイプの支払いに対してのみ使用されます。
LastFourDigits String この属性は、クレジットカードタイプの支払いに対してのみ使用されます。
メール String 支払い方法に関連付けられている電子メール アドレス。 この属性は、Pay 型の支払いにのみ使用されます。
BillingAgreementId String この属性は、Pay 型の支払いにのみ使用されます。
PayerId String この属性は、Pay 型の支払いにのみ使用されます。
PayerStatus String PayPal が支払人を認証したかどうかを示す値。 この属性は、Pay 型の支払いにのみ使用されます。
AddressStatus String PayPal が支払人の住所を認証したかどうかを示す値。 この属性は、Pay 型の支払いにのみ使用されます。
IMEI String この属性は、Mobilepayment タイプの支払いに対してのみ使用されます。
FirstName String アドレスに指定された名。
姓 String アドレスに指定された姓。
電話番号 String アドレスに指定された電話番号。 形式は、国または地域コードの後にハイフン (-) を付け、電話番号 (たとえば、米国の場合は +1-1234567890) にする必要があります。
Street1 String 住所に提供された最初の行。
Street2 String 住所に提供された 2 番目の行。 (この値を空白にすることはできません。)
Street3 String 住所に提供された 3 番目の行。 (この値を空白にすることはできません。)
City (市) String 住所に提供された都市。
状態 String 住所に提供された都道府県。
ZipCode String 住所に提供された郵便番号。
CountryCode String 住所に提供された国/リージョン コード。 値は、2 文字の ISO 国または地域コード (例: US) である必要があります。
PISource String 支払い方法のソース (CustomerInput、FromSavedProfile、MobilePay など)。

製品

属性 Type 説明
PurchaseId String トランザクション (または発注書) の識別子。
製品 ID String 製品識別子。 これは必須の属性です。
PurchasePrice 倍精度浮動小数点型 購入の品目の価格。
Margin String アイテムの販売によって得られた余白。
数量 （Quantity） Int32 購入された商品の数です。
ProductName String 顧客が読み取り可能な製品名。
種類 String 商品が物理的かデジタルかを示す値。
カテゴリ String 製品のカテゴリ (例: アパレル、 靴、 アクセサリ)。
マーケット String 製品が提供される市場。 値は、2 文字の ISO 国または地域コード (例: US) である必要があります。
Sku String 製品の在庫保管単位 (SKU)。
SalesPrice 倍精度浮動小数点型 税金を除いて販売された品目の価格。 この情報はマーチャントから提供されます。
通貨 String 3 文字の通貨コードとしての元の購入の通貨 (たとえば 、OANDA 通貨コードと一致する USD)。 この情報はマーチャントから提供されます。
COGS 倍精度浮動小数点型 販売された商品の原価 (つまり、品目の原材料原価)。 この情報はマーチャントから提供されます。
IsRecurring Boolean 製品が定期的なサブスクリプションであるかどうかを示す値。
IsFree Boolean 製品が無料で提供されるかどうかを示す値。
Language String 言語と言語の地域 (例: EN-US)。

チャージバック

評価および保護エクスペリエンスでは、次のスキーマが使用されます。

属性 Type 説明
ChargebackId String チャージバック識別子。
理由 String 銀行によって提供された理由。
状態 String ステータス 詳細については、「Dynamics 365 Fraud Protection API」を参照してください。
BankEventTimestamp DateTime 銀行からのタイムスタンプ。 形式は ISO 8601 です。
量 倍精度浮動小数点型 チャージバック金額。
通貨 String チャージバック金額に使用される通貨。
UserId String 顧客 ID。
PurchaseId String トランザクション (または発注書) の識別子。
MerchantLocalDate DateTime マーチャントのローカル タイム ゾーンでの購入インジェスト日。 形式は ISO 8601 です。

返金

評価および保護エクスペリエンスでは、次のスキーマが使用されます。

属性 Type 説明
RefundId String 払い戻し識別子。
理由 String 顧客が指定した理由。
状態 String 払い戻しの状態。 詳細については、「Dynamics 365 Fraud Protection API」を参照してください。
BankEventTimestamp DateTime 銀行からのタイムスタンプ。 形式は ISO 8601 です。
量 倍精度浮動小数点型 払い戻し金額。
通貨 String 販売価格の金額に使用される通貨。
UserId String 顧客 ID。 これは必須の属性です。
PurchaseId String トランザクション (または発注書) の識別子。
MerchantLocalDate DateTime ISO 8601 形式の日付。

PurchaseStatus

評価および保護エクスペリエンスでは、次のスキーマが使用されます。

属性 Type 説明
PurchaseId String トランザクション (または発注書) の識別子。
StatusType String 状態の種類。 詳細については、「Dynamics 365 Fraud Protection API」を参照してください。
StatusDate DateTime ステータスが適用された日時。 形式は ISO 8601 です。
理由 String 状態遷移の理由。
MerchantLocalDate DateTime ISO 8601 形式の日付。

BankEvents

評価および保護エクスペリエンスでは、次のスキーマが使用されます。

属性 Type 説明
BankEventId String 銀行イベント識別子。
種類 String 銀行イベントの種類。 詳細については、「Dynamics 365 Fraud Protection API」を参照してください。
BankEventTimestamp DateTime 銀行からのタイムスタンプ。 形式は ISO 8601 です。
状態 String ステータス 詳細については、「Dynamics 365 Fraud Protection API」を参照してください。
BankResponseCode String 応答の銀行コード。
PaymentProcessor String プロセッサ名 (FDC や PayPal など)。
MRN String マーチャント側の取引を識別するために使用されるマーチャント参照番号 (MRN)。
MID String 銀行の通信に使用されるマーチャント ID (MID)。
PurchaseId String トランザクション (または発注書) の識別子。
MerchantLocalDate DateTime ISO 8601 形式の日付。
MerchantPaymentInstrumentId String 複数の PI シナリオと PI 変更シナリオ。
PaymentMethod String お支払い方法のグループ化/カテゴリ。
CardType String 支払いのタイプ。
UpdatedPI String 購入で使用した PI とは異なる PI を使用しましたか?
CvvVerify String CVV 検証が使用可能かどうか、または正常に検証されたかどうかを示します。
  • Y = 正常に検証されました
  • N = 正常に検証されませんでした
  • U = 使用不可
  • A = 使用可能ですが、検証なし
AvsVerify String アドレスの検証が使用可能かどうか、または正常に検証されたかどうかを示します。
  • Y = 正常に検証されました
  • N = 正常に検証されませんでした
  • U = 使用不可
  • A = 使用可能ですが、検証なし
CavVerify String カード所有者認証の検証が使用可能であるか、正常に検証されたかを示します。
  • Y = 正常に検証されました
  • N = 正常に検証されませんでした
  • U = 使用不可
  • A = 使用可能ですが、検証なし
AuthorizationResultCode String 認証決定からの銀行の応答。
AuthorizationResultText String 承認決定の理由。特に拒否または保留中のトランザクションの場合。
ThreeDS String 購入シートの「3DS の購入」セクションを参照してください。

アカウント

評価および保護エクスペリエンスでは、次のスキーマが使用されます。

UpdateAccount

属性 Type 説明
CustomerLocalDate DateTime ISO 8601 形式の日付。
UserId String 顧客 ID。 これは必須の属性です。
UsercreationDate DateTime ISO 8601 形式の日付。
UserupdateDate DateTime ISO 8601 形式の日付。
FirstName String 顧客が指定した顧客アカウントの名。
姓 String 顧客が指定した顧客アカウントの姓。
CountryCode String 顧客の国または地域。 値は、2 文字の国または地域コード (例: US) である必要があります。
ZipCode String 顧客の郵便番号。
TimeZone String この属性は廃止されています (非推奨)。 値として空の文字列を指定します。
Language String 顧客の言語と言語の地域 (例: EN-US)。
電話番号 String 顧客の電話番号。 形式は、国/地域コードの後にハイフン (-) を付け、電話番号 (たとえば、米国の場合は +1-1234567890) にする必要があります。
メール String 顧客のメールアドレス。 この値は大文字と小文字を区別しません。
IsEmailValidated Boolean 顧客が指定した電子メールが顧客の所有として検証されたかどうかを示す値。
EmailValidatedDate DateTime 顧客が指定した電子メールが顧客の所有として検証された日付。 形式は ISO 8601 です。
Is電話NumberValidated Boolean 顧客が指定した電話番号が、顧客が所有する電話番号として検証済みかどうかを示す値。
電話NumberValidatedDate DateTime 顧客が指定した電話番号が顧客の所有として確認された日付。 形式は ISO 8601 です。
DeviceContextId String イベントのセッションのセッション ID (Microsoft Device Fingerprinting によって提供されます) またはセッションが使用できない場合はトランザクション ID。
プロバイダー String deviceContextId 値のソース (DFP フィンガープリントまたはマーチャント) を示す値。
DeviceContextDC String 顧客のセッション ID の Microsoft Device Fingerprinting データ センター。
ExternalDeviceId String 顧客のデバイス ID。 この情報は、マーチャントによって提供され、マスターされます。
ExternalDeviceType String マーチャントによって識別されるデバイスの種類 (PC やモバイル デバイスなど)。
IpAddress String 顧客の IP アドレス。 この情報は、Microsoft デバイスフィンガープリントによって提供されます。
MerchantLocalDate DateTime ISO 8601 形式の日付。
MembershipType String 顧客のメンバーシップ ステータスまたはタイプ。
LoginInputMethod String 顧客が資格情報の入力に使用する方法。
LastPasswordUpdatedDate String 顧客のパスワードが最後に更新された日時。
FirstPurchaseDate String 顧客が最初に購入したとき。
LoginChallengeType String 開始されたチャレンジ/レスポンス テストのタイプ。
AddressList String 「購入先住所」セクションを参照してください。
PaymentInstrumentList String 「PaymentInstrumentList の購入」セクションを参照してください。
DeviceContext String 「DeviceContext の購入」セクションを参照してください。

UpdateAddress

属性 Type 説明
UserId String 顧客 ID。 これは必須の属性です。
Addresstype String 住所の種類: [請求]、[ 配送先]、[ アカウント]、[ 不明] です。
FirstName String アドレスに指定された名。
姓 String アドレスに指定された姓。
電話番号 String アドレスに指定された電話番号。
Street1 String 住所に提供された最初の行。
Street2 String 住所に提供された 2 番目の行。 (この値を空白にすることはできません。)
Street3 String アドレスに指定された 3 行目。 (この値を空白にすることはできません。)
City (市) String 住所に提供された都市。
状態 String 住所に提供された都道府県。
District String 住所に提供された地区。 (この値を空白にすることはできません。)
ZipCode String 住所に提供された郵便番号。
CountryCode String 住所に指定された国または地域コード。 値は、2 文字の ISO 国または地域コード (例: US) である必要があります。

UpdatePaymentInstrument

属性 Type 説明
UserId String 顧客 ID。 これは必須の属性です。
MerchantPaymentInstrumentId String 支払い方法の ID。 この情報はマーチャントから提供されます。 これは必須の属性です。
PaymentInstrumenttype String 支払いの種類: CreditCard、Pal、CH、Standard Edition PA、BACS、モバイルペイメント、ギフトカードなど。
PaymentInstrumentcreationDate DateTime マーチャントのシステムでの支払い方法の最初のエントリの日付。 形式は ISO 8601 です。
PaymentInstrumentupdateDate DateTime マーチャントのシステムでの支払い方法の前回の更新の日付。 形式は ISO 8601 です。
PaymentInstrumentState String 支払い方法の状態:アクティブ、ブロック、または期限切れ。
CardType String この属性は、クレジットカードタイプの支払いに対してのみ使用されます。
HolderName String 支払い方法の顧客の名前。 この属性は、クレジットカードタイプの支払いに対してのみ使用されます。
BIN String この属性は、クレジットカードタイプの支払いに対してのみ使用されます。
ExpirationDate String マーチャントのシステムでの支払い方法の有効期限。 この属性は、クレジットカードタイプの支払いに対してのみ使用されます。
LastFourDigits String この属性は、クレジットカードタイプの支払いに対してのみ使用されます。
メール String 支払い方法に関連付けられている電子メール アドレス。 この属性は、Pay 型の支払いにのみ使用されます。
BillingAgreementId String この属性は、Pay 型の支払いにのみ使用されます。
PayerId String この属性は、Pay 型の支払いにのみ使用されます。
PayerStatus String PayPal が支払人を認証したかどうかを示す値。 この属性は、Pay 型の支払いにのみ使用されます。
AddressStatus String PayPal が支払人の住所を認証したかどうかを示す値。 この属性は、Pay 型の支払いにのみ使用されます。
IMEI String この属性は、Mobilepayment タイプの支払いに対してのみ使用されます。
BillingAddressfirstName String アドレスに指定された名。
BillingAddresslastName String アドレスに指定された姓。
BillingAddressphoneNumber String 住所に指定された電話番号。 形式は、国または地域コードの後にハイフン (-) を付け、電話番号 (たとえば、米国の場合は +1-1234567890) にする必要があります。
Street1 String 住所に提供された最初の行。
Street2 String 住所に提供された 2 番目の行。 (この値を空白にすることはできません。)
Street3 String アドレスに指定された 3 行目。 (この値を空白にすることはできません。)
City (市) String 住所に提供された都市。
状態 String 住所に提供された都道府県。
District String 住所に提供された地区。 (この値を空白にすることはできません。)
ZipCode String 住所に提供された郵便番号。
CountryCode String 住所に指定された国または地域コード。 値は、2 文字の ISO 国または地域コード (例: US) である必要があります。

Labels

評価および保護エクスペリエンスでは、次のスキーマが使用されます。

属性 Type 説明
TrackingId String 各イベント/レコードの一意の ID。
MerchantLocalDate DateTime 販売者のタイム ゾーン内の日付。 形式は ISO 8601 です。
EventTimeStamp DateTime イベントの日時。 形式は ISO 8601 です。 詳細については、「Dynamics 365 Fraud Protection API」を参照してください。
LabelObjectType String このフィールドは、ラベルの種類を示します:購入、サインアップ、カスタム詐欺評価、アカウント、支払い方法、または電子メール。
LabelObjectId String これは、オブジェクトの種類 (PurchaseId、SignupId、UserId、MerchantPaymentInstrumentId、または Email) の識別子フィールドです。
LabelSource String このフィールドは、ラベルのソースを表します。
LabelState String このフィールドは、ラベルの現在の状態を示します。 詳細については、「Dynamics 365 Fraud Protection API」を参照してください。
LabelReasonCodes String このフィールドは、ラベルの種類ごとに関連付けられている理由コードを示します。 詳細については、「Dynamics 365 Fraud Protection API」を参照してください。
プロセッサ String 銀行または支払い処理者の名前。 詳細については、「Dynamics 365 Fraud Protection API」を参照してください。
EffectiveStartDate DateTime このラベルが有効になる日付。 形式は ISO 8601 です。
EffectiveEndDate DateTime このラベルの終了日。 形式は ISO 8601 です。
量 倍精度浮動小数点型 顧客に請求された金額。 この情報はマーチャントから提供されます。
通貨 String 3 文字の通貨コードとしての元の購入の通貨。 (たとえば、OANDA 通貨コードと一致する USD)。 この情報はマーチャントから提供されます。

垂直方向に固有の属性

Attribute 垂直 型 説明
TravelOverview
CarRentalIncluded 移動 Boolean レンタカーが含まれているかどうかを示す True/False 値。
LodgingIncluded 移動 Boolean 宿泊費が含まれているかどうかを示す True/False 値。
TravelType 移動 String 旅行のカテゴリまたはタイプ。
IsRoundTrip 移動 Boolean 旅行が往復であるかどうかを示す True/False 値。
IsDiscountOffered 移動 Boolean 割引が提供されたかどうかを示す True/False 値。
TravelDateTime 移動 DateTimeOffset 旅行開始日時。
ReturnDateTime 移動 DateTimeOffset 旅行の終了または帰途の日時。
FromCity 移動 String 顧客の旅行元である市区町村。
FromState 移動 String 顧客の旅行元である都道府県。
FromCountryISO 移動 String 顧客の旅行元である ISO 国。
FromZipCode 移動 String 顧客の旅行元の郵便番号。
ToCity 移動 String 顧客の旅行先である市区町村。
ToState 移動 String 顧客の旅行先である都道府県。
ToCountryISO 移動 String 顧客の旅行先である ISO 国。
ToZipCode 移動 String 顧客の旅行先の郵便番号。
TravelDuration 移動 String 削除されました。 使用しないでください。
IsPackagedTour 移動 Boolean これがパッケージ ツアーかどうかを示す True/False 値。
BookingType 移動 String 予約タイプ。
WebUrl 移動 String 旅行が予約された URL。
IssueDateTime 移動 DateTimeOffset チケットが発行された日時。
FlightDetails 移動 Object FlightDetails セクションを参照してください。
LodgingDetails 移動 Object 「LodgingDetails」セクションを参照してください。
CarRentalDetails 移動 Object CarRentalDetails セクションを参照してください。
TravelAgent 移動 Object TravelAgent セクションを参照してください。
FlightDetails
TicketNumber 移動 String 一意のチケット番号。
PlaceOfIssue 移動 String チケットが発行された場所。
IsRestrictedTicket 移動 Boolean チケットが制限されているかどうかを示す True/False 値。
RewardsOrVoucherApplied 移動 Boolean リワードまたはバウチャーが注文に適用されたかどうかを示す True/False 値。
TotalRewardsApplied 移動 int32 注文に適用されたリワードの合計。
TotalFees 移動 小数 注文に適用される合計料金。
PassengerCount 移動 Int32 乗客の合計数。
NumberOfStops 移動 Int32 フライトの途中降機または乗り継ぎの数。
PurchaserProfileType 移動 String 顧客のプロファイルまたはメンバーシップ タイプ。
IsThirdParty 移動 Boolean 注文がサードパーティのサイトを通じて行われたかどうかを示す True/False 値。
IsPurchaserFrequentFlyer 移動 Boolean 顧客がフリークエント チラシであるかどうかを示す True/False 値。
FlightSegments 移動 Object FlightSegments セクションを参照してください。
乗客 移動 Object 「乗客」セクションを参照してください。
FlightSegments
AirlineCode 移動 String エアライン コード。
AirlineName 移動 String 航空会社名。
SegmentSequence 移動 Int32 指定されたフライト区間のシーケンス番号 (たとえば、フライトの 2 番目の区間の場合は 2)
TravelClass 移動 String 座席クラスまたはキャビン。
OperatedBy 移動 String フライトを運営している組織。
FlightNumber 移動 String フライト番号。
FromAirportCode 移動 String フライトの出発地である空港コード。
ToAirportCode 移動 String フライトの到着地である空港コード。
DepartureDateTime 移動 DateTimeOffset 出発日時。
ArrivalDateTime 移動 DateTimeOffset 到着日時。
FromAirportCity 移動 String 顧客の旅行元の空港がある市町村。
FromAirportState 移動 String 顧客の旅行元の空港がある都道府県。
FromAirportZipcode 移動 String 顧客の旅行元の空港の郵便番号。
FromAirportCountryISO 移動 String 顧客が移動している空港 ISO の国番号。
ToAirportCity 移動 String 顧客の旅行先の空港がある市町村。
ToAirportState 移動 String 顧客の旅行先の空港がある都道府県。
ToAirportZipcode 移動 String 顧客の旅行先の空港の郵便番号。
ToAirportCountryISO 移動 String 顧客の旅行先の空港の ISO 国。
乗客
FirstName 移動 String 乗客の名。
姓 移動 String 乗客の姓。
CarRentalDetails
PickupLocation 移動 String レンタカーの受取場所。
PickupDateTime 移動 DateTimeOffset レンタカーの受取日時。
DropOffLocation 移動 String レンタカーの返却場所。
DropOffDateTime 移動 DateTimeOffset レンタカーの返却日時
DiscountProgram 移動 String レンタカー注文に適用される割引プログラム。
CarType 移動 String 車両タイプまたはカテゴリ。
IsPrepaid 移動 Boolean レンタカーの料金が前払いされているかどうかを示す True/False 値。
InsuranceIncluded 移動 Boolean 保険が含まれているかどうかを示す True/False 値。
ContactEmail 移動 String レンタカーを借りた人のメール アドレス。
Contact電話Number 移動 String レンタカーを借りた人の電話番号。
PickupAddress 移動 Object 「アドレス」セクションを参照してください。
DropOffAddress 移動 Object 「アドレス」セクションを参照してください。
TravelAgent
AgencyCode 移動 String 旅行代理店コード。
AgencyName 移動 String 旅行代理店名。
AgentCode 移動 String 旅行代理店コード。
AgencyLocation 移動 Object AgentAddress セクションを参照してください。
AgentAddress
Street1 移動 String アドレスに指定された最初の行
Street2 移動 String 住所に提供された 2 番目の行。 (この値を空白にすることはできません。)
Street3 移動 String 住所に提供された 3 番目の行。 (この値を空白にすることはできません。)
市区町村 移動 String 住所に提供された都市。
都道府県 移動 String 住所に提供された都道府県。
District 移動 String 住所に提供された地区。
ZipCode 移動 String 住所に提供された郵便番号。
国 移動 String 住所に提供された国/リージョン コード。 値は、2 文字の ISO 国/リージョン コード (たとえば、US) である必要があります。
AgencyContact電話 移動 String 代理店の連絡先の電話番号。
AgencyContactEmail 移動 String 代理店の連絡先の電子メール アドレス。
LodgingDetails
FolioNumber 宿泊 String 宿泊プロパティの一意の識別子。
CheckInDate 宿泊 DateTimeOffset 宿泊滞在のチェックイン日。
CheckOutDate 宿泊 DateTimeOffset 宿泊滞在のチェックアウト日。
ReservationConfirmed 宿泊 Boolean 予約が確認されたかどうかを示す True/False 値。
MembershipDetails 宿泊 String 顧客のメンバーシップ ステータスに関する追加の詳細。
DiscountProgram 宿泊 String 宿泊注文に適用される割引プログラム。
AdultCount 宿泊 Int32 滞在に含まれる成人の人数。
KidCount 宿泊 Int32 滞在に含まれる子供の人数。
NightsCount 宿泊 Int32 滞在に含まれる宿泊日数。
RoomCount 宿泊 Int32 滞在に含まれる客室数。
BedType 宿泊 String ベッド タイプまたはカテゴリ。
RoomType 宿泊 String 客室タイプまたはカテゴリ。
PaymentDescription 宿泊 String 宿泊施設の支払いに関する追加の詳細。
設備 宿泊 Object 「施設」セクションを参照してください。
施設
名前 宿泊 String 設備名。
Type 宿泊 String 設備タイプ。
Contact電話Number 宿泊 String 設備への連絡に使用した電話番号。
ContactEmail 宿泊 String 設備への連絡に使用したメール。
DailyRoomRate 宿泊 小数 設備の 1 日あたりの宿泊料金。
通貨 宿泊 String 設備がサポートする通貨。
DailyRoomTaxAmount 宿泊 小数 設備が請求する 1 日あたりの客室税額。
番地 宿泊 Object 「アドレス」セクションを参照してください。
住所
Street1 レンタカー String アドレスに指定された最初の行
Street2 レンタカー String 住所に提供された 2 番目の行。 (この値を空白にすることはできません。)
Street3 レンタカー String 住所に提供された 3 番目の行。 (この値を空白にすることはできません。)
市区町村 レンタカー String 住所に提供された都市。
都道府県 レンタカー String 住所に提供された都道府県。
District レンタカー String 住所に提供された地区。
ZipCode レンタカー String 住所に提供された郵便番号。
国 レンタカー String 住所に提供された国/リージョン コード。 値は、2 文字の ISO 国/リージョン コード (たとえば、US) である必要があります。
CloudBusiness
OrganizationId CloudBusiness String クラウド サービスまたは組織の一意識別子。
CompanyName CloudBusiness String クラウド サービスの名前。
CompanyType CloudBusiness String クラウド会社タイプ。
CompanySize CloudBusiness Int32 クラウド会社の規模。
EntityId CloudBusiness String 組織の下の法人の一意の識別子。
PrimaryContactFirstName CloudBusiness String ビジネスの取引先責任者の名。
PrimaryContactLastName CloudBusiness String ビジネスの取引先責任者の姓。
PrimaryContactEmail CloudBusiness String ビジネスの取引先責任者のメール アドレス。
PrimaryContact電話Number CloudBusiness String ビジネスの取引先責任者の電話番号。
SubscriptionCount CloudBusiness Int32 利用できるサブスクリプション合計数。
CompanyAddress CloudBusiness Object 「アドレス」セクションを参照してください。

サンプル データをダウンロードする

独自の内部データを使用する前に、サンプル データ ファイルをダウンロードしてオプションを調べることができます。

  • 損失防止で使用できるサンプルについては、[損失防止サンプル データ ファイル] を選択します。
  • 購入保護で使用できるサンプルについては、[購入保護のサンプル データ ファイル] を選択します。

カスタム データ サンプル

次の例は、Fraud Protection のカスタム データ オブジェクトで購入 API を使用する方法を示しています。

{ 
"CustomData": { 
"EngagementDuration": 120.4, 
"GamerScore": 10, 
"InApp": true, 
"MiscSampleA": "abc" 
} 
}