共用方式為

帳戶保護架構

  • 發行項

本文概述透過應用程式開發介面 （API） 的架構。 如需詳細資訊，請參閱 整合 Dynamics 365 Fraud Protection 即時 API。

AccountCreation

AccountCreation API 可讓您與 Microsoft Dynamics 365 Fraud Protection 共用資訊與內容，以了解傳入的新帳戶建立事件以進行風險評估。

Object 屬性 類型 描述
租用戶識別碼 字串 TenantId 是代表 Azure ActiveDirectory 租使用者的 GUID。
名稱 字串 值為 AP。AccountCreation。
版本 字串 值為 0.5。
MetaData trackingId 字串 AccountCreationId 事件的標識符。
MetaData SignupId 字串 AccountCreationId 事件的標識符。 （這個值可以符合 trackingId 屬性的值，但與 userId 屬性不同。
MetaData assessmentType 字串 事件的評估類型。 可能的值為評估和保護。 如果未指定任何值，則會保護預設值。
MetaData customerLocalDate dateTime 客戶當地時區中 AccountCreationId 事件的建立日期。 格式為 ISO 8601。
MetaData merchantTimeStamp dateTime 事件的時間戳。
DeviceContext DeviceContextId 字串 客戶的會話標識碼。 此資訊是由 DFP 裝置指紋服務所掌握。
DeviceContext ipAddress 字串 客戶的IP位址，如商家提供。
DeviceContext Provider - 提供者 字串 裝置資訊的提供者。 可能的值為 DFPFingerprinting 和 Merchant。 如果未指定任何值，預設值為 DFPFingerprinting。
DeviceContext externalDeviceId 字串 客戶裝置標識碼，由商家提供及掌握。
DeviceContext externalDeviceType 字串 客戶裝置類型，由商家提供及主控。 可能的值為 Mobile、Computer、MerchantHardware、Tablet 和 GameConsole。
User userId 字串 用戶標識碼。 此資訊由商家提供。
User userType 字串 使用者的配置檔類型。 可能的值為消費者、開發人員、賣方、發行者和租使用者。
User UserName 字串 使用者提供的用戶名稱，在商家系統中是唯一的。
User firstName 字串 帳戶上使用者提供的名字。
User lastName 字串 帳戶上使用者提供的姓氏。
User CountryRegion 字串 用戶的國家或地區。 此值應該是兩個字母的 ISO 國家/地區代碼（例如 美國）。
User zipCode 字串 用戶的郵遞區號。
User timeZone 字串 用戶的時區。
User language 字串 用戶的語言和領域（例如 EN-US）。
User membershipId 字串 如果用戶已經有與商家的現有成員資格，則為成員資格標識符。
User isMembershipIdUserName bool True/False 值，指出 membershipId 值是否可以作為用戶名稱使用。 預設值為 [False] 。
電話 phoneType enum 電話號碼的類型。 可能的值為 [主要 ] 和 [替代]。 預設值為 [主要]。
電話 電話號碼 字串 用戶的電話號碼。 格式應該是國家/地區代碼後面接著連字元（-），然後是電話號碼（例如，針對美國， +1-1234567890）。
電話 isPhoneNumberValidated bool True/False 值，指出使用者提供的電話號碼是否已驗證為使用者所擁有的電話號碼。
電話 phoneNumberValidatedDate dateTime 用戶的電話號碼驗證日期。 格式為 ISO 8601。
電話 isPhoneUserName bool True/False 值，指出電話號碼是否可以作為用戶名稱使用。 預設值為 [False] 。
電子郵件 emailType enum 電子郵件地址的類型。 可能的值為 [主要 ] 和 [替代]。
電子郵件 emailValue 字串 使用者的電子郵件地址。 這個值不區分大小寫。
電子郵件 isEmailValidated bool True/False 值，指出使用者提供的電子郵件位址是否已驗證為使用者所擁有的電子郵件位址。
電子郵件 emailValidatedDate dateTime 用戶電子郵件地址的驗證日期。 格式為 ISO 8601。
電子郵件 isEmailUserName bool True/False 值，指出電子郵件位址是否可以作為用戶名稱使用。 預設值為 [False] 。
SSOAuthenticationProvider authenticationProvider 字串 如果使用者的單一登入 （SSO） 驗證提供者與商家的 SSO 驗證提供者不同，則為 。 可能的值為 MSA、Facebook、PSN、MerchantAuth 和 Google。
SSOAuthenticationProvider displayName 字串 SSO 驗證提供者的用戶顯示名稱（例如，來自Microsoft帳戶、Facebook 或 Google 的使用者名稱）。
位址 地址類型 enum 位址的類型。 可能的值為 [主要]、[帳單]、[出貨] 和 [替代]。 預設值為 [主要]。
位址 firstName 字串 與地址相關聯的使用者提供名字。
位址 lastName 字串 與地址相關聯的使用者提供姓氏。
位址 電話號碼 字串 與地址相關聯的使用者提供電話號碼。
位址 street1 字串 為位址提供的第一個數據列。
位址 street2 字串 為位址提供的第二個數據列。 （此值可以是空白的。
位址 street3 字串 為位址提供的第三個數據列。 （此值可以是空白的。
地址 市/鎮 字串 為位址提供的城市。
位址 state 字串 提供位址的州或省。
位址 區 字串 為位址提供的地區。
位址 zipCode 字串 為位址提供的郵遞區號。
位址 CountryRegion 字串 為位址提供的國家/地區代碼。 此值應該是兩個字母的 ISO 國家/地區代碼（例如 美國）。
PaymentInstrument merchantPaymentInstrumentId 字串 付款方式的標識碼。 此資訊由商家提供。
PaymentInstrument type 列舉 付款的類型。 可能的值為 CreditCard、DirectDebit、PayPal、MobileBilling、OnlineBankTransfer、Invoice、MerchantGiftCard、MerchantWallet、CashOnDelivery、Paytm 和 CCAvenue。
PaymentInstrument creationDate Datetime 商家系統中付款方式第一個專案的日期。 格式為 ISO 8601。
PaymentInstrument updateDate Datetime 商家系統中付款方式上次更新的日期。 格式為 ISO 8601。
PaymentInstrument state 字串 商家系統中付款方式的目前狀態（例如作用中、已封鎖或已過期）。
PaymentInstrument cardType 字串 此屬性僅適用於 CreditCard 或 DirectDebit 類型的付款。 可能的值為 Visa、萬事達卡、Amex、ACH、SEPA、銀聯、Inicis、MobileBillingCarrier、Discover、AllPay、JCB 和 DiscoverDiners。
PaymentInstrument holderName 字串 付款方式用戶的名稱。 此屬性僅適用於 CreditCard 或 DirectDebit 類型的付款。
PaymentInstrument 間隔 字串 此屬性僅適用於 CreditCard 或 DirectDebit 類型的付款。
PaymentInstrument expirationDate 字串 商家系統中付款方式的到期日。 格式為 ISO 8601。 此屬性僅適用於 CreditCard 或 DirectDebit 類型的付款。
PaymentInstrument lastFourDigits 字串 此屬性僅適用於 CreditCard 或 DirectDebit 類型的付款。
PaymentInstrument 電子郵件 字串 與付款方式相關聯的電子郵件位址。 此屬性僅用於PayPal類型的付款。
PaymentInstrument billingAgreementId 字串 此屬性僅用於PayPal類型的付款。
PaymentInstrument payerId 字串 此屬性僅用於PayPal類型的付款。
PaymentInstrument payerStatus 字串 值，指出PayPal是否已驗證付款人。 此屬性僅用於PayPal類型的付款。
PaymentInstrument addressStatus 字串 值，指出PayPal是否已驗證付款人的位址。 此屬性僅用於PayPal類型的付款。
PaymentInstrument imei 字串 此屬性僅用於MobileBilling類型的付款。
PaymentInstrument \ BillingAddress 地址類型 enum 位址的類型。 可能的值為 [主要]、[帳單]、[出貨] 和 [替代]。 預設值為 Billing。
PaymentInstrument \ BillingAddress firstName 字串 與地址相關聯的使用者提供名字。
PaymentInstrument \ BillingAddress lastName 字串 與地址相關聯的使用者提供姓氏。
PaymentInstrument \ BillingAddress 電話號碼 字串 與地址相關聯的使用者提供電話號碼。
PaymentInstrument \ BillingAddress street1 字串 為位址提供的第一個數據列。
PaymentInstrument \ BillingAddress street2 字串 為位址提供的第二個數據列。 （此值可以是空白的。
PaymentInstrument \ BillingAddress street3 字串 為位址提供的第三個數據列。 （此值可以是空白的。
PaymentInstrument \ BillingAddress 市/鎮 字串 為位址提供的城市。
PaymentInstrument \ BillingAddress state 字串 提供位址的州或省。
PaymentInstrument \ BillingAddress 區 字串 為位址提供的地區
PaymentInstrument \ BillingAddress zipCode 字串 為位址提供的郵遞區號。
PaymentInstrument \ BillingAddress CountryRegion 字串 為位址提供的國家/地區代碼。 此值應該是兩個字母的 ISO 國家/地區代碼（例如 美國）。
MarketingContext campaignType enum 營銷活動類型。 可能的值為 Direct、Email、Referral、PaidSearch、OrganicSearch、Advertising、SocialNetwork、General Marketing、Unknown、Other。
MarketingContext trafficSource-referrer 字串 如果已知，則為此使用者的來源。 如果透過現有的用戶轉介，請提供參考者的原始 MerchantUserId。
MarketingContext trafficSource-referralLink 字串 如果已知，則為此使用者的來源。 如果透過其他行銷活動類型而非現有的用戶推薦，請提供來源URL連結。
MarketingContext trafficSource-referralSite 字串 流量的來源月臺。 可能的值為 Facebook、Instagram、Twitter、Bing、Google、Pinterest、WhatsApp 等。
MarketingContext IncentiveType enum 新用戶的獎勵類型。 可能的值為 None、CashBack、Discount、FreeTrial、BonusPoints、Gift、Unknown、Other。
MarketingContext incentiveOffer 字串 確切的獎勵供應項目名稱。 例如，第一筆訂單 5 美元，免費出貨，5000 點。
MarketingContext CampaignStartDate date 活動開始於獎勵收集的日期。
MarketingContext CampaignExpireDate date 獎勵集合的營銷活動到期日。
MarketingContext IncentiveQuantityLimit 字串 商家設定的獎勵數量限制。 例如，每天最多 3 個 5000 點的使用者。

