共用方式為

Dynamics 365 詐騙保護 （預覽版）

Microsoft Dynamics 365 詐騙保護可讓商家取得與電子商務購買、詐騙帳戶註冊和線上商店登入嘗試相關的詐騙活動的風險評估

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 Microsoft
URL https://dynamics.microsoft.com/ai/fraud-protection/
Email dfpconnector@microsoft.com
連接器中繼資料
Publisher Microsoft
網站 https://docs.microsoft.com/fraud-protection-rest/api/fraud-protection-rest/
隱私策略 https://docs.microsoft.com/dynamics365/fraud-protection/data-processing-protection/
類別 AI

Microsoft Dynamics 365 詐騙保護連接器可讓商家取得與電子商務購買、詐騙帳戶註冊和線上商店登入嘗試相關聯的詐騙活動的風險評估。

先決條件

若要使用此連接器，使用者應該已經在 Dynamics 365 Fraud Protection 上擁有佈建的租用戶，並且應該已經在 Power App Platform 上擁有帳戶。

如何取得認證

有關如何取得認證的步驟記錄在此處： https://github.com/microsoft/Dynamics-365-Fraud-Protection-Samples/tree/master/power%20apps%20connector

開始使用連接器

如需如何開始使用的詳細資訊，請參閱 Dynamics 365 詐騙保護範例。

已知問題與限制

如需詳細資訊，請參閱 Dynamics 365 詐騙保護範例。

常見錯誤和補救措施

使用連接器呼叫 Dynamics 365 Fraud Protection 時，可能會發生一些常見問題：

  • 401 未授權：存取權杖無效，請檢查輸入的憑證。
  • 403 Forbidden：授權失敗，請檢查輸入的認證。
  • 400 錯誤請求：承載中的某些必填欄位遺失或格式錯誤，請檢查詳細的錯誤訊息。
  • 500 內部伺服器錯誤：伺服器端發生異常，請記下關聯 ID 並就此類錯誤聯絡 DFP 團隊。

FAQ

如需詳細資訊，請參閱 Dynamics 365 詐騙保護範例。

正在建立連線

連接器支援下列驗證類型：
預設值 建立連線的參數。 所有區域 不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

提供網上購物交易的風險評估

此事件會傳送有關傳入新購買交易的資訊和內容。 回應包含核准或拒絕購買交易的決定，以及商家應在授權呼叫中傳送給其銀行的適當商家ID （MID）
提供自訂事件的風險評估

此事件可讓您傳送他們自己選擇的結構，由他們自己選擇的條件觸發，以進行規則評估。 回應包含事件的決定
更新已確認的欺詐信息

此事件會傳送客戶與銀行爭議為詐騙的先前購買相關資訊。 這只是資料擷取事件。 許多商家會使用大量資料上傳來傳送這些事件
更新帳戶建立狀態

此事件會傳送帳戶建立狀態的更新，例如，如果帳戶建立已取消。 這只是資料擷取事件
更新帳戶登入狀態

此事件會傳送帳戶登入狀態的更新，例如，如果帳戶登入已取消。 這只是資料擷取事件
更新帳戶資訊以保護帳戶

此事件會更新或建立帳戶保護服務的使用者帳戶資訊，例如新增付款方式、新增地址或任何其他使用者屬性。 這只是資料擷取事件
更新帳戶資訊以保護購買

此事件會更新或建立購買保護服務的使用者帳戶資訊，例如「新增付款方式」、「新增地址」或任何其他使用者屬性。 這只是資料擷取事件
更新線上購買交易的狀態

此事件會傳送購買狀態的更新，例如，如果購買已取消。 這只是資料擷取事件
更新詐騙標籤資訊以保護帳戶

此事件會傳送標籤的更新。 這只是資料擷取事件
更新詐騙標籤資訊以保護購買

此事件會傳送標籤的更新。 這只是資料擷取事件
更新退款資訊

此事件會傳送先前退款購買交易的相關資訊。 這只是資料擷取事件。 許多商家會使用大量資料上傳來傳送這些事件
更新銀行授權資訊

此事件會傳達傳送至銀行的購買交易是否已核准或拒絕銀行授權或銀行收費/結算。 這只是資料擷取事件
為帳戶建立嘗試提供風險評估

此事件會傳送有關傳入新帳戶建立嘗試的資訊和內容。 回應包含帳戶建立的決定
為帳戶登入嘗試提供風險評估

此事件會傳送有關傳入新帳戶登入嘗試的資訊和內容。 回應包含帳戶登入的決定

提供網上購物交易的風險評估

作業識別碼：
PurchaseProtection_v1_PurchaseEvent

此事件會傳送有關傳入新購買交易的資訊和內容。 回應包含核准或拒絕購買交易的決定，以及商家應在授權呼叫中傳送給其銀行的適當商家ID （MID）

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
purchaseId
 purchaseId True string

商家系統中的交易（或購買/訂單）識別碼。
評估類型
 assessmentType string

指出事件的評量類型。 可能的值為 'Evaluate' 或 'Protect'。 如果未指定，預設值為「保護」
originalOrderId
 originalOrderId string

商家系統中的原始訂單標識符，用於定期計費（如每月訂閱）的付款。
客戶本地日期
 customerLocalDate date-time

根據客戶當地時區的購買建立日期。 格式ISO8601
merchantLocalDate
 merchantLocalDate True date-time

根據商家時區的購買建立日期。 格式ISO8601
商家識別碼
 merchantIdentifier string

銀行的商家識別碼 （MID）
merchantCategoryCode
 merchantCategoryCode string

銀行的商家類別代碼 （MCC）
merchantBusiness類型
 merchantBusinessType string

此購買的商家業務類型
商家業務區段
 merchantBusinessSegment string

此購買的商家業務區段
是測試
 isTest boolean

表示購買是測試購買
isFreeProduct包含
 isFreeProductIncluded boolean

表示免費產品是否屬於此購買的一部分
isRecurringCharge
 isRecurringCharge boolean

表示購買是否為週期性費用
是訪客結帳
 isGuestCheckout boolean

表示購買是否透過訪客結帳進行
isPostAuthCheck
 isPostAuthCheck boolean

表示購買項目是否在銀行驗證後傳送至 DFP
isRetryOrder
 isRetryOrder boolean

表示購買是否是先前失敗嘗試的重試
recurringCharge頻率在天數
 recurringChargeFrequencyInDays integer

費用重複發生的天數
recurringChargeStartDate
 recurringChargeStartDate date-time

此購買的開始日期 （如果是週期性）
recurringChargeEndDate
 recurringChargeEndDate date-time

此購買的結束日期 （如果週期性）
是後付費
 isPostpaid boolean

表示購買是否為後付款
distinctItemCount
 distinctItemCount double

作為購買的一部分銷售的不重複產品計數
總計項目計數
 totalItemCount double

作為購買的一部分銷售的產品總數
orderType
 orderType string

訂單類型，例如「外賣」
折扣金額
 discountAmount double

在計算總金額之前提供原始購買的折扣
tipAmount
 tipAmount double

購買時提供的小費
totalAmount
 totalAmount double

向客戶收取的總金額;含稅和運費。 可以選擇包括折扣和優惠券;目前沒有單獨的欄位。 由商家提供。
銷售稅
 salesTax double

交易收取的銷售稅。 由商家提供。
貨幣
 currency string

原始購買的貨幣，採用 ISO 4217 代碼格式（美元、英鎊等）。
shipping方法
 shippingMethod string

指出用於運送購買的方法。 可能的值 'InStorePickup' |「標準」 |“快遞” |“DirectEntitlement” |“數字代幣”
transactionProcessingOrder
 transactionProcessingOrder string

在交易流程期間進行詐騙評估的順序。 可能的值為 PREAUTHORIZATION、POSTAUTHORIZATION、BEFORE3DS AFTER3DS
recurringSubscriptionId
 recurringSubscriptionId string

週期性費用的唯一 ID
recurringChargeSequence
 recurringChargeSequence string

此客戶發生週期性費用的第 n 次 （1， 2， 3...）。
中間名稱
 midName string

與MID（商家識別碼）相關聯的商家名稱。
交易說明
 transactionDescription string

交易處理類型。 可能的值是 SUBSCRIPTIONFEE、DELAYEDCHARGES、NOSHOW、DEPOSIT
shipping電子郵件
 shippingEmail string

使用者的運送電子郵件地址
自訂數據
 customData object

可以傳入的鍵值對，以使用規則等。 瞭解更多https://docs.microsoft.com/dynamics365/fraud-protection/schema#download-sample-data
出貨日期
 shippingDate date-time

訂單出貨日期
orderInitiated通道
 orderInitiatedChannel string

建立交易的管道 （例如：「AppStore」、「Web」、「MobileWeb」、「App」、「InGamePurchase」）
orderInitiatedChannelName
 orderInitiatedChannelName string

建立交易的應用程式名稱或 Web URL
orderInitiatedChannelRegionORCountry
 orderInitiatedChannelRegionORCountry string

建立交易的市場（例如：App 市場）
商家業務區段L2
 merchantBusinessSegmentL2 string

第二級業務或產業區隔
lastUpdate年份
 lastUpdateYear integer

上次更新項目的年份
userId
 userId True string

使用者識別碼。 此資訊由商家提供。
創建日期
 creationDate date-time

使用者帳戶的建立日期。 格式為 ISO 8601。
更新日期
 updateDate date-time

上次變更使用者資料的日期。 格式為 ISO 8601。
名字
 firstName string

使用者在帳戶上提供的名字。
lastName
 lastName string

使用者在帳戶上提供的姓氏。
country
 country string

使用者所在的國家或地區。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，美國）。
郵遞區號
 zipCode string

使用者的郵遞區號。
timeZone
 timeZone string

使用者的時區。
語言
 language string

使用者的語言和地區 （例如，EN-US）。
電話號碼
 phoneNumber string

使用者的電話號碼。 格式應該是國家/地區代碼，後面接著連字號 （-），然後是電話號碼 （例如，對於美國，+1-1234567890）。
電子郵件
 email string

使用者的電子郵件地址。 此值不區分大小寫。
membershipId
 membershipId string

會員資格 ID，如果使用者已經擁有商家的現有會員資格。
個人資料類型
 profileType string

使用者的設定檔類型。 可能的值 'Consumer' |“賣家” |“出版商” |“租戶” |“開發商”
設定檔名稱
 profileName string

設定檔名稱，視 profileType 而定。
authenticationProvider
 authenticationProvider string

使用者的驗證提供者 （如果與商家的驗證提供者不同）。 可能的價值 'MSA' |“臉書” |“PSN” |“商家認證” |“谷歌”
驗證方法
 authenticationMethod string

客戶在購買前/購買期間進行驗證的方式。 一些可能的值包括 PASSWORD-BASED、MULTI-FACTOR、BIOMETRIC、TOKEN-BASED、
顯示名稱
 displayName string

使用者的顯示名稱。 範例：Xbox 玩家代號值
isEmail已驗證
 isEmailValidated boolean

True/False 值，指出使用者提供的電子郵件地址是否已驗證為使用者擁有。
電子郵件驗證日期
 emailValidatedDate date-time

使用者電子郵件的驗證日期。 格式為 ISO 8601。
isPhoneNumber已驗證
 isPhoneNumberValidated boolean

True/False 值，指出使用者提供的電話號碼是否已驗證為使用者擁有。
phoneNumber驗證日期
 phoneNumberValidatedDate date-time

使用者電話號碼的驗證日期。 格式為 ISO 8601。
membershipType
 membershipType string

客戶的會員資格狀態或類型。 可以指定不同的付費級別，例如高級、行政。 可能的值為 FREE、PAID、PREMIUM
login輸入方法
 loginInputMethod string

客戶輸入其認證的方式。 可能的值為 MANUALINPUT、AUTOFILL、SCRIPT、COPYPASTE、SELECTPROFILE
lastPasswordUpdatedDate
 lastPasswordUpdatedDate date-time

客戶密碼上次更新的時間。
第一個購買日期
 firstPurchaseDate date-time

當客戶首次購買時
loginChallenge類型
 loginChallengeType string

已啟動的挑戰-回應測試類型。 可能的值包括 TEXT SMS、PHONE SMS、EMAIL PIN、CAPTCHA
裝置內容識別碼
 deviceContextId True string

客戶的指紋識別工作階段 ID，或事件識別碼 （如果工作階段無法使用）。
提供者
 provider string

裝置資訊的提供者。 可能的值為 'DFPFingerPrinting' |“商人”。 如果使用 DFP 指紋識別 JS 指令碼，您必須傳遞 'DFPFingerPrinting' 才能正確連線所有資料。
裝置內容DC
 deviceContextDC string

已淘汰：DFP 指紋識別不再需要。 儲存客戶 DFP 指紋工作階段的資料中心 （由 DFP 指紋 JS 指令碼提供）。
externalDeviceId
 externalDeviceId string

客戶的裝置 ID，由商家提供並掌握。
externalDeviceType
 externalDeviceType string

客戶的裝置類型，由商家提供和掌握。 可能的值 'Mobile' |“計算機” |“商戶硬件” |“平板電腦” |“遊戲機”
ipAddress
 ipAddress string

客戶的IP地址（由商家提供）
http簽名
 httpSignature string

HTTP 訊息的數位簽章。
httpUserAgent
 httpUserAgent string

用來識別應用程式、作業系統、廠商和/或版本的要求標頭。
browser標頭
 browserHeader string

