通过

查看购买保护架构

  • 项目

本文概述了批量上传到 Microsoft Dynamics 365 欺诈保护的实时 API 和历史数据的架构。 有关上传过程的信息，请参阅 “上传历史数据”。 如果数据将通过应用程序编程接口（API）引入，请参阅 集成 Dynamics 365 欺诈防护实时 API。

请遵循以下要求：

  • 这些文件采用 CSV UTF-8（逗号、分号或制表符分隔）格式（*.csv或 *.tsv）。
  • 最大文件大小为 10 GB（GB）。
  • 以下字符在所有列中进行转义：逗号/分号、新行字符和多行字符。
  • “datetime”列采用 ISO 8601 格式。 例如，在 C# DateTime.UtcNow.ToString（“o”）中，格式为“2019-03-14T20：18：11.254Z”。
  • “double”（十进制）列精度为两个小数位数。

事务

评估和保护体验中使用以下架构。

购买

属性 类型 描述
PurchaseId 字符串 交易的标识符（或购买或订单）。
OriginalOrderId 字符串 定期计费付款的原始订单标识符，例如每月订阅计费。
CustomerLocalDate DateTime 客户的本地时区中的购买创建日期。 格式为 ISO 8601。
MerchantLocalDate DateTime 商家本地时区的购买引入日期。 格式为 ISO 8601。
TotalAmount 双精度 向客户收取的总金额，包括税款。 此信息由商家提供。
SalesTax 双精度 为交易收取的销售税。 此信息由商家提供。
货币 字符串 原始购买的货币作为三个字符的货币代码（例如： USD，与 OANDA 货币代码一致）。 此信息由商家提供。
DeviceContextId 字符串 事件的会话（由 Microsoft 设备指纹提供）的会话 ID 或事务 ID（如果会话不可用）。
IPAddress 字符串 客户的 IP 地址。 此信息由 Microsoft 设备指纹提供。
UserID 字符串 客户标识符。 此信息由商家提供。 此属性是必需的。
UserFirstName 字符串 客户在客户帐户上提供的名字。
UserLastName 字符串 客户在客户帐户中提供的姓氏。
UserEmail 字符串 客户的电子邮件地址。 此值不区分大小写。
UserCreationDate DateTime 客户帐户的创建日期。 格式为 ISO 8601。
UserUpdateDate DateTime 上次更改客户数据的日期。 格式为 ISO 8601。
UserZipCode 字符串 客户的邮政编码。
UserCountryCode 字符串 客户的国家或地区。 该值应为双字母国家或地区代码（例如： US）。
UserTimeZone 字符串 空字符串。
UserLanguage 字符串 客户的语言和语言区域（例如： EN-US）。
User电话Number 字符串 客户的电话号码。 格式应为国家或地区代码，后跟连字符（-），然后是电话号码（例如：对于美国， +1-1234567890）。
IsEmailValidated 布尔 一个 True/False 值，该值指示是否已将客户提供的电子邮件地址验证为客户拥有。
ShippingFirstName 字符串 为地址提供的名字。
ShippingLastName 字符串 为地址提供的姓氏。
Shipping电话Number 字符串 为地址提供的电话号码。 格式应为国家或地区代码，后跟连字符（-），然后是电话号码（例如：对于美国， +1-1234567890）。
Street1 字符串 为地址提供的第一行。
Street2 字符串 为地址提供的第二行。 （此值可以为空。
Street3 字符串 为地址提供的第三行。 （此值可以为空。
市/县 字符串 为地址提供的城市。
状态 字符串 为地址提供的国家或省。
邮政编码 字符串 为地址提供的邮政编码。
CountryCode 字符串 为地址提供的国家/地区代码。 该值应为双字母 ISO 国家或地区代码（例如： 美国）。
CustomData Object 可选的用户定义的 JavaScript 对象表示法 （JSON） 属性包。 当实例化 API 调用时，会填充它。 创建购买规则时，可以引用这些属性。

注意:

  • 支持以下基元类型：字符串（Unicode）、Int32、UInt32、Double、Boolean 和 DateTime（采用协调世界时 [UTC]），符合 .NET 语义。
  • 字符串数据限制为 256 个字符。
  • 每个有效负载的自定义属性限制为 100 个。
  • 不要发送敏感或高度管控的数据类型。 以下是一些示例：
    • 指示受保护类（如性别或种族）或私人/敏感类别（如宗教观点或性取向）的数据
    • 生物识别数据或任何与运行状况相关的数据
  • 自定义数据保留策略与购买事件的保留策略（六个月）匹配。

