檢視購買保護架構

本文概述大量上傳至 Microsoft Dynamics 365 Fraud Protection 的即時 API 和歷程記錄數據的架構。 如需上傳程式的相關信息，請參閱 上傳歷程記錄數據。 如果數據會透過應用程式開發介面擷取 （API），請參閱 整合 Dynamics 365 Fraud Protection 即時 API。

請遵循下列需求：

• 這些檔案是 CSV UTF-8（逗號、分號或製表符分隔）格式（*.csv或 *.tsv）。
• 檔案大小上限為 10 GB（GB）。
• 下列字元會在所有數據行中逸出：逗號/分號、新行字元和多行字元。
• 'datetime' 資料行的格式為 ISO 8601。 例如，在 C# DateTime.UtcNow.ToString（“o”） 中，格式為 “2019-03-14T20：18：11.254Z”。
• 'double' （十進位） 數據行有效位數是兩個小數字數。

交易

下列架構用於評估和保護體驗。

購買

屬性	類型	描述
PurchaseId	String	交易的標識碼（或採購或訂單）。
OriginalOrderId	String	週期性計費之付款的原始訂單標識碼，例如每月訂閱計費。
CustomerLocalDate	Datetime	客戶當地時區中的購買建立日期。 格式為 ISO 8601。
MerchantLocalDate	Datetime	商家當地時區的購買擷取日期。 格式為 ISO 8601。
TotalAmount	Double	向客戶收取的總金額，包括稅金。 此資訊由商家提供。
SalesTax	Double	針對交易收取的銷售稅。 此資訊由商家提供。
貨幣	String	原始購買的貨幣為三個字元的貨幣代碼（例如： 美元，與 OANDA 貨幣代碼一致）。 此資訊由商家提供。
DeviceContextId	String	事件會話的會話標識碼（由 Microsoft 裝置指紋提供），如果會話無法使用，則為交易標識符。
IPAddress	String	客戶的IP位址。 此資訊由 Microsoft 裝置指紋提供。
UserId	String	客戶標識碼。 此資訊由商家提供。 這是必要屬性。
UserFirstName	String	客戶在客戶帳戶上提供的名字。
UserLastName	String	客戶在客戶帳戶上提供姓氏。
UserEmail	String	客戶的電子郵件地址。 這個值不區分大小寫。
UserCreationDate	Datetime	客戶帳戶的建立日期。 格式為 ISO 8601。
UserUpdateDate	Datetime	上次變更客戶數據的日期。 格式為 ISO 8601。
UserZipCode	String	客戶的郵遞區號。
UserCountryCode	String	客戶的國家或地區。 此值應該是兩個字母的國家/地區代碼（例如： 美國）。
UserTimeZone	String	空字串。
UserLanguage	String	客戶的語言和語言領域（例如： EN-US）。
User 電話 Number	String	客戶的電話號碼。 格式應該是國家或地區代碼，後面接著連字元（-），然後是電話號碼（例如：針對美國， +1-1234567890）。
IsEmailValidated	布林值	True/False 值，指出客戶提供的電子郵件位址是否已驗證為客戶所擁有的電子郵件位址。
ShippingFirstName	String	為位址提供的第一個名稱。
ShippingLastName	String	為位址提供的姓氏。
Shipping 電話 Number	String	為位址提供的電話號碼。 格式應該是國家或地區代碼，後面接著連字元（-），然後是電話號碼（例如：針對美國， +1-1234567890）。
Street1	String	為位址提供的第一個數據列。
Street2	String	為位址提供的第二個數據列。 （此值可以是空白的。
Street3	String	為位址提供的第三個數據列。 （此值可以是空白的。
城市	String	為位址提供的城市。
州 (縣/市)	String	提供位址的州或省。
ZipCode	String	為位址提供的郵遞區號。
CountryCode	String	為位址提供的國家/地區代碼。 此值應該是兩個字母的 ISO 國家或地區代碼（例如： 美國）。
CustomData	Object	選擇性的使用者定義 JavaScript 物件表示法 （JSON） 屬性包。 當 API 呼叫具現化時，就會填入。 當您建立購買規則時，可以參考屬性。 注意： 支援下列基本類型：String （Unicode）、Int32、UInt32、Double、Boolean 和 DateTime（以國際標準時間 [UTC]，符合 .NET 語意）。 字串數據限製為 256 個字元。 每個承載有100個自訂屬性的限制。 請勿傳送敏感性或高度管制的數據類型。 以下列出一些範例： 資料，指出受保護的類別（如性別或種族）或私人/敏感性類別（如宗教觀點或性取向） 生物特徵辨識數據或任何與健康情況相關的數據 自定義數據保留原則符合購買事件的保留原則（六個月）。 如需示範如何在詐騙保護中搭配自定義數據物件使用購買 API 的範例，請參閱 本文結尾的自定義數據範例 一節。
MerchantBusinessType	String	商業或行業垂直（例如：遊戲、零售、餐飲或社交網路）。
MerchantIdentifier	String	商家標識碼（MID）是附加至企業的特定標識符，可告知交易中涉及哪些資金的付款處理系統。 您可以將它想像為企業位址。 例如，如果您沒有商家標識碼，涉及的網路將不知道要寄錢的位置。
MerchantCategoryCode	String	商家類別代碼 （MCC） 是 ISO 18245 中針對零售金融服務列出的四位數數位。 MCC 是用來依其所提供的商品或服務類型來分類企業。
MerchantBusinessSegment	String	商家整體營運的子區段，其中已建立、個別的產品線、商務線或子品牌（例如：Xbox 或 Surface）。
MerchantProductCategory	String	商家定義的產品或服務類別。
StoreId	String	存放區標識碼。
StoreName	String	市集顯示名稱。
StoreAddress	String	商店的完整位址（街道、城市、州、zip）。
IsTest	布林值	值，指出交易是否為生產環境中的測試。
IsFreeProductIncluded	布林值	值，指出免費產品是否包含在交易中。
IsGuestCheckout	布林值	值，指出是否以來賓身分購買。
IsPostAuthCheck	布林值	值，指出是否有驗證后檢查。
IsRecurringCharge	布林值	值，指出交易是否為訂閱/週期性。
週期性ChargeFrequencyInDays	Double	週期性購買費用的頻率，例如每30天、每半年、每年等。
週期性ChargeStartDate	Datetime	週期性交易的開始日期。
週期性ChargeEndDate	Datetime	週期性交易的結束日期。
IsPostpaid	布林值	值，指出交易是否為後派。
DiscountAmount	Double	套用至交易的折扣金額。 例如，如果使用者購買相同 XBOX 控制器的 10 個，此專案將會是數位 1。 或者，如果使用者購買5個不同的遊戲和10個相同的XX控制器，此專案將會是數位5+1或 6。
TipAmount	Double	套用至交易的小費金額。
DistinctItemCount	Double	每個交易的相異/唯一項目計數。
TotalItemCount	Double	每個交易的項目總數。 例如，如果使用者購買相同 XBOX 控制器的 10 個，此專案將會是數位 10。 或者，如果使用者購買5個不同的遊戲和10個相同的XX控制器，此專案將會是數位5+10或 15。
IsLowLiabilityPIType	布林值	值，表示低負債付款工具（例如：Apple Pay、支付寶或銀聯）。
OrderType	String	交易的類型（例如：外賣）。
IsRetryOrder	布林值	值，指出是否重試訂單。
AttemptId	String	每個交易重試的標識碼。
ShippingDate	Datetime	訂單出貨的日期。
OrderInitiatedChannel	String	建立交易的通道（例如：'AppStore'、'Web'、MobileWeb、'App'、'InGamePurchase'）。
OrderInitiatedChannelName	String	建立交易的應用程式名稱或 Web URL。
OrderInitiatedChannelRegionORCountry	String	交易建立所在的市場（例如：應用程式市場）。
MerchantBusinessSubSegmentL2	String	第二級（L2）商業或行業區段。
MidName	String	與 MID 相關聯的商家名稱（商家標識符）。
TransactionProcessingOrder	String	交易流程期間進行詐騙評估的順序。
RecurringSubscriptionId	String	週期性費用的唯一標識符
週期性ChargeSequence	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	客戶的成員資格狀態或類型。 您可以指定不同的層級，例如 進階版 和 Executive。
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	布林值	True/False 值，指出是否啟用 Cookie。
EnabledFlash	布林值	True/False 值，指出是否啟用 Flash。
EnabledJavaScript	布林值	True/False 值，指出是否啟用 JavaScript。
ScreenAspectRatio	String	瀏覽器的外觀比例。
ScreenColorDepth	String	畫面的色彩深度。
ScreenResolution	String	以像素為單位的裝置螢幕解析度
SiteHostName	String	網站的主機名。
OS	String	裝置作業系統。
OSFonts	String	操作系統的預設字型。
DeviceProcessor	String	裝置處理器。
工作階段識別碼	String	唯一的會話標識碼。
TrueIp	String	由裝置指紋識別之裝置的真實IP位址
ProxyIp	String	Proxy 裝置的IP位址。
DeviceId	String	裝置指紋所產生的每個裝置唯一 GUID
時區	String	與 GMT 相關的當地時區位移，以小時為單位
UserAgentDetails	String	其他使用者代理程式或瀏覽器詳細數據。
AppVersion	String	應用程式版本。
BrowserPackagesList	String	裝置上安裝的套件清單。
BuildManufacturer	String	裝置的製造商。
BuildModel	String	最終產品的用戶可見名稱。
BuildSdkVersion	String	組建版本。
DataNetworkType	String	行動數據網路的類型。
DeviceModelName	String	裝置型號。
DeviceSystemName	String	計算機的裝置名稱。
DeviceSystemVersion	String	裝置版本。
Is 藍牙 Enabled	布林值	True/False 值，指出是否已啟用 藍牙。
SimNetworkCountryISO	String	行動服務提供者的 ISO 國家/地區代碼。
SimNetworkType	String	行動網路類型。
SystemUpTime	String	裝置已運作且可用的持續時間。
PaymentMethod	String	最上層付款方式類別。
IsLowLiabilityPIType	布林值	True/False 值，指出付款方式是否為低負債。
HolderCompanyName	布林值	提供商務或公司卡的組織名稱（僅適用於商務購買）。
SettlementApprovalRequired	布林值	True/False 值，指出 SEPA 交易是否需要核准。
PaymentCheckoutProvider	String	eWallet 結帳提供者。
BinName	String	BIN 顯示名稱。
BinCountryISO	String	與 BIN 相關聯的 ISO 國家/地區代碼。
BinCardType	String	BIN 卡片類型。
BinCardAssociation	String	BIN 卡片關聯。
BinBankGroup	String	BIN 銀行群組。
貨幣	String	所選付款方式的貨幣代碼。
IsInternationalMoneyTransfer	布林值	True/False 值，指出是否發生國際匯款。
BankIdentifierCode	String	銀行識別碼 （BIC 或 SWIFT 代碼）
BankName	String	銀行名稱。
BankZipCode	String	銀行郵政編碼。
BankState	String	銀行州。
BankCountryISO	String	銀行 ISO 國家/地區。
PaymentCollectionDate	DateTimeOffset	付款收集的估計日期（主要用於付款服務提供者）。
InstantPaymentSettlement	布林值	True/False 值，表示銀行重新導向（用來支援 CSV 付款）。
AutoCaptureEnabled	布林值	True/False 值，指出是否已針對卡片付款自動擷取付款。 對於重新導向付款，這隻是合作夥伴銀行是否自動提取資金的指標。
AccountType	String	表示要為交易收取費用的帳戶類型。 UNSPECIFIED 是預設值。 CHEQUE_ACCOUNT使用卡片作為轉帳卡。 CREDIT_FACILITY使用卡片作為信用卡。
AuthorizationType	String	授權類型。 萬事達卡和 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	布林值	True 是表示 當使用者重新訂購先前的訂單時（不只是來自該訂單的產品）。
PreOrderAvailabilityDate	DateTimeOffset	產品第一次可供預先排序使用時。
TerminalId	String	銷售點終端機的唯一標識符。
TerminalName	String	銷售點終端機名稱。
IsThreeDSAuth	布林值	True/False 值，指出此交易是否透過 3DS 進行驗證。
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