AccountCreationStatus

AccountCreationStatus API 可讓您與 Fraud Protection 共用帳戶建立事件狀態的相關信息和內容。 此事件只是數據擷取事件。

Object 屬性 類型 描述
租用戶識別碼 字串 TenantId 是代表 Azure ActiveDirectory 租使用者的 GUID。
名稱 字串 值為 AP。AccountCreation.Status。
版本 字串 值為 0.5。
MetaData trackingID 字串 SignupStatus 事件的標識符。
MetaData signupId 字串 Signup 事件的標識碼。
MetaData merchantTimeStamp Datetime 事件的時間戳。
MetaData userId 字串 用戶標識碼。 此資訊由商家提供。
StatusDetails statusType enum 狀態的類型： 已核准、 已拒絕或 擱置。
StatusDetails reasonType enum 原因類型： 已放棄挑戰、 挑戰失敗、 已通過挑戰、 擱置挑戰、 檢閱失敗、 檢閱通過、 檢閱擱置或 無。 預設值是 None。
StatusDetails challengeType enum 檢閱狀態的類型： SMS、 電子郵件、 電話、 其他或 無。 預設值是 None。
StatusDetails statusDate Datetime 套用狀態的日期和時間。 格式為 ISO 8601。

AccountLogIn

AccountLogIn API 可讓您與詐騙保護共用有關傳入登入事件的信息和內容，以進行風險評估。