有关演示如何在欺诈保护中使用自定义数据对象的购买 API 的示例，请参阅本文末尾的 “自定义数据示例 ”部分。
MerchantBusinessType 字符串 业务或行业垂直（例如：游戏、零售、餐饮或社交网络）。
MerchantIdentifier 字符串 商家 ID （MID） 是附加到业务的特定标识号，用于告知交易中涉及的付款处理系统，用于发送哪些资金。 你可以将其视为企业地址。 例如，如果没有商家 ID，所涉及的网络将不知道向何处发送你的钱。
MerchantCategoryCode 字符串 商家类别代码（MCC）是 ISO 18245 中用于零售金融服务的四位数。 MCC 用于按业务提供的商品或服务类型对业务进行分类。
MerchantBusinessSegment 字符串 商家的整体运营的子部分，其中有一个已建立的、独立的生产线、业务线或子品牌（例如：Xbox 或 Surface）。
MerchantProductCategory 字符串 商家定义的产品或服务类别。
StoreId 字符串 存储标识符。
StoreName 字符串 应用商店显示名称。
StoreAddress 字符串 商店的完整地址（街道、城市、州、zip）。
IsTest 布尔 一个值，该值指示事务是否在生产环境中进行测试。
IsFreeProductIncluded 布尔 一个值，该值指示是否将免费产品包含在事务中。
IsGuestCheckout 布尔 一个值，该值指示是否以来宾身份进行购买。
IsPostAuthCheck 布尔 一个值，该值指示是否存在身份验证后检查。
IsRecurringCharge 布尔 指示事务是否为订阅/定期的值。
RecurringChargeFrequencyInDays 双精度 定期购买的收费频率，例如每 30 天、每半年、每年等。
RecurringChargeStartDate DateTime 定期事务的开始日期。
RecurringChargeEndDate DateTime 定期事务的结束日期。
IsPostpaid 布尔 一个值，该值指示事务是否为 postpaid。
DiscountAmount 双精度 应用于交易的折扣金额。 例如，如果用户购买了同一 XBOX 控制器中的 10 个，则此项将为 1 号。 或者，如果用户购买了 5 个不同的游戏和 10 个相同的 XBOX 控制器，则此项将为 5+1 或 6。
TipAmount 双精度 应用于事务的小费金额。
DistinctItemCount 双精度 每个事务的非重复/唯一项计数。
TotalItemCount 双精度 每个事务的总项计数。 例如，如果用户购买了同一 XBOX 控制器中的 10 个，则此项将为 10 号。 或者，如果用户购买了 5 个不同的游戏和 10 个相同的 XBOX 控制器，则此项将为 5+10 或 15。
IsLowLiabilityPIType 布尔 指示低负债支付工具的值（例如：Apple Pay、支付宝或银联）。
OrderType 字符串 事务的类型（例如：外卖）。
IsRetryOrder 布尔 一个值，该值指示是否重试了订单。
AttemptId 字符串 每个事务重试的标识符。
ShippingDate DateTime 订单的发货日期。
OrderInitiatedChannel 字符串 创建事务的通道（例如：“AppStore”、“Web”、“MobileWeb”、“App”、“InGamePurchase”）。
OrderInitiatedChannelName 字符串 在其中创建事务的应用名称或 Web URL。
OrderInitiatedChannelRegionORCountry 字符串 创建交易的市场（例如：应用市场）。
MerchantBusinessSubSegmentL2 字符串 第二级（L2）业务或行业细分市场。
MidName 字符串 与 MID 关联的商家名称（商家标识符）。
TransactionProcessingOrder 字符串 在交易流期间进行欺诈评估的顺序。
RecurringSubscriptionId 字符串 定期费用的唯一 ID
RecurringChargeSequence Int32 此客户发生的定期费用的第 n （1， 2， 3...） 次。
TransactionDescription 字符串 事务处理类型
OrganizationLevel1 Object 组织层次结构的顶层。
OrganizationLevel2 Object 组织层次结构的中间级别。
OrganizationLevel3 Object 组织层次结构的最低级别。
ThreeDS Object 请参阅 ThreeDS 部分。
RecipientUser Object 请参阅用户部分。
TravelOverview Object 请参阅“TravelOverview”部分的垂直特定属性。
CloudBusiness Object 请参阅 CloudBusiness 部分的垂直特定属性。
MembershipType 字符串 客户的成员身份状态或类型。 可以指定不同的级别，例如 高级版 和 Executive。
AuthenticationMethod 字符串 客户在购买之前/期间进行身份验证的方式。
LoginInputMethod 字符串 客户输入其凭据的方式。
LastPasswordUpdatedDate DateTimeOffset 上次更新客户的密码时。
FirstPurchaseDate DateTimeOffset 客户首次购买时
LoginChallengeType 字符串 发起的挑战响应测试的类型。
HttpSignature 字符串 HTTP 消息的数字签名。
HttpUserAgent 字符串 用于标识应用程序、操作系统、供应商和/或版本的请求标头。
BrowserHeader 字符串 浏览器发送的请求标头的完整列表。
BrowserResolution 字符串 浏览器分辨率。
BrowserLanguage 字符串 浏览器默认语言首选项。
TcpSignature 字符串 TCP 应用程序签名。
SslSignature 字符串 SSL 签名。
EnabledCookies 布尔 一个 True/False 值，该值指示是否启用 Cookie。
EnabledFlash 布尔 一个 True/False 值，该值指示是否启用 Flash。
EnabledJavaScript 布尔 一个 True/False 值，该值指示是否启用 JavaScript。
ScreenAspectRatio 字符串 浏览器的纵横比。
ScreenColorDepth 字符串 屏幕的颜色深度。
ScreenResolution 字符串 设备屏幕分辨率（以像素为单位）
SiteHostName 字符串 网站的主机名。
操作系统 字符串 设备操作系统。
OSFonts 字符串 操作系统的默认字体。
DeviceProcessor 字符串 设备处理器。
SessionId 字符串 唯一会话 ID。
TrueIp 字符串 设备指纹标识的设备的真实 IP 地址
ProxyIp 字符串 代理设备的 IP 地址。
DeviceId 字符串 设备指纹生成的每个设备的唯一 GUID
TimeZone 字符串 相对于 GMT 的本地时区偏移量（以小时为单位）
UserAgentDetails 字符串 其他用户代理或浏览器详细信息。
AppVersion 字符串 应用程序版本。
BrowserPackagesList 字符串 设备上安装的包列表。
BuildManufacturer 字符串 设备的制造商。
BuildModel 字符串 最终产品的用户可见名称。
BuildSdkVersion 字符串 生成版本。
DataNetworkType 字符串 移动数据网络的类型。
DeviceModelName 字符串 设备模型。
DeviceSystemName 字符串 计算机的设备名称。
DeviceSystemVersion 字符串 设备版本。
Is蓝牙Enabled 布尔 一个 True/False 值，该值指示是否已启用蓝牙。
SimNetworkCountryISO 字符串 移动服务提供商的 ISO 国家/地区代码。
SimNetworkType 字符串 移动网络类型。
SystemUpTime 字符串 设备正常工作和可用的持续时间。
PaymentMethod 字符串 顶级付款方式类别。
IsLowLiabilityPIType 布尔 一个 True/False 值，该值指示付款方式是否为低负债。
HolderCompanyName 布尔 提供业务或公司卡的组织的名称（仅适用于业务购买）。
SettlementApprovalRequired 布尔 一个 True/False 值，该值指示是否需要批准 标准版PA 事务。
PaymentCheckoutProvider 字符串 eWallet 检查out 提供程序。
BinName 字符串 BIN 显示名称。
BinCountryISO 字符串 与 BIN 关联的 ISO 国家/地区代码。
BinCardType 字符串 BIN 卡类型。
BinCardAssociation 字符串 BIN 卡关联。
BinBankGroup 字符串 BIN 银行组。
货币 字符串 所选付款方式的货币代码。
IsInternationalMoneyTransfer 布尔 一个 True/False 值，指示是否发生了国际资金转移。
BankIdentifierCode 字符串 银行标识符代码（BIC 或 SWIFT 代码）
BankName 字符串 银行名称。
BankZipCode 字符串 银行邮政编码。
BankState 字符串 银行州。
BankCountryISO 字符串 银行 ISO 国家/地区。
PaymentCollectionDate DateTimeOffset 付款收集的估计日期（主要用于支付服务提供商）。
InstantPaymentSettlement 布尔 指示银行重定向（用于支持 CSV 付款）的 True/False 值。
AutoCaptureEnabled 布尔 一个 True/False 值，该值指示是否自动为卡付款捕获付款。 对于重定向付款，这只是合作伙伴银行是否自动提取资金的指标。
AccountType 字符串 指示要为事务收取费用的帐户类型。 UNSPECIFIED 是默认值。 CHEQUE_ACCOUNT使用卡作为借记卡。 CREDIT_FACILITY使用卡作为信用卡。
AuthorizationType 字符串 授权类型。 Master卡 和 Visa 现在要求商家将授权尝试定义为预授权或最终授权。
AuthorizationResultCode 字符串 授权决定的银行响应。
AuthorizationResultText 字符串 授权决策的原因，尤其是拒绝或挂起的事务。
AcquirerId 字符串 获取机构标识代码。
AcquirerCountryISO 字符串 获取机构国家/地区代码。
CvvVerify 字符串 指示 CVV 验证是否可用和/或已成功验证。
  • Y = 已成功验证
  • N = 未成功验证
  • U = 不可用
  • A = 可用，但没有验证