瀏覽器傳送的要求標頭完整清單。
瀏覽器解決方案
 browserResolution string

瀏覽器解析度。
瀏覽器語言
 browserLanguage string

瀏覽器預設語言偏好設定。
tcp簽名
 tcpSignature string

TCP 應用程式簽章。
ssl簽名
 sslSignature string

SSL 簽章。
啟用Cookie
 enabledCookies boolean

True/False 值，指出是否已啟用 Cookie。
啟用快閃記憶體
 enabledFlash boolean

True/False 值，指出是否啟用 Flash。
已啟用JavaScript
 enabledJavaScript boolean

True/False 值，指出是否啟用 javascript。
螢幕寬高比
 screenAspectRatio string

瀏覽器的長寬比。
螢幕顏色深度
 screenColorDepth string

螢幕的色彩深度。
螢幕解析度
 screenResolution string

裝置螢幕解析度 （以像素為單位）
siteHostName
 siteHostName string

網站的主機名稱。
操作系統
 os string

裝置作業系統。
oS版本
 oSFonts string

作業系統的預設字型。
裝置處理器
 deviceProcessor string

裝置處理器。
sessionId
 sessionId string

唯一的工作階段 ID。
真IP
 trueIp string

透過裝置指紋識別的裝置真實IP位址
代理IP
 proxyIp string

代理設備的IP地址。
deviceId
 deviceId string

裝置指紋所產生的每個裝置的唯一 GUID
timeZone
 timeZone string

當地時區相對於 GMT 的偏移量（以小時為單位）
userAgent詳細資料
 userAgentDetails string

其他使用者代理程式或瀏覽器詳細資料。
應用程式版本
 appVersion string

應用程式版本。
瀏覽器套件清單
 browserPackagesList string

裝置上安裝的套件清單。
建置製造商
 buildManufacturer string

設備製造商。
建構模型
 buildModel string

最終產品的最終使用者可見名稱。
buildSdk版本
 buildSdkVersion string

組建版本。
資料網路類型
 dataNetworkType string

行動數據網路的類型。
裝置型號名稱
 deviceModelName string

裝置型號。
裝置系統名稱
 deviceSystemName string

本機的裝置名稱。
裝置系統版本
 deviceSystemVersion string

裝置版本。
是藍牙啟用
 isBluetoothEnabled boolean

True/False 值，表示是否已啟用藍牙。
simNetwork國家ISO
 simNetworkCountryISO string

行動服務供應商的 ISO 國家/地區代碼。
simNetwork類型
 simNetworkType string

行動網路類型。
系統正常運行時間
 systemUpTime string

裝置運作且可用的持續時間。
merchantPaymentInstrumentId
 merchantPaymentInstrumentId string

付款方式的識別碼。 此資訊由商家提供。
付款方式
 paymentMethod string

最上層付款方式類別。 可能的值包括 CARD、CASH、DIRECTDEBIT、E-WALLET、MOBILE、E-BANKING、INVOICE、VOUCHERS
型別
 type True string

付款類型。 可能的值 'CreditCard' |“DirectDebit” |「PayPal」 |「行動帳單」 |「網上銀行轉帳」 |「發票」 |「商戶禮品卡」 |“商家錢包” |「送貨上付款」 |“Paytm” |“CCAvenue”
創建日期
 creationDate date-time

在商家系統中首次輸入付款方式的日期。 格式為 ISO 8601。
更新日期
 updateDate date-time

商家系統中付款方式的上次更新日期。 格式為 ISO 8601。
付款結帳提供者
 paymentCheckoutProvider string

電子錢包結帳提供者。
是低責任PIType
 isLowLiabilityPIType boolean

True/False 值，指出付款方式是否為低負債。
狀態
 state string

商家系統中 PI 的現行狀態。 可能的值 'Active' |“不活躍”
卡片類型
 cardType string

此屬性僅用於信用卡/簽帳金融卡類型的付款。 提供卡的網路。 可能的值 'Visa' |“萬事達卡” |“美國運通” |“ACH” |“SEPA” |「銀聯」 |《伊尼西斯》 |“移動計費運營商” |“發現” |「AllPay」 |“JCB” |“發現食客”
持有人名稱
 holderName string

付款工具使用者的名稱。 此屬性僅用於信用卡/簽帳金融卡類型的付款。
持有人公司名稱
 holderCompanyName string

提供公司卡或公司卡的組織名稱（僅適用於商業購買）。
settlementApprovalRequired（結算）ApprovalRequired
 settlementApprovalRequired boolean

True/False 值，指出 SEPA 交易是否需要核准。
間隔
 bin string

此屬性僅用於信用卡/簽帳金融卡類型的付款。
bin名稱
 binName string

BIN 顯示名稱。
bin國家/地區ISO
 binCountryISO string

與 BIN 相關聯的 ISO 國家/地區代碼。
binCardType
 binCardType string

BIN 卡類型。 可能的值為 DEBIT、CREDIT、PREPAID、FLEET、CREDITDEBIT
binCard關聯
 binCardAssociation string

BIN 卡關聯。 一些可能的價值包括 VISA、MASTERCARD、AMEX、DISCOVER、MAESTRO、JCB、銀聯、DINERSCLUB
binBank集團
 binBankGroup string

BIN銀行集團。
到期日期
 expirationDate string

商家系統中付款方式的到期日。 格式為 ISO 8601。 此屬性僅用於信用卡/簽帳金融卡類型的付款。
lastFourDigits
 lastFourDigits string

此屬性僅用於信用卡/簽帳金融卡類型的付款。
電子郵件
 email string

與付款工具相關聯的電子郵件地址。 此屬性僅用於PayPal型別的付款。
billingAgreementId
 billingAgreementId string

此屬性僅用於PayPal型別的付款。
付款人識別碼
 payerId string

此屬性僅用於PayPal型別的付款。
付款人狀態
 payerStatus string

指出 PayPal 是否已驗證付款人的值。 此屬性僅用於PayPal型別的付款。 可能的值 '已驗證' |“未經證實”
地址狀態
 addressStatus string

指出 PayPal 是否已驗證付款人地址的值。 此屬性僅用於PayPal型別的付款。 可能的值 'Confirmed' |“未經證實”
伊梅
 imei string

此屬性僅用於行動支付類型的付款。
貨幣
 currency string

所選付款工具的貨幣代碼。
是國際匯款
 isInternationalMoneyTransfer boolean

True/False 值，指出是否發生國際匯款。
銀行識別碼
 bankIdentifierCode string

銀行識別碼（BIC 或 SWIFT 代碼）
銀行名稱
 bankName string

銀行名稱
銀行郵遞區號
 bankZipCode string

銀行郵遞區號
銀行狀態
 bankState string

銀行狀態
銀行國家/地區ISO
 bankCountryISO string

銀行 ISO 國家
付款收款日期
 paymentCollectionDate date-time

收款的預計日期（主要用於支付服務提供者）。
即時付款結算
 instantPaymentSettlement boolean

True/False 值表示銀行重新導向 （用於支援 CSV 付款）。
自動擷取已啟用
 autoCaptureEnabled boolean

True/False 值，指出是否自動擷取卡片付款的付款。 對於重定向付款，這只是合作夥伴銀行是否自動提取資金的指標。
accountType 帳戶類型
 accountType string

指出要為交易收取的帳戶類型。 UNSPECIFIED 是預設值。 CHEQUE_ACCOUNT將該卡用作借記卡。 CREDIT_FACILITY使用該卡作為信用卡。
authorizationType
 authorizationType string

授權類型。 萬事達卡和維薩卡現在要求商家將授權嘗試定義為預授權或最終授權。 可能的值為 PRE_AUTHORIZATION、FINAL_AUTHORIZATION
授權結果代碼
 authorizationResultCode string

銀行對授權決定的回應。 可能的值為 APPROVE、DECLINE、PENDING
授權結果文字
 authorizationResultText string

授權決定的理由;特別是對於被拒絕或待處理的交易。 可能的值為MISMATCH_CVV、MISMATCH_ADDRESS、MISMATCH_EXPIRATIONDATE、NOACCOUNT、INVALIDPIN、LOWFUND、OVERLIMIT SUSPICIOUSACCOUNT
收購機構識別碼
 acquirerId string

取得機構識別碼。
收單機構國家/地區ISO
 acquirerCountryISO string

收單機構國家代碼
cvv驗證
 cvvVerify string

指出 CVV 驗證是否可用和/或成功驗證。 Y = 驗證成功，N = 未成功驗證，U = 不可用，A = 可用，但未驗證
avs驗證
 avsVerify string

指出 addres 驗證是否可用和/或成功驗證。 Y = 驗證成功，N = 未成功驗證，U = 不可用，A = 可用，但未驗證
cav驗證
 cavVerify string

指出持卡人驗證是否可用和/或成功驗證。 Y = 驗證成功，N = 未成功驗證，U = 不可用，A = 可用，但未驗證
piInputMethod
 piInputMethod string

N/A
encrypted信用卡號碼
 encryptedCreditCardNumber string

雜湊或加密的信用卡號碼。
購買金額
 purchaseAmount double

使用此 PI 進行交易的總購買金額
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
country
 country string

為地址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，美國）。
名字
 firstName string

名字與地址一起提供
lastName
 lastName string

姓氏與地址一起提供
電話號碼
 phoneNumber string

與地址一起提供的電話號碼
organizationId
 organizationId True string

商家或組織的唯一識別碼。
名稱
 name True string

組織名稱
郵遞區號
 zipCode string

組織所在的郵遞區號
狀態
 state string

組織所在的州
國家/地區ISO
 countryISO string

組織所在的國家/地區 ISO
organizationId
 organizationId True string

商家或組織的唯一識別碼。
名稱
 name True string

組織名稱
郵遞區號
 zipCode string

組織所在的郵遞區號
狀態
 state string

組織所在的州
國家/地區ISO
 countryISO string

組織所在的國家/地區 ISO
organizationId
 organizationId True string

商家或組織的唯一識別碼。
名稱
 name True string

組織名稱
郵遞區號
 zipCode string

組織所在的郵遞區號
狀態
 state string

組織所在的州
國家/地區ISO
 countryISO string

組織所在的國家/地區 ISO
是ThreeDSAuth
 isThreeDSAuth boolean

True/False 值，指出此交易是否透過 3DS 進行驗證。
訊息類別
 messageCategory string

識別特定使用案例的訊息類別。 接受的值：01 = PA、02 = NPA、03-79 = 保留供 EMVCo 未來使用（在 EMVCo 定義之前值無效）、80-99 = 保留供 DS 使用
裝置通道
 deviceChannel string

指出用來起始交易的通道介面類型。 接受的值：01 = 應用程式型 （APP）、02 = 瀏覽器 （BRW）、03 = 3DS 請求者啟動 （3RI）、04-79 = 保留供 EMVCo 未來使用 （值在 EMVCo 定義之前無效）、80-99 = 保留供 DS 使用
threeDSServerTransId
 threeDSServerTransId string

由 3DS 伺服器分配的通用唯一交易識別碼，用於識別單一交易。
threeDSRequestorAuthenticationInd
 threeDSRequestorAuthenticationInd string
threeDSRequestorChallengeInd
 threeDSRequestorChallengeInd string

指出是否為此交易要求挑戰。 接受的值：01 = 無偏好設定、02 = 未要求質詢、03 = 要求質詢 （3DS 要求者偏好設定）、04 = 要求質詢 （授權）、05 = 未要求質詢 （已執行交易風險分析）、06 = 未要求質詢 （僅限資料共用）、07 = 未要求質詢 （已執行強式消費者身份驗證）、08 = 未要求質詢 （如果不需要質詢，則使用白名單豁免）， 09 = 請求挑戰（如果需要挑戰，則請求白名單提示）
三RIInd
 threeRIInd string

指出 3RI 要求的類型。 接受的值：01 = 定期交易，02 = 分期付款交易，03 = 添加卡，04 = 維護卡信息，05 = 帳戶驗證，06 = 拆分，延遲發貨，07 = 充值，08 = 郵購，09 = 電話訂單，10 = 白名單狀態檢查，11 = 其他付款，12-79 = 保留供 EMVCo 將來使用（值在 EMVCo 定義之前無效），80-99 = 保留供 DS 使用
threeDSReqPriorAuthMethod
 threeDSReqPriorAuthMethod string

持卡人先前向 3DS 請求者進行身份驗證的機制。 接受的值：01 = ACS 發生無摩擦驗證、02 = ACS 發生持卡人質疑、03 = AVS 驗證、04 = 其他發卡機構方法、05-79 = 保留供 EMVCo 未來使用 （值在 EMVCo 定義之前無效）、80-99 = 保留供 DS 使用
跨狀態
 transStatus string

指出交易是否符合已驗證交易或帳戶驗證的資格。 接受的值：Y = 驗證驗證成功。 N = 未驗證，帳戶未驗證;交易被拒絕。 U = 認證，無法進行帳戶驗證;技術或其他問題，如 ARes 或 RReq 所示。 A = 執行的嘗試處理次數;未驗證，已驗證，但提供嘗試驗證的證明，驗證。 C = 需要挑戰;需要使用 CReq，CRes 進行其他身份驗證。 D = 需要挑戰;已確認分離驗證。 R = 身份驗證，帳戶驗證被拒絕;發卡機構拒絕驗證、驗證，並要求不要嘗試授權。 I = 僅供參考;確認 3DS 請求者挑戰偏好。
transStatus原因
 transStatusReason string