Object 屬性 類型 Description
Name 字串 值為 AP。AccountLogin。
版本 字串 值為 0.5。
MetaData trackingId 字串 Login 事件的標識碼。
MetaData LogInId 字串 Signup 事件的標識碼。 （這個值可以符合 trackingId 屬性的值。
MetaData assessmentType 字串 事件的評估類型。 可能的值為評估和保護。 如果未指定任何值，則會保護預設值。
MetaData customerLocalDate dateTime 註冊事件的建立日期，位於客戶的當地時區。 格式為 ISO 8601。
MetaData merchantTimeStamp dateTime 事件的時間戳。
DeviceContext DeviceContextId 字串 客戶的會話標識碼。 此資訊是由 DFP 裝置指紋服務所掌握。
DeviceContext ipAddress 字串 客戶的IP位址，如商家提供。
DeviceContext Provider - 提供者 字串 裝置資訊的提供者。 可能的值為 DFPFingerprinting 和 Merchant。 如果未指定任何值，預設值為 DFPFingerprinting。
DeviceContext externalDeviceId 字串 客戶裝置標識碼，由商家提供及掌握。
DeviceContext externalDeviceType 字串 客戶裝置類型，由商家提供及主控。
User userId 字串 用戶標識碼。 此資訊由商家提供。
User userType 字串 使用者的配置檔類型。 可能的值為消費者、開發人員、賣方、發行者和租使用者。
User UserName 字串 使用者提供的用戶名稱，在商家系統中是唯一的。
SSOAuthenticationProvider authenticationProvider 字串 如果使用者的 SSO 驗證提供者與商家的 SSO 驗證提供者不同，則為 。 可能的值為 MSA、Facebook、PSN、MerchantAuth 和 Google。
SSOAuthenticationProvider displayName 字串 SSO 驗證提供者的用戶顯示名稱。 例如，來自Microsoft帳戶、Facebook 或Google的用戶名稱。
RecentUpdate lastPhoneNumberUpdate dateTime 最新更新或建立任何電話號碼的日期/時間。
RecentUpdate lastEmailUpdate dateTime 最新更新或建立任何電子郵件位址的日期/時間。
RecentUpdate lastAddressUpdate dateTime 最新更新或建立任何位址的日期/時間。
RecentUpdate lastPaymentInstrumentUpdate dateTime 最新更新或建立任何付款方式的日期/時間。
MarketingContext campaignType enum 營銷活動類型。 可能的值為 Direct、Email、Referral、PaidSearch、OrganicSearch、Advertising、SocialNetwork、General Marketing、Unknown、Other。
MarketingContext trafficSource-referrer 字串 如果已知，則為此使用者的來源。 如果透過現有的用戶轉介，請提供參考者的原始 MerchantUserId。
MarketingContext trafficSource-referralLink 字串 如果已知，則為此使用者的來源。 如果透過其他行銷活動類型而非現有的用戶推薦，請提供來源URL連結。
MarketingContext trafficSource-referralSite 字串 流量的來源月臺。 可能的值為 Facebook、Instagram、Twitter、Bing、Google、Pinterest、WhatsApp 等。
MarketingContext IncentiveType enum 新用戶的獎勵類型。 可能的值為 None、CashBack、Discount、FreeTrial、BonusPoints、Gift、Unknown、Other。
MarketingContext incentiveOffer 字串 確切的獎勵供應項目名稱。 例如，第一筆訂單 5 美元，免費出貨，5000 點。
MarketingContext CampaignStartDate date 活動開始於獎勵收集的日期。
MarketingContext CampaignExpireDate date 獎勵集合的營銷活動到期日。
MarketingContext IncentiveQuantityLimit 字串 商家設定的獎勵數量限制。 例如，每天最多 3 個 5000 點的使用者。