AvsVerify 字符串 指示地址验证是否可用和/或已成功验证。
  • Y = 已成功验证
  • N = 未成功验证
  • U = 不可用
  • A = 可用，但没有验证
CavVerify 字符串 指示卡持有者身份验证验证是否可用和/或已成功验证。
  • Y = 已成功验证
  • N = 未成功验证
  • U = 不可用
  • A = 可用，但没有验证
EncryptedCreditCardNumber 字符串 哈希或加密的信用额度卡编号。
OrganizationId 字符串 商家或组织的唯一标识符。
名称 字符串 组织名称。
邮政编码 字符串 组织所在的邮政编码。
状态 字符串 组织所在位置的状态。
CountryISO 字符串 组织所在的国家/地区 ISO 代码。
ProductBrand 字符串 产品的品牌名称。
BuyItAgainOrder 布尔 如果用户重新订购以前的订单（而不仅仅是该订单中的产品），则为 True。
PreOrderAvailabilityDate DateTimeOffset 当产品首次可供预排序时。
TerminalId 字符串 销售点终端的唯一标识符。
TerminalName 字符串 销售点终端名称。
IsThreeDSAuth 布尔 一个 True/False 值，该值指示此事务是否通过 3DS 进行身份验证。
MessageCategory 字符串 标识特定用例的消息类别。
DeviceChannel 字符串 指示用于启动事务的通道接口的类型。
ThreeDSServerTransId 字符串 由 3DS 服务器分配的通用唯一事务标识符，用于标识单个事务。
ThreeDSRequestorAuthenticationInd 字符串 指示身份验证请求的类型。
ThreeRIInd 字符串 指示 3RI 请求的类型。
ThreeDSReqPriorAuthMethod 字符串 持卡人以前用于向 3DS 请求者进行身份验证的机制。
TransStatus 字符串 指示事务是限定为经过身份验证的事务还是帐户验证。
TransStatusReason 字符串 提供有关事务状态字段具有指定值的原因的信息。
ThreeDSCompInd 字符串 指示 3DS 方法是否已成功完成。
AcsChallengeMandated 字符串 指示由于局部/区域授权或其他变量，是否需要对事务进行授权。
ThreeDSRequestorChallengeInd 字符串 指示是否为此事务请求质询。
ChallengeCompletionInd 字符串 ACS 质询周期的状态指示符以及质询已完成还是需要其他消息。
接受的值：
Eci 字符串 电子商务指标（ECI）。 ACS 或 DS 提供的付款系统特定值，用于指示尝试对持卡人进行身份验证的结果。
ShipNameIndicator 字符串 指示帐户上的持卡人名称是否与用于此交易的发货名称相同。
SuspiciousAccActivity 字符串 指示 3DS 请求者是否在卡持有人帐户上遇到可疑活动（包括以前的欺诈）。
ChAccPwChangeInd 字符串 指示自具有 3DS 请求者的卡持有人帐户发生密码更改或帐户重置以来的时长。
ChAccAgeInd 字符串 卡持有人拥有 3DS 请求者的帐户的时间长度。
ProvisionAttemptsDay 字符串 过去 24 小时内添加卡片尝试次数。
长度：最多 3 个字符。