提供有關 [交易狀態] 欄位具有指定值的原因的資訊。 接受的值：01 = 卡身份驗證失敗，02 = 未知裝置，03 = 不支援的裝置，04 = 超過身份驗證頻率限制，05 = 過期的卡，06 = 無效的卡號，07 = 無效交易，08 = 無卡記錄，09 = 安全故障，10 = 卡被盜，11 = 涉嫌欺詐，12 = 不允許持卡人交易，13 = 持卡人未註冊服務，14 = ACS 交易超時， 15 = 低置信度，16 = 中置信度，17 = 高置信度，18 = 非常高置信度，19 = 超過 ACS 最大挑戰，20 = 不支援非付款交易，21 = 不支援 3RI 交易，22 = ACS 技術問題，23 = ACS 需要但 3DS 請求者未請求的解耦身份驗證，24 = 3DS 請求者解耦最大到期時間已超過，25 = 分離身份驗證沒有足夠的時間來驗證持卡人。 ACS不會嘗試，26 =嘗試驗證但未由持卡人執行，27-79 =保留供EMVCo將來使用（值在EMVCo定義之前無效），80-99 = 保留供DS使用
三DSCompInd
 threeDSCompInd string

指出 3DS 方法是否成功完成。 接受的值：Y = 成功完成，N = 未成功完成，U = 無法使用的 3DS 方法 URL 不存在於與持卡人帳號相關聯的卡片範圍的 PRes 訊息資料中。
acsChallenge已強制
 acsChallengeMandated string

表明由於當地/區域授權或其他變數，交易是否需要提出質疑才能獲得授權。 接受的值：Y = 強制挑戰，N = 非強制挑戰
ECI
 eci string

電子商務指標 （ECI）。 ACS 或 DS 提供的支付系統特定值，用於指示嘗試驗證持卡人的結果。 接受的值：02 （MasterCard）/05 （Visa）= 成功驗證 01 （MasterCard）/06/07 （Visa） = 所有其他值
shipName指標
 shipNameIndicator string

指出帳戶上的持卡人姓名是否與用於此交易的託運名稱相同。 接受的值：01 = 帳戶名稱與出貨名稱相同，02 = 帳戶名稱與出貨名稱不同
challengeCompletionInd
 challengeCompletionInd string

ACS 挑戰週期狀態的指標，以及挑戰是否已完成或將需要其他訊息。 接受的值：Y = 挑戰已完成，不需要進一步的挑戰訊息交換，N = 挑戰未完成，且需要額外的挑戰訊息交換
chAccPwChangeInd
 chAccPwChangeInd string

表示持卡人在 3DS 請求者的帳戶更改密碼或重置帳戶以來的時間長度。 接受的值：01 = 無變化，02 = 在此交易期間發生變化，03 = 少於 30 天，04 = 30-60 天，05 = 超過 60 天
chAccAgeInd
 chAccAgeInd string

持卡人在 3DS 請求者處擁有帳戶的時間長度。 接受的值：01 = 無帳戶（訪客退房）、02 = 在此交易期間建立、03 = 少於 30 天、04 = 30-60 天、05 = 超過 60 天
provisionAttemptsDay
 provisionAttemptsDay string

過去 24 小時內嘗試新增卡片的次數。 長度：最多 3 個字元範例值：2、02、002
豁免已提高
 exemptionRaised string

PSD2 豁免請求，Y - 豁免，N - 不豁免
可疑的 AccActivity
 suspiciousAccActivity string

指出 3DS 請求者是否在持卡人帳戶上遇到可疑活動（包括先前的詐欺）。 接受的值：01 = 未觀察到可疑活動，02 = 已觀察到可疑活動
產品ID
 productId True string

商家系統中的產品識別碼。
產品名稱
 productName string

使用者可讀的產品名稱。
型別
 type string

所售產品類型。 可能的值 'Digital' |“身體”
sku
 sku string

產品 SKU
分類
 category string

產品類別。 可能的值 'Subscription' |“遊戲” |“遊戲消耗品” |“遊戲DLC” |“硬件設備” |「硬體配件」 |“軟件代幣” |「SoftwareDirectEntitlement」 |「服裝鞋」 |“娛樂設備” |「珠寶」 |“酒店” |“門票” |“車輛租賃” |「禮品卡」 |“電影” |“音樂” |“車庫工業” |「家庭花園」 |“工具” |“書籍” |「健康美容」 |「傢俬」 |「玩具」 |“食品雜貨店”
merchantProduct類別
 merchantProductCategory string

商家在其系統中定義的產品類別
市
 market string

提供產品的市場
產品品牌
 productBrand string

產品品牌名稱
購買它再次訂購
 buyItAgainOrder boolean

當使用者重新訂購先前的訂單 （而不只是該訂單中的產品） 時為 True
preOrderAvailabilityDate
 preOrderAvailabilityDate date-time

產品首次開放預訂時
銷售價格
 salesPrice double

已售商品的價格（不含稅）。 由商家提供。
貨幣
 currency string

用於銷售價格的貨幣。 由商家提供。
齒輪
 cogs double

銷貨成本 - 物品的原材料成本。 由商家提供。
是經常性
 isRecurring boolean

指出產品是否為週期性訂閱。
是免費的
 isFree boolean

指出產品是否免費提供。
語言
 language string

描述產品的語言。
購買價格
 purchasePrice double

購買時委刊項的價格。
邊界
 margin double

出售商品獲得的利潤。
數量
 quantity integer

購買的商品數量
是預購
 isPreorder boolean

指出產品是否可供預訂。
shipping方法
 shippingMethod string

指出用於運送產品的方法。 可能的值 'InStorePickup' |「標準」 |“快遞” |“DirectEntitlement” |“數字代幣”
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
country
 country string

為地址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，美國）。
名字
 firstName string

名字與地址一起提供
lastName
 lastName string

姓氏與地址一起提供
電話號碼
 phoneNumber string

與地址一起提供的電話號碼
儲存標識
 storeId True string

商家系統中的商店識別碼
storeName
 storeName string

商家系統中的店鋪名稱
終端標識碼
 terminalId string

銷售點終端機的唯一識別碼
終端名稱
 terminalName string

銷售點終端名稱
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
country
 country string

為地址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，美國）。
userId
 userId True string

使用者識別碼。 此資訊由商家提供。
創建日期
 creationDate date-time

使用者帳戶的建立日期。 格式為 ISO 8601。
更新日期
 updateDate date-time

上次變更使用者資料的日期。 格式為 ISO 8601。
名字
 firstName string

使用者在帳戶上提供的名字。
lastName
 lastName string

使用者在帳戶上提供的姓氏。
country
 country string

使用者所在的國家或地區。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，美國）。
郵遞區號
 zipCode string

使用者的郵遞區號。
timeZone
 timeZone string

使用者的時區。
語言
 language string

使用者的語言和地區 （例如，EN-US）。
電話號碼
 phoneNumber string

使用者的電話號碼。 格式應該是國家/地區代碼，後面接著連字號 （-），然後是電話號碼 （例如，對於美國，+1-1234567890）。
電子郵件
 email string

使用者的電子郵件地址。 此值不區分大小寫。
membershipId
 membershipId string

會員資格 ID，如果使用者已經擁有商家的現有會員資格。
個人資料類型
 profileType string

使用者的設定檔類型。 可能的值 'Consumer' |“賣家” |“出版商” |“租戶” |“開發商”
設定檔名稱
 profileName string

設定檔名稱，視 profileType 而定。
authenticationProvider
 authenticationProvider string

使用者的驗證提供者 （如果與商家的驗證提供者不同）。 可能的價值 'MSA' |“臉書” |“PSN” |“商家認證” |“谷歌”
驗證方法
 authenticationMethod string

客戶在購買前/購買期間進行驗證的方式。 一些可能的值包括 PASSWORD-BASED、MULTI-FACTOR、BIOMETRIC、TOKEN-BASED、
顯示名稱
 displayName string

使用者的顯示名稱。 範例：Xbox 玩家代號值
isEmail已驗證
 isEmailValidated boolean

True/False 值，指出使用者提供的電子郵件地址是否已驗證為使用者擁有。
電子郵件驗證日期
 emailValidatedDate date-time

使用者電子郵件的驗證日期。 格式為 ISO 8601。
isPhoneNumber已驗證
 isPhoneNumberValidated boolean

True/False 值，指出使用者提供的電話號碼是否已驗證為使用者擁有。
phoneNumber驗證日期
 phoneNumberValidatedDate date-time

使用者電話號碼的驗證日期。 格式為 ISO 8601。
membershipType
 membershipType string

客戶的會員資格狀態或類型。 可以指定不同的付費級別，例如高級、行政。 可能的值為 FREE、PAID、PREMIUM
login輸入方法
 loginInputMethod string

客戶輸入其認證的方式。 可能的值為 MANUALINPUT、AUTOFILL、SCRIPT、COPYPASTE、SELECTPROFILE
lastPasswordUpdatedDate
 lastPasswordUpdatedDate date-time

客戶密碼上次更新的時間。
第一個購買日期
 firstPurchaseDate date-time

當客戶首次購買時
loginChallenge類型
 loginChallengeType string

已啟動的挑戰-回應測試類型。 可能的值包括 TEXT SMS、PHONE SMS、EMAIL PIN、CAPTCHA
航空公司包含
 airlineIncluded boolean

True/False 值，指出是否包含機票價格。
汽車租賃包含
 carRentalIncluded boolean

True/False 值，指出是否包含汽車租賃。
住宿包含
 lodgingIncluded boolean

True/False 值，指出是否包含住宿。
旅行類型
 travelType string

旅行類別或類型。
是來回
 isRoundTrip boolean

True/False 值，指出出差是否為來回。
是折扣優惠
 isDiscountOffered boolean

True/False 值，指出是否提供折扣。
是打包旅遊
 isPackagedTour boolean

True/False 值，指出這是否是套件遊覽。
issueDateTime
 issueDateTime date-time

票券開立的日期和時間。
travelDateTime
 travelDateTime date-time

旅行開始日期和時間。
returnDateTime
 returnDateTime date-time

旅行結束或返回日期和時間。
預訂類型
 bookingType string

預約類型。 一些可能的值是 WEBSITE、AGENT
網址
 webUrl string

預訂旅行的 URL。
fromCity
 fromCity string

客戶出發的城市。
fromState
 fromState string

客戶的出發地。
fromCountryISO
 fromCountryISO string

客戶出發的 ISO 國家/地區。
from郵遞區號
 fromZipCode string

客戶出發的郵遞區號。
到城市
 toCity string

客戶要前往的城市。
到狀態
 toState string

客戶要前往的州。
到國家/地區ISO
 toCountryISO string

客戶要前往的 ISO 國家/地區。
到郵遞區號
 toZipCode string

客戶要前往的郵遞區號。
票號
 ticketNumber string

唯一的票號。
問題地點
 placeOfIssue string

開票地點。
isRestrictedTicket
 isRestrictedTicket boolean

True/False 值，指出票證是否受到限制。
獎勵或優惠券已申請
 rewardsOrVoucherApplied boolean

True/False 值，指出獎勵或抵用券是否已套用至訂單。
總獎勵已申請
 totalRewardsApplied integer

應用於訂單的總獎勵。
總費用
 totalFees double

適用於訂單的總費用。
purchaser設定檔類型
 purchaserProfileType string

客戶的設定檔或成員資格類型。 可能的值為 CORPORATE、INDIVIDUAL
是第三方
 isThirdParty boolean

True/False 值，指出訂單是否透過第三方網站下達。
是購買者常客傳單
 isPurchaserFrequentFlyer boolean

True/False 值，指出訂單是否透過第三方網站下達。
passengerCount
 passengerCount integer

乘客總數。
停止數
 numberOfStops integer

航班的中途停留或中途停留次數。
航空公司代碼
 airlineCode string

航空公司代碼。
航空公司名稱
 airlineName string

航空公司名稱。
營運者
 operatedBy string

運營航班的組織。
航班編號
 flightNumber string

航班號。
出發日期時間
 departureDateTime date-time

出發日期和時間。
抵達日期時間
 arrivalDateTime date-time

到達日期和時間。
從機場代碼
 fromAirportCode string

航班起飛的機場代碼。
fromAirportCity
 fromAirportCity string

客戶出發的機場城市。
fromAirportState
 fromAirportState string

客戶出發的機場州。
fromAirport郵遞區號
 fromAirportZipcode string

客戶出發的機場郵遞區號。
fromAirportCountryISO
 fromAirportCountryISO string

客戶出發的機場 ISO 國家/地區。
到機場代碼
 toAirportCode string

航班飛往的機場代碼。
前往機場城
 toAirportCity string

客戶要前往的機場城市。
到機場州
 toAirportState string

客戶要前往的機場州。
toAirport郵遞區號
 toAirportZipcode string

客戶前往的機場郵遞區號。
到機場國家/地區ISO
 toAirportCountryISO string

客戶前往的機場 ISO 國家/地區。
旅行類別
 travelClass string

座位等級或客艙。
segmentSequence
 segmentSequence integer

給定航段的序號（例如，航班的第二航段為 2）
名字
 firstName string

乘客名字。
lastName
 lastName string

乘客姓氏。
對開本編號
 folioNumber string

住宿物業的唯一識別碼。
checkInDate
 checkInDate date-time

住宿的入住日期。
checkOutDate
 checkOutDate date-time

住宿的退房日期。
預訂已確認
 reservationConfirmed boolean