屬性	類型	描述
PurchaseId	String	交易的標識碼（或採購或訂單）。
MerchantPaymentInstrumentId	String	付款方式的標識碼。 此資訊由商家提供。 這是必要的屬性。
型別	String	付款的類型。 如需詳細資訊，請參閱 Dynamics 365 Fraud Protection API。
PurchaseAmount	Double	交易使用此付款方式的總購買金額。
CreationDate	Datetime	商家系統中付款方式第一個專案的日期。 格式為 ISO 8601。
UpdateDate	Datetime	商家系統中付款方式上次更新的日期。 格式為 ISO 8601。
CardType	String	此屬性僅用於信用卡類型的付款。
HolderName	String	付款方式的客戶名稱。 此屬性僅用於信用卡類型的付款。
BIN	String	此屬性僅用於信用卡類型的付款。
ExpirationDate	String	商家系統中付款方式的到期日。 格式為 ISO 8601。 此屬性僅用於信用卡類型的付款。
LastFourDigits	String	此屬性僅用於信用卡類型的付款。
Email	String	與付款方式相關聯的電子郵件位址。 此屬性僅用於 PayPal 類型的付款。
BillingAgreementId	String	此屬性僅用於 PayPal 類型的付款。
PayerId	String	此屬性僅用於 PayPal 類型的付款。
PayerStatus	String	值，指出PayPal 是否已驗證付款人。 此屬性僅用於 PayPal 類型的付款。
AddressStatus	String	值，指出 PayPal 是否已驗證付款人的位址。 此屬性僅用於 PayPal 類型的付款。
IMEI	String	此屬性僅用於Mobilepayment類型的付款。
FirstName	String	為位址提供的第一個名稱。
LastName	String	為位址提供的姓氏。
PhoneNumber	String	為位址提供的電話號碼。 格式應該是國家或地區代碼，後面接著連字元（-），然後是電話號碼（例如：針對美國， +1-1234567890）。
Street1	String	為位址提供的第一個數據列。
Street2	String	為位址提供的第二個數據列。 （此值可以是空白的。
Street3	String	為位址提供的第三個數據列。 （此值可以是空白的。
城市	String	為位址提供的城市。
州 (縣/市)	String	提供位址的州或省。
ZipCode	String	為位址提供的郵遞區號。
CountryCode	String	為位址提供的國家/地區代碼。 此值應該是兩個字母的 ISO 國家或地區代碼（例如： 美國）。
PISource	String	付款方式來源（例如：CustomerInput、FromSavedProfile、MobilePay）。