示例值：
  • 2
  • 02
  • 002
ExemptionRaised 字符串

PSD2 豁免请求。

  • Y - 豁免
  • N - 未免除

PaymentInstruments

属性 类型 描述
PurchaseId 字符串 交易的标识符（或购买或订单）。
MerchantPaymentInstrumentId 字符串 付款方式的标识符。 此信息由商家提供。 这是必需的属性。
类型 字符串 付款类型。 有关详细信息，请参阅 Dynamics 365 欺诈防护 API。
PurchaseAmount 双精度 使用此付款方式进行交易的总购买金额。
CreationDate DateTime 商家系统中付款方式的第一个条目的日期。 格式为 ISO 8601。
UpdateDate DateTime 商家系统中付款方式的上次更新日期。 格式为 ISO 8601。
CardType 字符串 此属性仅用于信用卡类型的付款。
HolderName 字符串 付款方式的客户的名称。 此属性仅用于信用卡类型的付款。
BIN 字符串 此属性仅用于信用卡类型的付款。
ExpirationDate 字符串 商家系统中付款方式的到期日期。 格式为 ISO 8601。 此属性仅用于信用卡类型的付款。
LastFourDigits 字符串 此属性仅用于信用卡类型的付款。
电子邮件 字符串 与付款方式关联的电子邮件地址。 此属性仅用于 Paypal 类型的付款。
BillingAgreementId 字符串 此属性仅用于 Paypal 类型的付款。
PayerId 字符串 此属性仅用于 Paypal 类型的付款。
PayerStatus 字符串 一个值，该值指示 PayPal 是否已验证付款人。 此属性仅用于 Paypal 类型的付款。
AddressStatus 字符串 一个值，该值指示 PayPal 是否已验证付款人的地址。 此属性仅用于 Paypal 类型的付款。
IMEI 字符串 此属性仅用于 Mobilepayment 类型的付款。
名字 字符串 为地址提供的名字。
姓氏 字符串 为地址提供的姓氏。
PhoneNumber 字符串 为地址提供的电话号码。 格式应为国家或地区代码，后跟连字符（-），然后是电话号码（例如：对于美国， +1-1234567890）。
Street1 字符串 为地址提供的第一行。
Street2 字符串 为地址提供的第二行。 （此值可以为空。
Street3 字符串 为地址提供的第三行。 （此值可以为空。
市/县 字符串 为地址提供的城市。
状态 字符串 为地址提供的国家或省。
邮政编码 字符串 为地址提供的邮政编码。
CountryCode 字符串 为地址提供的国家/地区代码。 该值应为双字母 ISO 国家或地区代码（例如： 美国）。
PISource 字符串 付款方式源（例如：CustomerInput、FromSavedProfile、MobilePay）。

产品

属性 类型 描述
PurchaseId 字符串 交易的标识符（或购买或订单）。
ProductId 字符串 产品标识符。 这是必需的属性。
PurchasePrice 双精度 购买的行项的价格。
Margin 字符串 通过销售商品获得的利润率。
数量 Int32 已购买的项目数。
ProductName 字符串 客户可读产品名称。
类型 字符串 一个值，指示货物是物理还是数字。
类别 字符串 产品类别（例如： 服装、 鞋类或 配件）。
市场 字符串 产品提供的市场。 该值应为双字母 ISO 国家或地区代码（例如： 美国）。
SKU 字符串 产品的库存单位（SKU）。
SalesPrice 双精度 不包括税项的价格。 此信息由商家提供。
货币 字符串 原始购买的货币作为三个字符的货币代码（例如： USD，与 OANDA 货币代码一致）。 此信息由商家提供。
COGS 双精度 销售的商品成本（即商品的原材料成本）。 此信息由商家提供。
IsRecurring 布尔 一个值，该值指示产品是否为定期订阅。
IsFree 布尔 一个值，该值指示产品是否免费提供。
语言 字符串 语言和语言区域（例如： EN-US）。

退款