True/False 值，指出保留是否已確認。
會員資格詳情
 membershipDetails string

有關客戶會員資格狀態的其他詳細資訊。
折扣計劃
 discountProgram string

折扣計劃適用於住宿訂單。
成人計數
 adultCount integer

住宿中包含的成人人數。
孩子計數
 kidCount integer

住宿中包含的兒童人數。
夜晚計數
 nightsCount integer

住宿包含的晚數。
房間計數
 roomCount integer

住宿中包含的房間數量。
床型
 bedType string

床型或類別。
房間類型
 roomType string

房間類型或類別。
付款說明
 paymentDescription string

有關住宿付款的其他詳細資訊。
名稱
 name string

設施名稱。
型別
 type string

設施類型。
contact電話號碼
 contactPhoneNumber string

用於聯繫該設施的電話號碼。
聯繫我們電子郵件
 contactEmail string

用於聯繫設施的電子郵件地址。
每日房價
 dailyRoomRate double

該設施的每日房價。
貨幣
 currency string

設施支援的貨幣。
dailyRoomTax金額
 dailyRoomTaxAmount double

設施收取的每日客房稅金額。
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
country
 country string

為地址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，美國）。
pickup地點
 pickupLocation string

租車取車地點。
pickupDateTime
 pickupDateTime date-time

租車取車日期和時間。
dropOff位置
 dropOffLocation string

租車還車地點。
dropOffDateTime
 dropOffDateTime date-time

租車還車日期和時間
折扣計劃
 discountProgram string

折扣計劃適用於汽車租賃訂單。
汽車類型
 carType string

汽車類型或類別。
是預付費
 isPrepaid boolean

True/False 值，表示汽車租賃是否已預付。
保險已包含
 insuranceIncluded boolean

True/False 值，指出是否包含保險。
聯繫我們電子郵件
 contactEmail string

租車人的電子郵件地址。
contact電話號碼
 contactPhoneNumber string

租車人的電話號碼。
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
country
 country string

為地址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，美國）。
機構代碼
 agencyCode string

旅行社代碼。
代理機構名稱
 agencyName string

旅行社名稱。
agent代碼
 agentCode string

N/A
代理聯絡電話
 agencyContactPhone string

N/A
代理機構聯絡方式電子郵件
 agencyContactEmail string

N/A
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
country
 country string

為地址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，美國）。
organizationId
 organizationId True string

雲端服務或組織的唯一識別碼。
companyName
 companyName string

雲端服務名稱。
公司類型
 companyType string

雲端公司類型。
公司規模
 companySize integer

雲端公司規模。
entityId
 entityId string

組織下法律實體的唯一識別碼。
primaryContactFirstName
 primaryContactFirstName string

企業主要連絡人的名字。
primaryContactLastName
 primaryContactLastName string

企業主要連絡人的姓氏。
主要聯絡方式電子郵件
 primaryContactEmail string

企業主要連絡人的電子郵件地址。
primaryContactPhoneNumber
 primaryContactPhoneNumber string

企業主要連絡人的電話號碼。
訂閱計數
 subscriptionCount integer

可用的訂閱總數。
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
country
 country string

為地址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，美國）。
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp date-time

事件的時間戳記

傳回

結果詳情

身體
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseActivity.PurchaseResponseWrapper

提供自訂事件的風險評估

作業識別碼：
Assessment_v1_Assessment

此事件可讓您傳送他們自己選擇的結構，由他們自己選擇的條件觸發，以進行規則評估。 回應包含事件的決定

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
評量 API 名稱
 assessment-api-name True string

評量的 API 名稱
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
名稱
 name True string

評量事件名稱。 名稱應符合評估建立期間的 API 名稱，以及 URL 的 '{assessment-API-name}。
版本
 version True string

承載版本。 應該是「1.0」
trackingId
 trackingId True string

帳戶建立事件的識別碼。
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp True date-time

事件的時間戳記。
userId
 userId string

使用者識別碼。 此資訊由商家提供。
國家/地區
 countryRegion string

使用者的 CountryRegion。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，US）。
郵遞區號
 zipCode string

使用者的郵遞區號。
timeZone
 timeZone string

使用者的時區。
語言
 language string

使用者的語言和地區 （例如，EN-US）。
範例字串
 sampleString string

這是如何擴充使用者類型的範例。
是員工
 isEmployee boolean

基本類型的範例。
金額
 amount integer

範例欄位。
available
 available integer

範例欄位。

傳回

Dynamics 詐騙保護 API 的回應物件

身體
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccessDetails

更新已確認的欺詐信息

作業識別碼：
PurchaseProtection_v1_ChargebackEvent

此事件會傳送客戶與銀行爭議為詐騙的先前購買相關資訊。 這只是資料擷取事件。 許多商家會使用大量資料上傳來傳送這些事件

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
chargebackId
 chargebackId True string

識別此扣款事件的唯一字串
reason
 reason string

銀行提供的原因
狀態
 status string

可能的值 '查詢' |“接受” |“有爭議” |“逆轉” |“重新提交請求”
bankEvent時間戳記
 bankEventTimestamp date-time

來自銀行的時間戳記
金額
 amount double

交易退單金額
貨幣
 currency string

用於扣款金額的貨幣。
purchaseId
 purchaseId True string

原始購買標識碼
userId
 userId string

識別使用者的唯一字串
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp date-time

事件的時間戳記

傳回

結果詳情

身體
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.ChargebackActivity.ChargebackResponseWrapper

更新帳戶建立狀態

作業識別碼：
AccountProtection_v1_AccountCreationStatus

此事件會傳送帳戶建立狀態的更新，例如，如果帳戶建立已取消。 這只是資料擷取事件

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
名稱
 name True string

事件名稱。 應該是“美聯社。AccountCreation.Status'
版本
 version True string

承載版本。 應該是「0.5」
trackingId
 trackingId True string

帳戶建立狀態事件的識別碼。
signUpId
 signUpId True string

帳戶建立事件的識別碼。
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp True date-time

事件的時間戳記。
userId
 userId True string

使用者識別碼。 此資訊由商家提供。
狀態類型
 statusType True string

狀態類型：「已核准」|'已拒絕'|'待定“。
原因類型
 reasonType string

原因類型：'無'|'挑戰被遺棄'|'ChallengeFailed'|'挑戰通過'|'挑戰待定'|'ReviewFailed'|'審查通過'|'ReviewPendinge'。 預設為「無」。
challengeType
 challengeType string

審查狀態類型：「簡訊'|'電子郵件'|'電話'|'其他'|'沒有」。 預設為「無」。
statusDate
 statusDate True date-time

套用狀態的日期和時間。 格式為 ISO 8601。

傳回

Dynamics 詐騙保護成功物件

身體
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccess

更新帳戶登入狀態

作業識別碼：
AccountProtection_v1_AccountLoginStatus

此事件會傳送帳戶登入狀態的更新，例如，如果帳戶登入已取消。 這只是資料擷取事件

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
名稱
 name True string

事件名稱。 應該是“美聯社。AccountLogin.Status'
版本
 version True string

承載版本。 應該是「0.5」
trackingId
 trackingId True string

「帳戶登入狀態」事件的識別碼。
登入 ID
 loginId True string

帳戶登入事件的識別碼。
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp True date-time

事件的時間戳記。
userId
 userId True string

使用者識別碼。 此資訊由商家提供。
狀態類型
 statusType True string

狀態類型：「已核准」|'已拒絕'|'待定“。
原因類型
 reasonType string

原因類型：'無'|'挑戰被遺棄'|'ChallengeFailed'|'挑戰通過'|'挑戰待定'|'ReviewFailed'|'審查通過'|'ReviewPendinge'。 預設為「無」。
challengeType
 challengeType string

審查狀態類型：「簡訊'|'電子郵件'|'電話'|'其他'|'沒有」。 預設為「無」。
statusDate
 statusDate True date-time

套用狀態的日期和時間。 格式為 ISO 8601。

傳回

Dynamics 詐騙保護成功物件

身體
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccess

更新帳戶資訊以保護帳戶

作業識別碼：
AccountProtection_v1_AccountUpdate

此事件會更新或建立帳戶保護服務的使用者帳戶資訊，例如新增付款方式、新增地址或任何其他使用者屬性。 這只是資料擷取事件

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
使用者識別碼
 UserId True string

帳戶更新的使用者 ID
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
名稱
 name True string

事件名稱。 應該是“美聯社。帳戶更新'
版本
 version True string

承載版本。 應該是「0.5」
trackingId
 trackingId True string

帳戶更新事件的識別碼。
帳戶更新標識符
 accountUpdateId True string

帳戶更新事件的識別碼。 可以比對 trackingId。
評估類型
 assessmentType string

指出事件的評量類型。 可能的值為 'Evaluate' |“保護”。 如果未指定，預設值為「保護」。
客戶本地日期
 customerLocalDate True date-time

帳戶更新事件的建立日期，以客戶的當地時區為準。 格式為 ISO 8601。
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp True date-time

事件的時間戳記。
裝置內容識別碼
 deviceContextId True string

客戶的裝置 ID，由 DFP 裝置指紋識別服務提供和掌握。
ipAddress
 ipAddress string

客戶的 IP 位址。
提供者
 provider string

裝置資訊的提供者。 可能的值為 'DFPFingerprinting'|'商人'|'未知」。 如果未指定，則預設值為 'DFPFingerprinting'。
externalDeviceId
 externalDeviceId string

客戶的裝置 ID，由商家提供並掌握。
externalDeviceType
 externalDeviceType string

客戶的裝置類型，由商家提供和掌握。 可能的值為 'Mobile' 、 'Computer' 、 'MerchantHardware' 、 'Tablet' 、 'GameConsole'。
userId
 userId string

使用者識別碼。 此資訊由商家提供。
用戶類型
 userType string

使用者的設定檔類型。 可能的值為 'Consumer'|'開發商'|'賣家'|'出版商'|'租戶'。
使用者名稱
 username True string

使用者提供的使用者名稱。
名字
 firstName string

使用者在帳戶上提供的名字。
lastName
 lastName string

使用者在帳戶上提供的姓氏。
國家/地區
 countryRegion string

使用者的 CountryRegion。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，US）。
郵遞區號
 zipCode string

使用者的郵遞區號。
timeZone
 timeZone string

使用者的時區。
語言
 language string

使用者的語言和地區 （例如，EN-US）。
membershipId
 membershipId string

會員資格 ID，如果使用者已經擁有商家的現有會員資格。
isMembershipId使用者名稱
 isMembershipIdUsername boolean

membershipId 可以作為使用者名稱使用，預設為 False。
電話類型
 phoneType True string

值為：「主要」|」Alternative'，預設為 'Primary'。
電話號碼
 phoneNumber True string

使用者的電話號碼。 格式應該是國家/地區代碼，後面接著連字號 （-），然後是電話號碼 （例如，對於美國，+1-1234567890）。
isPhoneNumber已驗證
 isPhoneNumberValidated boolean

True/False 值，指出使用者提供的電話號碼是否已驗證為使用者擁有。
phoneNumber驗證日期
 phoneNumberValidatedDate date-time

使用者電話號碼的驗證日期。 格式為 ISO 8601。
isPhone使用者名稱
 isPhoneUsername boolean

電話號碼可作為使用者名稱使用，預設為 False。
電子郵件類型
 emailType True string

值為：「主要」、「替代」
電子郵件值
 emailValue True string

使用者的電子郵件地址。 此值不區分大小寫。
isEmail已驗證
 isEmailValidated boolean

True/False 值，指出使用者提供的電子郵件地址是否已驗證為使用者擁有。
電子郵件驗證日期
 emailValidatedDate date-time

使用者電子郵件的驗證日期。 格式為 ISO 8601。
isEmailUsername
 isEmailUsername boolean

電子郵件可作為使用者名稱使用，預設為 False。
authenticationProvider
 authenticationProvider True string

使用者的單一登入 （SSO） 驗證提供者 （如果與商家不同）。 可能的價值是 'MSA'|'臉書'|'PSN'|'商家身份驗證'|'谷歌“。
顯示名稱
 displayName True string

使用者的單一登入 （SSO） 驗證提供者 （如果與商家不同）。 可能的價值是 'MSA'|'臉書'|'PSN'|'商家身份驗證'|'谷歌“。
addressType
 addressType True string

地址類型。 值為：'Primary'|'計費'|'運輸'|'替代方案“。 預設為「主要」。
名字
 firstName string

使用者提供與地址相關聯的名字。
lastName
 lastName string

使用者提供的與地址相關聯的姓氏。
電話號碼
 phoneNumber string

與地址相關聯的使用者提供的電話號碼。
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
國家/地區
 countryRegion string

為位址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，US）。
merchantPaymentInstrumentId
 merchantPaymentInstrumentId True string

付款方式的識別碼。 此資訊由商家提供。
型別
 type True string

付款類型。 可能的值為： 'Other'|'信用卡'|'DirectDebit'|'PayPal'|'行動帳單'|'OnlineBankTransfer' |'發票' |'商家禮品卡'|'商家錢包'|'送貨時現金'|'Paytm'|'CCAvenue'。
創建日期
 creationDate date-time

在商家系統中首次輸入付款方式的日期。 格式為 ISO 8601。
更新日期
 updateDate date-time

商家系統中付款方式的上次更新日期。 不應早於 creationDate。 格式為 ISO 8601。
狀態
 state string

商家系統中 PI 的現行狀態。 可能的值為：「Active」|'已封鎖'|'已過期'
卡片類型
 cardType string