AccountLogInStatus

AccountLogInStatus API 可讓您與 Fraud Protection 共用帳戶登入事件狀態的相關信息和內容。 此事件只是數據擷取事件。

Object 屬性 類型 Description
Name 字串 值為 AP。AccountLogin.Status。
版本 字串 值為 0.5。
MetaData trackingID 字串 LoginStatus 事件的標識碼。
MetaData logInId 字串 Login 事件的標識碼。
MetaData merchantTimeStamp Datetime 事件的時間戳。
MetaData userId 字串 用戶標識碼。 此資訊由商家提供。
StatusDetails statusType 字串 狀態的類型： 已核准、 已拒絕或 擱置。
StatusDetails reasonType enum 原因類型： 已放棄挑戰、 挑戰失敗、 已通過挑戰、 擱置挑戰、 檢閱失敗、 檢閱通過、 檢閱擱置或 無。 預設值是 None。
StatusDetails challengeType enum 檢閱狀態的類型： SMS、 電子郵件、 電話、 其他或 無。 預設值是 None。
StatusDetails statusDate Datetime 套用狀態的日期和時間。 格式為 ISO 8601。

AccountUpdate

AccountUpdate API 可讓您與詐騙保護共用帳戶資訊更新。 例如，可能會編輯或新增下列資訊：使用者配置檔、位址、付款方式、電話號碼、電子郵件位址和 SSO。 此事件只是數據擷取事件。