產品

屬性	類型	描述
PurchaseId	String	交易的標識碼（或採購或訂單）。
ProductId	String	產品標識碼。 這是必要的屬性。
PurchasePrice	Double	購買明細項目的價格。
Margin	String	銷售專案所取得的獲利率。
數量	Int32	已購買的項目數。
ProductName	String	客戶可讀取的產品名稱。
型別	String	值，指出貨物是實體還是數位。
類別	String	產品類別（例如： 服裝、 鞋子或 配件）。
Market	String	提供產品的市場。 此值應該是兩個字母的 ISO 國家或地區代碼（例如： 美國）。
Sku	String	產品的庫存單位（SKU）。
SalesPrice	Double	不含稅項的項目價格。 此資訊由商家提供。
貨幣	String	原始購買的貨幣為三個字元的貨幣代碼（例如： 美元，與 OANDA 貨幣代碼一致）。 此資訊由商家提供。
COGS	Double	銷售的商品成本（也就是專案的原材料成本）。 此資訊由商家提供。
IsRecurring	布林值	值，指出產品是否為週期性訂閱。
IsFree	布林值	值，指出產品是否免費提供。
語言	String	語言和語言領域（例如： EN-US）。

退款

下列架構用於評估和保護體驗。

屬性	類型	描述
ChargebackId	String	退款標識碼。
原因	String	銀行提供的原因。
狀態	String	狀態。 如需詳細資訊，請參閱 Dynamics 365 Fraud Protection API。
BankEventTimestamp	Datetime	銀行的時間戳。 格式為 ISO 8601。
總數	Double	退款金額。
貨幣	String	用於退款金額的貨幣。
UserId	String	客戶標識碼。
PurchaseId	String	交易的標識碼（或採購或訂單）。
MerchantLocalDate	Datetime	商家當地時區的購買擷取日期。 格式為 ISO 8601。