评估和保护体验中使用了以下架构。

属性 类型 描述
ChargebackId 字符串 退款标识符。
原因 字符串 银行提供的原因。
Status 字符串 状态。 有关详细信息，请参阅 Dynamics 365 欺诈防护 API。
BankEventTimestamp DateTime 银行中的时间戳。 格式为 ISO 8601。
金额 双精度 退款金额。
货币 字符串 用于退款金额的货币。
UserID 字符串 客户标识符。
PurchaseId 字符串 交易的标识符（或购买或订单）。
MerchantLocalDate DateTime 商家本地时区的购买引入日期。 格式为 ISO 8601。

退款

评估和保护体验中使用了以下架构。

属性 类型 描述
RefundId 字符串 退款标识符。
原因 字符串 客户提供的原因。
Status 字符串 退款状态。 有关详细信息，请参阅 Dynamics 365 欺诈防护 API。
BankEventTimestamp DateTime 银行中的时间戳。 格式为 ISO 8601。
金额 双精度 退款金额。
货币 字符串 用于销售价格金额的货币。
UserID 字符串 客户标识符。 这是必需的属性。
PurchaseId 字符串 交易的标识符（或购买或订单）。
MerchantLocalDate DateTime ISO 8601 格式的日期。

PurchaseStatus

评估和保护体验中使用了以下架构。

属性 类型 描述
PurchaseId 字符串 交易的标识符（或购买或订单）。
StatusType 字符串 状态的类型。 有关详细信息，请参阅 Dynamics 365 欺诈防护 API。
StatusDate DateTime 应用状态的日期和时间。 格式为 ISO 8601。
原因 字符串 状态转换的原因。
MerchantLocalDate DateTime ISO 8601 格式的日期。

BankEvents

评估和保护体验中使用了以下架构。

属性 类型 描述
BankEventId 字符串 银行事件标识符。
类型 字符串 银行事件类型。 有关详细信息，请参阅 Dynamics 365 欺诈防护 API。
BankEventTimestamp DateTime 银行中的时间戳。 格式为 ISO 8601。
Status 字符串 状态。 有关详细信息，请参阅 Dynamics 365 欺诈防护 API。
BankResponseCode 字符串 响应上的银行代码。
PaymentProcessor 字符串 处理器名称（例如： FDC 或 PayPal）。
MRN 字符串 用于标识商家端交易的商家参考号（MRN）。
MID 字符串 用于银行通信的商家 ID （MID）。
PurchaseId 字符串 交易的标识符（或购买或订单）。
MerchantLocalDate DateTime ISO 8601 格式的日期。
MerchantPaymentInstrumentId 字符串 多个 PI 方案和 PI 更改方案。
PaymentMethod 字符串 付款方式的分组/类别。
CardType 字符串 付款类型。
UpdatedPI 字符串 使用的 PI 不同于购买中的 PI？
CvvVerify 字符串 指示 CVV 验证是否可用和/或已成功验证。
  • Y = 已成功验证
  • N = 未成功验证
  • U = 不可用
  • A = 可用，但没有验证
AvsVerify 字符串 指示地址验证是否可用和/或已成功验证。
  • Y = 已成功验证
  • N = 未成功验证
  • U = 不可用
  • A = 可用，但没有验证
CavVerify 字符串 指示卡持有者身份验证验证是否可用和/或已成功验证。
  • Y = 已成功验证
  • N = 未成功验证
  • U = 不可用
  • A = 可用，但没有验证
AuthorizationResultCode 字符串 授权决定的银行响应。
AuthorizationResultText 字符串 授权决定的原因;尤其是对于已拒绝或挂起的事务。
ThreeDS 字符串 请参阅“购买工作表”中的“购买三维”部分。

帐户

评估和保护体验中使用以下架构。

UpdateAccount

属性 类型 描述
CustomerLocalDate DateTime ISO 8601 格式的日期。
UserID 字符串 客户标识符。 这是必需的属性。
UsercreationDate DateTime ISO 8601 格式的日期。
UserupdateDate DateTime ISO 8601 格式的日期。
名字 字符串 客户在客户帐户上提供的名字。
姓氏 字符串 客户在客户帐户中提供的姓氏。
CountryCode 字符串 客户的国家或地区。 该值应为双字母国家或地区代码（例如： US）。
邮政编码 字符串 客户的邮政编码。
TimeZone 字符串 此属性已过时（已弃用）。 提供空字符串作为值。
语言 字符串 客户的语言和语言区域（例如： EN-US）。
PhoneNumber 字符串 客户的电话号码。 格式应为国家/地区代码，后跟连字符（-），然后是电话号码（例如：对于美国， +1-1234567890）。
电子邮件 字符串 客户的电子邮件地址。 此值不区分大小写。
IsEmailValidated 布尔 一个值，该值指示是否已将客户提供的电子邮件验证为客户拥有的电子邮件。
EmailValidatedDate DateTime 客户提供的电子邮件被客户验证为客户拥有的日期。 格式为 ISO 8601。
Is电话NumberValidated 布尔 一个值，该值指示客户提供的电话号码是否已验证为客户拥有的电话号码。
电话NumberValidatedDate DateTime 客户提供的电话号码被客户验证为客户拥有的日期。 格式为 ISO 8601。
DeviceContextId 字符串 事件的会话（由 Microsoft 设备指纹提供）的会话 ID 或事务 ID（如果会话不可用）。
提供程序 字符串 一个值，指示 deviceContextId 值的源：DFP 指纹或商家。
DeviceContextDC 字符串 客户的会话 ID 的 Microsoft 设备指纹数据中心。
ExternalDeviceId 字符串 客户的设备 ID。 此信息由商家提供和掌握。
ExternalDeviceType 字符串 由商家标识的设备类型（例如 ：电脑 或 移动设备）。
IpAddress 字符串 客户的 IP 地址。 此信息由 Microsoft 设备指纹提供。
MerchantLocalDate DateTime ISO 8601 格式的日期。
MembershipType 字符串 客户的成员身份状态或类型。
LoginInputMethod 字符串 客户用来输入其凭据的方法。
LastPasswordUpdatedDate 字符串 上次更新客户的密码时。
FirstPurchaseDate 字符串 客户首次购买时。
LoginChallengeType 字符串 发起的挑战响应测试的类型。
AddressList 字符串 请参阅“购买地址”部分。
PaymentInstrumentList 字符串 请参阅 Purchase PaymentInstrumentList 部分。
DeviceContext 字符串 请参阅“购买 DeviceContext”部分。

