帐户保护架构
重要
自 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 | 设备信息的提供程序。 可能的值为 DFPFingerprinting 和 Merchant。 如果未指定任何值,则默认值为 DFPFingerprinting。 |
DeviceContext | externalDeviceId | string | 由商家提供和掌握的客户设备 ID。 |
DeviceContext | externalDeviceType | string | 客户的设备类型,由商家提供和掌握。 可能的值为 Mobile、 Computer、 MerchantHardware、 Tablet 和 GameConsole。 |
用户 | userId | string | 用户标识符。 此信息由商家提供。 |
用户 | userType | string | 用户的配置文件类型。 可能的值为 Consumer、Developer、Seller、Publisher 和 Tenant。 |
用户 | 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 | 电话号码的类型。 可能的值为 Primary 和 Alternative。 默认值为 Primary。 |
Phone | phoneNumber | string | 用户的电话号码。 格式应为国家/地区代码,后跟连字符(-),然后是电话号码(例如,对于美国, +1-1234567890)。 |
Phone | isPhoneNumberValidated | 布尔 | 一个 True/False 值,该值指示用户提供的电话号码是否已验证为用户拥有的电话号码。 |
Phone | phoneNumberValidatedDate | dateTime | 用户的电话号码的验证日期。 格式为 ISO 8601。 |
Phone | isPhoneUserName | 布尔 | 一个 True/False 值,该值指示电话号码是否可以用作用户名。 默认值为 False。 |
电子邮件 | emailType | enum | 电子邮件地址的类型。 可能的值为 Primary 和 Alternative。 |
电子邮件 | emailValue | string | 用户的电子邮件地址。 此值不区分大小写。 |
电子邮件 | isEmailValidated | 布尔 | 一个 True/False 值,该值指示用户提供的电子邮件地址是否已验证为用户拥有。 |
电子邮件 | emailValidatedDate | dateTime | 用户电子邮件地址的验证日期。 格式为 ISO 8601。 |
电子邮件 | isEmailUserName | 布尔 | 一个 True/False 值,该值指示电子邮件地址是否可以用作用户名。 默认值为 False。 |
SSOAuthenticationProvider | authenticationProvider | string | 用户的单一登录 (SSO) 身份验证提供程序(如果它不同于商家的 SSO 身份验证提供程序)。 可能的值为 MSA、Facebook、PSN、MerchantAuth 和 Google。 |
SSOAuthenticationProvider | displayName | string | SSO 身份验证提供程序的用户显示名称(例如,来自Microsoft帐户、Facebook 或 Google 的用户名)。 |
Address | addressType | enum | 地址类型。 可能的值为 Primary、 Billing、 Shipping 和 Alternative。 默认值为 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、DirectDebit、PayPal、MobileBilling、OnlineBankTransfer、Invoice、BusinessGiftCard、BusinessWallet、CashOnDelivery、Paytm 和 CCAvenue。 |
PaymentInstrument | creationDate | DateTime | 商家系统中付款方式的第一个条目的日期。 格式为 ISO 8601。 |
PaymentInstrument | updateDate | DateTime | 商家系统中付款方式的上次更新日期。 格式为 ISO 8601。 |
PaymentInstrument | State | string | 商家系统中付款方式的当前状态(例如 活动、 阻止或 过期)。 |
PaymentInstrument | cardType | string | 此属性仅用于信用卡或 DirectDebit 类型的付款。 可能的值为 Visa、 万事达卡、 Amex、 ACH、 SEPA、 银联、 Inicis、 MobileBillingCarrier、 Discover、 AllPay、 JCB 和 DiscoverDiners。 |
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 | 地址类型。 可能的值为 Primary、 Billing、 Shipping 和 Alternative。 默认值为 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、OrganicSearch、Advertising、SocialNetwork、General Marketing、Unknown、Other。 |
MarketingContext | trafficSource-referrer | string | 此用户的源(如果已知)。 如果通过现有用户引荐,请提供引用者的原始 MerchantUserId。 |
MarketingContext | trafficSource-referralLink | string | 此用户的源(如果已知)。 如果通过其他市场活动类型而不是现有用户引荐,请提供源 URL 链接。 |
MarketingContext | trafficSource-referralSite | string | 流量的源站点。 可能的值为 Facebook、Instagram、Twitter、必应、Google、Pinterest、WhatsApp 等。 |
MarketingContext | IncentiveType | enum | 新用户的奖励类型。 可能的值为 None、CashBack、Discount、FreeTrial、BonusPoints、Gift、Unknown、Other。 |
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 | 审阅状态的类型: SMS、 Email、 Phone、 Other 或 None。 默认值为无。 |
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 | 设备信息的提供程序。 可能的值为 DFPFingerprinting 和 Merchant。 如果未指定任何值,则默认值为 DFPFingerprinting。 |
DeviceContext | externalDeviceId | string | 由商家提供和掌握的客户设备 ID。 |
DeviceContext | externalDeviceType | string | 客户的设备类型,由商家提供和掌握。 |
用户 | userId | string | 用户标识符。 此信息由商家提供。 |
用户 | userType | string | 用户的配置文件类型。 可能的值为 Consumer、Developer、Seller、Publisher 和 Tenant。 |
用户 | UserName | string | 在商家系统中唯一的用户提供的用户名。 |
SSOAuthenticationProvider | authenticationProvider | string | 用户的 SSO 身份验证提供程序(如果它不同于商家的 SSO 身份验证提供程序)。 可能的值为 MSA、Facebook、PSN、MerchantAuth 和 Google。 |
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、OrganicSearch、Advertising、SocialNetwork、General Marketing、Unknown、Other。 |
MarketingContext | trafficSource-referrer | string | 此用户的源(如果已知)。 如果通过现有用户引荐,请提供引用者的原始 MerchantUserId。 |
MarketingContext | trafficSource-referralLink | string | 此用户的源(如果已知)。 如果通过其他市场活动类型而不是现有用户引荐,请提供源 URL 链接。 |
MarketingContext | trafficSource-referralSite | string | 流量的源站点。 可能的值为 Facebook、Instagram、Twitter、必应、Google、Pinterest、WhatsApp 等。 |
MarketingContext | IncentiveType | enum | 新用户的奖励类型。 可能的值为 None、CashBack、Discount、FreeTrial、BonusPoints、Gift、Unknown、Other。 |
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 | 审阅状态的类型: SMS、 Email、 Phone、 Other 或 None。 默认值为无。 |
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 | 设备信息的提供程序。 可能的值为 DFPFingerprinting 和 Merchant。 如果未指定任何值,则默认值为 DFPFingerprinting。 |
DeviceContext | externalDeviceId | string | 由商家提供和掌握的客户设备 ID。 |
DeviceContext | externalDeviceType | string | 客户的设备类型,由商家提供和掌握。 可能的值为 Mobile'、Computer、MerchantHardware、Tablet 和 GameConsole。 |
用户 | userId | string | 用户标识符。 此信息由商家提供。 |
用户 | userType | string | 用户的配置文件类型。 可能的值为 Consumer、Developer、Seller、Publisher 和 Tenant。 |
用户 | 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 | 电话号码的类型。 可能的值为 Primary 和 Alternative。 默认值为 Primary。 |
Phone | phoneNumber | string | 用户的电话号码。 格式应为国家/地区代码,后跟连字符(-),然后是电话号码(例如,对于美国, +1-1234567890)。 |
Phone | isPhoneNumberValidated | 布尔 | 一个 True/False 值,该值指示用户提供的电话号码是否已验证为用户拥有的电话号码。 |
Phone | phoneNumberValidatedDate | dateTime | 用户的电话号码的验证日期。 格式为 ISO 8601。 |
Phone | isPhoneUserName | 布尔 | 一个 True/False 值,该值指示电话号码是否可以用作用户名。 默认值为 False。 |
电子邮件 | emailType | enum | 电子邮件地址的类型。 可能的值为 Primary 和 Alternative。 |
电子邮件 | emailValue | string | 用户的电子邮件地址。 此值不区分大小写。 |
电子邮件 | isEmailValidated | 布尔 | 一个 True/False 值,该值指示用户提供的电子邮件地址是否已验证为用户拥有。 |
电子邮件 | emailValidatedDate | dateTime | 用户电子邮件地址的验证日期。 格式为 ISO 8601。 |
电子邮件 | isEmailUserName | 布尔 | 一个 True/False 值,该值指示电子邮件地址是否可以用作用户名。 默认值为 False。 |
SSOAuthenticationProvider | authenticationProvider | string | 用户的 SSO 身份验证提供程序(如果它不同于商家的 SSO 身份验证提供程序)。 可能的值为 MSA、Facebook、PSN、MerchantAuth 和 Google。 |
SSOAuthenticationProvider | displayName | string | SSO 身份验证提供程序的用户显示名称(例如,来自Microsoft帐户、Facebook 或 Google 的用户名)。 |
Address | addressType | enum | 地址类型。 可能的值为 Primary、 Billing、 Shipping 和 Alternative。 默认值为 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、DirectDebit、PayPal、MobileBilling、OnlineBankTransfer、Invoice、BusinessGiftCard、BusinessWallet、CashOnDelivery、Paytm 和 CCAvenue。 |
PaymentInstrument | creationDate | DateTime | 商家系统中付款方式的第一个条目的日期。 格式为 ISO 8601。 |
PaymentInstrument | updateDate | DateTime | 商家系统中付款方式的上次更新日期。 格式为 ISO 8601。 |
PaymentInstrument | State | string | 商家系统中付款方式的当前状态(例如 活动、 阻止或 过期)。 |
PaymentInstrument | cardType | string | 此属性仅用于信用卡或 DirectDebit 类型的付款。 可能的值为 Visa、 万事达卡、 Amex、 ACH、 SEPA、 银联、 Inicis、 MobileBillingCarrier、 Discover、 AllPay、 JCB 和 DiscoverDiners。 |
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 | 地址类型。 可能的值为 Primary、 Billing、 Shipping 和 Alternative。 默认值为 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、AccountCreationId、AccountLoginId、AccountUpdateId、UserId、MerchantPaymentInstrumentId 或 Email。 |
标签 | LabelSource | enum | 标签的来源: 客户升级、 退款、 TC40_SAFE、 手动评审、 退款、 脱机分析或 帐户保护评审。 |
标签 | LabelState | enum | 标签的当前状态:已接受查询、欺诈、争议、反向、滥用、重新提交请求、AccountCompromised 或 AccountNotCompromised。 |
标签 | LabelReasonCodes | enum | 与每种标签类型关联的原因代码:处理器/银行响应代码、欺诈退款、帐户接管、付款方式欺诈、帐户欺诈、滥用、友好欺诈、帐户凭据泄露或通过的帐户保护检查。 |
标签 | 处理器 | 字符串 | 生成 TC40 或系统以避免欺诈(SAFE)信息的银行或付款处理者的名称。 |
标签 | EffectiveStartDate | DateTime | 此标签生效的日期。 格式为 ISO 8601。 |
标签 | EffectiveEndDate | DateTime | 此标签的结束日期。 格式为 ISO 8601。 |