退費

下列架構用於評估和保護體驗。

屬性	類型	描述
RefundId	String	退款標識碼。
原因	String	客戶提供的原因。
狀態	String	退款狀態。 如需詳細資訊，請參閱 Dynamics 365 Fraud Protection API。
BankEventTimestamp	Datetime	銀行的時間戳。 格式為 ISO 8601。
總數	Double	退款金額。
貨幣	String	用於銷售價格金額的貨幣。
UserId	String	客戶標識碼。 這是必要的屬性。
PurchaseId	String	交易的標識碼（或採購或訂單）。
MerchantLocalDate	Datetime	ISO 8601 格式的日期。

PurchaseStatus

下列架構用於評估和保護體驗。

屬性	類型	描述
PurchaseId	String	交易的標識碼（或採購或訂單）。
StatusType	String	狀態的類型。 如需詳細資訊，請參閱 Dynamics 365 Fraud Protection API。
StatusDate	Datetime	套用狀態的日期和時間。 格式為 ISO 8601。
原因	String	狀態轉換的原因。
MerchantLocalDate	Datetime	ISO 8601 格式的日期。

BankEvents

下列架構用於評估和保護體驗。

屬性	類型	描述
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	用於銀行通訊的商家標識碼（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	請參閱購買工作表中的購買 ThreeDS 一節。