此屬性僅用於信用卡/簽帳金融卡類型的付款。 可能的值為：「Visa」|'萬事達卡'|'美國運通'|'ACH'|'SEPA'|'銀聯'|'伊尼西斯'|'MobileBillingCarrier'|'發現'|'全付通'|'JCB' |'發現食客。
持有人名稱
 holderName string

付款工具使用者的名稱。 此屬性僅用於信用卡/簽帳金融卡類型的付款。
間隔
 bin string

信用卡/借記卡垃圾箱。 此屬性僅用於信用卡/簽帳金融卡類型的付款。
到期日期
 expirationDate string

商家系統中付款方式的到期日。 格式為 ISO 8601。 此屬性僅用於信用卡/簽帳金融卡類型的付款。
lastFourDigits
 lastFourDigits string

信用卡/借記卡的最後四位數字。 此屬性僅用於信用卡/簽帳金融卡類型的付款。
addressType
 addressType True string

地址類型。 值為：'Primary'|'計費'|'運輸'|'替代方案“。 預設為「主要」。
名字
 firstName string

使用者提供與地址相關聯的名字。
lastName
 lastName string

使用者提供的與地址相關聯的姓氏。
電話號碼
 phoneNumber string

與地址相關聯的使用者提供的電話號碼。
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
國家/地區
 countryRegion string

為位址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，US）。
電子郵件
 email string

與付款工具相關聯的電子郵件地址。 此屬性僅用於PayPal型別的付款。
billingAgreementId
 billingAgreementId string

此屬性僅用於PayPal型別的付款。
付款人識別碼
 payerId string

此屬性僅用於PayPal型別的付款。
付款人狀態
 payerStatus string

指出 PayPal 是否已驗證付款人的值。 此屬性僅用於PayPal型別的付款。
地址狀態
 addressStatus string

指出 PayPal 是否已驗證付款人地址的值。 此屬性僅用於PayPal型別的付款。
伊梅
 imei string

此屬性僅用於行動支付類型的付款。

傳回

Dynamics 詐騙保護成功物件

身體
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccess

更新帳戶資訊以保護購買

作業識別碼：
PurchaseProtection_v1_UpdateAccount

此事件會更新或建立購買保護服務的使用者帳戶資訊，例如「新增付款方式」、「新增地址」或任何其他使用者屬性。 這只是資料擷取事件

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
userId
 userId True string

使用者識別碼。 此資訊由商家提供。
創建日期
 creationDate date-time

使用者帳戶的建立日期。 格式為 ISO 8601。
更新日期
 updateDate date-time

上次變更使用者資料的日期。 格式為 ISO 8601。
名字
 firstName string

使用者在帳戶上提供的名字。
lastName
 lastName string

使用者在帳戶上提供的姓氏。
country
 country string

使用者所在的國家或地區。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，美國）。
郵遞區號
 zipCode string

使用者的郵遞區號。
timeZone
 timeZone string

使用者的時區。
語言
 language string

使用者的語言和地區 （例如，EN-US）。
電話號碼
 phoneNumber string

使用者的電話號碼。 格式應該是國家/地區代碼，後面接著連字號 （-），然後是電話號碼 （例如，對於美國，+1-1234567890）。
電子郵件
 email string

使用者的電子郵件地址。 此值不區分大小寫。
membershipId
 membershipId string

會員資格 ID，如果使用者已經擁有商家的現有會員資格。
個人資料類型
 profileType string

使用者的設定檔類型。 可能的值 'Consumer' |“賣家” |“出版商” |“租戶” |“開發商”
設定檔名稱
 profileName string

設定檔名稱，視 profileType 而定。
authenticationProvider
 authenticationProvider string

使用者的驗證提供者 （如果與商家的驗證提供者不同）。 可能的價值 'MSA' |“臉書” |“PSN” |“商家認證” |“谷歌”
驗證方法
 authenticationMethod string

客戶在購買前/購買期間進行驗證的方式。 一些可能的值包括 PASSWORD-BASED、MULTI-FACTOR、BIOMETRIC、TOKEN-BASED、
顯示名稱
 displayName string

使用者的顯示名稱。 範例：Xbox 玩家代號值
isEmail已驗證
 isEmailValidated boolean

True/False 值，指出使用者提供的電子郵件地址是否已驗證為使用者擁有。
電子郵件驗證日期
 emailValidatedDate date-time

使用者電子郵件的驗證日期。 格式為 ISO 8601。
isPhoneNumber已驗證
 isPhoneNumberValidated boolean

True/False 值，指出使用者提供的電話號碼是否已驗證為使用者擁有。
phoneNumber驗證日期
 phoneNumberValidatedDate date-time

使用者電話號碼的驗證日期。 格式為 ISO 8601。
membershipType
 membershipType string

客戶的會員資格狀態或類型。 可以指定不同的付費級別，例如高級、行政。 可能的值為 FREE、PAID、PREMIUM
login輸入方法
 loginInputMethod string

客戶輸入其認證的方式。 可能的值為 MANUALINPUT、AUTOFILL、SCRIPT、COPYPASTE、SELECTPROFILE
lastPasswordUpdatedDate
 lastPasswordUpdatedDate date-time

客戶密碼上次更新的時間。
第一個購買日期
 firstPurchaseDate date-time

當客戶首次購買時
loginChallenge類型
 loginChallengeType string

已啟動的挑戰-回應測試類型。 可能的值包括 TEXT SMS、PHONE SMS、EMAIL PIN、CAPTCHA
型別
 type string

可能的值 'Shipping' |“計費” |“註冊”
名字
 firstName string

使用者提供與地址相關聯的名字。
lastName
 lastName string

使用者提供的與地址相關聯的姓氏。
電話號碼
 phoneNumber string

與地址相關聯的使用者提供的電話號碼。
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
country
 country string

為地址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，美國）。
merchantPaymentInstrumentId
 merchantPaymentInstrumentId string

付款方式的識別碼。 此資訊由商家提供。
付款方式
 paymentMethod string

最上層付款方式類別。 可能的值包括 CARD、CASH、DIRECTDEBIT、E-WALLET、MOBILE、E-BANKING、INVOICE、VOUCHERS
型別
 type True string

付款類型。 可能的值 'CreditCard' |“DirectDebit” |「PayPal」 |「行動帳單」 |「網上銀行轉帳」 |「發票」 |「商戶禮品卡」 |“商家錢包” |「送貨上付款」 |“Paytm” |“CCAvenue”
創建日期
 creationDate date-time

在商家系統中首次輸入付款方式的日期。 格式為 ISO 8601。
更新日期
 updateDate date-time

商家系統中付款方式的上次更新日期。 格式為 ISO 8601。
付款結帳提供者
 paymentCheckoutProvider string

電子錢包結帳提供者。
是低責任PIType
 isLowLiabilityPIType boolean

True/False 值，指出付款方式是否為低負債。
狀態
 state string

商家系統中 PI 的現行狀態。 可能的值 'Active' |“不活躍”
卡片類型
 cardType string

此屬性僅用於信用卡/簽帳金融卡類型的付款。 提供卡的網路。 可能的值 'Visa' |“萬事達卡” |“美國運通” |“ACH” |“SEPA” |「銀聯」 |《伊尼西斯》 |“移動計費運營商” |“發現” |「AllPay」 |“JCB” |“發現食客”
持有人名稱
 holderName string

付款工具使用者的名稱。 此屬性僅用於信用卡/簽帳金融卡類型的付款。
持有人公司名稱
 holderCompanyName string

提供公司卡或公司卡的組織名稱（僅適用於商業購買）。
settlementApprovalRequired（結算）ApprovalRequired
 settlementApprovalRequired boolean

True/False 值，指出 SEPA 交易是否需要核准。
間隔
 bin string

此屬性僅用於信用卡/簽帳金融卡類型的付款。
bin名稱
 binName string

BIN 顯示名稱。
bin國家/地區ISO
 binCountryISO string

與 BIN 相關聯的 ISO 國家/地區代碼。
binCardType
 binCardType string

BIN 卡類型。 可能的值為 DEBIT、CREDIT、PREPAID、FLEET、CREDITDEBIT
binCard關聯
 binCardAssociation string

BIN 卡關聯。 一些可能的價值包括 VISA、MASTERCARD、AMEX、DISCOVER、MAESTRO、JCB、銀聯、DINERSCLUB
binBank集團
 binBankGroup string

BIN銀行集團。
到期日期
 expirationDate string

商家系統中付款方式的到期日。 格式為 ISO 8601。 此屬性僅用於信用卡/簽帳金融卡類型的付款。
lastFourDigits
 lastFourDigits string

此屬性僅用於信用卡/簽帳金融卡類型的付款。
電子郵件
 email string

與付款工具相關聯的電子郵件地址。 此屬性僅用於PayPal型別的付款。
billingAgreementId
 billingAgreementId string

此屬性僅用於PayPal型別的付款。
付款人識別碼
 payerId string

此屬性僅用於PayPal型別的付款。
付款人狀態
 payerStatus string

指出 PayPal 是否已驗證付款人的值。 此屬性僅用於PayPal型別的付款。 可能的值 '已驗證' |“未經證實”
地址狀態
 addressStatus string

指出 PayPal 是否已驗證付款人地址的值。 此屬性僅用於PayPal型別的付款。 可能的值 'Confirmed' |“未經證實”
伊梅
 imei string

此屬性僅用於行動支付類型的付款。
貨幣
 currency string

所選付款工具的貨幣代碼。
是國際匯款
 isInternationalMoneyTransfer boolean

True/False 值，指出是否發生國際匯款。
銀行識別碼
 bankIdentifierCode string

銀行識別碼（BIC 或 SWIFT 代碼）
銀行名稱
 bankName string

銀行名稱
銀行郵遞區號
 bankZipCode string

銀行郵遞區號
銀行狀態
 bankState string

銀行狀態
銀行國家/地區ISO
 bankCountryISO string

銀行 ISO 國家
付款收款日期
 paymentCollectionDate date-time

收款的預計日期（主要用於支付服務提供者）。
即時付款結算
 instantPaymentSettlement boolean

True/False 值表示銀行重新導向 （用於支援 CSV 付款）。
自動擷取已啟用
 autoCaptureEnabled boolean

True/False 值，指出是否自動擷取卡片付款的付款。 對於重定向付款，這只是合作夥伴銀行是否自動提取資金的指標。
accountType 帳戶類型
 accountType string

指出要為交易收取的帳戶類型。 UNSPECIFIED 是預設值。 CHEQUE_ACCOUNT將該卡用作借記卡。 CREDIT_FACILITY使用該卡作為信用卡。
authorizationType
 authorizationType string

授權類型。 萬事達卡和維薩卡現在要求商家將授權嘗試定義為預授權或最終授權。 可能的值為 PRE_AUTHORIZATION、FINAL_AUTHORIZATION
授權結果代碼
 authorizationResultCode string

銀行對授權決定的回應。 可能的值為 APPROVE、DECLINE、PENDING
授權結果文字
 authorizationResultText string

授權決定的理由;特別是對於被拒絕或待處理的交易。 可能的值為MISMATCH_CVV、MISMATCH_ADDRESS、MISMATCH_EXPIRATIONDATE、NOACCOUNT、INVALIDPIN、LOWFUND、OVERLIMIT SUSPICIOUSACCOUNT
收購機構識別碼
 acquirerId string

取得機構識別碼。
收單機構國家/地區ISO
 acquirerCountryISO string

收單機構國家代碼
cvv驗證
 cvvVerify string

指出 CVV 驗證是否可用和/或成功驗證。 Y = 驗證成功，N = 未成功驗證，U = 不可用，A = 可用，但未驗證
avs驗證
 avsVerify string

指出 addres 驗證是否可用和/或成功驗證。 Y = 驗證成功，N = 未成功驗證，U = 不可用，A = 可用，但未驗證
cav驗證
 cavVerify string

指出持卡人驗證是否可用和/或成功驗證。 Y = 驗證成功，N = 未成功驗證，U = 不可用，A = 可用，但未驗證
piInputMethod
 piInputMethod string

N/A
encrypted信用卡號碼
 encryptedCreditCardNumber string

雜湊或加密的信用卡號碼。
名字
 firstName string

名字與地址一起提供
lastName
 lastName string

姓氏與地址一起提供
電話號碼
 phoneNumber string

與地址一起提供的電話號碼
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
country
 country string

為地址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，美國）。
裝置內容識別碼
 deviceContextId True string

客戶的指紋識別工作階段 ID，或事件識別碼 （如果工作階段無法使用）。
ipAddress
 ipAddress string

客戶的IP地址（由商家提供）
提供者
 provider string

裝置資訊的提供者。 可能的值為 'DFPFingerPrinting' |“商人”。 如果使用 DFP 指紋識別 JS 指令碼，您必須傳遞 'DFPFingerPrinting' 才能正確連線所有資料。
裝置內容DC
 deviceContextDC string

已淘汰：DFP 指紋識別不再需要。 儲存客戶 DFP 指紋工作階段的資料中心 （由 DFP 指紋 JS 指令碼提供）。
externalDeviceId
 externalDeviceId string

客戶的裝置 ID，由商家提供並掌握。
externalDeviceType
 externalDeviceType string

客戶的裝置類型，由商家提供和掌握。 可能的值 'Mobile' |“計算機” |“商戶硬件” |“平板電腦” |“遊戲機”
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp date-time

事件的時間戳記

傳回

結果詳情