UpdateAddress

属性 类型 说明
UserId 字符串 客户标识符。 这是必需的属性。
Addresstype 字符串 地址类型： 计费、 寄送、 帐户或 未知。
名字 字符串 为地址提供的名字。
姓氏 字符串 为地址提供的姓氏。
PhoneNumber 字符串 为地址提供的电话号码。
Street1 字符串 为地址提供的第一行。
Street2 字符串 为地址提供的第二行。 （此值可以为空。
Street3 字符串 为地址提供的第三行。 （此值可以为空。
市/县 字符串 为地址提供的城市。
状态 字符串 为地址提供的国家或省。
地区 字符串 为地址提供的区域。 （此值可以为空。
邮政编码 字符串 为地址提供的邮政编码。
CountryCode 字符串 为地址提供的国家/地区代码。 该值应为双字母 ISO 国家或地区代码（例如： 美国）。

UpdatePaymentInstrument

属性 类型 说明
UserId 字符串 客户标识符。 这是必需的属性。
MerchantPaymentInstrumentId 字符串 付款方式的标识符。 此信息由商家提供。 这是必需的属性。
PaymentInstrumenttype 字符串 付款类型：信用卡、Paypal、CH、标准版PA、BACS、Mobilepayment、礼品卡或其他。
PaymentInstrumentcreationDate DateTime 商家系统中付款方式的第一个条目的日期。 格式为 ISO 8601。
PaymentInstrumentupdateDate DateTime 商家系统中付款方式的上次更新日期。 格式为 ISO 8601。
PaymentInstrumentState 字符串 付款方式的状态： 活动、 阻止或 过期。
CardType 字符串 此属性仅用于信用卡类型的付款。
HolderName 字符串 付款方式的客户的名称。 此属性仅用于信用卡类型的付款。
BIN 字符串 此属性仅用于信用卡类型的付款。
ExpirationDate 字符串 商家系统中付款方式的到期日期。 此属性仅用于信用卡类型的付款。
LastFourDigits 字符串 此属性仅用于信用卡类型的付款。
电子邮件 字符串 与付款方式关联的电子邮件地址。 此属性仅用于 Paypal 类型的付款。
BillingAgreementId 字符串 此属性仅用于 Paypal 类型的付款。
PayerId 字符串 此属性仅用于 Paypal 类型的付款。
PayerStatus 字符串 一个值，该值指示 PayPal 是否已验证付款人。 此属性仅用于 Paypal 类型的付款。
AddressStatus 字符串 一个值，该值指示 PayPal 是否已验证付款人的地址。 此属性仅用于 Paypal 类型的付款。
IMEI 字符串 此属性仅用于 Mobilepayment 类型的付款。
BillingAddressfirstName 字符串 为地址提供的名字。
BillingAddresslastName 字符串 为地址提供的姓氏。
BillingAddressphoneNumber 字符串 为地址提供的电话号码。 格式应为国家或地区代码，后跟连字符（-），然后是电话号码（例如：对于美国， +1-1234567890）。
Street1 字符串 为地址提供的第一行。
Street2 字符串 为地址提供的第二行。 （此值可以为空。
Street3 字符串 为地址提供的第三行。 （此值可以为空。
市/县 字符串 为地址提供的城市。
状态 字符串 为地址提供的国家或省。
地区 字符串 为地址提供的区域。 （此值可以为空。
邮政编码 字符串 为地址提供的邮政编码。
CountryCode 字符串 为地址提供的国家/地区代码。 该值应为双字母 ISO 国家或地区代码（例如： 美国）。

标签

评估和保护体验中使用了以下架构。

