帐户保护架构

重要

自 2025 年 2 月 3 日起,Dynamics 365 欺诈保护不再可供购买。 对欺诈保护的支持将于 2026 年 2 月 3 日结束。 有关详细信息,请参阅 Dynamics 365 欺诈保护 文章 终止支持。

本文概述了通过应用程序编程接口(API)的架构。 有关详细信息,请参阅 集成 Dynamics 365 欺诈防护实时 API

AccountCreation

AccountCreation API 允许你与 Microsoft Dynamics 365 欺诈保护共享有关传入的新帐户创建事件的信息和上下文,以便进行风险评估。

Object 属性 类型 描述
租户 ID string TenantId 是表示 Azure ActiveDirectory 租户的 GUID。
名称 string 值为 AP。AccountCreation
版本 string 值为 0.5
MetaData trackingId string AccountCreationId 事件的标识符
MetaData SignupId string AccountCreationId 事件的标识符。 (此值可以匹配 trackingId 属性的值,但与 userId 属性不同。
MetaData assessmentType string 事件的评估类型。 可能的值为值和保护。 如果未指定任何值,则默认值是 保护的。
MetaData customerLocalDate dateTime 客户本地时区中的 AccountCreationId 事件的创建日期。 格式为 ISO 8601。
MetaData merchantTimeStamp dateTime 事件的时间戳。
DeviceContext DeviceContextId string 客户的会话 ID。 此信息由 DFP 设备指纹服务掌握。
DeviceContext ipAddress string 由商家提供的客户的 IP 地址。
DeviceContext 提供程序 string 设备信息的提供程序。 可能的值为 DFPFingerprintingMerchant。 如果未指定任何值,则默认值为 DFPFingerprinting
DeviceContext externalDeviceId string 由商家提供和掌握的客户设备 ID。
DeviceContext externalDeviceType string 客户的设备类型,由商家提供和掌握。 可能的值为 MobileComputerMerchantHardwareTabletGameConsole
用户 userId string 用户标识符。 此信息由商家提供。
用户 userType string 用户的配置文件类型。 可能的值为 Consumer、DeveloperSellerPublisherTenant
用户 UserName string 在商家系统中唯一的用户提供的用户名。
用户 firstName string 帐户上用户提供的名字。
用户 lastName string 帐户上用户提供的姓氏。
用户 CountryRegion string 用户所在的国家或地区。 该值应为双字母 ISO 国家/地区代码(例如 美国)。
用户 zipCode string 用户的邮政编码。
用户 timezone string 用户的时区。
用户 language string 用户的语言和区域(例如 EN-US)。
用户 membershipId string 如果用户已有与商家的现有成员身份,则成员身份 ID。
用户 isMembershipIdUserName 布尔 一个 True/False 值,该值指示 membershipId 值是否可以用作用户名。 默认值为 False
Phone phoneType enum 电话号码的类型。 可能的值为 PrimaryAlternative。 默认值为 Primary
Phone phoneNumber string 用户的电话号码。 格式应为国家/地区代码,后跟连字符(-),然后是电话号码(例如,对于美国, +1-1234567890)。
Phone isPhoneNumberValidated 布尔 一个 True/False 值,该值指示用户提供的电话号码是否已验证为用户拥有的电话号码。
Phone phoneNumberValidatedDate dateTime 用户的电话号码的验证日期。 格式为 ISO 8601。
Phone isPhoneUserName 布尔 一个 True/False 值,该值指示电话号码是否可以用作用户名。 默认值为 False
电子邮件 emailType enum 电子邮件地址的类型。 可能的值为 PrimaryAlternative
电子邮件 emailValue string 用户的电子邮件地址。 此值不区分大小写。
电子邮件 isEmailValidated 布尔 一个 True/False 值,该值指示用户提供的电子邮件地址是否已验证为用户拥有。
电子邮件 emailValidatedDate dateTime 用户电子邮件地址的验证日期。 格式为 ISO 8601。
电子邮件 isEmailUserName 布尔 一个 True/False 值,该值指示电子邮件地址是否可以用作用户名。 默认值为 False
SSOAuthenticationProvider authenticationProvider string 用户的单一登录 (SSO) 身份验证提供程序(如果它不同于商家的 SSO 身份验证提供程序)。 可能的值为 MSA、FacebookPSNMerchantAuthGoogle
SSOAuthenticationProvider displayName string SSO 身份验证提供程序的用户显示名称(例如,来自Microsoft帐户、Facebook 或 Google 的用户名)。
Address addressType enum 地址类型。 可能的值为 PrimaryBillingShippingAlternative。 默认值为 Primary
Address firstName string 与地址关联的用户提供的名字。
Address lastName string 与地址关联的用户提供的姓氏。
Address phoneNumber string 与地址关联的用户提供的电话号码。
Address street1 string 为地址提供的第一行。
Address street2 string 为地址提供的第二行。 (此值可以为空。
Address street3 string 为地址提供的第三行。 (此值可以为空。
Address city string 为地址提供的城市。
Address State string 为地址提供的国家或省。
Address string 为地址提供的区域。
Address zipCode string 为地址提供的邮政编码。
Address CountryRegion string 为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码(例如 美国)。
PaymentInstrument merchantPaymentInstrumentId string 付款方式的标识符。 此信息由商家提供。
PaymentInstrument type enum 付款类型。 可能的值为 CreditCard、DirectDebitPayPalMobileBillingOnlineBankTransferInvoiceBusinessGiftCardBusinessWalletCashOnDeliveryPaytmCCAvenue
PaymentInstrument creationDate DateTime 商家系统中付款方式的第一个条目的日期。 格式为 ISO 8601。
PaymentInstrument updateDate DateTime 商家系统中付款方式的上次更新日期。 格式为 ISO 8601。
PaymentInstrument State string 商家系统中付款方式的当前状态(例如 活动阻止过期)。
PaymentInstrument cardType string 此属性仅用于信用卡或 DirectDebit 类型的付款。 可能的值为 Visa万事达卡AmexACHSEPA银联InicisMobileBillingCarrierDiscoverAllPayJCBDiscoverDiners
PaymentInstrument holderName string 付款方式用户的名称。 此属性仅用于信用卡或 DirectDebit 类型的付款
PaymentInstrument bin string 此属性仅用于信用卡或 DirectDebit 类型的付款
PaymentInstrument expirationDate string 商家系统中付款方式的到期日期。 格式为 ISO 8601。 此属性仅用于信用卡或 DirectDebit 类型的付款
PaymentInstrument lastFourDigits string 此属性仅用于信用卡或 DirectDebit 类型的付款
PaymentInstrument 电子邮件 string 与付款方式关联的电子邮件地址。 此属性仅用于PayPal类型的付款
PaymentInstrument billingAgreementId string 此属性仅用于PayPal类型的付款
PaymentInstrument payerId string 此属性仅用于PayPal类型的付款
PaymentInstrument payerStatus string 一个值,该值指示PayPal是否已验证付款人。 此属性仅用于PayPal类型的付款
PaymentInstrument addressStatus string 一个值,该值指示PayPal是否已验证付款人的地址。 此属性仅用于PayPal类型的付款
PaymentInstrument imei string 此属性仅用于 MobileBilling 类型的付款
PaymentInstrument \ BillingAddress addressType enum 地址类型。 可能的值为 PrimaryBillingShippingAlternative。 默认值为 Billing
PaymentInstrument \ BillingAddress firstName string 与地址关联的用户提供的名字。
PaymentInstrument \ BillingAddress lastName string 与地址关联的用户提供的姓氏。
PaymentInstrument \ BillingAddress phoneNumber string 与地址关联的用户提供的电话号码。
PaymentInstrument \ BillingAddress street1 string 为地址提供的第一行。
PaymentInstrument \ BillingAddress street2 string 为地址提供的第二行。 (此值可以为空。
PaymentInstrument \ BillingAddress street3 string 为地址提供的第三行。 (此值可以为空。
PaymentInstrument \ BillingAddress city string 为地址提供的城市。
PaymentInstrument \ BillingAddress State string 为地址提供的国家或省。
PaymentInstrument \ BillingAddress string 为地址提供的区域
PaymentInstrument \ BillingAddress zipCode string 为地址提供的邮政编码。
PaymentInstrument \ BillingAddress CountryRegion string 为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码(例如 美国)。
MarketingContext campaignType enum 市场营销活动类型。 可能的值为 Direct、Email、Referral、PaidSearch、OrganicSearchAdvertisingSocialNetworkGeneral MarketingUnknownOther。
MarketingContext trafficSource-referrer string 此用户的源(如果已知)。 如果通过现有用户引荐,请提供引用者的原始 MerchantUserId。
MarketingContext trafficSource-referralLink string 此用户的源(如果已知)。 如果通过其他市场活动类型而不是现有用户引荐,请提供源 URL 链接。
MarketingContext trafficSource-referralSite string 流量的源站点。 可能的值为 Facebook、InstagramTwitter必应、GooglePinterestWhatsApp 等。
MarketingContext IncentiveType enum 新用户的奖励类型。 可能的值为 None、CashBackDiscountFreeTrialBonusPointsGiftUnknownOther
MarketingContext incentiveOffer string 确切的奖励套餐名称。 例如,第一订单 5 美元,免费送货,5000 点。
MarketingContext CampaignStartDate date 从奖励收集开始的竞选活动日期。
MarketingContext CampaignExpireDate date 奖励收集的市场活动到期日期。
MarketingContext IncentiveQuantityLimit string 商家设置的奖励数量限制。 例如,每个用户每天最多 3 个 5000 点。

AccountCreationStatus

AccountCreationStatus API 允许你与欺诈保护共享有关帐户创建事件状态的信息和上下文。 此事件只是数据引入事件。

Object 属性 类型 描述
租户 ID string TenantId 是表示 Azure ActiveDirectory 租户的 GUID。
名称 string 值为 AP。AccountCreation.Status
版本 string 值为 0.5
MetaData trackingID string SignupStatus 事件的标识符
MetaData signupId string Signup 事件的标识符
MetaData merchantTimeStamp DateTime 事件的时间戳。
MetaData userId string 用户标识符。 此信息由商家提供。
StatusDetails statusType enum 状态类型: 已批准拒绝挂起
StatusDetails reasonType enum 原因类型: 已放弃挑战、 质询失败质询通过待定质询审阅失败审阅通过审阅挂起。 默认值为
StatusDetails challengeType enum 审阅状态的类型: SMSEmailPhoneOtherNone。 默认值为
StatusDetails statusDate DateTime 应用状态的日期和时间。 格式为 ISO 8601。

AccountLogIn

通过 AccountLogIn API,你可以与欺诈保护共享有关传入登录事件的信息和上下文,以便进行风险评估。

Object 属性 类型 描述
名称 string 值为 AP。AccountLogin
版本 string 值为 0.5
MetaData trackingId string Login 事件的标识符
MetaData LogInId string Signup 事件的标识符。 (此值可以匹配 trackingId 属性的值
MetaData assessmentType string 事件的评估类型。 可能的值为值和保护。 如果未指定任何值,则默认值是 保护的。
MetaData customerLocalDate dateTime 注册事件的创建日期,位于客户的本地时区。 格式为 ISO 8601。
MetaData merchantTimeStamp dateTime 事件的时间戳。
DeviceContext DeviceContextId string 客户的会话 ID。 此信息由 DFP 设备指纹服务掌握。
DeviceContext ipAddress string 由商家提供的客户的 IP 地址。
DeviceContext 提供程序 string 设备信息的提供程序。 可能的值为 DFPFingerprintingMerchant。 如果未指定任何值,则默认值为 DFPFingerprinting
DeviceContext externalDeviceId string 由商家提供和掌握的客户设备 ID。
DeviceContext externalDeviceType string 客户的设备类型,由商家提供和掌握。
用户 userId string 用户标识符。 此信息由商家提供。
用户 userType string 用户的配置文件类型。 可能的值为 Consumer、DeveloperSellerPublisherTenant
用户 UserName string 在商家系统中唯一的用户提供的用户名。
SSOAuthenticationProvider authenticationProvider string 用户的 SSO 身份验证提供程序(如果它不同于商家的 SSO 身份验证提供程序)。 可能的值为 MSA、FacebookPSNMerchantAuthGoogle
SSOAuthenticationProvider displayName string SSO 身份验证提供程序的用户显示名称。 例如,Microsoft帐户、Facebook 或 Google 中的用户名。
RecentUpdate lastPhoneNumberUpdate dateTime 最新更新或创建任何电话号码的日期/时间。
RecentUpdate lastEmailUpdate dateTime 最新更新或创建任何电子邮件地址的日期/时间。
RecentUpdate lastAddressUpdate dateTime 最新更新或创建任何地址的日期/时间。
RecentUpdate lastPaymentInstrumentUpdate dateTime 最近更新或创建任何付款方式的日期/时间。
MarketingContext campaignType enum 市场营销活动类型。 可能的值为 Direct、Email、Referral、PaidSearch、OrganicSearchAdvertisingSocialNetworkGeneral MarketingUnknownOther。
MarketingContext trafficSource-referrer string 此用户的源(如果已知)。 如果通过现有用户引荐,请提供引用者的原始 MerchantUserId。
MarketingContext trafficSource-referralLink string 此用户的源(如果已知)。 如果通过其他市场活动类型而不是现有用户引荐,请提供源 URL 链接。
MarketingContext trafficSource-referralSite string 流量的源站点。 可能的值为 Facebook、InstagramTwitter必应、GooglePinterestWhatsApp 等。
MarketingContext IncentiveType enum 新用户的奖励类型。 可能的值为 None、CashBackDiscountFreeTrialBonusPointsGiftUnknownOther
MarketingContext incentiveOffer string 确切的奖励套餐名称。 例如,第一订单 5 美元,免费送货,5000 点。
MarketingContext CampaignStartDate date 从奖励收集开始的竞选活动日期。
MarketingContext CampaignExpireDate date 奖励收集的市场活动到期日期。
MarketingContext IncentiveQuantityLimit string 商家设置的奖励数量限制。 例如,每个用户每天最多 3 个 5000 点。

AccountLogInStatus

AccountLogInStatus API 允许你与欺诈保护共享有关帐户登录事件状态的信息和上下文。 此事件只是数据引入事件。

Object 属性 类型 描述
名称 string 值为 AP。AccountLogin.Status
版本 string 值为 0.5
MetaData trackingID string LoginStatus 事件的标识符
MetaData logInId string Login 事件的标识符
MetaData merchantTimeStamp DateTime 事件的时间戳。
MetaData userId string 用户标识符。 此信息由商家提供。
StatusDetails statusType string 状态类型: 已批准拒绝挂起
StatusDetails reasonType enum 原因类型: 已放弃挑战、 质询失败质询通过待定质询审阅失败审阅通过审阅挂起。 默认值为
StatusDetails challengeType enum 审阅状态的类型: SMSEmailPhoneOtherNone。 默认值为
StatusDetails statusDate DateTime 应用状态的日期和时间。 格式为 ISO 8601。

AccountUpdate

AccountUpdate API 允许你与欺诈保护共享帐户信息更新。 例如,可以编辑或添加以下信息:用户配置文件、地址、付款方式、电话号码、电子邮件地址和 SSO。 此事件只是数据引入事件。

Object 属性 类型 描述
名称 string 值为 AP。AccountUpdate
版本 string 值为 0.5
MetaData trackingId string AccountUpdate 事件的标识符
MetaData SignupId string AccountUpdateId 事件的标识符。 (此值可以匹配 trackingId 属性的值
MetaData customerLocalDate dateTime AccountUpdate 事件的创建日期,位于客户的本地时区。 格式为 ISO 8601。
MetaData merchantTimeStamp dateTime 事件的时间戳。
DeviceContext DeviceContextId string 客户的会话 ID。 此信息由 DFP 设备指纹服务掌握。
DeviceContext ipAddress string 由商家提供的客户的 IP 地址。
DeviceContext 提供程序 string 设备信息的提供程序。 可能的值为 DFPFingerprintingMerchant。 如果未指定任何值,则默认值为 DFPFingerprinting
DeviceContext externalDeviceId string 由商家提供和掌握的客户设备 ID。
DeviceContext externalDeviceType string 客户的设备类型,由商家提供和掌握。 可能的值为 Mobile'、ComputerMerchantHardwareTabletGameConsole
用户 userId string 用户标识符。 此信息由商家提供。
用户 userType string 用户的配置文件类型。 可能的值为 Consumer、DeveloperSellerPublisherTenant
用户 UserName string 在商家系统中唯一的用户提供的用户名。
用户 firstName string 帐户上用户提供的名字。
用户 lastName string 帐户上用户提供的姓氏。
用户 CountryRegion string 用户所在的国家或地区。 该值应为双字母 ISO 国家/地区代码(例如 美国)。
用户 zipCode string 用户的邮政编码。
用户 timezone string 用户的时区。
用户 language string 用户的语言和区域(例如 EN-US)。
用户 membershipId string 如果用户已有与商家的现有成员身份,则成员身份 ID。
用户 isMembershipIdUserName 布尔 一个 True/False 值,该值指示 membershipId 值是否可以用作用户名。 默认值为 False
Phone phoneType enum 电话号码的类型。 可能的值为 PrimaryAlternative。 默认值为 Primary
Phone phoneNumber string 用户的电话号码。 格式应为国家/地区代码,后跟连字符(-),然后是电话号码(例如,对于美国, +1-1234567890)。
Phone isPhoneNumberValidated 布尔 一个 True/False 值,该值指示用户提供的电话号码是否已验证为用户拥有的电话号码。
Phone phoneNumberValidatedDate dateTime 用户的电话号码的验证日期。 格式为 ISO 8601。
Phone isPhoneUserName 布尔 一个 True/False 值,该值指示电话号码是否可以用作用户名。 默认值为 False
电子邮件 emailType enum 电子邮件地址的类型。 可能的值为 PrimaryAlternative
电子邮件 emailValue string 用户的电子邮件地址。 此值不区分大小写。
电子邮件 isEmailValidated 布尔 一个 True/False 值,该值指示用户提供的电子邮件地址是否已验证为用户拥有。
电子邮件 emailValidatedDate dateTime 用户电子邮件地址的验证日期。 格式为 ISO 8601。
电子邮件 isEmailUserName 布尔 一个 True/False 值,该值指示电子邮件地址是否可以用作用户名。 默认值为 False
SSOAuthenticationProvider authenticationProvider string 用户的 SSO 身份验证提供程序(如果它不同于商家的 SSO 身份验证提供程序)。 可能的值为 MSA、FacebookPSNMerchantAuthGoogle
SSOAuthenticationProvider displayName string SSO 身份验证提供程序的用户显示名称(例如,来自Microsoft帐户、Facebook 或 Google 的用户名)。
Address addressType enum 地址类型。 可能的值为 PrimaryBillingShippingAlternative。 默认值为 Primary
Address firstName string 与地址关联的用户提供的名字。
Address lastName string 与地址关联的用户提供的姓氏。
Address phoneNumber string 与地址关联的用户提供的电话号码。
Address street1 string 为地址提供的第一行。
Address street2 string 为地址提供的第二行。 (此值可以为空。
Address street3 string 为地址提供的第三行。 (此值可以为空。
Address city string 为地址提供的城市。
Address State string 为地址提供的国家或省。
Address string 为地址提供的区域。
Address zipCode string 为地址提供的邮政编码。
Address CountryRegion string 为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码(例如 美国)。
PaymentInstrument merchantPaymentInstrumentId string 付款方式的标识符。 此信息由商家提供。
PaymentInstrument type enum 付款类型。 可能的值为 CreditCard、DirectDebitPayPalMobileBillingOnlineBankTransferInvoiceBusinessGiftCardBusinessWalletCashOnDeliveryPaytmCCAvenue
PaymentInstrument creationDate DateTime 商家系统中付款方式的第一个条目的日期。 格式为 ISO 8601。
PaymentInstrument updateDate DateTime 商家系统中付款方式的上次更新日期。 格式为 ISO 8601。
PaymentInstrument State string 商家系统中付款方式的当前状态(例如 活动阻止过期)。
PaymentInstrument cardType string 此属性仅用于信用卡或 DirectDebit 类型的付款。 可能的值为 Visa万事达卡AmexACHSEPA银联InicisMobileBillingCarrierDiscoverAllPayJCBDiscoverDiners
PaymentInstrument holderName string 付款方式用户的名称。 此属性仅用于信用卡 DirectDebit 类型的付款
PaymentInstrument bin string 此属性仅用于信用卡或 DirectDebit 类型的付款
PaymentInstrument expirationDate string 商家系统中付款方式的到期日期。 格式为 ISO 8601。 此属性仅用于信用卡或 DirectDebit 类型的付款
PaymentInstrument lastFourDigits string 此属性仅用于信用卡或 DirectDebit 类型的付款
PaymentInstrument 电子邮件 string 与付款方式关联的电子邮件地址。 此属性仅用于PayPal类型的付款
PaymentInstrument billingAgreementId string 此属性仅用于PayPal类型的付款
PaymentInstrument payerId string 此属性仅用于PayPal类型的付款
PaymentInstrument payerStatus string 一个值,该值指示PayPal是否已验证付款人。 此属性仅用于PayPal类型的付款
PaymentInstrument addressStatus string 一个值,该值指示PayPal是否已验证付款人的地址。 此属性仅用于PayPal类型的付款
PaymentInstrument imei string 此属性仅用于 MobileBilling 类型的付款
PaymentInstrument \ BillingAddress addressType enum 地址类型。 可能的值为 PrimaryBillingShippingAlternative。 默认值为 Billing
PaymentInstrument \ BillingAddress firstName string 与地址关联的用户提供的名字。
PaymentInstrument \ BillingAddress lastName string 与地址关联的用户提供的姓氏。
PaymentInstrument \ BillingAddress phoneNumber string 与地址关联的用户提供的电话号码。
PaymentInstrument \ BillingAddress street1 string 为地址提供的第一行。
PaymentInstrument \ BillingAddress street2 string 为地址提供的第二行。 (此值可以为空。
PaymentInstrument \ BillingAddress street3 string 为地址提供的第三行。 (此值可以为空。
PaymentInstrument \ BillingAddress city string 为地址提供的城市。
PaymentInstrument \ BillingAddress State string 为地址提供的国家或省。
PaymentInstrument \ BillingAddress string 为地址提供的区域。
PaymentInstrument \ BillingAddress zipCode string 为地址提供的邮政编码。
PaymentInstrument \ BillingAddress CountryRegion string 为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码(例如 美国)。

标签

使用 标签 API 可以共享有关基于一组附加欺诈信号的模型训练的事务和事件结果的其他信息。 此信息包括从银行收到的信息。 此事件只是数据引入事件。

类别 属性 类型 描述
名称 string 值为 AP。AccountLabel
版本 string 值为 0.5
MetaData TrackingId 字符串 每个事件/记录的唯一 ID。
MetaData merchantTimeStamp DateTime 在商家的时区中的日期。 格式为 ISO 8601。
MetaData userId string 用户标识符。 此信息由商家提供。
标签 EventTimeStamp DateTime 事件的日期和时间。 可能的值为退款日期和审阅日期。 格式为 ISO 8601。
标签 LabelObjectType enum 标签类型:购买、帐户创建、帐户登录帐户更新自定义欺诈评估帐户付款方式电子邮件
标签 LabelObjectId 字符串 对象的标识符字段:PurchaseId、AccountCreationIdAccountLoginIdAccountUpdateId、UserIdMerchantPaymentInstrumentIdEmail
标签 LabelSource enum 标签的来源: 客户升级退款TC40_SAFE手动评审退款脱机分析帐户保护评审
标签 LabelState enum 标签的当前状态:已接受查询、欺诈争议反向滥用重新提交请求AccountCompromisedAccountNotCompromised
标签 LabelReasonCodes enum 与每种标签类型关联的原因代码:处理器/银行响应代码欺诈退款帐户接管付款方式欺诈、帐户欺诈滥用友好欺诈帐户凭据泄露通过的帐户保护检查
标签 处理器 字符串 生成 TC40 或系统以避免欺诈(SAFE)信息的银行或付款处理者的名称。
标签 EffectiveStartDate DateTime 此标签生效的日期。 格式为 ISO 8601。
标签 EffectiveEndDate DateTime 此标签的结束日期。 格式为 ISO 8601。