身體
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.UpdateAccountActivity.UpdateAccountResponseWrapper

更新線上購買交易的狀態

作業識別碼：
PurchaseProtection_v1_PurchaseStatus

此事件會傳送購買狀態的更新，例如，如果購買已取消。 這只是資料擷取事件

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
purchaseId
 purchaseId True string

商家系統中的交易（或購買/訂單）識別碼。
狀態類型
 statusType True string

狀態的類型。 可能的值 '已核准' |“待定” |“被拒絕” |“失敗” |“取消”
statusDate
 statusDate True date-time

套用此狀態的日期時間
reason
 reason string

狀態轉換的原因。 可能的值 'RuleEngine' |“商家覆蓋” |“挑戰已解決” |“挑戰失敗” |「客戶請求」 |“Fufillment失敗” |《InlineManualReview_General》 |《InlineManualReview_Fraud》 |《InlineManualReview_AccountCompromise》 |“OfflineManualReview_General” |《OfflineManualReview_Fraud》 |《OfflineManualReview_AccountCompromise》 |“安全清單” |“黑名單”
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp date-time

事件的時間戳記

傳回

結果詳情

身體
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseStatusActivity.PurchaseStatusResponseWrapper

更新詐騙標籤資訊以保護帳戶

作業識別碼：
AccountProtection_v1_Label

此事件會傳送標籤的更新。 這只是資料擷取事件

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
使用者識別碼
 UserId True string

標籤 API 的使用者 ID
連接類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
名稱
 name True string

事件名稱。 應該是“美聯社。標籤'
版本
 version True string

承載版本。 應該是「0.5」
trackingId
 trackingId True string

每個事件/記錄的唯一識別碼。
userId
 userId True string

使用者識別碼。 此資訊由商家提供。
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp True date-time

事件的時間戳記。
事件時間戳記
 eventTimeStamp True date-time

事件的日期和時間。 可能的值：Chargeback Date 或 Review Date。 格式為 ISO 8601。
標籤物件類型
 labelObjectType True string

此欄位表示標籤類型：「購買」|'帳戶建立'|'帳戶登入'|'帳戶更新'|'CustomFraud評估'|'帳戶'|'付款工具'|'電子郵件'。
labelObjectId
 labelObjectId True string

這是物件的識別碼欄位：PurchaseId、AccountCreationId、AccountLoginId、AccountUpdateId、UserId、MerchantPaymentInstrumentId 或 Email。
標籤來源
 labelSource string

此欄位代表標籤的來源：「CustomerEscalation」|'退款'|'TC40_SAFE'|'手動審查'|'退款'|'離線分析'|'AccountProtectionReview'。
labelState
 labelState True string

此欄位指出標籤的目前狀態：「InquiryAccepted'|」欺詐'|'有爭議'|'反轉'|'虐待'|'重新提交請求'|'帳戶已洩露'|'AccountNotCompromised'。
labelReasonCode
 labelReasonCode string

此欄位指出與每種標籤類型相關聯的原因碼： 'ProcessorResponseCode'|'BankResponseCode'|'FraudRefund'|'帳戶接管'|'PaymentInstrumentFraud'|'帳戶詐騙'|'虐待'|'友好欺詐'|'AccountCredentialsLeaked'|'PassedAccountProtectionChecks'
處理器
 processor string

產生 TC40 或 SAFE 資訊的銀行或付款處理商名稱。
生效開始日期
 effectiveStartDate date-time

此標籤生效的日期。 格式為 ISO 8601。
有效結束日期
 effectiveEndDate date-time

此標籤的結束日期。 格式為 ISO 8601。 不得早於 effectiveStartDate。

傳回

Dynamics 詐騙保護成功物件

身體
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccess

更新詐騙標籤資訊以保護購買

作業識別碼：
PurchaseProtection_v1_Label

此事件會傳送標籤的更新。 這只是資料擷取事件

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
標籤物件類型
 labelObjectType True string

EntityName 此標籤實體所套用的實體名稱。 如果設定為 電子郵件，則會從電子郵件 LabelObjectId 中查詢使用者 ID。 可能的值為 PURCHASE 、 SIGNUP 、 CUSTOMFRAUDEVALUATION 、 ACCOUNT 、 PI 、 EMAIL
labelObjectId
 labelObjectId True string

此標籤實體所套用的 LabelObjectType 內的 Id 值。
標籤來源
 labelSource string

發出此標籤的 LabelReasonCodes 或 LabelState 的授權單位。 可能的值 'CustomerEscalation' |「退款」 |《TC40_SAFE》 |“手動審查” |“退款” |“離線分析”
labelReason代碼
 labelReasonCodes string
labelState
 labelState string

如果 LabelSource 有狀態轉換，則此標籤的目前狀態。 例如 「已接受」表示先前的欺詐嫌疑已被清除。 可能的值 '查詢' |“接受” |“欺詐” |“有爭議” |“逆轉” |“重新提交請求”
處理器
 processor string

發出 LabelReasonCodes 的特定 LabelSource 機構。
事件時間戳記
 eventTimeStamp date-time

據 LabelSource/Processor 報導，該事件的最終創作。 格式ISO8601。
生效開始日期
 effectiveStartDate date-time

此標籤在商家時區中套用的開始時間（如果與MerchantLocalDate不同）。 格式ISO8601。
有效結束日期
 effectiveEndDate date-time

此標籤在商家時區套用時的結束時間，或不適用/不確定的 null。 格式ISO8601。
金額
 amount double

此標籤所涉及的金額，例如部分退款。 貨幣欄位提供的單位。
貨幣
 currency string

金額的貨幣，例如「美元」
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp date-time

事件的時間戳記

傳回

結果詳情

身體
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.LabelActivity.LabelResponseWrapper

更新退款資訊

作業識別碼：
PurchaseProtection_v1_RefundEvent

此事件會傳送先前退款購買交易的相關資訊。 這只是資料擷取事件。 許多商家會使用大量資料上傳來傳送這些事件

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
退款標識符
 refundId True string

識別此退款事件的唯一字串
reason
 reason string

用戶提供的原因。 可能的值 'FraudRefund' |「客戶請求」 |“非欺詐退款”
狀態
 status string

可能的值 '已核准' |“拒絕” |“未知”
bankEvent時間戳記
 bankEventTimestamp date-time

來自銀行的時間戳記
金額
 amount double

退款金額
貨幣
 currency string

用於銷售價格金額的貨幣。
userId
 userId string

識別使用者的唯一字串
purchaseId
 purchaseId True string

原始購買標識碼
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp date-time

事件的時間戳記

傳回

結果詳情

身體
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.RefundActivity.RefundResponseWrapper

更新銀行授權資訊

作業識別碼：
PurchaseProtection_v1_BankEvent

此事件會傳達傳送至銀行的購買交易是否已核准或拒絕銀行授權或銀行收費/結算。 這只是資料擷取事件

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
銀行事件標識碼
 bankEventId True string

識別此 Bank Event 的唯一字串
型別
 type True string

銀行事件類型。 可能的值 'Auth' |“驗證取消” |“衝鋒逆轉” |“衝鋒”
bankEvent時間戳記
 bankEventTimestamp date-time

來自銀行的時間戳記
狀態
 status string

可能的值 '已核准' |“未知” |“拒絕”
銀行回應代碼
 bankResponseCode string

回應時的銀行代碼
付款處理器
 paymentProcessor string

處理器名稱。 可能的值 'FDC' |“阿迪恩” |“TSYS” |「世界支付」 |“追逐” |“條紋” |“PayPal”
MRN
 mrn string

商家參考編號，用於從商家端識別交易
中
 mid string

發送到銀行和/或從銀行收到的商家 ID （MID）。
merchantPaymentInstrumentId
 merchantPaymentInstrumentId string

付款方式的識別碼。 此資訊由商家提供。
付款方式
 paymentMethod string

付款方式的分組/類別。 可能的值包括 CARD、CASH、DIRECTDEBIT、E-WALLET、MOBILE、E-BANKING、INVOICE、VOUCHERS
卡片類型
 cardType string

付款類型。 可能的值為 VISA 、 MASTERCARD 、 AMEX 、ACH 、 SEPA 、 UNIONPAY 、 INICIS 、 MOBILEBILLINGCARRIER 、 DISCOVER 、 ALLPAY 、 JCB 、 DISCOVERDINERS
更新PI
 updatedPI boolean

使用與購買中的 PI 不同的 PI
cvv驗證
 cvvVerify string

指出 CVV 驗證是否可用和/或成功驗證。 Y = 驗證成功，N = 未成功驗證，U = 不可用，A = 可用，但未驗證
avs驗證
 avsVerify string

指出 addres 驗證是否可用和/或成功驗證。 Y = 驗證成功，N = 未成功驗證，U = 不可用，A = 可用，但未驗證
cav驗證
 cavVerify string

指出持卡人驗證是否可用和/或成功驗證。 Y = 驗證成功，N = 未成功驗證，U = 不可用，A = 可用，但未驗證
authResultCode
 authResultCode string

銀行對授權決定的回應。 可能的值為 APPROVE、DECLINE、PENDING
authResultText
 authResultText string

授權決定的理由;特別是對於被拒絕或待處理的交易。 可能的值為MISMATCH_CVV、MISMATCH_ADDRESS、MISMATCH_EXPIRATIONDATE、NOACCOUNT、INVALIDPIN、LOWFUND、OVERLIMIT SUSPICIOUSACCOUNT
purchaseId
 purchaseId True string

識別購買的唯一字串
是ThreeDSAuth
 isThreeDSAuth boolean

True/False 值，指出此交易是否透過 3DS 進行驗證。
訊息類別
 messageCategory string

識別特定使用案例的訊息類別。 接受的值：01 = PA、02 = NPA、03-79 = 保留供 EMVCo 未來使用（在 EMVCo 定義之前值無效）、80-99 = 保留供 DS 使用
裝置通道
 deviceChannel string

指出用來起始交易的通道介面類型。 接受的值：01 = 應用程式型 （APP）、02 = 瀏覽器 （BRW）、03 = 3DS 請求者啟動 （3RI）、04-79 = 保留供 EMVCo 未來使用 （值在 EMVCo 定義之前無效）、80-99 = 保留供 DS 使用
threeDSServerTransId
 threeDSServerTransId string

由 3DS 伺服器分配的通用唯一交易識別碼，用於識別單一交易。
threeDSRequestorAuthenticationInd
 threeDSRequestorAuthenticationInd string
threeDSRequestorChallengeInd
 threeDSRequestorChallengeInd string

指出是否為此交易要求挑戰。 接受的值：01 = 無偏好設定、02 = 未要求質詢、03 = 要求質詢 （3DS 要求者偏好設定）、04 = 要求質詢 （授權）、05 = 未要求質詢 （已執行交易風險分析）、06 = 未要求質詢 （僅限資料共用）、07 = 未要求質詢 （已執行強式消費者身份驗證）、08 = 未要求質詢 （如果不需要質詢，則使用白名單豁免）， 09 = 請求挑戰（如果需要挑戰，則請求白名單提示）
三RIInd
 threeRIInd string

指出 3RI 要求的類型。 接受的值：01 = 定期交易，02 = 分期付款交易，03 = 添加卡，04 = 維護卡信息，05 = 帳戶驗證，06 = 拆分，延遲發貨，07 = 充值，08 = 郵購，09 = 電話訂單，10 = 白名單狀態檢查，11 = 其他付款，12-79 = 保留供 EMVCo 將來使用（值在 EMVCo 定義之前無效），80-99 = 保留供 DS 使用
threeDSReqPriorAuthMethod
 threeDSReqPriorAuthMethod string

持卡人先前向 3DS 請求者進行身份驗證的機制。 接受的值：01 = ACS 發生無摩擦驗證、02 = ACS 發生持卡人質疑、03 = AVS 驗證、04 = 其他發卡機構方法、05-79 = 保留供 EMVCo 未來使用 （值在 EMVCo 定義之前無效）、80-99 = 保留供 DS 使用
跨狀態
 transStatus string

指出交易是否符合已驗證交易或帳戶驗證的資格。 接受的值：Y = 驗證驗證成功，N = 未驗證，帳戶未驗證;交易被拒絕，U = 身份驗證，無法進行帳戶驗證;技術或其他問題，如 ARes 或 RReq 所示，A = 嘗試執行處理;未驗證，已驗證，但嘗試驗證的證明，提供驗證，C = 需要挑戰;需要使用 CReq，CRes，D = Challenge Required;解耦認證確認，R = 認證，帳戶驗證被拒絕;發卡人拒絕身份驗證、驗證並要求不要嘗試授權，I = 僅供參考;確認 3DS 請求者挑戰偏好。
transStatus原因
 transStatusReason string

提供有關 [交易狀態] 欄位具有指定值的原因的資訊。 接受的值：01 = 卡身份驗證失敗，02 = 未知裝置，03 = 不支援的裝置，04 = 超過身份驗證頻率限制，05 = 過期的卡，06 = 無效的卡號，07 = 無效交易，08 = 無卡記錄，09 = 安全故障，10 = 卡被盜，11 = 涉嫌欺詐，12 = 不允許持卡人交易，13 = 持卡人未註冊服務，14 = ACS 交易超時， 15 = 低置信度，16 = 中置信度，17 = 高置信度，18 = 非常高置信度，19 = 超過 ACS 最大挑戰，20 = 不支援非付款交易，21 = 不支援 3RI 交易，22 = ACS 技術問題，23 = ACS 需要但 3DS 請求者未請求的解耦身份驗證，24 = 3DS 請求者解耦最大到期時間已超過，25 = 分離身份驗證沒有足夠的時間來驗證持卡人。 ACS不會嘗試，26 =嘗試驗證但未由持卡人執行，27-79 =保留供EMVCo將來使用（值在EMVCo定義之前無效），80-99 = 保留供DS使用
三DSCompInd
 threeDSCompInd string