属性 类型 描述
TrackingId 字符串 每个事件/记录的唯一 ID。
MerchantLocalDate DateTime 商家时区中的日期。 格式为 ISO 8601。
EventTimeStamp DateTime 事件的日期和时间。 格式为 ISO 8601。 有关详细信息，请参阅 Dynamics 365 欺诈防护 API。
LabelObjectType 字符串 此字段指示标签的类型：购买、注册、自定义欺诈评估、帐户、付款方式或电子邮件。
LabelObjectId 字符串 这是对象的类型的标识符字段：PurchaseId、SignupId、UserId、MerchantPaymentInstrumentId 或 Email。
LabelSource 字符串 此字段表示标签的源。
LabelState 字符串 此字段指示标签的当前状态。 有关详细信息，请参阅 Dynamics 365 欺诈防护 API。
LabelReasonCodes 字符串 此字段指示与每种标签类型关联的原因代码。 有关详细信息，请参阅 Dynamics 365 欺诈防护 API。
处理器 字符串 银行或付款处理者的名称。 有关详细信息，请参阅 Dynamics 365 欺诈防护 API。
EffectiveStartDate DateTime 此标签生效的日期。 格式为 ISO 8601。
EffectiveEndDate DateTime 此标签的结束日期。 格式为 ISO 8601。
金额 双精度 向客户收取的金额。 此信息由商家提供。
货币 字符串 原始购买的货币作为三个字符的货币代码。 （例如：美元，它与 OANDA 货币代码一致）。 此信息由商家提供。

特定于垂直的属性