客戶​​

下列架構用於評估和保護體驗。

UpdateAccount

屬性	類型	描述
CustomerLocalDate	Datetime	ISO 8601 格式的日期。
UserId	String	客戶標識碼。 這是必要的屬性。
UsercreationDate	Datetime	ISO 8601 格式的日期。
UserupdateDate	Datetime	ISO 8601 格式的日期。
FirstName	String	客戶在客戶帳戶上提供的名字。
LastName	String	客戶在客戶帳戶上提供姓氏。
CountryCode	String	客戶的國家或地區。 此值應該是兩個字母的國家/地區代碼（例如： 美國）。
ZipCode	String	客戶的郵遞區號。
時區	String	這個屬性已經過時（已淘汰）。 提供空字串做為 值。
語言	String	客戶的語言和語言領域（例如： EN-US）。
PhoneNumber	String	客戶的電話號碼。 格式應該是國家/地區代碼，後面接著連字元（-），然後是電話號碼（例如：針對美國， +1-1234567890）。
Email	String	客戶的電子郵件地址。 這個值不區分大小寫。
IsEmailValidated	布林值	值，指出客戶提供的電子郵件是否已驗證為客戶所擁有的電子郵件。
EmailValidatedDate	Datetime	客戶提供的電子郵件已驗證為客戶所擁有的日期。 格式為 ISO 8601。
Is 電話 NumberValidated	布林值	值，指出客戶提供的電話號碼是否已驗證為客戶所擁有的電話號碼。
電話 NumberValidatedDate	Datetime	客戶提供的電話號碼已驗證為客戶所擁有的日期。 格式為 ISO 8601。
DeviceContextId	String	事件會話的會話標識碼（由 Microsoft 裝置指紋提供），如果會話無法使用，則為交易標識符。
Provider	String	值，指出 deviceContextId 值的來源：DFP 指紋或商家。
DeviceContextDC	String	客戶會話標識碼的 Microsoft 裝置指紋數據中心。
ExternalDeviceId	String	客戶的裝置識別碼。 此資訊由商家提供並掌握。
ExternalDeviceType	String	商家所識別的裝置類型（例如： 計算機 或 行動裝置）。
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

屬性	類型	描述
UserId	String	客戶標識碼。 這是必要的屬性。
Addresstype	String	位址類型：計費、出貨、帳戶或未知。
FirstName	String	為位址提供的第一個名稱。
LastName	String	為位址提供的姓氏。
PhoneNumber	String	為位址提供的電話號碼。
Street1	String	為位址提供的第一個數據列。
Street2	String	為位址提供的第二個數據列。 （此值可以是空白的。
Street3	String	為位址提供的第三個數據列。 （此值可以是空白的。
城市	String	為位址提供的城市。
州 (縣/市)	String	提供位址的州或省。
區域	String	為位址提供的地區。 （此值可以是空白的。
ZipCode	String	為位址提供的郵遞區號。
CountryCode	String	為位址提供的國家/地區代碼。 此值應該是兩個字母的 ISO 國家或地區代碼（例如： 美國）。

UpdatePaymentInstrument