指出 3DS 方法是否成功完成。 接受的值：Y = 成功完成，N = 未成功完成，U = 無法使用的 3DS 方法 URL 不存在於與持卡人帳號相關聯的卡片範圍的 PRes 訊息資料中。
acsChallenge已強制
 acsChallengeMandated string

表明由於當地/區域授權或其他變數，交易是否需要提出質疑才能獲得授權。 接受的值：Y = 強制挑戰，N = 非強制挑戰
ECI
 eci string

電子商務指標 （ECI）。 ACS 或 DS 提供的支付系統特定值，用於指示嘗試驗證持卡人的結果。 接受的值：02 （MasterCard）/05 （Visa）= 成功驗證 01 （MasterCard）/06/07 （Visa） = 所有其他值
shipName指標
 shipNameIndicator string

指出帳戶上的持卡人姓名是否與用於此交易的託運名稱相同。 接受的值：01 = 帳戶名稱與出貨名稱相同，02 = 帳戶名稱與出貨名稱不同
challengeCompletionInd
 challengeCompletionInd string

ACS 挑戰週期狀態的指標，以及挑戰是否已完成或將需要其他訊息。 接受的值：Y = 挑戰已完成，不需要進一步的挑戰訊息交換，N = 挑戰未完成，且需要額外的挑戰訊息交換
chAccPwChangeInd
 chAccPwChangeInd string

表示持卡人在 3DS 請求者的帳戶更改密碼或重置帳戶以來的時間長度。 接受的值：01 = 無變化，02 = 在此交易期間發生變化，03 = 少於 30 天，04 = 30-60 天，05 = 超過 60 天
chAccAgeInd
 chAccAgeInd string

持卡人在 3DS 請求者處擁有帳戶的時間長度。 接受的值：01 = 無帳戶（訪客退房）、02 = 在此交易期間建立、03 = 少於 30 天、04 = 30-60 天、05 = 超過 60 天
provisionAttemptsDay
 provisionAttemptsDay string

過去 24 小時內嘗試新增卡片的次數。 長度：最多 3 個字元範例值：2、02、002
豁免已提高
 exemptionRaised string

PSD2 豁免請求，Y - 豁免，N - 不豁免
可疑的 AccActivity
 suspiciousAccActivity string

指出 3DS 請求者是否在持卡人帳戶上遇到可疑活動（包括先前的詐欺）。 接受的值：01 = 未觀察到可疑活動，02 = 已觀察到可疑活動
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp date-time

事件的時間戳記

傳回

結果詳情

身體
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.BankEventActivity.BankEventResponseWrapper

為帳戶建立嘗試提供風險評估

作業識別碼：
AccountProtection_v1_AccountCreation

此事件會傳送有關傳入新帳戶建立嘗試的資訊和內容。 回應包含帳戶建立的決定

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
名稱
 name True string

事件名稱。 應該是“美聯社。帳戶建立」
版本
 version True string

承載版本。 應該是「0.5」
trackingId
 trackingId True string

帳戶建立事件的識別碼。
signUpId
 signUpId True string

帳戶建立事件的識別碼。 可以比對 trackingId。
評估類型
 assessmentType string

指出事件的評量類型。 可能的值為 'Evaluate' |“保護”。 如果未指定，預設值為「保護」。
客戶本地日期
 customerLocalDate True date-time

帳戶建立事件的建立日期，以客戶的當地時區為準。 格式為 ISO 8601。
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp True date-time

事件的時間戳記。
裝置內容識別碼
 deviceContextId True string

客戶的裝置 ID，由 DFP 裝置指紋識別服務提供和掌握。
ipAddress
 ipAddress string

客戶的 IP 位址。
提供者
 provider string

裝置資訊的提供者。 可能的值為 'DFPFingerprinting'|'商人'|'未知」。 如果未指定，則預設值為 'DFPFingerprinting'。
externalDeviceId
 externalDeviceId string

客戶的裝置 ID，由商家提供並掌握。
externalDeviceType
 externalDeviceType string

客戶的裝置類型，由商家提供和掌握。 可能的值為 'Mobile' 、 'Computer' 、 'MerchantHardware' 、 'Tablet' 、 'GameConsole'。
userId
 userId string

使用者識別碼。 此資訊由商家提供。
用戶類型
 userType string

使用者的設定檔類型。 可能的值為 'Consumer'|'開發商'|'賣家'|'出版商'|'租戶'。
使用者名稱
 username True string

使用者提供的使用者名稱。
名字
 firstName string

使用者在帳戶上提供的名字。
lastName
 lastName string

使用者在帳戶上提供的姓氏。
國家/地區
 countryRegion string

使用者的 CountryRegion。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，US）。
郵遞區號
 zipCode string

使用者的郵遞區號。
timeZone
 timeZone string

使用者的時區。
語言
 language string

使用者的語言和地區 （例如，EN-US）。
membershipId
 membershipId string

會員資格 ID，如果使用者已經擁有商家的現有會員資格。
isMembershipId使用者名稱
 isMembershipIdUsername boolean

membershipId 可以作為使用者名稱使用，預設為 False。
電話類型
 phoneType True string

值為：「主要」|」Alternative'，預設為 'Primary'。
電話號碼
 phoneNumber True string

使用者的電話號碼。 格式應該是國家/地區代碼，後面接著連字號 （-），然後是電話號碼 （例如，對於美國，+1-1234567890）。
isPhoneNumber已驗證
 isPhoneNumberValidated boolean

True/False 值，指出使用者提供的電話號碼是否已驗證為使用者擁有。
phoneNumber驗證日期
 phoneNumberValidatedDate date-time

使用者電話號碼的驗證日期。 格式為 ISO 8601。
isPhone使用者名稱
 isPhoneUsername boolean

電話號碼可作為使用者名稱使用，預設為 False。
電子郵件類型
 emailType True string

值為：「主要」、「替代」
電子郵件值
 emailValue True string

使用者的電子郵件地址。 此值不區分大小寫。
isEmail已驗證
 isEmailValidated boolean

True/False 值，指出使用者提供的電子郵件地址是否已驗證為使用者擁有。
電子郵件驗證日期
 emailValidatedDate date-time

使用者電子郵件的驗證日期。 格式為 ISO 8601。
isEmailUsername
 isEmailUsername boolean

電子郵件可作為使用者名稱使用，預設為 False。
authenticationProvider
 authenticationProvider True string

使用者的單一登入 （SSO） 驗證提供者 （如果與商家不同）。 可能的價值是 'MSA'|'臉書'|'PSN'|'商家身份驗證'|'谷歌“。
顯示名稱
 displayName True string

使用者的單一登入 （SSO） 驗證提供者 （如果與商家不同）。 可能的價值是 'MSA'|'臉書'|'PSN'|'商家身份驗證'|'谷歌“。
addressType
 addressType True string

地址類型。 值為：'Primary'|'計費'|'運輸'|'替代方案“。 預設為「主要」。
名字
 firstName string

使用者提供與地址相關聯的名字。
lastName
 lastName string

使用者提供的與地址相關聯的姓氏。
電話號碼
 phoneNumber string

與地址相關聯的使用者提供的電話號碼。
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
國家/地區
 countryRegion string

為位址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，US）。
merchantPaymentInstrumentId
 merchantPaymentInstrumentId True string

付款方式的識別碼。 此資訊由商家提供。
型別
 type True string

付款類型。 可能的值為： 'Other'|'信用卡'|'DirectDebit'|'PayPal'|'行動帳單'|'OnlineBankTransfer' |'發票' |'商家禮品卡'|'商家錢包'|'送貨時現金'|'Paytm'|'CCAvenue'。
創建日期
 creationDate date-time

在商家系統中首次輸入付款方式的日期。 格式為 ISO 8601。
更新日期
 updateDate date-time

商家系統中付款方式的上次更新日期。 不應早於 creationDate。 格式為 ISO 8601。
狀態
 state string

商家系統中 PI 的現行狀態。 可能的值為：「Active」|'已封鎖'|'已過期'
卡片類型
 cardType string

此屬性僅用於信用卡/簽帳金融卡類型的付款。 可能的值為：「Visa」|'萬事達卡'|'美國運通'|'ACH'|'SEPA'|'銀聯'|'伊尼西斯'|'MobileBillingCarrier'|'發現'|'全付通'|'JCB' |'發現食客。
持有人名稱
 holderName string

付款工具使用者的名稱。 此屬性僅用於信用卡/簽帳金融卡類型的付款。
間隔
 bin string

信用卡/借記卡垃圾箱。 此屬性僅用於信用卡/簽帳金融卡類型的付款。
到期日期
 expirationDate string

商家系統中付款方式的到期日。 格式為 ISO 8601。 此屬性僅用於信用卡/簽帳金融卡類型的付款。
lastFourDigits
 lastFourDigits string

信用卡/借記卡的最後四位數字。 此屬性僅用於信用卡/簽帳金融卡類型的付款。
addressType
 addressType True string

地址類型。 值為：'Primary'|'計費'|'運輸'|'替代方案“。 預設為「主要」。
名字
 firstName string

使用者提供與地址相關聯的名字。
lastName
 lastName string

使用者提供的與地址相關聯的姓氏。
電話號碼
 phoneNumber string

與地址相關聯的使用者提供的電話號碼。
街道1
 street1 string

為地址提供的第一列。
街道2
 street2 string

為地址提供的第二列。 （此值可以是空白。
街道3
 street3 string

為地址提供的第三行。 （此值可以是空白。
city
 city string

為地址提供的城市。
狀態
 state string

為地址提供的州或省。
區
 district string

為地址提供的地區。
郵遞區號
 zipCode string

為地址提供的郵遞區號。
國家/地區
 countryRegion string

為位址提供的國家/地區代碼。 值應該是兩個字母的 ISO 國家/地區代碼 （例如，US）。
電子郵件
 email string

與付款工具相關聯的電子郵件地址。 此屬性僅用於PayPal型別的付款。
billingAgreementId
 billingAgreementId string

此屬性僅用於PayPal型別的付款。
付款人識別碼
 payerId string

此屬性僅用於PayPal型別的付款。
付款人狀態
 payerStatus string

指出 PayPal 是否已驗證付款人的值。 此屬性僅用於PayPal型別的付款。
地址狀態
 addressStatus string

指出 PayPal 是否已驗證付款人地址的值。 此屬性僅用於PayPal型別的付款。
伊梅
 imei string

此屬性僅用於行動支付類型的付款。
活動類型
 campaignType string

行銷活動型別。 可能的值包括 'Direct'、 'Email' 、 'Referral' 、 'PaidSearch'、 'OrganicSearch'、 'Advertising' 、 'SocialNetwork' 、 'General Marketing'、 'Unknown' 和 'Other'。
trafficSourceReferrer
 trafficSourceReferrer string

此使用者的來源（如果已知）。 如果透過現有使用者轉介，請提供反向連結的原始MerchantUserId。
trafficSourceReferralLink
 trafficSourceReferralLink uri

此使用者的來源（如果已知）。 如果透過其他行銷活動類型而非現有使用者轉介，請提供來源網址連結。
trafficSourceReferralSite
 trafficSourceReferralSite string

流量的來源網站。 可能的值為 'Facebook'、'Instagram'、'Twitter'、'Bing'、'Google'、'Pinterest'、'WhatsApp' 等。
激勵類型
 incentiveType string

新使用者的獎勵類型。 可能的值為 'None' 、 'CashBack' 、 'Discount' 、 'FreeTrial' 、 'BonusPoints' 、 'Gift' 、 'Unknown' 、 'Other'。
激勵優惠
 incentiveOffer string

確切的獎勵優惠名稱。 例如：首單減 5 美元、免運費、5000 積分。
活動開始日期
 campaignStartDate date-time

從獎勵收集開始的活動日期。
活動結束日期
 campaignEndDate date-time

獎勵集合上的行銷活動到期日期。
激勵QuantitiyLimit
 incentiveQuantitiyLimit string

商家設定的獎勵數量限制。 即，每位用戶每天最多可獲得三個 5000 點。

傳回

Dynamics 詐騙保護帳戶的回應物件建立 API

身體
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountCreateResponseSuccessDetails

為帳戶登入嘗試提供風險評估

作業識別碼：
AccountProtection_v1_AccountLogin

此事件會傳送有關傳入新帳戶登入嘗試的資訊和內容。 回應包含帳戶登入的決定

參數

名稱 機碼 必要 類型 Description
主機網址
 hostUrl True string

主機網址
內容類型
 Content-Type True string

application/json
相互關聯標識碼
 x-ms-correlation-id string

一個不切實際的、每個請求 Correlation-Id 有助於追蹤運行時問題。
環境識別碼
 x-ms-dfpenvid string

環境標識碼
名稱
 name True string

事件名稱。 應該是“美聯社。帳戶登入
版本
 version True string

承載版本。 應該是「0.5」
trackingId
 trackingId True string

登入事件的識別碼。
登入 ID
 loginId True string

登入事件的識別碼。 可以比對 trackingId。
評估類型
 assessmentType string