属性 垂直 类型 描述
TravelOverview
CarRentalIncluded 旅行 布尔 一个 True/False 值，该值指示是否包括出租汽车。
LodgingIncluded 旅行 布尔 一个 True/False 值，该值指示是否包括住宿。
TravelType 旅行 字符串 旅行类别或类型。
IsRoundTrip 旅行 布尔 一个 True/False 值，该值指示旅行是否往返。
IsDiscountOffered 旅行 布尔 一个 True/False 值，该值指示是否提供折扣。
TravelDateTime 旅行 DateTimeOffset 旅行开始日期和时间。
ReturnDateTime 旅行 DateTimeOffset 行程结束或返回日期和时间。
FromCity 旅行 字符串 客户从中旅行的城市。
FromState 旅行 字符串 客户从中旅行的状态。
FromCountryISO 旅行 字符串 客户所在的 ISO 国家/地区。
FromZipCode 旅行 字符串 客户从中旅行的邮政编码。
ToCity 旅行 字符串 客户前往的城市。
ToState 旅行 字符串 客户前往的状态。
ToCountryISO 旅行 字符串 客户前往的 ISO 国家/地区。
ToZipCode 旅行 字符串 客户前往的邮政编码。
TravelDuration 旅行 字符串 已弃用。 请勿使用。
IsPackagedTour 旅行 布尔 一个 True/False 值，该值指示这是否是打包教程。
BookingType 旅行 字符串 预订类型。
WebUrl 旅行 字符串 预订旅行的 URL。
IssueDateTime 旅行 DateTimeOffset 颁发票证的日期和时间。
FlightDetails 旅行 Object 请参阅 FlightDetails 部分。
LodgingDetails 旅行 Object 请参阅“住宿”部分。
CarRentalDetails 旅行 Object 请参阅 CarRentalDetails 部分。
TravelAgent 旅行 Object 请参阅 TravelAgent 部分。
FlightDetails
TicketNumber 旅行 字符串 唯一票证号。
PlaceOfIssue 旅行 字符串 颁发票证的位置。
IsRestrictedTicket 旅行 布尔 一个 True/False 值，该值指示票证是否受到限制。
RewardsOrVoucherApplied 旅行 布尔 一个 True/False 值，该值指示奖励或凭证是否应用于订单。
TotalRewardsApplied 旅行 int32 应用于订单的总奖励。
TotalFees 旅行 十进制 应用于订单的总费用。
PassengerCount 旅行 Int32 乘客总数。
NumberOfStops 旅行 Int32 航班的停站或下车次数。
PurchaserProfileType 旅行 字符串 客户的个人资料或成员身份类型。
IsThirdParty 旅行 布尔 一个 True/False 值，该值指示订单是否通过第三方网站放置。
IsPurchaserFrequentFlyer 旅行 布尔 一个 True/False 值，该值指示客户是否是常客。
FlightSegments 旅行 Object 请参阅 FlightSegments 部分。
乘客 旅行 Object 请参阅“乘客”部分。
FlightSegments
AirlineCode 旅行 字符串 航空公司代码。
AirlineName 旅行 字符串 航空公司名称。
SegmentSequence 旅行 Int32 给定飞行段的序列号（例如航班第二回合的 2）
旅行级别 旅行 字符串 座位舱或机舱。
OperatedBy 旅行 字符串 运行外部测试版的组织。
FlightNumber 旅行 字符串 外部测试版编号。
FromAirportCode 旅行 字符串 航班从哪里起飞的机场代码。
ToAirportCode 旅行 字符串 航班飞往的机场代码。
DepartureDateTime 旅行 DateTimeOffset 出发日期和时间。
ArrivalDateTime 旅行 DateTimeOffset 到达日期和时间。
FromAirportCity 旅行 字符串 客户从该机场出发的机场城市。
FromAirportState 旅行 字符串 客户从其出发的机场状态。
FromAirportZipcode 旅行 字符串 客户从其出发的机场邮政编码。
FromAirportCountryISO 旅行 字符串 客户从其出发的机场 ISO 国家/地区代码。
ToAirportCity 旅行 字符串 客户前往的机场城市。
ToAirportState 旅行 字符串 客户前往的机场状态。
ToAirportZipcode 旅行 字符串 客户前往的机场邮政编码。
ToAirportCountryISO 旅行 字符串 客户前往的机场 ISO 国家/地区。
乘客
FirstName 旅行 字符串 乘客名字。
姓氏 旅行 字符串 乘客姓氏。
CarRentalDetails
PickupLocation 旅行 字符串 汽车租赁皮卡位置。
PickupDateTime 旅行 DateTimeOffset 租赁取件日期和时间。
DropOffLocation 旅行 字符串 出租的下车地点。
DropOffDateTime 旅行 DateTimeOffset 出租汽车的下车日期和时间
DiscountProgram 旅行 字符串 应用于租赁订单的折扣计划。
CarType 旅行 字符串 汽车类型或类别。
IsPrepaid 旅行 布尔 一个 True/False 值，指示是否预付了租金。
InsuranceIncluded 旅行 布尔 一个 True/False 值，指示是否包括保险。
ContactEmail 旅行 字符串 租车者的电子邮件地址。
Contact电话Number 旅行 字符串 租车者的电话号码。
PickupAddress 旅行 Object 请参阅“地址”部分。
DropOffAddress 旅行 Object 请参阅“地址”部分。
TravelAgent
AgencyCode 旅行 字符串 旅行社代码。
AgencyName 旅行 字符串 旅行社名称。
AgentCode 旅行 字符串 旅行社代码。
AgencyLocation 旅行 Object 请参阅 AgentAddress 部分。
AgentAddress
Street1 旅行 字符串 为地址提供的第一行
Street2 旅行 字符串 为地址提供的第二行。 （此值可以为空。
Street3 旅行 字符串 为地址提供的第三行。 （此值可以为空。
City 旅行 字符串 为地址提供的城市。
State 旅行 字符串 为地址提供的国家或省。
地区 旅行 字符串 为地址提供的区域。
邮政编码 旅行 字符串 为地址提供的邮政编码。
国家/地区 旅行 字符串 为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码（例如美国）。
AgencyContact电话 旅行 字符串 代理联系电话号码。
AgencyContactEmail 旅行 字符串 代理联系电子邮件地址。
LodgingDetails
FolioNumber 住宿 字符串 住宿属性的唯一标识符。
CheckInDate 住宿 DateTimeOffset 住宿检查日期。
CheckOutDate 住宿 DateTimeOffset 住宿检查日期。
ReservationConfirmed 住宿 布尔 一个 True/False 值，该值指示是否已确认预留。
MembershipDetails 住宿 字符串 有关客户成员身份状态的其他详细信息。
DiscountProgram 住宿 字符串 适用于住宿订单的折扣计划。
AdultCount 住宿 Int32 住宿中包含的成人数量。
KidCount 住宿 Int32 住宿中包含的儿童数量。
NightsCount 住宿 Int32 住宿中包含的夜晚数。
RoomCount 住宿 Int32 住宿中包含的房间数。
BedType 住宿 字符串 床类型或类别。
RoomType 住宿 字符串 房间类型或类别。
PaymentDescription 住宿 字符串 住宿付款的其他详细信息。
设施 住宿 Object 请参阅“设施”部分。
设施
名称 住宿 字符串 设施名称。
类型 住宿 字符串 设施类型。
Contact电话Number 住宿 字符串 用于联系设施的电话号码。
ContactEmail 住宿 字符串 用于联系设施的电子邮件地址。
DailyRoomRate 住宿 十进制 设施的每日房价。
货币 住宿 字符串 设施支持的货币。
DailyRoomTaxAmount 住宿 十进制 设施收取的每日房间税额。
Address 住宿 Object 请参阅“地址”部分。
Address
Street1 汽车租赁 字符串 为地址提供的第一行
Street2 汽车租赁 字符串 为地址提供的第二行。 （此值可以为空。
Street3 汽车租赁 字符串 为地址提供的第三行。 （此值可以为空。
City 汽车租赁 字符串 为地址提供的城市。
State 汽车租赁 字符串 为地址提供的国家或省。
地区 汽车租赁 字符串 为地址提供的区域。
邮政编码 汽车租赁 字符串 为地址提供的邮政编码。
国家/地区 汽车租赁 字符串 为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码（例如美国）。
CloudBusiness
OrganizationId CloudBusiness 字符串 云服务或组织的唯一标识符。
CompanyName CloudBusiness 字符串 云服务名称。
CompanyType CloudBusiness 字符串 云公司类型。
CompanySize CloudBusiness Int32 云公司规模。
EntityId CloudBusiness 字符串 组织下法律实体的唯一标识符。
PrimaryContactFirstName CloudBusiness 字符串 业务的主要联系人的名字。
PrimaryContactLastName CloudBusiness 字符串 业务的主要联系人的姓氏。
PrimaryContactEmail CloudBusiness 字符串 业务的主要联系人的电子邮件地址。
PrimaryContact电话Number CloudBusiness 字符串 业务的主要联系人的电话号码。
SubscriptionCount CloudBusiness Int32 可用的订阅总数。
CompanyAddress CloudBusiness Object 请参阅“地址”部分。

下载示例数据

可以在使用自己的内部数据之前下载示例数据文件以浏览选项。

自定义数据示例

以下示例演示如何在欺诈保护中将购买 API 与自定义数据对象配合使用。

{ 
"CustomData": { 
"EngagementDuration": 120.4, 
"GamerScore": 10, 
"InApp": true, 
"MiscSampleA": "abc" 
} 
}