Object 屬性 類型 Description
Name 字串 值為 AP。AccountUpdate。
版本 字串 值為 0.5。
MetaData trackingId 字串 AccountUpdate 事件的標識符。
MetaData SignupId 字串 AccountUpdateId 事件的標識符。 （這個值可以符合 trackingId 屬性的值。
MetaData customerLocalDate dateTime 客戶當地時區中 AccountUpdate 事件的建立日期。 格式為 ISO 8601。
MetaData merchantTimeStamp dateTime 事件的時間戳。
DeviceContext DeviceContextId 字串 客戶的會話標識碼。 此資訊是由 DFP 裝置指紋服務所掌握。
DeviceContext ipAddress 字串 客戶的IP位址，如商家提供。
DeviceContext Provider - 提供者 字串 裝置資訊的提供者。 可能的值為 DFPFingerprinting 和 Merchant。 如果未指定任何值，預設值為 DFPFingerprinting。
DeviceContext externalDeviceId 字串 客戶裝置標識碼，由商家提供及掌握。
DeviceContext externalDeviceType 字串 客戶裝置類型，由商家提供及主控。 可能的值為 Mobile'、 Computer、 MerchantHardware、 Tablet 和 GameConsole。
User userId 字串 用戶標識碼。 此資訊由商家提供。
User userType 字串 使用者的配置檔類型。 可能的值為消費者、開發人員、賣方、發行者和租使用者。
User UserName 字串 使用者提供的用戶名稱，在商家系統中是唯一的。
User firstName 字串 帳戶上使用者提供的名字。
User lastName 字串 帳戶上使用者提供的姓氏。
User CountryRegion 字串 用戶的國家或地區。 此值應該是兩個字母的 ISO 國家/地區代碼（例如 美國）。
User zipCode 字串 用戶的郵遞區號。
User timeZone 字串 用戶的時區。
User language 字串 用戶的語言和領域（例如 EN-US）。
User membershipId 字串 如果用戶已經有與商家的現有成員資格，則為成員資格標識符。
User isMembershipIdUserName bool True/False 值，指出 membershipId 值是否可以作為用戶名稱使用。 預設值為 [False] 。
電話 phoneType enum 電話號碼的類型。 可能的值為 [主要 ] 和 [替代]。 預設值為 [主要]。
電話 電話號碼 字串 用戶的電話號碼。 格式應該是國家/地區代碼後面接著連字元（-），然後是電話號碼（例如，針對美國， +1-1234567890）。
電話 isPhoneNumberValidated bool True/False 值，指出使用者提供的電話號碼是否已驗證為使用者所擁有的電話號碼。
電話 phoneNumberValidatedDate dateTime 用戶的電話號碼驗證日期。 格式為 ISO 8601。
電話 isPhoneUserName bool True/False 值，指出電話號碼是否可以作為用戶名稱使用。 預設值為 [False] 。
電子郵件 emailType enum 電子郵件地址的類型。 可能的值為 [主要 ] 和 [替代]。
電子郵件 emailValue 字串 使用者的電子郵件地址。 這個值不區分大小寫。
電子郵件 isEmailValidated bool True/False 值，指出使用者提供的電子郵件位址是否已驗證為使用者所擁有的電子郵件位址。
電子郵件 emailValidatedDate dateTime 用戶電子郵件地址的驗證日期。 格式為 ISO 8601。
電子郵件 isEmailUserName bool True/False 值，指出電子郵件位址是否可以作為用戶名稱使用。 預設值為 [False] 。
SSOAuthenticationProvider authenticationProvider 字串 如果使用者的 SSO 驗證提供者與商家的 SSO 驗證提供者不同，則為 。 可能的值為 MSA、Facebook、PSN、MerchantAuth 和 Google。
SSOAuthenticationProvider displayName 字串 SSO 驗證提供者的用戶顯示名稱（例如，來自Microsoft帳戶、Facebook 或 Google 的使用者名稱）。
位址 地址類型 enum 位址的類型。 可能的值為 [主要]、[帳單]、[出貨] 和 [替代]。 預設值為 [主要]。
位址 firstName 字串 與地址相關聯的使用者提供名字。
位址 lastName 字串 與地址相關聯的使用者提供姓氏。
位址 電話號碼 字串 與地址相關聯的使用者提供電話號碼。
位址 street1 字串 為位址提供的第一個數據列。
位址 street2 字串 為位址提供的第二個數據列。 （此值可以是空白的。
位址 street3 字串 為位址提供的第三個數據列。 （此值可以是空白的。
地址 市/鎮 字串 為位址提供的城市。
位址 state 字串 提供位址的州或省。
位址 區 字串 為位址提供的地區。
位址 zipCode 字串 為位址提供的郵遞區號。
位址 CountryRegion 字串 為位址提供的國家/地區代碼。 此值應該是兩個字母的 ISO 國家/地區代碼（例如 美國）。
PaymentInstrument merchantPaymentInstrumentId 字串 付款方式的標識碼。 此資訊由商家提供。
PaymentInstrument type 列舉 付款的類型。 可能的值為 CreditCard、DirectDebit、PayPal、MobileBilling、OnlineBankTransfer、Invoice、MerchantGiftCard、MerchantWallet、CashOnDelivery、Paytm 和 CCAvenue。
PaymentInstrument creationDate Datetime 商家系統中付款方式第一個專案的日期。 格式為 ISO 8601。
PaymentInstrument updateDate Datetime 商家系統中付款方式上次更新的日期。 格式為 ISO 8601。
PaymentInstrument state 字串 商家系統中付款方式的目前狀態（例如作用中、已封鎖或已過期）。
PaymentInstrument cardType 字串 此屬性僅適用於 CreditCard 或 DirectDebit 類型的付款。 可能的值為 Visa、萬事達卡、Amex、ACH、SEPA、銀聯、Inicis、MobileBillingCarrier、Discover、AllPay、JCB 和 DiscoverDiners。
PaymentInstrument holderName 字串 付款方式用戶的名稱。 此屬性僅用於信用卡 DirectDebit 類型的付款。
PaymentInstrument 間隔 字串 此屬性僅適用於 CreditCard 或 DirectDebit 類型的付款。
PaymentInstrument expirationDate 字串 商家系統中付款方式的到期日。 格式為 ISO 8601。 此屬性僅適用於 CreditCard 或 DirectDebit 類型的付款。
PaymentInstrument lastFourDigits 字串 此屬性僅適用於 CreditCard 或 DirectDebit 類型的付款。
PaymentInstrument 電子郵件 字串 與付款方式相關聯的電子郵件位址。 此屬性僅用於PayPal類型的付款。
PaymentInstrument billingAgreementId 字串 此屬性僅用於PayPal類型的付款。
PaymentInstrument payerId 字串 此屬性僅用於PayPal類型的付款。
PaymentInstrument payerStatus 字串 值，指出PayPal是否已驗證付款人。 此屬性僅用於PayPal類型的付款。
PaymentInstrument addressStatus 字串 值，指出PayPal是否已驗證付款人的位址。 此屬性僅用於PayPal類型的付款。
PaymentInstrument imei 字串 此屬性僅用於MobileBilling類型的付款。
PaymentInstrument \ BillingAddress 地址類型 enum 位址的類型。 可能的值為 [主要]、[帳單]、[出貨] 和 [替代]。 預設值為 Billing。
PaymentInstrument \ BillingAddress firstName 字串 與地址相關聯的使用者提供名字。
PaymentInstrument \ BillingAddress lastName 字串 與地址相關聯的使用者提供姓氏。
PaymentInstrument \ BillingAddress 電話號碼 字串 與地址相關聯的使用者提供電話號碼。
PaymentInstrument \ BillingAddress street1 字串 為位址提供的第一個數據列。
PaymentInstrument \ BillingAddress street2 字串 為位址提供的第二個數據列。 （此值可以是空白的。
PaymentInstrument \ BillingAddress street3 字串 為位址提供的第三個數據列。 （此值可以是空白的。
PaymentInstrument \ BillingAddress 市/鎮 字串 為位址提供的城市。
PaymentInstrument \ BillingAddress state 字串 提供位址的州或省。
PaymentInstrument \ BillingAddress 區 字串 為位址提供的地區。
PaymentInstrument \ BillingAddress zipCode 字串 為位址提供的郵遞區號。
PaymentInstrument \ BillingAddress CountryRegion 字串 為位址提供的國家/地區代碼。 此值應該是兩個字母的 ISO 國家/地區代碼（例如 美國）。