屬性	類型	描述
UserId	String	客戶標識碼。 這是必要的屬性。
MerchantPaymentInstrumentId	String	付款方式的標識碼。 此資訊由商家提供。 這是必要的屬性。
PaymentInstrumenttype	String	付款類型： CreditCard、 PayPal、 CH、 SEPA、 BACS、 Mobilepayment、 Giftcard 或其他。
PaymentInstrumentcreationDate	Datetime	商家系統中付款方式第一個專案的日期。 格式為 ISO 8601。
PaymentInstrumentupdateDate	Datetime	商家系統中付款方式上次更新的日期。 格式為 ISO 8601。
PaymentInstrumentState	String	付款方式的狀態： 作用中、 封鎖或 到期。
CardType	String	此屬性僅用於信用卡類型的付款。
HolderName	String	付款方式的客戶名稱。 此屬性僅用於信用卡類型的付款。
BIN	String	此屬性僅用於信用卡類型的付款。
ExpirationDate	String	商家系統中付款方式的到期日。 此屬性僅用於信用卡類型的付款。
LastFourDigits	String	此屬性僅用於信用卡類型的付款。
Email	String	與付款方式相關聯的電子郵件位址。 此屬性僅用於 PayPal 類型的付款。
BillingAgreementId	String	此屬性僅用於 PayPal 類型的付款。
PayerId	String	此屬性僅用於 PayPal 類型的付款。
PayerStatus	String	值，指出PayPal 是否已驗證付款人。 此屬性僅用於 PayPal 類型的付款。
AddressStatus	String	值，指出 PayPal 是否已驗證付款人的位址。 此屬性僅用於 PayPal 類型的付款。
IMEI	String	此屬性僅用於Mobilepayment類型的付款。
BillingAddressfirstName	String	為位址提供的第一個名稱。
BillingAddresslastName	String	提供給位址的姓氏。
BillingAddressphoneNumber	String	提供地址的電話號碼。 格式應該是國家或地區代碼，後面接著連字元（-），然後是電話號碼（例如：針對美國， +1-1234567890）。
Street1	String	為位址提供的第一個數據列。
Street2	String	為位址提供的第二個數據列。 （此值可以是空白的。
Street3	String	為位址提供的第三個數據列。 （此值可以是空白的。
城市	String	為位址提供的城市。
州 (縣/市)	String	提供位址的州或省。
區域	String	為位址提供的地區。 （此值可以是空白的。
ZipCode	String	為位址提供的郵遞區號。
CountryCode	String	為位址提供的國家/地區代碼。 此值應該是兩個字母的 ISO 國家或地區代碼（例如： 美國）。

標籤

下列架構用於評估和保護體驗。

屬性	類型	描述
TrackingId	String	每個事件/記錄的唯一標識符。
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。
總數	Double	向客戶收取的金額。 此資訊由商家提供。
貨幣	String	原始購買的貨幣，以三個字元的貨幣代碼表示。 （例如：美元，其與 OANDA 貨幣代碼一致）。 此資訊由商家提供。

垂直特定屬性