指出事件的評量類型。 可能的值為 'Evaluate' |“保護”。 如果未指定，預設值為「保護」。
客戶本地日期
 customerLocalDate True date-time

帳戶登入事件的登入日期，以客戶的當地時區為準。 格式為 ISO 8601。
merchantTimeStamp （商家時間戳記）
 merchantTimeStamp True date-time

事件的時間戳記。
裝置內容識別碼
 deviceContextId True string

客戶的裝置 ID，由 DFP 裝置指紋識別服務提供和掌握。
ipAddress
 ipAddress string

客戶的 IP 位址。
提供者
 provider string

裝置資訊的提供者。 可能的值為 'DFPFingerprinting'|'商人'|'未知」。 如果未指定，則預設值為 'DFPFingerprinting'。
externalDeviceId
 externalDeviceId string

客戶的裝置 ID，由商家提供並掌握。
externalDeviceType
 externalDeviceType string

客戶的裝置類型，由商家提供和掌握。 可能的值為 'Mobile' 、 'Computer' 、 'MerchantHardware' 、 'Tablet' 、 'GameConsole'。
userId
 userId True string

使用者識別碼。 此資訊由商家提供。
用戶類型
 userType string

使用者的設定檔類型。 可能的值為 'Consumer'|'開發商'|'賣家'|'出版商'|'租戶'。
使用者名稱
 username True string

使用者提供的使用者名稱。
authenticationProvider
 authenticationProvider True string

使用者的單一登入 （SSO） 驗證提供者 （如果與商家不同）。 可能的價值是 'MSA'|'臉書'|'PSN'|'商家身份驗證'|'谷歌“。
顯示名稱
 displayName True string

使用者的單一登入 （SSO） 驗證提供者 （如果與商家不同）。 可能的價值是 'MSA'|'臉書'|'PSN'|'商家身份驗證'|'谷歌“。
lastPhoneNumber更新日期
 lastPhoneNumberUpdateDate date-time

任何電話號碼的最新更新或創建日期/時間。
lastEmail更新日期
 lastEmailUpdateDate date-time

任何電子郵件的最新更新或建立日期/時間。
lastAddressUpdateDate
 lastAddressUpdateDate date-time

任何地址的最新更新或創建日期/時間。
lastPaymentInstrumentUpdateDate
 lastPaymentInstrumentUpdateDate date-time

任何 PaymentInstrument 的最新更新或建立日期/時間。
活動類型
 campaignType string

行銷活動型別。 可能的值包括 'Direct'、 'Email' 、 'Referral' 、 'PaidSearch'、 'OrganicSearch'、 'Advertising' 、 'SocialNetwork' 、 'General Marketing'、 'Unknown' 和 'Other'。
trafficSourceReferrer
 trafficSourceReferrer string

此使用者的來源（如果已知）。 如果透過現有使用者轉介，請提供反向連結的原始MerchantUserId。
trafficSourceReferralLink
 trafficSourceReferralLink uri

此使用者的來源（如果已知）。 如果透過其他行銷活動類型而非現有使用者轉介，請提供來源網址連結。
trafficSourceReferralSite
 trafficSourceReferralSite string

流量的來源網站。 可能的值為 'Facebook'、'Instagram'、'Twitter'、'Bing'、'Google'、'Pinterest'、'WhatsApp' 等。
激勵類型
 incentiveType string

新使用者的獎勵類型。 可能的值為 'None' 、 'CashBack' 、 'Discount' 、 'FreeTrial' 、 'BonusPoints' 、 'Gift' 、 'Unknown' 、 'Other'。
激勵優惠
 incentiveOffer string

確切的獎勵優惠名稱。 例如：首單減 5 美元、免運費、5000 積分。
活動開始日期
 campaignStartDate date-time

從獎勵收集開始的活動日期。
活動結束日期
 campaignEndDate date-time

獎勵集合上的行銷活動到期日期。
激勵QuantitiyLimit
 incentiveQuantitiyLimit string

商家設定的獎勵數量限制。 即，每位用戶每天最多可獲得三個 5000 點。

傳回

Dynamics 詐騙保護 API 的回應物件

身體
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccessDetails

定義

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountCreateEnrichment

類別代表「帳戶建立」評定的擴充功能

名稱 路徑 類型 Description
裝置屬性
 deviceAttributes Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.DeviceAttributes

代表衍生自使用者裝置屬性的功能的類別。
計算功能
 calculatedFeatures Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.CalculatedFeatures

代表評量期間計算特徵的類別

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountCreateResponseSuccessDetails

Dynamics 詐騙保護帳戶的回應物件建立 API

名稱 路徑 類型 Description
名稱
 name string

N/A
版本
 version string

N/A
字碼
 code string

N/A
描述
 description string

N/A
結果細節
 resultDetails array of Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResultDetail

AssessmentResultDetail 集合
transactionReferenceId
 transactionReferenceId string

用於識別個別交易的唯一 ID
擴充
 enrichment Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountCreateEnrichment

類別代表「帳戶建立」評定的擴充功能

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountProtectionEnrichment

代表擴充功能的類別

名稱 路徑 類型 Description
裝置屬性
 deviceAttributes Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.DeviceAttributes

代表衍生自使用者裝置屬性的功能的類別。

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.CalculatedFeatures

代表評量期間計算特徵的類別

名稱 路徑 類型 Description
電子郵件網域
 emailDomain string

從評量承載剖析的電子郵件網域
電子郵件模式
 emailPattern string

從電子郵件計算的電子郵件句柄模式。 電子郵件前綴中的所有大寫字母都替換為“U”，小寫字母替換為“I”，數字替換為“d”。 重複的「I」和「U」會摺疊，其餘字元保持不變。 例如，電子郵件 'kAyla.277@contoso.com' 會傳回電子郵件模式 'lUl.ddd'

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.DeviceAttributes

代表衍生自使用者裝置屬性的功能的類別。

名稱 路徑 類型 Description
真IP
 trueIp string

透過裝置指紋識別的裝置真實IP位址
代理IP
 proxyIp string

裝置指紋辨識的裝置代理IP位址
realtimeTimezoneOffset
 realtimeTimezoneOffset string

考慮日光節約時間表的時區偏移
SLD的
 sld string

與真實IP相關的二級域名
timeZone
 timeZone string

相對於格林威治標準時間的時區偏移
proxy最後偵測到
 proxyLastDetected string

裝置 IP 被識別為作用中 Proxy 的最新日期
deviceId
 deviceId string

裝置指紋辨識產生的唯一裝置ID
裝置國家代碼
 deviceCountryCode string

設備位置真實IP的國家/地區
裝置狀態
 deviceState string

真實IP的裝置位置狀態
裝置城市
 deviceCity string

設備位置真實IP城市
裝置郵遞區號
 devicePostalCode string

真實IP的設備位置郵遞區號
裝置Asn
 deviceAsn string

裝置指紋識別的裝置 ASN
平台
 platform string

設備的操作系統平台
browserUserAgent語言
 browserUserAgentLanguages string

儲存在使用者代理程式中的語言
瀏覽器使用者代理程式
 browserUserAgent string

工作階段中使用的瀏覽器
tcp距離
 tcpDistance string

連線中的網路躍點數
電訊廠商
 carrier string

已識別真實IP的ISP
ip路由類型
 ipRoutingType string

IP 的路由類型
Proxy
 proxy string

判斷呼叫端是否為 Proxy 的旗標
proxyType
 proxyType string

Proxy 的類型 （如果偵測到）
userAgentPlatform
 userAgentPlatform string

瀏覽器版本
userAgent瀏覽器
 userAgentBrowser string

瀏覽器系列
userAgentOperatingSystem
 userAgentOperatingSystem string

作業系統版本
sdk類型
 sdkType string

裝置用來撥打電話的 SDK （Android、iOS 或 Web）
資料網路類型
 dataNetworkType string

使用的網路類型（Wifi 或行動裝置）。 適用於 Android 和 iOS 裝置。
本地IPv4
 localIpv4 string

裝置的本機 IPV4 位址。 適用於 Android 和 iOS 裝置。
isDeviceEmulator
 isDeviceEmulator string

指出是否模擬裝置。 適用於 Android 和 iOS 裝置。
isDeviceRoot
 isDeviceRooted string

指出裝置是否已root。 適用於 Android 和 iOS 裝置。
isWifi啟用
 isWifiEnabled string

指出裝置的 wifi 是啟用還是停用。 對於 Android 設備。
裝置系統版本
 deviceSystemVersion string

作業系統的目前版本。 適用於 iOS 裝置。
裝置型號名稱
 deviceModelName string

裝置型號名稱。 適用於 iOS 裝置。
本地IPv6
 localIpv6 string

裝置的本機 IPV6 位址。 適用於 iOS 裝置。

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccess

Dynamics 詐騙保護成功物件

名稱 路徑 類型 Description
名稱
 name string

N/A
版本
 version string

N/A
字碼
 code string

N/A
描述
 description string

N/A

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccessDetails

Dynamics 詐騙保護 API 的回應物件

名稱 路徑 類型 Description
名稱
 name string

N/A
版本
 version string

N/A
字碼
 code string

N/A
描述
 description string

N/A
結果細節
 resultDetails array of Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResultDetail

AssessmentResultDetail 集合
transactionReferenceId
 transactionReferenceId string

用於識別個別交易的唯一 ID
擴充
 enrichment Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountProtectionEnrichment

代表擴充功能的類別

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResultDetail

評定結果詳細資料

名稱 路徑 類型 Description
主意
 decision string

所做決策的類型
challengeType
 challengeType string

挑戰類型
原因
 reasons array of string

原因清單
規則
 rule string

承載相符的規則
子句名稱
 clauseName string

做出決定的規則子句易記名稱
支援訊息
 supportMessages array of string

支援決策的訊息清單
other
 other object

任何其他數據
分數
 scores array of Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.Score

不同分數列表
規則評估
 ruleEvaluations array of Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.RuleEvaluation

為做出此決定而諮詢的規則集路徑

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.RuleEvaluation

在前往

名稱 路徑 類型 Description
規則
 rule string

規則集的易記名稱
子句名稱
 clauseNames array of string

該規則按順序觸發的條款，最後一個是最終達到的決定

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.Score

分數物件

名稱 路徑 類型 Description
分數類型
 scoreType string

分數類型
分數值
 scoreValue double

分數值。 最大值為 999
reason
 reason string

分數值的原因

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.BankEventActivity.BankEvent

名稱 路徑 類型 Description
object

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.BankEventActivity.BankEventResponseWrapper

結果詳情

名稱 路徑 類型 Description
結果細節
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.BankEventActivity.BankEvent

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.ChargebackActivity.Chargeback

名稱 路徑 類型 Description
object

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.ChargebackActivity.ChargebackResponseWrapper

結果詳情

名稱 路徑 類型 Description
結果細節
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.ChargebackActivity.Chargeback

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.LabelActivity.Label

名稱 路徑 類型 Description
object

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.LabelActivity.LabelResponseWrapper

結果詳情

名稱 路徑 類型 Description
結果細節
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.LabelActivity.Label

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseActivity.PurchaseResponseWrapper

結果詳情

名稱 路徑 類型 Description
結果細節
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseActivity.PurchaseWrapper

購買回應承載

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseActivity.PurchaseWrapper

購買回應承載

名稱 路徑 類型 Description
risk分數
 riskScore integer

由詐騙保護風險模型計算的風險評分，範圍從 -1 到 1000。 -1 表示判斷風險分數的錯誤。
merchantRule決策
 merchantRuleDecision string

在獲得交易風險評分後，商家規則做出的決定。 可能的值 'Approve' |“拒絕”
規則評估
 ruleEvaluations array of

包含評估以做出決定的規則名稱。
子句名稱
 clauseName string

包含作出決定的條款名稱。
中旗
 midFlag string

建議的商家 ID （MID） 旗標。 可能的值 'Program' |「標準」 |“控制”
原因代碼
 reasonCodes string

說明決策的原因碼。
政策應用
 policyApplied string

導致商家規則決策的商家規則或預設規則的名稱。
銀行名稱
 bankName string

DFP要求進行此交易的銀行（發行人）。
hashedEvaluationId
 hashedEvaluationId string

HashedEvaluationId （由 DFP 計算）
diagnostics
 diagnostics object

以命名空間索引鍵的診斷物件
purchaseId
 purchaseId string

商家系統中的交易（或購買/訂單）識別碼。
裝置屬性
 deviceAttributes object

DFP 指紋識別中的裝置屬性
成功了
 succeeded string

請求是否成功

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseStatusActivity.PurchaseStatus

名稱 路徑 類型 Description
object

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseStatusActivity.PurchaseStatusResponseWrapper

結果詳情

名稱 路徑 類型 Description
結果細節
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseStatusActivity.PurchaseStatus

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.RefundActivity.Refund

名稱 路徑 類型 Description
object

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.RefundActivity.RefundResponseWrapper

結果詳情

名稱 路徑 類型 Description
結果細節
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.RefundActivity.Refund

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.UpdateAccountActivity.UpdateAccount

UpdateAccount 回應承載

名稱 路徑 類型 Description
裝置屬性
 deviceAttributes object

DFP 指紋識別中的裝置屬性
成功了
 succeeded string

請求是否成功

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.UpdateAccountActivity.UpdateAccountResponseWrapper

結果詳情

名稱 路徑 類型 Description
結果細節
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.UpdateAccountActivity.UpdateAccount

UpdateAccount 回應承載