標籤

卷 標 API 可讓您針對以一組額外的詐騙訊號為基礎的模型定型，共用交易和事件結果的其他資訊。 此資訊包含您從銀行收到的資訊。 此事件只是數據擷取事件。

類別 屬性 類型 Description
Name 字串 值為 AP。AccountLabel。
版本 字串 值為 0.5。
MetaData TrackingId String 每個事件/記錄的唯一標識符。
MetaData merchantTimeStamp Datetime 日期，位於商家的時區。 格式為 ISO 8601。
MetaData userId 字串 用戶標識碼。 此資訊由商家提供。
標籤 EventTimeStamp Datetime 事件的日期與時間。 可能的值為退款日期和檢閱日期。 格式為 ISO 8601。
標籤 LabelObjectType enum 標籤的類型：購買、帳戶建立、帳戶登入、帳戶更新、自定義詐騙評估、帳戶、付款方式或電子郵件。
標籤 LabelObjectId String 對象的標識符字段：PurchaseId、AccountCreationId、AccountLoginId、AccountUpdateId、UserId、MerchantPaymentInstrumentId 或 Email。
標籤 LabelSource enum 卷標的來源： 客戶呈報、 退款、 TC40_SAFE、 手動檢閱、 退款、 離線分析或 帳戶保護檢閱。
標籤 LabelState enum 卷標的目前狀態：已接受查詢、詐騙、爭議、反轉、濫用、重新提交要求、AccountCompromised 或 AccountNotCompromised。
標籤 LabelReasonCodes enum 與每種標籤類型相關聯的原因碼：處理器/銀行回應碼、詐騙退款、帳戶接管、付款方式詐騙、帳戶詐騙、濫用、易記詐騙、帳戶認證外洩或通過的帳戶保護檢查。
標籤 處理器 String 產生 TC40 或系統以避免有效詐騙的銀行或付款處理器名稱。
標籤 EffectiveStartDate Datetime 此標籤生效的日期。 格式為 ISO 8601。
標籤 EffectiveEndDate Datetime 此標籤的結束日期。 格式為 ISO 8601。