屬性	垂直	類型	描述
TravelOverview
CarRentalIncluded	旅遊	布林值	True/False 值，指出是否包含計程車。
LodgingIncluded	旅遊	布林值	True/False 值，指出是否包含住宿。
TravelType	旅遊	String	旅行類別或類型。
IsRoundTrip	旅遊	布林值	True/False 值，指出旅行是否往返。
IsDiscountOffered	旅遊	布林值	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	旅遊	布林值	True/False 值，指出這是否為封裝導覽。
BookingType	旅遊	String	預約類型。
WebUrl	旅遊	String	預訂旅行的 URL。
IssueDateTime	旅遊	DateTimeOffset	發出票證的日期和時間。
FlightDetails	旅遊	Object	請參閱 FlightDetails 一節。
住宿Details	旅遊	Object	請參閱住宿區段。
CarRentalDetails	旅遊	Object	請參閱 CarRentalDetails 一節。
TravelAgent	旅遊	Object	請參閱 TravelAgent 一節。
FlightDetails
TicketNumber	旅遊	String	唯一的票證號碼。
PlaceOfIssue	旅遊	String	發出票證的位置。
IsRestrictedTicket	旅遊	布林值	True/False 值，指出票證是否受到限制。
RewardsOrVoucherApplied	旅遊	布林值	True/False 值，指出獎勵或代金券是否套用至訂單。
TotalRewardsApplied	旅遊	int32	套用至訂單的總獎勵。
TotalFees	旅遊	decimal	套用至訂單的總費用。
PassengerCount	旅遊	Int32	乘客總數。
NumberOfStops	旅遊	Int32	航班的停站或換班次數。
PurchaserProfileType	旅遊	String	客戶的配置檔或成員資格類型。
IsThirdParty	旅遊	布林值	True/False 值，指出訂單是否透過第三方網站放置。
IsPurchaserFrequentFlyer	旅遊	布林值	True/False 值，指出客戶是否為常客。
FlightSegments	旅遊	Object	請參閱 FlightSegments 一節。
乘客	旅遊	Object	請參閱乘客一節。
FlightSegments
AirlineCode	旅遊	String	航空公司代碼。
AirlineName	旅遊	String	航空公司名稱。
SegmentSequence	旅遊	Int32	指定飛行回合的序號（例如航班第二回合的 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	乘客名字。
LastName	旅遊	String	乘客姓氏。
CarRentalDetails
PickupLocation	旅遊	String	汽車出租取貨地點。
PickupDateTime	旅遊	DateTimeOffset	汽車出租取貨日期和時間。
DropOffLocation	旅遊	String	計程車下車地點。
DropOffDateTime	旅遊	DateTimeOffset	計程車的下車日期和時間
DiscountProgram	旅遊	String	套用至出租訂單的折扣方案。
CarType	旅遊	String	汽車類型或類別。
IsPrepaid	旅遊	布林值	True/False 值，指出是否預付汽車。
InsuranceIncluded	旅遊	布林值	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	為位址提供的第二個數據列。 （此值可以是空白的。
Street3	旅遊	String	為位址提供的第三個數據列。 （此值可以是空白的。
縣/市	旅遊	String	為位址提供的城市。
州/省	旅遊	String	提供位址的州或省。
區域	旅遊	String	為位址提供的地區。
ZipCode	旅遊	String	為位址提供的郵遞區號。
Country	旅遊	String	為位址提供的國家/地區代碼。 此值應該是兩個字母的 ISO 國家/地區代碼（例如美國）。
AgencyContact 電話	旅遊	String	代理程式連絡電話號碼。
AgencyContactEmail	旅遊	String	代理程式連絡電子郵件位址。
住宿Details
FolioNumber	住宿	String	住宿屬性的唯一標識碼。
CheckInDate	住宿	DateTimeOffset	住宿住宿的入住日期。
CheckOutDate	住宿	DateTimeOffset	住宿住宿的簽出日期。
ReservationConfirmed	住宿	布林值	True/False 值，指出是否已確認保留。
MembershipDetails	住宿	String	客戶成員資格狀態的其他詳細數據。
DiscountProgram	住宿	String	套用至住宿訂單的折扣方案。
成人帳戶	住宿	Int32	住宿中包括的成年人數目。
KidCount	住宿	Int32	住宿中包含的孩子數量。
NightsCount	住宿	Int32	住宿中包含的夜晚數目。
RoomCount	住宿	Int32	住宿中包含的房間數目。
BedType	住宿	String	床類型或類別。
RoomType	住宿	String	會議室類型或類別。
PaymentDescription	住宿	String	住宿付款的其他詳細數據。
設施	住宿	Object	請參閱設施一節。
設施
名稱	住宿	String	設施名稱。
類型	住宿	String	設施類型。
Contact 電話 Number	住宿	String	用來聯繫設施的電話號碼。
ContactEmail	住宿	String	用來連絡設施的電子郵件位址。
DailyRoomRate	住宿	decimal	設施的每日房價。
貨幣	住宿	String	設施支持的貨幣。
DailyRoomTaxAmount	住宿	decimal	設施收取的每日房間稅額。
位址	住宿	Object	請參閱地址一節。
地址
Street1	租車	String	為位址提供的第一個數據列
Street2	租車	String	為位址提供的第二個數據列。 （此值可以是空白的。
Street3	租車	String	為位址提供的第三個數據列。 （此值可以是空白的。
縣/市	租車	String	為位址提供的城市。
州/省	租車	String	提供位址的州或省。
區域	租車	String	為位址提供的地區。
ZipCode	租車	String	為位址提供的郵遞區號。
Country	租車	String	為位址提供的國家/地區代碼。 此值應該是兩個字母的 ISO 國家/地區代碼（例如美國）。
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" 
} 
}