通过

Dynamics 365 欺诈防护（预览版）

Microsoft Dynamics 365 欺诈保护为商家提供在电子商务购买、欺诈帐户注册和登录尝试中与电子商务购买相关的欺诈活动获得风险评估的功能

此连接器在以下产品和区域中可用：

服务 Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 高级 除以下各项外的所有 Power Apps 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人​​
Name Microsoft
URL https://dynamics.microsoft.com/ai/fraud-protection/
Email dfpconnector@microsoft.com
连接器元数据
发布者 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 欺诈保护上拥有预配的租户，并且应该已在 Power App Platform 上拥有帐户。

如何获取凭据

此处介绍了有关如何获取凭据的步骤： https://github.com/microsoft/Dynamics-365-Fraud-Protection-Samples/tree/master/power%20apps%20connector

连接器入门

有关如何开始使用的详细信息，请参阅 Dynamics 365 欺诈保护示例。

已知问题和限制

有关详细信息，请参阅 Dynamics 365 欺诈保护示例。

常见错误和补救措施

使用连接器调用 Dynamics 365 欺诈防护时，可能会出现一些常见问题：

  • 401 未授权：访问令牌无效，请检查输入的凭据。
  • 403 禁止访问：授权失败，检查输入的凭据。
  • 400 错误请求：有效负载中的某些必填字段缺失或格式不正确，请检查详细的错误消息。
  • 500 内部服务器错误：服务器端发生异常，记下相关 ID 并联系 DFP 团队，以了解此类错误。

FAQ

有关详细信息，请参阅 Dynamics 365 欺诈保护示例。

正在创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

为自定义事件提供风险评估

此事件允许你发送自己的选择结构，这些结构由自己选择规则评估的条件触发。 响应包含事件的决策
提供在线购买交易的风险评估

此事件发送有关传入的新购买交易的信息和上下文。 响应包含批准或拒绝购买交易的决定，以及商家应在授权呼叫中发送给其银行的相应商家 ID（MID）
提供帐户创建尝试的风险评估

此事件发送有关传入的新帐户创建尝试的信息和上下文。 响应包含帐户创建决策
提供帐户登录尝试的风险评估

此事件发送有关传入的新帐户登录尝试的信息和上下文。 响应包含帐户登录名的决定
更新帐户保护的帐户信息

此事件更新或创建帐户保护服务的用户帐户信息，例如添加付款方式、添加地址或任何其他用户属性。 这只是数据引入事件
更新帐户保护的欺诈标签信息

此事件发送标签的更新。 这只是数据引入事件
更新帐户创建状态

此事件发送帐户创建状态的更新，例如，如果帐户创建已取消。 这只是数据引入事件
更新帐户登录状态

此事件发送帐户登录状态的更新，例如，如果帐户登录名已取消。 这只是数据引入事件
更新欺诈标签信息以获取购买保护

此事件发送标签的更新。 这只是数据引入事件
更新确认的欺诈信息

此事件发送有关客户与银行发生欺诈纠纷之前购买的信息。 这只是数据引入事件。 许多商家使用批量数据上传发送这些事件
更新联机购买交易的状态

此事件发送购买状态的更新，例如，如果已取消购买。 这只是数据引入事件
更新购买保护的帐户信息

此事件更新或创建购买保护服务的用户帐户信息，例如添加付款方式、添加地址或任何其他用户属性。 这只是数据引入事件
更新退款信息

此事件发送有关之前正在退款的购买交易的信息。 这只是数据引入事件。 许多商家使用批量数据上传发送这些事件
更新银行授权信息

此事件传达发送到银行的购买交易是否已获得银行授权或银行费用/结算的批准或拒绝。 这只是数据引入事件

为自定义事件提供风险评估

操作 ID:
Assessment_v1_Assessment

此事件允许你发送自己的选择结构，这些结构由自己选择规则评估的条件触发。 响应包含事件的决策

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
评估 API 名称
 assessment-api-name True string

评估 API 名称
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
姓名
 name True string

评估事件名称。 在创建评估期间，该名称应与 API 名称匹配，URL 的“{assessment-API-name}”。
版本
 version True string

有效负载版本。 应为“1.0”
trackingId
 trackingId True string

帐户创建事件的标识符。
merchantTimeStamp
 merchantTimeStamp True date-time

事件的 TimeStamp。
userId
 userId string

用户标识符。 此信息由商家提供。
countryRegion
 countryRegion string

用户的 CountryRegion。 该值应为双字母 ISO CountryRegion 代码（例如美国）。
邮政编码
 zipCode string

用户的邮政编码。
timeZone
 timeZone string

用户的时区。
语言
 language string

用户的语言和区域（例如，EN-US）。
sampleString
 sampleString string

这是如何扩展用户类型的示例。
isEmployee
 isEmployee boolean

基元类型的示例。
量
 amount integer

示例字段。
可用
 available integer

示例字段。

返回

Dynamics 欺诈保护 API 的响应对象

Body
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccessDetails

提供在线购买交易的风险评估

操作 ID:
PurchaseProtection_v1_PurchaseEvent

此事件发送有关传入的新购买交易的信息和上下文。 响应包含批准或拒绝购买交易的决定，以及商家应在授权呼叫中发送给其银行的相应商家 ID（MID）

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
purchaseId
 purchaseId True string

商家系统中的交易（或采购订单）标识符。
评估类型
 assessmentType string

指示事件的评估类型。 可能的值为“Evaluate”或“Protect”。 如果未指定，则默认值为“保护”
originalOrderId
 originalOrderId string

商家系统中用于支付定期计费（例如每月订阅）的原始订单标识符。
customerLocalDate
 customerLocalDate date-time

根据客户本地时区购买创建日期。 格式为ISO8601
merchantLocalDate
 merchantLocalDate True date-time

根据商家时区购买创建日期。 格式为ISO8601
merchantIdentifier
 merchantIdentifier string

银行的商家标识符（MID）
merchantCategoryCode
 merchantCategoryCode string

银行的商家类别代码 （MCC）
merchantBusinessType
 merchantBusinessType string

此次购买的商家业务类型
merchantBusinessSegment
 merchantBusinessSegment string

此次购买的商家业务细分市场
isTest
 isTest boolean

表示购买是测试购买
isFreeProductIncluded
 isFreeProductIncluded boolean

表示免费产品是否是此次购买的一部分
是否是周期性收费
 isRecurringCharge boolean

表示购买是否为定期费用
isGuestCheckout
 isGuestCheckout boolean

表示是否通过最粗心的结帐进行购买
isPostAuthCheck
 isPostAuthCheck boolean

表示购买是否被发送到 DFP post Bank 身份验证
isRetryOrder
 isRetryOrder boolean

表示购买是否重试以前失败的尝试
recurringChargeFrequencyInDays
 recurringChargeFrequencyInDays integer

费用递归后的天数
recurringChargeStartDate
 recurringChargeStartDate date-time

此购买的开始日期（如果定期）
recurringChargeEndDate
 recurringChargeEndDate date-time

此购买的结束日期（如果定期）
isPostpaid
 isPostpaid boolean

表示购买是否是付费后的
distinctItemCount
 distinctItemCount double

作为购买的一部分销售的唯一产品计数
totalItemCount
 totalItemCount double

在购买过程中销售的产品总数
orderType
 orderType string

订单类型，例如“带出”
discountAmount
 discountAmount double

在派生总金额之前对原始购买提供的折扣
tipAmount
 tipAmount double

购买时提供的提示
totalAmount
 totalAmount double

向客户收取的总金额;包括税务和发货。 可以选择包括折扣和优惠券;当前没有单独的字段。 由商家提供。
salesTax
 salesTax double

交易的销售税。 由商家提供。
货币
 currency string

以 ISO 4217 代码格式（美元、GBP 等）购买的原始购买货币。
shippingMethod
 shippingMethod string

指示用于寄送购买的方法。 可能的值“InStorePickup” |“Standard” |“Express” |'DirectEntitlement' |“DigitalToken”
transactionProcessingOrder
 transactionProcessingOrder string

在交易流期间进行欺诈评估的顺序。 可能的值为 PREAUTHORIZATION、POSTAUTHORIZATION、BEFORE3DS、AFTER3DS
recurringSubscriptionId
 recurringSubscriptionId string

定期费用的唯一 ID
recurringChargeSequence
 recurringChargeSequence string

此客户发生的定期费用的第 n （1， 2， 3...） 次。
midName
 midName string

与 MID 关联的商家名称（商家标识符）。
transactionDescription
 transactionDescription string

事务处理类型。 Possilbe 值为 SUBSCRIPTIONFEE、DELAYEDCHARGES、NOSHOW、DEPOSIT
shippingEmail
 shippingEmail string

用户的寄送电子邮件地址
自定义数据
 customData object

可用于使用规则等的键值对。 有关详细信息，请访问 https://docs.microsoft.com/dynamics365/fraud-protection/schema#download-sample-data
shippingDate
 shippingDate date-time

订单发货日期
orderInitiatedChannel
 orderInitiatedChannel string

在其中创建事务的通道（例如：“AppStore”、“Web”、“MobileWeb”、“App”、“InGamePurchase”）
orderInitiatedChannelName
 orderInitiatedChannelName string

在其中创建事务的应用名称或 Web URL
orderInitiatedChannelRegionORCountry
 orderInitiatedChannelRegionORCountry string

创建交易的市场（例如：应用市场）
merchantBusinessSegmentL2
 merchantBusinessSegmentL2 string

第二级业务或行业细分市场
lastUpdateYear
 lastUpdateYear integer

上次更新项目时的年份
userId
 userId True string

用户标识符。 此信息由商家提供。
创建日期
 creationDate date-time

用户帐户的创建日期。 格式为 ISO 8601。
updateDate
 updateDate date-time

上次更改用户数据的日期。 格式为 ISO 8601。
firstName
 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
 profileType string

用户的配置文件类型。 可能的值为“Consumer” |'Seller' |'Publisher' |“Tenant” |“Developer”
profileName
 profileName string

配置文件名称，具体取决于 profileType。
authenticationProvider
 authenticationProvider string

用户的身份验证提供程序（如果不同于商家的身份验证提供程序）。 可能的 valuse “MSA” |“Facebook”|“PSN” |“MerchantAuth” |“Google”
认证方法
 authenticationMethod string

客户在购买之前/期间进行身份验证的方式。 一些可能的值是基于密码、多重、生物识别、基于令牌的、
displayName
 displayName string

用户的显示名称。 示例：Xbox 玩家代号值
isEmailValidated
 isEmailValidated boolean

一个 True/False 值，该值指示用户提供的电子邮件地址是否已验证为用户拥有。
emailValidatedDate
 emailValidatedDate date-time

用户电子邮件的验证日期。 格式为 ISO 8601。
isPhoneNumberValidated
 isPhoneNumberValidated boolean

一个 True/False 值，该值指示用户提供的电话号码是否已验证为用户拥有的电话号码。
phoneNumberValidatedDate
 phoneNumberValidatedDate date-time

用户电话号码的验证日期。 格式为 ISO 8601。
membershipType
 membershipType string

客户的成员身份状态或类型。 可以指定不同的付费级别，例如 Premium、Executive。 可能的值是 FREE、PAID、PREMIUM
loginInputMethod
 loginInputMethod string

客户输入其凭据的方式。 可能的值包括 MANUALINPUT、AUTOFILL、SCRIPT、COPYPASTE、SELECTPROFILE
lastPasswordUpdatedDate
 lastPasswordUpdatedDate date-time

上次更新客户的密码时。
firstPurchaseDate
 firstPurchaseDate date-time

客户首次购买时
loginChallengeType
 loginChallengeType string

发起的挑战响应测试的类型。 可能的值包括短信、电话短信、电子邮件 PIN、CAPTCHA
deviceContextId
 deviceContextId True string

客户的指纹会话 ID;如果会话不可用，则为事件 ID。
提供商
 provider string

设备信息的提供程序。 可能的值为“DFPFingerPrinting” |“商人”。 如果使用 DFP 指纹 JS 脚本，则必须传递“DFPFingerPrinting”才能使所有数据正确连接。
deviceContextDC
 deviceContextDC string

已弃用：DFP 指纹不再需要。 存储客户的 DFP 指纹会话的数据中心（由 DFP 指纹 JS 脚本提供）。
externalDeviceId
 externalDeviceId string

由商家提供和掌握的客户设备 ID。
externalDeviceType
 externalDeviceType string

客户的设备类型，由商家提供和掌握。 可能的值为“Mobile” |“Computer” |'MerchantHardware' |“Tablet” |“GameConsole”
ipAddress
 ipAddress string

客户的 IP 地址（由商家提供）
httpSignature
 httpSignature string

HTTP 消息的数字签名。
httpUserAgent
 httpUserAgent string

用于标识应用程序、作系统、供应商和/或版本的请求标头。
browserHeader
 browserHeader string

浏览器发送的请求标头的完整列表。
browserResolution
 browserResolution string

浏览器分辨率。
browserLanguage
 browserLanguage string

浏览器默认语言首选项。
tcpSignature
 tcpSignature string

TCP 应用程序签名。
sslSignature
 sslSignature string

SSL 签名。
enabledCookies
 enabledCookies boolean

一个 True/False 值，该值指示是否启用 Cookie。
enabledFlash
 enabledFlash boolean

一个 True/False 值，该值指示是否启用 Flash。
enabledJavaScript
 enabledJavaScript boolean

一个 True/False 值，该值指示是否启用 javascript。
screenAspectRatio
 screenAspectRatio string

浏览器的纵横比。
screenColorDepth
 screenColorDepth string

屏幕的颜色深度。
screenResolution
 screenResolution string

设备屏幕分辨率（以像素为单位）
siteHostName
 siteHostName string

网站的主机名。
os
 os string

设备操作系统。
oSFonts
 oSFonts string

作系统的默认字体。
deviceProcessor
 deviceProcessor string

设备处理器。
sessionId
 sessionId string

唯一会话 ID。
trueIp
 trueIp string

设备指纹标识的设备的真实 IP 地址
proxyIp
 proxyIp string

代理设备的 IP 地址。
deviceId
 deviceId string

设备指纹生成的每个设备的唯一 GUID
timeZone
 timeZone string

相对于 GMT 的本地时区偏移量（以小时为单位）
userAgentDetails
 userAgentDetails string

其他用户代理或浏览器详细信息。
appVersion
 appVersion string

应用程序版本。
browserPackagesList
 browserPackagesList string

设备上安装的包列表。
buildManufacturer
 buildManufacturer string

设备的制造商。
buildModel
 buildModel string

最终产品的最终用户可见性名称。
buildSdkVersion
 buildSdkVersion string

生成版本。
dataNetworkType
 dataNetworkType string

移动数据网络的类型。
deviceModelName
 deviceModelName string

设备模型。
deviceSystemName
 deviceSystemName string

计算机的设备名称。
deviceSystemVersion
 deviceSystemVersion string

设备版本。
isBluetoothEnabled
 isBluetoothEnabled boolean

一个 True/False 值，该值指示是否已启用蓝牙。
simNetworkCountryISO
 simNetworkCountryISO string

移动服务提供商的 ISO 国家/地区代码。
simNetworkType
 simNetworkType string

移动网络类型。
systemUpTime
 systemUpTime string

设备正常工作和可用的持续时间。
merchantPaymentInstrumentId
 merchantPaymentInstrumentId string

付款方式的标识符。 此信息由商家提供。
paymentMethod
 paymentMethod string

顶级付款方式类别。 可能的值为 CARD、CASH、DIRECTDEBIT、E-WALLET、MOBILE、E-BANKING、INVOICE、VOUCHERS
类型
 type True string

付款类型。 可能的值“CreditCard” |'DirectDebit' |“PayPal” |'MobileBilling' |'OnlineBankTransfer' |'Invoice' |“MerchantGiftCard” |“MerchantWallet” |'CashOnDelivery' |“Paytm” |“CCAvenue”
创建日期
 creationDate date-time

商家系统中付款方式的第一个条目的日期。 格式为 ISO 8601。
updateDate
 updateDate date-time

商家系统中付款方式的上次更新日期。 格式为 ISO 8601。
paymentCheckoutProvider
 paymentCheckoutProvider string

eWallet 签出提供程序。
isLowLiabilityPIType
 isLowLiabilityPIType boolean

一个 True/False 值，该值指示付款方式是否为低负债。
状态
 state string

商家系统中 PI 的当前状态。 可能的值“Active” |“非活动”
cardType
 cardType string

此属性仅用于信用卡/借记卡类型的付款。 提供卡的网络。 可能的值“Visa” |“万事达卡” |“Amex” |'ACH' |'SEPA' |“银联” |“Inicis” |“MobileBillingCarrier” |“发现” |“AllPay”|'JCB' |“DiscoverDiners”
holderName
 holderName string

付款方式用户的名称。 此属性仅用于信用卡/借记卡类型的付款。
holderCompanyName
 holderCompanyName string

提供商务或公司卡的组织的名称（仅适用于商务购买）。
settlementApprovalRequired
 settlementApprovalRequired boolean

一个 True/False 值，该值指示是否需要 SEPA 事务的审批。
箱
 bin string

此属性仅用于信用卡/借记卡类型的付款。
binName
 binName string

BIN 显示名称。
binCountryISO
 binCountryISO string

与 BIN 关联的 ISO 国家/地区代码。
binCardType
 binCardType string

BIN 卡类型。 可能的值为借记、信用额度、预付、机队、CREDITDEBIT
binCardAssociation
 binCardAssociation string

BIN 卡关联。 一些可能的值为 VISA、MASTERCARD、AMEX、DISCOVER、MAESTRO、JCB、银联、DINERSCLUB
binBankGroup
 binBankGroup string

BIN 银行组。
到期日期
 expirationDate string

商家系统中付款方式的到期日期。 格式为 ISO 8601。 此属性仅用于信用卡/借记卡类型的付款。
lastFourDigits
 lastFourDigits string

此属性仅用于信用卡/借记卡类型的付款。
电子邮件
 email string

与付款方式关联的电子邮件地址。 此属性仅用于PayPal类型的付款。
billingAgreementId
 billingAgreementId string

此属性仅用于PayPal类型的付款。
payerId
 payerId string

此属性仅用于PayPal类型的付款。
payerStatus
 payerStatus string

一个值，该值指示PayPal是否已验证付款人。 此属性仅用于PayPal类型的付款。 可能的值“已验证” |“Unverified”
addressStatus
 addressStatus string

一个值，该值指示PayPal是否已验证付款人的地址。 此属性仅用于PayPal类型的付款。 可能的值“Confirmed” |“未确认”
imei
 imei string

此属性仅用于 Mobilepayment 类型的付款。
货币
 currency string

所选付款方式的货币代码。
isInternationalMoneyTransfer
 isInternationalMoneyTransfer boolean

一个 True/False 值，指示是否发生了国际资金转移。
bankIdentifierCode
 bankIdentifierCode string

银行标识符代码（BIC 或 SWIFT 代码）
bankName
 bankName string

银行名称
bankZipCode
 bankZipCode string

银行邮政编码
bankState
 bankState string

银行州
bankCountryISO
 bankCountryISO string

银行 ISO 国家/地区
paymentCollectionDate
 paymentCollectionDate date-time

付款收集的估计日期（主要用于支付服务提供商）。
instantPaymentSettlement
 instantPaymentSettlement boolean

指示银行重定向（用于支持 CSV 付款）的 True/False 值。
autoCaptureEnabled
 autoCaptureEnabled boolean

一个 True/False 值，该值指示是否自动为卡付款捕获付款。 对于重定向付款，这只是合作伙伴银行是否自动提取资金的指标。
accountType 账户类型
 accountType string

指示要为事务收取费用的帐户类型。 UNSPECIFIED 是默认值。 CHEQUE_ACCOUNT使用卡作为借记卡。 CREDIT_FACILITY使用该卡作为信用卡。
authorizationType
 authorizationType string

授权类型。 万事达卡和 Visa 现在要求商家将授权尝试定义为预授权或最终授权。 可能的值为PRE_AUTHORIZATION，FINAL_AUTHORIZATION
authorizationResultCode
 authorizationResultCode string

授权决定的银行响应。 可能的值为“批准”、“拒绝”、“挂起”
authorizationResultText
 authorizationResultText string

授权决定的原因;尤其是对于已拒绝或挂起的事务。 可能的值为MISMATCH_CVV、MISMATCH_ADDRESS、MISMATCH_EXPIRATIONDATE、NOACCOUNT、INVALIDPIN、LOWFUND、OVERLIMIT SUSPICIOUSACCOUNT
acquirerId
 acquirerId string

获取机构标识代码。
acquirerCountryISO
 acquirerCountryISO string

获取机构国家/地区代码
cvvVerify
 cvvVerify string

指示 CVV 验证是否可用，以及/或已成功验证。 Y = 已成功验证，N = 未成功验证，U = 不可用，A = 可用，但没有验证
avsVerify
 avsVerify string

指示加载项验证是否可用，以及/或成功验证。 Y = 已成功验证，N = 未成功验证，U = 不可用，A = 可用，但没有验证
cavVerify
 cavVerify string

指示持卡人身份验证验证是否可用，以及/或已成功验证。 Y = 已成功验证，N = 未成功验证，U = 不可用，A = 可用，但没有验证
piInputMethod
 piInputMethod string

N/A
encryptedCreditCardNumber
 encryptedCreditCardNumber string

哈希或加密的信用卡号。
purchaseAmount
 purchaseAmount double

使用此 PI 进行交易的总购买金额
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
country
 country string

为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码（例如美国）。
firstName
 firstName string

随地址一起提供的名字
lastName
 lastName string

提供地址的姓氏
电话号码
 phoneNumber string

提供地址的电话号码
organizationId
 organizationId True string

商家或组织的唯一标识符。
姓名
 name True string

组织的名称
邮政编码
 zipCode string

组织所在位置的邮政编码
状态
 state string

组织所在位置的状态
countryISO
 countryISO string

组织所在的国家/地区
organizationId
 organizationId True string

商家或组织的唯一标识符。
姓名
 name True string

组织的名称
邮政编码
 zipCode string

组织所在位置的邮政编码
状态
 state string

组织所在位置的状态
countryISO
 countryISO string

组织所在的国家/地区
organizationId
 organizationId True string

商家或组织的唯一标识符。
姓名
 name True string

组织的名称
邮政编码
 zipCode string

组织所在位置的邮政编码
状态
 state string

组织所在位置的状态
countryISO
 countryISO string

组织所在的国家/地区
isThreeDSAuth
 isThreeDSAuth boolean

一个 True/False 值，该值指示此事务是否通过 3DS 进行身份验证。
messageCategory
 messageCategory string

标识特定用例的消息类别。 接受的值：01 = PA，02 = NPA，03-79 = 保留用于 EMVCo 的未来使用（值无效，直到 EMVCo 定义），80-99 = 为 DS 使用保留
deviceChannel
 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 = 请求质询 （如果需要质询时请求的允许列表提示）
threeRIInd
 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
 transStatus string

指示事务是限定为经过身份验证的事务还是帐户验证。 接受的值：Y = 身份验证验证成功。 N = 未进行身份验证，帐户未验证;事务被拒绝。 U = 身份验证，无法执行帐户验证;ARes 或 RReq 中所示的技术或其他问题。 A = 已执行的尝试处理;未通过身份验证、已验证，但提供了尝试身份验证的证明、验证。 C = 需要质询;需要使用 CReq、CRes 进行其他身份验证。 D = 需要质询;已确认分离身份验证。 R = 身份验证，帐户验证被拒绝;颁发者拒绝身份验证、验证并请求未尝试授权。 I = 仅信息;已确认 3DS 请求者质询首选项。
transStatusReason
 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 使用保留
threeDSCompInd
 threeDSCompInd string

指示 3DS 方法是否已成功完成。 接受的值：Y = 成功完成，N = 未成功完成，U = Unavailabl 3DS 方法 URL 不存在于与持卡人帐号关联的卡范围的 PRes 消息数据中。
acsChallengeMandated
 acsChallengeMandated string

指示由于局部/地区授权或其他变量，是否需要对交易提出质询。 接受的值：Y = 强制要求质询，N = 未授权质询
eci
 eci string

电子商务指标（ECI）。 ACS 或 DS 提供的付款系统特定值，用于指示尝试对持卡人进行身份验证的结果。 接受的值： 02 （万事达卡）/05 （Visa）= 成功身份验证 01 （万事达卡）/06/07 （Visa） = 所有其他值
shipNameIndicator
 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
 exemptionRaised string

PSD2 豁免请求，Y - 豁免，N - 未免除
suspiciousAccActivity
 suspiciousAccActivity string

指示 3DS 请求者是否在持卡人帐户上遇到可疑活动（包括以前的欺诈）。 接受的值：01 = 未观察到可疑活动，02 = 观察到可疑活动
productId
 productId True string

商家系统中的产品标识符。
产品名称
 productName string

用户可读产品名称。
类型
 type string

销售的产品类型。 可能的值“Digital” |“Physical”
sku
 sku string

产品 SKU
分类
 category string

产品类别。 可能的值“Subscription” |“Game” |“GameConsumable” |“GameDLC” |“HardwareDevice” |“HardwareAccessory” |“SoftwareToken” |'SoftwareDirectEntitlement' |'ClothingShoes' |“RecreationalEquipment” |“珠宝” |'Hotel' |“Ticket” |“VehicleRental” |'GiftCard' |“Movies” |'Music' |“GarageIndustrial” |“HomeGarden” |“工具” |“Books” |“HealthBeauty” |“家具” |“Toys” |“FoodGrocery”
merchantProductCategory
 merchantProductCategory string

由商家在其系统中定义的产品类别
市场
 market string

产品提供的市场
productBrand
 productBrand string

产品的品牌名称
buyItAgainOrder
 buyItAgainOrder boolean

如果用户重新订购以前的订单（而不仅仅是该订单中的产品）
preOrderAvailabilityDate
 preOrderAvailabilityDate date-time

产品首次可供预排序时
salesPrice
 salesPrice double

销售商品的价格（不包括税款）。 由商家提供。
货币
 currency string

用于销售价格的货币。 由商家提供。
齿轮
 cogs double

销售的商品成本 - 商品的原材料成本。 由商家提供。
isRecurring
 isRecurring boolean

指示产品是否是定期订阅。
isFree
 isFree boolean

指示产品是否免费提供。
语言
 language string

描述产品的语言。
purchasePrice
 purchasePrice double

购买时行项的价格。
边距
 margin double

通过销售商品获得的利润率。
数量
 quantity integer

购买的项目数量
isPreorder
 isPreorder boolean

指示是否为预排序提供产品。
shippingMethod
 shippingMethod string

指示用于交付产品的方法。 可能的值“InStorePickup” |“Standard” |“Express” |'DirectEntitlement' |“DigitalToken”
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
country
 country string

为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码（例如美国）。
firstName
 firstName string

随地址一起提供的名字
lastName
 lastName string

提供地址的姓氏
电话号码
 phoneNumber string

提供地址的电话号码
storeId
 storeId True string

商家系统中的应用商店标识符
storeName
 storeName string

商家系统中的应用商店名称
terminalId
 terminalId string

销售点终端的唯一标识符
terminalName
 terminalName string

销售点终端名称
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
country
 country string

为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码（例如美国）。
userId
 userId True string

用户标识符。 此信息由商家提供。
创建日期
 creationDate date-time

用户帐户的创建日期。 格式为 ISO 8601。
updateDate
 updateDate date-time

上次更改用户数据的日期。 格式为 ISO 8601。
firstName
 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
 profileType string

用户的配置文件类型。 可能的值为“Consumer” |'Seller' |'Publisher' |“Tenant” |“Developer”
profileName
 profileName string

配置文件名称，具体取决于 profileType。
authenticationProvider
 authenticationProvider string

用户的身份验证提供程序（如果不同于商家的身份验证提供程序）。 可能的 valuse “MSA” |“Facebook”|“PSN” |“MerchantAuth” |“Google”
认证方法
 authenticationMethod string

客户在购买之前/期间进行身份验证的方式。 一些可能的值是基于密码、多重、生物识别、基于令牌的、
displayName
 displayName string

用户的显示名称。 示例：Xbox 玩家代号值
isEmailValidated
 isEmailValidated boolean

一个 True/False 值，该值指示用户提供的电子邮件地址是否已验证为用户拥有。
emailValidatedDate
 emailValidatedDate date-time

用户电子邮件的验证日期。 格式为 ISO 8601。
isPhoneNumberValidated
 isPhoneNumberValidated boolean

一个 True/False 值，该值指示用户提供的电话号码是否已验证为用户拥有的电话号码。
phoneNumberValidatedDate
 phoneNumberValidatedDate date-time

用户电话号码的验证日期。 格式为 ISO 8601。
membershipType
 membershipType string

客户的成员身份状态或类型。 可以指定不同的付费级别，例如 Premium、Executive。 可能的值是 FREE、PAID、PREMIUM
loginInputMethod
 loginInputMethod string

客户输入其凭据的方式。 可能的值包括 MANUALINPUT、AUTOFILL、SCRIPT、COPYPASTE、SELECTPROFILE
lastPasswordUpdatedDate
 lastPasswordUpdatedDate date-time

上次更新客户的密码时。
firstPurchaseDate
 firstPurchaseDate date-time

客户首次购买时
loginChallengeType
 loginChallengeType string

发起的挑战响应测试的类型。 可能的值包括短信、电话短信、电子邮件 PIN、CAPTCHA
airlineIncluded
 airlineIncluded boolean

一个 True/False 值，该值指示是否包括机票。
carRentalIncluded
 carRentalIncluded boolean

一个 True/False 值，该值指示是否包括出租汽车。
lodgingIncluded
 lodgingIncluded boolean

一个 True/False 值，该值指示是否包括住宿。
travelType
 travelType string

旅行类别或类型。
isRoundTrip
 isRoundTrip boolean

一个 True/False 值，该值指示旅行是否往返。
isDiscountOffered
 isDiscountOffered boolean

一个 True/False 值，该值指示是否提供折扣。
isPackagedTour
 isPackagedTour boolean

一个 True/False 值，该值指示这是否是打包教程。
issueDateTime
 issueDateTime date-time

颁发票证的日期和时间。
travelDateTime
 travelDateTime date-time

旅行开始日期和时间。
returnDateTime
 returnDateTime date-time

行程结束或返回日期和时间。
bookingType
 bookingType string

预订类型。 一些可能的值是 WEBSITE、AGENT
webUrl
 webUrl string

预订旅行的 URL。
fromCity
 fromCity string

客户从中旅行的城市。
fromState
 fromState string

客户从中旅行的状态。
fromCountryISO
 fromCountryISO string

客户所在的 ISO 国家/地区。
fromZipCode
 fromZipCode string

客户从中旅行的邮政编码。
toCity
 toCity string

客户前往的城市。
toState
 toState string

客户前往的状态。
toCountryISO
 toCountryISO string

客户前往的 ISO 国家/地区。
toZipCode
 toZipCode string

客户前往的邮政编码。
ticketNumber
 ticketNumber string

唯一票证号。
placeOfIssue
 placeOfIssue string

颁发票证的位置。
isRestrictedTicket
 isRestrictedTicket boolean

一个 True/False 值，该值指示票证是否受到限制。
rewardsOrVoucherApplied
 rewardsOrVoucherApplied boolean

一个 True/False 值，该值指示奖励或凭证是否应用于订单。
totalRewardsApplied
 totalRewardsApplied integer

应用于订单的总奖励。
totalFees
 totalFees double

应用于订单的总费用。
purchaserProfileType
 purchaserProfileType string

客户的个人资料或成员身份类型。 可能的值是 CORPORATE、INDIVIDUAL
isThirdParty
 isThirdParty boolean

一个 True/False 值，该值指示订单是否通过第三方网站放置。
isPurchaserFrequentFlyer
 isPurchaserFrequentFlyer boolean

一个 True/False 值，该值指示订单是否通过第三方网站放置。
passengerCount
 passengerCount integer

乘客总数。
numberOfStops
 numberOfStops integer

航班的停站或下车次数。
airlineCode
 airlineCode string

航空公司代码。
airlineName
 airlineName string

航空公司名称。
operatedBy
 operatedBy string

运行外部测试版的组织。
flightNumber
 flightNumber string

外部测试版编号。
departureDateTime
 departureDateTime date-time

出发日期和时间。
arrivalDateTime
 arrivalDateTime date-time

到达日期和时间。
fromAirportCode
 fromAirportCode string

航班从哪里起飞的机场代码。
fromAirportCity
 fromAirportCity string

客户从该机场出发的机场城市。
fromAirportState
 fromAirportState string

客户从其出发的机场状态。
fromAirportZipcode
 fromAirportZipcode string

客户从其出发的机场邮政编码。
fromAirportCountryISO
 fromAirportCountryISO string

客户从其出发的机场 ISO 国家/地区。
toAirportCode
 toAirportCode string

航班飞往的机场代码。
toAirportCity
 toAirportCity string

客户前往的机场城市。
toAirportState
 toAirportState string

客户前往的机场状态。
toAirportZipcode
 toAirportZipcode string

客户前往的机场邮政编码。
toAirportCountryISO
 toAirportCountryISO string

客户前往的机场 ISO 国家/地区。
travelClass
 travelClass string

座位舱或机舱。
segmentSequence
 segmentSequence integer

给定飞行段的序列号（例如航班第二回合的 2）
firstName
 firstName string

乘客名字。
lastName
 lastName string

乘客姓氏。
folioNumber
 folioNumber string

住宿属性的唯一标识符。
checkInDate
 checkInDate date-time

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

住宿的签出日期。
reservationConfirmed
 reservationConfirmed boolean

一个 True/False 值，该值指示是否已确认预留。
membershipDetails
 membershipDetails string

有关客户成员身份状态的其他详细信息。
discountProgram
 discountProgram string

适用于住宿订单的折扣计划。
adultCount
 adultCount integer

住宿中包含的成人数量。
kidCount
 kidCount integer

住宿中包含的儿童数量。
nightsCount
 nightsCount integer

住宿中包含的夜晚数。
roomCount
 roomCount integer

住宿中包含的房间数。
bedType
 bedType string

床类型或类别。
roomType
 roomType string

房间类型或类别。
paymentDescription
 paymentDescription string

有关滞纳付款的其他详细信息。
姓名
 name string

设施名称。
类型
 type string

设施类型。
contact电话号码
 contactPhoneNumber string

用于联系设施的电话号码。
联系我们电子邮件
 contactEmail string

用于联系设施的电子邮件地址。
dailyRoomRate
 dailyRoomRate double

设施的每日房价。
货币
 currency string

设施支持的货币。
dailyRoomTaxAmount
 dailyRoomTaxAmount double

设施收取的每日房间税额。
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
country
 country string

为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码（例如美国）。
pickupLocation
 pickupLocation string

汽车租赁皮卡位置。
pickupDateTime
 pickupDateTime date-time

租赁取件日期和时间。
dropOffLocation
 dropOffLocation string

出租的下车地点。
dropOffDateTime
 dropOffDateTime date-time

出租汽车的下车日期和时间
discountProgram
 discountProgram string

应用于租赁订单的折扣计划。
carType
 carType string

汽车类型或类别。
isPrepaid
 isPrepaid boolean

一个 True/False 值，指示是否预付了租金。
insuranceIncluded
 insuranceIncluded boolean

一个 True/False 值，指示是否包括保险。
联系我们电子邮件
 contactEmail string

租车者的电子邮件地址。
contact电话号码
 contactPhoneNumber string

租车者的电话号码。
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
country
 country string

为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码（例如美国）。
agencyCode
 agencyCode string

旅行社代码。
agencyName
 agencyName string

旅行社名称。
agentCode
 agentCode string

N/A
agencyContactPhone
 agencyContactPhone string

N/A
agencyContactEmail
 agencyContactEmail string

N/A
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
country
 country string

为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码（例如美国）。
organizationId
 organizationId True string

云服务或组织的唯一标识符。
companyName
 companyName string

云服务名称。
companyType
 companyType string

云公司类型。
companySize
 companySize integer

云公司规模。
entityId
 entityId string

组织下法律实体的唯一标识符。
primaryContactFirstName
 primaryContactFirstName string

业务的主要联系人的名字。
primaryContactLastName
 primaryContactLastName string

业务的主要联系人的姓氏。
primaryContactEmail
 primaryContactEmail string

业务的主要联系人的电子邮件地址。
primaryContactPhoneNumber
 primaryContactPhoneNumber string

业务的主要联系人的电话号码。
subscriptionCount
 subscriptionCount integer

可用的订阅总数。
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
country
 country string

为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码（例如美国）。
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp
 merchantTimeStamp date-time

事件的 TimeStamp

返回

结果详细信息

Body
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseActivity.PurchaseResponseWrapper

提供帐户创建尝试的风险评估

操作 ID:
AccountProtection_v1_AccountCreation

此事件发送有关传入的新帐户创建尝试的信息和上下文。 响应包含帐户创建决策

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
姓名
 name True string

事件名称。 应为“AP”。AccountCreation'
版本
 version True string

有效负载版本。 应为“0.5”
trackingId
 trackingId True string

帐户创建事件的标识符。
signUpId
 signUpId True string

帐户创建事件的标识符。 可以匹配 trackingId。
评估类型
 assessmentType string

指示事件的评估类型。 可能的值为“Evaluate” |“保护”。 如果未指定，则默认值为“保护”。
customerLocalDate
 customerLocalDate True date-time

客户本地时区中的帐户创建事件的创建日期。 格式为 ISO 8601。
merchantTimeStamp
 merchantTimeStamp True date-time

事件的 TimeStamp。
deviceContextId
 deviceContextId True string

由 DFP 设备指纹服务提供和掌握的客户设备 ID。
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

用户的配置文件类型。 可能的值是“使用者”|”开发人员'|'Seller'|'Publisher'|'Tenant'。
用户名
 username True string

用户提供的用户名。
firstName
 firstName string

帐户上用户提供的名字。
lastName
 lastName string

帐户上用户提供的姓氏。
countryRegion
 countryRegion string

用户的 CountryRegion。 该值应为双字母 ISO CountryRegion 代码（例如美国）。
邮政编码
 zipCode string

用户的邮政编码。
timeZone
 timeZone string

用户的时区。
语言
 language string

用户的语言和区域（例如，EN-US）。
membershipId
 membershipId string

如果用户已有与商家的现有成员身份，则成员身份 ID。
isMembershipIdUsername
 isMembershipIdUsername boolean

membershipId 可用作用户名，默认值为 False。
phoneType
 phoneType True string

值为：“Primary”|”替代项，默认为“Primary”。
电话号码
 phoneNumber True string

用户的电话号码。 格式应为国家/地区代码，后跟连字符（-），然后是电话号码（例如，对于美国，+1-1234567890）。
isPhoneNumberValidated
 isPhoneNumberValidated boolean

一个 True/False 值，该值指示用户提供的电话号码是否已验证为用户拥有的电话号码。
phoneNumberValidatedDate
 phoneNumberValidatedDate date-time

用户电话号码的验证日期。 格式为 ISO 8601。
isPhoneUsername
 isPhoneUsername boolean

电话号码可用作用户名，默认值为 False。
emailType
 emailType True string

值为：“Primary”、“Alternative”
emailValue
 emailValue True string

用户的电子邮件地址。 此值不区分大小写。
isEmailValidated
 isEmailValidated boolean

一个 True/False 值，该值指示用户提供的电子邮件地址是否已验证为用户拥有。
emailValidatedDate
 emailValidatedDate date-time

用户电子邮件的验证日期。 格式为 ISO 8601。
isEmailUsername
 isEmailUsername boolean

电子邮件可用作用户名，默认值为 False。
authenticationProvider
 authenticationProvider True string

用户的单一登录 （SSO） 身份验证提供程序（如果不同于商家）。 可能的 valuse 为“MSA”|”Facebook'|'PSN'|'MerchantAuth'|'谷歌'
displayName
 displayName True string

用户的单一登录 （SSO） 身份验证提供程序（如果不同于商家）。 可能的 valuse 为“MSA”|”Facebook'|'PSN'|'MerchantAuth'|'谷歌'
addressType
 addressType True string

地址类型。 值为：'Primary'|'计费'|'Shipping'|'替代项”。 默认值为“Primary”。
firstName
 firstName string

与地址关联的用户提供的名字。
lastName
 lastName string

与地址关联的用户提供的姓氏。
电话号码
 phoneNumber string

与地址关联的用户提供的电话号码。
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
countryRegion
 countryRegion string

为地址提供的国家/地区代码。 该值应为双字母 ISO CountryRegion 代码（例如美国）。
merchantPaymentInstrumentId
 merchantPaymentInstrumentId True string

付款方式的标识符。 此信息由商家提供。
类型
 type True string

付款类型。 可能的值为：“Other”|”CreditCard'|'DirectDebit'|'PayPal'|'MobileBilling'|'OnlineBankTransfer' |'发票' |'MerchantGiftCard'|'MerchantWallet'|'CashOnDelivery'|'Paytm'|'CCAvenue'.
创建日期
 creationDate date-time

商家系统中付款方式的第一个条目的日期。 格式为 ISO 8601。
updateDate
 updateDate date-time

商家系统中付款方式的上次更新日期。 不应早于 creationDate。 格式为 ISO 8601。
状态
 state string

商家系统中 PI 的当前状态。 可能的值为：“Active”|”已阻止'|'已过期'
cardType
 cardType string

此属性仅用于信用卡/借记卡类型的付款。 可能的值为：“Visa”|”万事达卡'|'Amex'|'ACH'|'SEPA'|'UnionPay'|'Inicis'|'MobileBillingCarrier'|'发现“|”AllPay'|'JCB' |'DiscoverDiners'.
holderName
 holderName string

付款方式用户的名称。 此属性仅用于信用卡/借记卡类型的付款。
箱
 bin string

信用卡/借记卡箱。 此属性仅用于信用卡/借记卡类型的付款。
到期日期
 expirationDate string

商家系统中付款方式的到期日期。 格式为 ISO 8601。 此属性仅用于信用卡/借记卡类型的付款。
lastFourDigits
 lastFourDigits string

信用卡/借记卡的最后四位数字。 此属性仅用于信用卡/借记卡类型的付款。
addressType
 addressType True string

地址类型。 值为：'Primary'|'计费'|'Shipping'|'替代项”。 默认值为“Primary”。
firstName
 firstName string

与地址关联的用户提供的名字。
lastName
 lastName string

与地址关联的用户提供的姓氏。
电话号码
 phoneNumber string

与地址关联的用户提供的电话号码。
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
countryRegion
 countryRegion string

为地址提供的国家/地区代码。 该值应为双字母 ISO CountryRegion 代码（例如美国）。
电子邮件
 email string

与付款方式关联的电子邮件地址。 此属性仅用于PayPal类型的付款。
billingAgreementId
 billingAgreementId string

此属性仅用于PayPal类型的付款。
payerId
 payerId string

此属性仅用于PayPal类型的付款。
payerStatus
 payerStatus string

一个值，该值指示PayPal是否已验证付款人。 此属性仅用于PayPal类型的付款。
addressStatus
 addressStatus string

一个值，该值指示PayPal是否已验证付款人的地址。 此属性仅用于PayPal类型的付款。
imei
 imei string

此属性仅用于 Mobilepayment 类型的付款。
campaignType
 campaignType string

市场营销活动类型。 可能的值为“Direct”、“Email”、“Referral”、“PaidSearch”、“OrganicSearch”、“Advertising”、“SocialNetwork”、“General Marketing”、“Unknown”、“Other”。
trafficSourceReferrer
 trafficSourceReferrer string

此用户的源（如果已知）。 如果通过现有用户引荐，请提供引用者的原始 MerchantUserId。
trafficSourceReferralLink
 trafficSourceReferralLink uri

此用户的源（如果已知）。 如果通过其他市场活动类型而不是现有用户引荐，请提供源 URL 链接。
trafficSourceReferralSite
 trafficSourceReferralSite string

流量的源站点。 可能的值为“Facebook”、“Instagram”、“Twitter”、“必应”、“Google”、“Pinterest”、“WhatsApp”等。
incentiveType
 incentiveType string

新用户的奖励类型。 可能的值为“None”、“CashBack”、“Discount”、“FreeTrial”、“BonusPoints”、“Gift”、“Unknown”、“Other”。
incentiveOffer
 incentiveOffer string

确切的奖励套餐名称。 示例：第一订单 5 美元，免费送货，5000 点。
campaignStartDate
 campaignStartDate date-time

从奖励收集开始的竞选活动日期。
campaignEndDate
 campaignEndDate date-time

奖励收集的市场活动到期日期。
incentiveQuantitiyLimit
 incentiveQuantitiyLimit string

商家设置的奖励数量限制。 即，每个用户每天最多 3 个 5000 点。

返回

Dynamics 欺诈保护 AccountCreate API 的响应对象

Body
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountCreateResponseSuccessDetails

提供帐户登录尝试的风险评估

操作 ID:
AccountProtection_v1_AccountLogin

此事件发送有关传入的新帐户登录尝试的信息和上下文。 响应包含帐户登录名的决定

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
姓名
 name True string

事件名称。 应为“AP”。AccountLogin'
版本
 version True string

有效负载版本。 应为“0.5”
trackingId
 trackingId True string

Login 事件的标识符。
loginId
 loginId True string

Login 事件的标识符。 可以匹配 trackingId。
评估类型
 assessmentType string

指示事件的评估类型。 可能的值为“Evaluate” |“保护”。 如果未指定，则默认值为“保护”。
customerLocalDate
 customerLocalDate True date-time

客户本地时区中的帐户登录事件的登录日期。 格式为 ISO 8601。
merchantTimeStamp
 merchantTimeStamp True date-time

事件的 TimeStamp。
deviceContextId
 deviceContextId True string

由 DFP 设备指纹服务提供和掌握的客户设备 ID。
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

用户的配置文件类型。 可能的值是“使用者”|”开发人员'|'Seller'|'Publisher'|'Tenant'。
用户名
 username True string

用户提供的用户名。
authenticationProvider
 authenticationProvider True string

用户的单一登录 （SSO） 身份验证提供程序（如果不同于商家）。 可能的 valuse 为“MSA”|”Facebook'|'PSN'|'MerchantAuth'|'谷歌'
displayName
 displayName True string

用户的单一登录 （SSO） 身份验证提供程序（如果不同于商家）。 可能的 valuse 为“MSA”|”Facebook'|'PSN'|'MerchantAuth'|'谷歌'
lastPhoneNumberUpdateDate
 lastPhoneNumberUpdateDate date-time

任何电话号码的最新更新或创建日期/时间。
lastEmailUpdateDate
 lastEmailUpdateDate date-time

最新更新或创建任何电子邮件的日期/时间。
lastAddressUpdateDate
 lastAddressUpdateDate date-time

最新更新或创建任何地址的日期/时间。
lastPaymentInstrumentUpdateDate
 lastPaymentInstrumentUpdateDate date-time

最新更新或创建任何 PaymentInstrument 的日期/时间。
campaignType
 campaignType string

市场营销活动类型。 可能的值为“Direct”、“Email”、“Referral”、“PaidSearch”、“OrganicSearch”、“Advertising”、“SocialNetwork”、“General Marketing”、“Unknown”、“Other”。
trafficSourceReferrer
 trafficSourceReferrer string

此用户的源（如果已知）。 如果通过现有用户引荐，请提供引用者的原始 MerchantUserId。
trafficSourceReferralLink
 trafficSourceReferralLink uri

此用户的源（如果已知）。 如果通过其他市场活动类型而不是现有用户引荐，请提供源 URL 链接。
trafficSourceReferralSite
 trafficSourceReferralSite string

流量的源站点。 可能的值为“Facebook”、“Instagram”、“Twitter”、“必应”、“Google”、“Pinterest”、“WhatsApp”等。
incentiveType
 incentiveType string

新用户的奖励类型。 可能的值为“None”、“CashBack”、“Discount”、“FreeTrial”、“BonusPoints”、“Gift”、“Unknown”、“Other”。
incentiveOffer
 incentiveOffer string

确切的奖励套餐名称。 示例：第一订单 5 美元，免费送货，5000 点。
campaignStartDate
 campaignStartDate date-time

从奖励收集开始的竞选活动日期。
campaignEndDate
 campaignEndDate date-time

奖励收集的市场活动到期日期。
incentiveQuantitiyLimit
 incentiveQuantitiyLimit string

商家设置的奖励数量限制。 即，每个用户每天最多 3 个 5000 点。

返回

Dynamics 欺诈保护 API 的响应对象

Body
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccessDetails

更新帐户保护的帐户信息

操作 ID:
AccountProtection_v1_AccountUpdate

此事件更新或创建帐户保护服务的用户帐户信息，例如添加付款方式、添加地址或任何其他用户属性。 这只是数据引入事件

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
用户 ID
 UserId True string

帐户更新的用户 ID
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
姓名
 name True string

事件名称。 应为“AP”。AccountUpdate'
版本
 version True string

有效负载版本。 应为“0.5”
trackingId
 trackingId True string

帐户更新事件的标识符。
accountUpdateId
 accountUpdateId True string

帐户更新事件的标识符。 可以匹配 trackingId。
评估类型
 assessmentType string

指示事件的评估类型。 可能的值为“Evaluate” |“保护”。 如果未指定，则默认值为“保护”。
customerLocalDate
 customerLocalDate True date-time

客户本地时区中的帐户更新事件的创建日期。 格式为 ISO 8601。
merchantTimeStamp
 merchantTimeStamp True date-time

事件的 TimeStamp。
deviceContextId
 deviceContextId True string

由 DFP 设备指纹服务提供和掌握的客户设备 ID。
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

用户的配置文件类型。 可能的值是“使用者”|”开发人员'|'Seller'|'Publisher'|'Tenant'。
用户名
 username True string

用户提供的用户名。
firstName
 firstName string

帐户上用户提供的名字。
lastName
 lastName string

帐户上用户提供的姓氏。
countryRegion
 countryRegion string

用户的 CountryRegion。 该值应为双字母 ISO CountryRegion 代码（例如美国）。
邮政编码
 zipCode string

用户的邮政编码。
timeZone
 timeZone string

用户的时区。
语言
 language string

用户的语言和区域（例如，EN-US）。
membershipId
 membershipId string

如果用户已有与商家的现有成员身份，则成员身份 ID。
isMembershipIdUsername
 isMembershipIdUsername boolean

membershipId 可用作用户名，默认值为 False。
phoneType
 phoneType True string

值为：“Primary”|”替代项，默认为“Primary”。
电话号码
 phoneNumber True string

用户的电话号码。 格式应为国家/地区代码，后跟连字符（-），然后是电话号码（例如，对于美国，+1-1234567890）。
isPhoneNumberValidated
 isPhoneNumberValidated boolean

一个 True/False 值，该值指示用户提供的电话号码是否已验证为用户拥有的电话号码。
phoneNumberValidatedDate
 phoneNumberValidatedDate date-time

用户电话号码的验证日期。 格式为 ISO 8601。
isPhoneUsername
 isPhoneUsername boolean

电话号码可用作用户名，默认值为 False。
emailType
 emailType True string

值为：“Primary”、“Alternative”
emailValue
 emailValue True string

用户的电子邮件地址。 此值不区分大小写。
isEmailValidated
 isEmailValidated boolean

一个 True/False 值，该值指示用户提供的电子邮件地址是否已验证为用户拥有。
emailValidatedDate
 emailValidatedDate date-time

用户电子邮件的验证日期。 格式为 ISO 8601。
isEmailUsername
 isEmailUsername boolean

电子邮件可用作用户名，默认值为 False。
authenticationProvider
 authenticationProvider True string

用户的单一登录 （SSO） 身份验证提供程序（如果不同于商家）。 可能的 valuse 为“MSA”|”Facebook'|'PSN'|'MerchantAuth'|'谷歌'
displayName
 displayName True string

用户的单一登录 （SSO） 身份验证提供程序（如果不同于商家）。 可能的 valuse 为“MSA”|”Facebook'|'PSN'|'MerchantAuth'|'谷歌'
addressType
 addressType True string

地址类型。 值为：'Primary'|'计费'|'Shipping'|'替代项”。 默认值为“Primary”。
firstName
 firstName string

与地址关联的用户提供的名字。
lastName
 lastName string

与地址关联的用户提供的姓氏。
电话号码
 phoneNumber string

与地址关联的用户提供的电话号码。
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
countryRegion
 countryRegion string

为地址提供的国家/地区代码。 该值应为双字母 ISO CountryRegion 代码（例如美国）。
merchantPaymentInstrumentId
 merchantPaymentInstrumentId True string

付款方式的标识符。 此信息由商家提供。
类型
 type True string

付款类型。 可能的值为：“Other”|”CreditCard'|'DirectDebit'|'PayPal'|'MobileBilling'|'OnlineBankTransfer' |'发票' |'MerchantGiftCard'|'MerchantWallet'|'CashOnDelivery'|'Paytm'|'CCAvenue'.
创建日期
 creationDate date-time

商家系统中付款方式的第一个条目的日期。 格式为 ISO 8601。
updateDate
 updateDate date-time

商家系统中付款方式的上次更新日期。 不应早于 creationDate。 格式为 ISO 8601。
状态
 state string

商家系统中 PI 的当前状态。 可能的值为：“Active”|”已阻止'|'已过期'
cardType
 cardType string

此属性仅用于信用卡/借记卡类型的付款。 可能的值为：“Visa”|”万事达卡'|'Amex'|'ACH'|'SEPA'|'UnionPay'|'Inicis'|'MobileBillingCarrier'|'发现“|”AllPay'|'JCB' |'DiscoverDiners'.
holderName
 holderName string

付款方式用户的名称。 此属性仅用于信用卡/借记卡类型的付款。
箱
 bin string

信用卡/借记卡箱。 此属性仅用于信用卡/借记卡类型的付款。
到期日期
 expirationDate string

商家系统中付款方式的到期日期。 格式为 ISO 8601。 此属性仅用于信用卡/借记卡类型的付款。
lastFourDigits
 lastFourDigits string

信用卡/借记卡的最后四位数字。 此属性仅用于信用卡/借记卡类型的付款。
addressType
 addressType True string

地址类型。 值为：'Primary'|'计费'|'Shipping'|'替代项”。 默认值为“Primary”。
firstName
 firstName string

与地址关联的用户提供的名字。
lastName
 lastName string

与地址关联的用户提供的姓氏。
电话号码
 phoneNumber string

与地址关联的用户提供的电话号码。
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
countryRegion
 countryRegion string

为地址提供的国家/地区代码。 该值应为双字母 ISO CountryRegion 代码（例如美国）。
电子邮件
 email string

与付款方式关联的电子邮件地址。 此属性仅用于PayPal类型的付款。
billingAgreementId
 billingAgreementId string

此属性仅用于PayPal类型的付款。
payerId
 payerId string

此属性仅用于PayPal类型的付款。
payerStatus
 payerStatus string

一个值，该值指示PayPal是否已验证付款人。 此属性仅用于PayPal类型的付款。
addressStatus
 addressStatus string

一个值，该值指示PayPal是否已验证付款人的地址。 此属性仅用于PayPal类型的付款。
imei
 imei string

此属性仅用于 Mobilepayment 类型的付款。

返回

Dynamics 欺诈保护成功对象

Body
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccess

更新帐户保护的欺诈标签信息

操作 ID:
AccountProtection_v1_Label

此事件发送标签的更新。 这只是数据引入事件

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
用户 ID
 UserId True string

标签 API 的用户 ID
连接类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
姓名
 name True string

事件名称。 应为“AP”。标签'
版本
 version True string

有效负载版本。 应为“0.5”
trackingId
 trackingId True string

每个事件/记录的唯一 ID。
userId
 userId True string

用户标识符。 此信息由商家提供。
merchantTimeStamp
 merchantTimeStamp True date-time

事件的 TimeStamp。
eventTimeStamp
 eventTimeStamp True date-time

事件的日期和时间。 可能的值：退款日期或查看日期。 格式为 ISO 8601。
labelObjectType
 labelObjectType True string

此字段指示标签的类型：“Purchase”|”AccountCreation'|'AccountLogin'|'AccountUpdate'|'CustomFraudEvaluation'|'帐户'|'PaymentInstrument'|'电子邮件”。
labelObjectId
 labelObjectId True string

这是对象的标识符字段：PurchaseId、AccountCreationId、AccountLoginId、AccountUpdateId、UserId、MerchantPaymentInstrumentId 或 Email。
labelSource
 labelSource string

此字段表示标签的源：“CustomerEscalation”|”Chargeback'|'TC40_SAFE'|'ManualReview'|'退款'|'OfflineAnalysis'|'AccountProtectionReview'。
labelState
 labelState True string

此字段指示标签的当前状态：“InquiryAccepted”|”欺诈'|'争议'|'Reversed'|'滥用'|'ResubmittedRequest'|'AccountCompromised'|'AccountNotCompromised'。
labelReasonCode
 labelReasonCode string

此字段指示与每种标签类型关联的原因代码：“ProcessorResponseCode”|”BankResponseCode'|'FraudRefund'|'AccountTakeOver'|'PaymentInstrumentFraud'|'AccountFraud'|'滥用'|'FriendlyFraud'|'AccountCredentialsLeaked'|'PassedAccountProtectionChecks'
处理器
 processor string

生成 TC40 或 SAFE 信息的银行或付款处理器的名称。
生效开始日期
 effectiveStartDate date-time

此标签生效的日期。 格式为 ISO 8601。
生效结束日期
 effectiveEndDate date-time

此标签的结束日期。 格式为 ISO 8601。 不能早于 effectiveStartDate。

返回

Dynamics 欺诈保护成功对象

Body
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccess

更新帐户创建状态

操作 ID:
AccountProtection_v1_AccountCreationStatus

此事件发送帐户创建状态的更新，例如，如果帐户创建已取消。 这只是数据引入事件

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
姓名
 name True string

事件名称。 应为“AP”。AccountCreation.Status'
版本
 version True string

有效负载版本。 应为“0.5”
trackingId
 trackingId True string

帐户创建状态事件的标识符。
signUpId
 signUpId True string

帐户创建事件的标识符。
merchantTimeStamp
 merchantTimeStamp True date-time

事件的 TimeStamp。
userId
 userId True string

用户标识符。 此信息由商家提供。
statusType
 statusType True string

状态类型：“已批准”|”Rejected'|'挂起'。
reasonType
 reasonType string

原因类型：“None”|”ChallengeAbandoned'|'ChallengeFailed'|'ChallengePassed'|'ChallengePending'|'ReviewFailed'|'ReviewPassed'|'ReviewPendinge'。 默认值为“None”。
challengeType
 challengeType string

审阅状态的类型：“SMS”|”电子邮件'|'Phone'|'其他“|”None'。 默认值为“None”。
statusDate
 statusDate True date-time

应用状态的日期和时间。 格式为 ISO 8601。

返回

Dynamics 欺诈保护成功对象

Body
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccess

更新帐户登录状态

操作 ID:
AccountProtection_v1_AccountLoginStatus

此事件发送帐户登录状态的更新，例如，如果帐户登录名已取消。 这只是数据引入事件

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
姓名
 name True string

事件名称。 应为“AP”。AccountLogin.Status'
版本
 version True string

有效负载版本。 应为“0.5”
trackingId
 trackingId True string

帐户登录状态事件的标识符。
loginId
 loginId True string

帐户登录事件的标识符。
merchantTimeStamp
 merchantTimeStamp True date-time

事件的 TimeStamp。
userId
 userId True string

用户标识符。 此信息由商家提供。
statusType
 statusType True string

状态类型：“已批准”|”Rejected'|'挂起'。
reasonType
 reasonType string

原因类型：“None”|”ChallengeAbandoned'|'ChallengeFailed'|'ChallengePassed'|'ChallengePending'|'ReviewFailed'|'ReviewPassed'|'ReviewPendinge'。 默认值为“None”。
challengeType
 challengeType string

审阅状态的类型：“SMS”|”电子邮件'|'Phone'|'其他“|”None'。 默认值为“None”。
statusDate
 statusDate True date-time

应用状态的日期和时间。 格式为 ISO 8601。

返回

Dynamics 欺诈保护成功对象

Body
Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccess

更新欺诈标签信息以获取购买保护

操作 ID:
PurchaseProtection_v1_Label

此事件发送标签的更新。 这只是数据引入事件

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
labelObjectType
 labelObjectType True string

此标签实体应用到的 EntityName。 如果设置为“电子邮件”，则会从电子邮件 LabelObjectId 中查找用户 ID。 可能的值为 PURCHASE、SIGNUP、CUSTOMFRAUDEVALUATION、ACCOUNT、PI、EMAIL
labelObjectId
 labelObjectId True string

此标签实体应用到的 LabelObjectType 中的 ID 值。
labelSource
 labelSource string

颁发此标签的 LabelReasonCodes 或 LabelState 的颁发机构。 可能的值“CustomerEscalation” |'Chargeback' |“TC40_SAFE” |“ManualReview” |“退款” |“OfflineAnalysis”
labelReasonCodes
 labelReasonCodes string
labelState
 labelState string

如果 LabelSource 具有状态转换，则此标签的当前状态。 例如： “接受”意味着先前的欺诈怀疑已被清除。 可能的值“查询” |“Accepted” |“欺诈” |“争议” |“Reversed” |“ResubmittedRequest”
处理器
 processor string

颁发 LabelReasonCodes 的特定 LabelSource 机构。
eventTimeStamp
 eventTimeStamp date-time

从 LabelSource/Processor 报告的事件的最终创建。 格式为ISO8601。
生效开始日期
 effectiveStartDate date-time

此标签在商家时区（如果与 MerchantLocalDate 不同）中应用的开始时间。 格式为ISO8601。
生效结束日期
 effectiveEndDate date-time

此标签在商家时区中应用或 null 时结束（对于不适用/不确定）。 格式为ISO8601。
量
 amount double

此标签涉及的货币金额，例如部分退款。 “货币”字段给出的单位。
货币
 currency string

金额所在的货币，例如“USD”
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp
 merchantTimeStamp date-time

事件的 TimeStamp

返回

结果详细信息

Body
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.LabelActivity.LabelResponseWrapper

更新确认的欺诈信息

操作 ID:
PurchaseProtection_v1_ChargebackEvent

此事件发送有关客户与银行发生欺诈纠纷之前购买的信息。 这只是数据引入事件。 许多商家使用批量数据上传发送这些事件

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
chargebackId
 chargebackId True string

标识此退款事件的唯一字符串
原因
 reason string

银行提供的原因
状态
 status string

可能的值“查询” |“Accepted” |“争议” |“Reversed” |“ResubmittedRequest”
bankEventTimestamp
 bankEventTimestamp date-time

Bank 的时间戳
量
 amount double

退款金额
货币
 currency string

用于退款金额的货币。
purchaseId
 purchaseId True string

原始购买 ID
userId
 userId string

标识用户的唯一字符串
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp
 merchantTimeStamp date-time

事件的 TimeStamp

返回

结果详细信息

Body
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.ChargebackActivity.ChargebackResponseWrapper

更新联机购买交易的状态

操作 ID:
PurchaseProtection_v1_PurchaseStatus

此事件发送购买状态的更新，例如，如果已取消购买。 这只是数据引入事件

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
purchaseId
 purchaseId True string

商家系统中的交易（或采购订单）标识符。
statusType
 statusType True string

状态的类型。 可能的值“已批准” |“Pending” |“Rejected” |“Failed” |“Canceled”
statusDate
 statusDate True date-time

应用此状态时的 DateTime
原因
 reason string

状态转换的原因。 可能的值“RuleEngine” |“MerchantOverride” |“ChallengeSolved” |“ChallengeFailed” |'CustomerRequest' |“FufillmentFailed” |“InlineManualReview_General” |“InlineManualReview_Fraud” |“InlineManualReview_AccountCompromise” |“OfflineManualReview_General” |“OfflineManualReview_Fraud” |“OfflineManualReview_AccountCompromise” |“Safelist” |“阻止列表”
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp
 merchantTimeStamp date-time

事件的 TimeStamp

返回

结果详细信息

Body
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseStatusActivity.PurchaseStatusResponseWrapper

更新购买保护的帐户信息

操作 ID:
PurchaseProtection_v1_UpdateAccount

此事件更新或创建购买保护服务的用户帐户信息，例如添加付款方式、添加地址或任何其他用户属性。 这只是数据引入事件

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
userId
 userId True string

用户标识符。 此信息由商家提供。
创建日期
 creationDate date-time

用户帐户的创建日期。 格式为 ISO 8601。
updateDate
 updateDate date-time

上次更改用户数据的日期。 格式为 ISO 8601。
firstName
 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
 profileType string

用户的配置文件类型。 可能的值为“Consumer” |'Seller' |'Publisher' |“Tenant” |“Developer”
profileName
 profileName string

配置文件名称，具体取决于 profileType。
authenticationProvider
 authenticationProvider string

用户的身份验证提供程序（如果不同于商家的身份验证提供程序）。 可能的 valuse “MSA” |“Facebook”|“PSN” |“MerchantAuth” |“Google”
认证方法
 authenticationMethod string

客户在购买之前/期间进行身份验证的方式。 一些可能的值是基于密码、多重、生物识别、基于令牌的、
displayName
 displayName string

用户的显示名称。 示例：Xbox 玩家代号值
isEmailValidated
 isEmailValidated boolean

一个 True/False 值，该值指示用户提供的电子邮件地址是否已验证为用户拥有。
emailValidatedDate
 emailValidatedDate date-time

用户电子邮件的验证日期。 格式为 ISO 8601。
isPhoneNumberValidated
 isPhoneNumberValidated boolean

一个 True/False 值，该值指示用户提供的电话号码是否已验证为用户拥有的电话号码。
phoneNumberValidatedDate
 phoneNumberValidatedDate date-time

用户电话号码的验证日期。 格式为 ISO 8601。
membershipType
 membershipType string

客户的成员身份状态或类型。 可以指定不同的付费级别，例如 Premium、Executive。 可能的值是 FREE、PAID、PREMIUM
loginInputMethod
 loginInputMethod string

客户输入其凭据的方式。 可能的值包括 MANUALINPUT、AUTOFILL、SCRIPT、COPYPASTE、SELECTPROFILE
lastPasswordUpdatedDate
 lastPasswordUpdatedDate date-time

上次更新客户的密码时。
firstPurchaseDate
 firstPurchaseDate date-time

客户首次购买时
loginChallengeType
 loginChallengeType string

发起的挑战响应测试的类型。 可能的值包括短信、电话短信、电子邮件 PIN、CAPTCHA
类型
 type string

可能的值“Shipping”|“Billing” |“注册”
firstName
 firstName string

与地址关联的用户提供的名字。
lastName
 lastName string

与地址关联的用户提供的姓氏。
电话号码
 phoneNumber string

与地址关联的用户提供的电话号码。
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
country
 country string

为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码（例如美国）。
merchantPaymentInstrumentId
 merchantPaymentInstrumentId string

付款方式的标识符。 此信息由商家提供。
paymentMethod
 paymentMethod string

顶级付款方式类别。 可能的值为 CARD、CASH、DIRECTDEBIT、E-WALLET、MOBILE、E-BANKING、INVOICE、VOUCHERS
类型
 type True string

付款类型。 可能的值“CreditCard” |'DirectDebit' |“PayPal” |'MobileBilling' |'OnlineBankTransfer' |'Invoice' |“MerchantGiftCard” |“MerchantWallet” |'CashOnDelivery' |“Paytm” |“CCAvenue”
创建日期
 creationDate date-time

商家系统中付款方式的第一个条目的日期。 格式为 ISO 8601。
updateDate
 updateDate date-time

商家系统中付款方式的上次更新日期。 格式为 ISO 8601。
paymentCheckoutProvider
 paymentCheckoutProvider string

eWallet 签出提供程序。
isLowLiabilityPIType
 isLowLiabilityPIType boolean

一个 True/False 值，该值指示付款方式是否为低负债。
状态
 state string

商家系统中 PI 的当前状态。 可能的值“Active” |“非活动”
cardType
 cardType string

此属性仅用于信用卡/借记卡类型的付款。 提供卡的网络。 可能的值“Visa” |“万事达卡” |“Amex” |'ACH' |'SEPA' |“银联” |“Inicis” |“MobileBillingCarrier” |“发现” |“AllPay”|'JCB' |“DiscoverDiners”
holderName
 holderName string

付款方式用户的名称。 此属性仅用于信用卡/借记卡类型的付款。
holderCompanyName
 holderCompanyName string

提供商务或公司卡的组织的名称（仅适用于商务购买）。
settlementApprovalRequired
 settlementApprovalRequired boolean

一个 True/False 值，该值指示是否需要 SEPA 事务的审批。
箱
 bin string

此属性仅用于信用卡/借记卡类型的付款。
binName
 binName string

BIN 显示名称。
binCountryISO
 binCountryISO string

与 BIN 关联的 ISO 国家/地区代码。
binCardType
 binCardType string

BIN 卡类型。 可能的值为借记、信用额度、预付、机队、CREDITDEBIT
binCardAssociation
 binCardAssociation string

BIN 卡关联。 一些可能的值为 VISA、MASTERCARD、AMEX、DISCOVER、MAESTRO、JCB、银联、DINERSCLUB
binBankGroup
 binBankGroup string

BIN 银行组。
到期日期
 expirationDate string

商家系统中付款方式的到期日期。 格式为 ISO 8601。 此属性仅用于信用卡/借记卡类型的付款。
lastFourDigits
 lastFourDigits string

此属性仅用于信用卡/借记卡类型的付款。
电子邮件
 email string

与付款方式关联的电子邮件地址。 此属性仅用于PayPal类型的付款。
billingAgreementId
 billingAgreementId string

此属性仅用于PayPal类型的付款。
payerId
 payerId string

此属性仅用于PayPal类型的付款。
payerStatus
 payerStatus string

一个值，该值指示PayPal是否已验证付款人。 此属性仅用于PayPal类型的付款。 可能的值“已验证” |“Unverified”
addressStatus
 addressStatus string

一个值，该值指示PayPal是否已验证付款人的地址。 此属性仅用于PayPal类型的付款。 可能的值“Confirmed” |“未确认”
imei
 imei string

此属性仅用于 Mobilepayment 类型的付款。
货币
 currency string

所选付款方式的货币代码。
isInternationalMoneyTransfer
 isInternationalMoneyTransfer boolean

一个 True/False 值，指示是否发生了国际资金转移。
bankIdentifierCode
 bankIdentifierCode string

银行标识符代码（BIC 或 SWIFT 代码）
bankName
 bankName string

银行名称
bankZipCode
 bankZipCode string

银行邮政编码
bankState
 bankState string

银行州
bankCountryISO
 bankCountryISO string

银行 ISO 国家/地区
paymentCollectionDate
 paymentCollectionDate date-time

付款收集的估计日期（主要用于支付服务提供商）。
instantPaymentSettlement
 instantPaymentSettlement boolean

指示银行重定向（用于支持 CSV 付款）的 True/False 值。
autoCaptureEnabled
 autoCaptureEnabled boolean

一个 True/False 值，该值指示是否自动为卡付款捕获付款。 对于重定向付款，这只是合作伙伴银行是否自动提取资金的指标。
accountType 账户类型
 accountType string

指示要为事务收取费用的帐户类型。 UNSPECIFIED 是默认值。 CHEQUE_ACCOUNT使用卡作为借记卡。 CREDIT_FACILITY使用该卡作为信用卡。
authorizationType
 authorizationType string

授权类型。 万事达卡和 Visa 现在要求商家将授权尝试定义为预授权或最终授权。 可能的值为PRE_AUTHORIZATION，FINAL_AUTHORIZATION
authorizationResultCode
 authorizationResultCode string

授权决定的银行响应。 可能的值为“批准”、“拒绝”、“挂起”
authorizationResultText
 authorizationResultText string

授权决定的原因;尤其是对于已拒绝或挂起的事务。 可能的值为MISMATCH_CVV、MISMATCH_ADDRESS、MISMATCH_EXPIRATIONDATE、NOACCOUNT、INVALIDPIN、LOWFUND、OVERLIMIT SUSPICIOUSACCOUNT
acquirerId
 acquirerId string

获取机构标识代码。
acquirerCountryISO
 acquirerCountryISO string

获取机构国家/地区代码
cvvVerify
 cvvVerify string

指示 CVV 验证是否可用，以及/或已成功验证。 Y = 已成功验证，N = 未成功验证，U = 不可用，A = 可用，但没有验证
avsVerify
 avsVerify string

指示加载项验证是否可用，以及/或成功验证。 Y = 已成功验证，N = 未成功验证，U = 不可用，A = 可用，但没有验证
cavVerify
 cavVerify string

指示持卡人身份验证验证是否可用，以及/或已成功验证。 Y = 已成功验证，N = 未成功验证，U = 不可用，A = 可用，但没有验证
piInputMethod
 piInputMethod string

N/A
encryptedCreditCardNumber
 encryptedCreditCardNumber string

哈希或加密的信用卡号。
firstName
 firstName string

随地址一起提供的名字
lastName
 lastName string

提供地址的姓氏
电话号码
 phoneNumber string

提供地址的电话号码
street1
 street1 string

为地址提供的第一行。
street2
 street2 string

为地址提供的第二行。 （此值可以为空。
street3
 street3 string

为地址提供的第三行。 （此值可以为空。
城市
 city string

为地址提供的城市。
状态
 state string

为地址提供的国家或省。
区
 district string

为地址提供的区域。
邮政编码
 zipCode string

为地址提供的邮政编码。
country
 country string

为地址提供的国家/地区代码。 该值应为双字母 ISO 国家/地区代码（例如美国）。
deviceContextId
 deviceContextId True string

客户的指纹会话 ID;如果会话不可用，则为事件 ID。
ipAddress
 ipAddress string

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

设备信息的提供程序。 可能的值为“DFPFingerPrinting” |“商人”。 如果使用 DFP 指纹 JS 脚本，则必须传递“DFPFingerPrinting”才能使所有数据正确连接。
deviceContextDC
 deviceContextDC string

已弃用：DFP 指纹不再需要。 存储客户的 DFP 指纹会话的数据中心（由 DFP 指纹 JS 脚本提供）。
externalDeviceId
 externalDeviceId string

由商家提供和掌握的客户设备 ID。
externalDeviceType
 externalDeviceType string

客户的设备类型，由商家提供和掌握。 可能的值为“Mobile” |“Computer” |'MerchantHardware' |“Tablet” |“GameConsole”
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp
 merchantTimeStamp date-time

事件的 TimeStamp

返回

结果详细信息

Body
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.UpdateAccountActivity.UpdateAccountResponseWrapper

更新退款信息

操作 ID:
PurchaseProtection_v1_RefundEvent

此事件发送有关之前正在退款的购买交易的信息。 这只是数据引入事件。 许多商家使用批量数据上传发送这些事件

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
refundId
 refundId True string

标识此退款事件的唯一字符串
原因
 reason string

用户提供了原因。 可能的值“FraudRefund” |'CustomerRequest' |“NonFraudRefund”
状态
 status string

可能的值“已批准” |“已拒绝” |“未知”
bankEventTimestamp
 bankEventTimestamp date-time

Bank 的时间戳
量
 amount double

退款金额
货币
 currency string

用于销售价格金额的货币。
userId
 userId string

标识用户的唯一字符串
purchaseId
 purchaseId True string

原始购买 ID
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp
 merchantTimeStamp date-time

事件的 TimeStamp

返回

结果详细信息

Body
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.RefundActivity.RefundResponseWrapper

更新银行授权信息

操作 ID:
PurchaseProtection_v1_BankEvent

此事件传达发送到银行的购买交易是否已获得银行授权或银行费用/结算的批准或拒绝。 这只是数据引入事件

参数

名称 密钥 必需 类型 说明
hosturl
 hostUrl True string

主机 URL
内容类型
 Content-Type True string

application/json
相关 ID
 x-ms-correlation-id string

在跟踪运行时问题时，每个请求 Correlation-Id 一个未经请求的帮助。
环境 ID
 x-ms-dfpenvid string

EnvironmentId
bankEventId
 bankEventId True string

标识此银行事件的唯一字符串
类型
 type True string

银行事件类型。 可能的值“Auth” |“AuthCancel” |'ChargeReversal' |“Charge”
bankEventTimestamp
 bankEventTimestamp date-time

Bank 的时间戳
状态
 status string

可能的值“已批准” |“未知” |“已拒绝”
bankResponseCode
 bankResponseCode string

响应时银行代码
paymentProcessor
 paymentProcessor string

处理器名称。 可能的值“FDC” |“Adyen” |'TSYS' |'WorldPay' |'Chase' |'Stripe' |“PayPal”
mrn
 mrn string

商家参考编号，用于从商家端识别交易
mid
 mid string

发送给银行的商家 ID（MID）和/或从中收到。
merchantPaymentInstrumentId
 merchantPaymentInstrumentId string

付款方式的标识符。 此信息由商家提供。
paymentMethod
 paymentMethod string

付款方式的分组/类别。 可能的值为 CARD、CASH、DIRECTDEBIT、E-WALLET、MOBILE、E-BANKING、INVOICE、VOUCHERS
cardType
 cardType string

付款类型。 可能的值为 VISA、万事达卡、AMEX、ACH、SEPA、银联、INICIS、MOBILEBILLINGCARRIER、DISCOVER、ALLPAY、JCB、DISCOVERDINERS
updatedPI
 updatedPI boolean

使用的 PI 不同于购买中的 PI
cvvVerify
 cvvVerify string

指示 CVV 验证是否可用，以及/或已成功验证。 Y = 已成功验证，N = 未成功验证，U = 不可用，A = 可用，但没有验证
avsVerify
 avsVerify string

指示加载项验证是否可用，以及/或成功验证。 Y = 已成功验证，N = 未成功验证，U = 不可用，A = 可用，但没有验证
cavVerify
 cavVerify string

指示持卡人身份验证验证是否可用，以及/或已成功验证。 Y = 已成功验证，N = 未成功验证，U = 不可用，A = 可用，但没有验证
authResultCode
 authResultCode string

授权决定的银行响应。 可能的值为“批准”、“拒绝”、“挂起”
authResultText
 authResultText string

授权决定的原因;尤其是对于已拒绝或挂起的事务。 可能的值为MISMATCH_CVV、MISMATCH_ADDRESS、MISMATCH_EXPIRATIONDATE、NOACCOUNT、INVALIDPIN、LOWFUND、OVERLIMIT SUSPICIOUSACCOUNT
purchaseId
 purchaseId True string

标识购买的唯一字符串
isThreeDSAuth
 isThreeDSAuth boolean

一个 True/False 值，该值指示此事务是否通过 3DS 进行身份验证。
messageCategory
 messageCategory string

标识特定用例的消息类别。 接受的值：01 = PA，02 = NPA，03-79 = 保留用于 EMVCo 的未来使用（值无效，直到 EMVCo 定义），80-99 = 为 DS 使用保留
deviceChannel
 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 = 请求质询 （如果需要质询时请求的允许列表提示）
threeRIInd
 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
 transStatus string

指示事务是限定为经过身份验证的事务还是帐户验证。 接受的值：Y = 身份验证验证成功，N = 未进行身份验证，帐户未验证;事务被拒绝，U = 身份验证，无法执行帐户验证;技术或其他问题，如 ARes 或 RReq 中所示，A = 正在执行的尝试处理;未通过身份验证、已验证，但提供了尝试身份验证的证明、验证、C = 要求质询;需要使用 CReq、CRes、D = 要求质询;已确认分离身份验证，R = 身份验证，帐户验证被拒绝;颁发者拒绝身份验证、验证并请求未尝试授权，I = 仅信息性;已确认 3DS 请求者质询首选项。
transStatusReason
 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 使用保留
threeDSCompInd
 threeDSCompInd string

指示 3DS 方法是否已成功完成。 接受的值：Y = 成功完成，N = 未成功完成，U = Unavailabl 3DS 方法 URL 不存在于与持卡人帐号关联的卡范围的 PRes 消息数据中。
acsChallengeMandated
 acsChallengeMandated string

指示由于局部/地区授权或其他变量，是否需要对交易提出质询。 接受的值：Y = 强制要求质询，N = 未授权质询
eci
 eci string

电子商务指标（ECI）。 ACS 或 DS 提供的付款系统特定值，用于指示尝试对持卡人进行身份验证的结果。 接受的值： 02 （万事达卡）/05 （Visa）= 成功身份验证 01 （万事达卡）/06/07 （Visa） = 所有其他值
shipNameIndicator
 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
 exemptionRaised string

PSD2 豁免请求，Y - 豁免，N - 未免除
suspiciousAccActivity
 suspiciousAccActivity string

指示 3DS 请求者是否在持卡人帐户上遇到可疑活动（包括以前的欺诈）。 接受的值：01 = 未观察到可疑活动，02 = 观察到可疑活动
trackingId
 trackingId string

事件的 TrackingId
merchantTimeStamp
 merchantTimeStamp date-time

事件的 TimeStamp

返回

结果详细信息

Body
Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.BankEventActivity.BankEventResponseWrapper

定义

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountCreateEnrichment

类表示帐户创建评估的扩充功能

名称 路径 类型 说明
deviceAttributes
 deviceAttributes Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.DeviceAttributes

一个类，表示派生自用户设备属性的功能。
calculatedFeatures
 calculatedFeatures Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.CalculatedFeatures

表示评估期间计算的特征的类

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountCreateResponseSuccessDetails

Dynamics 欺诈保护 AccountCreate API 的响应对象

名称 路径 类型 说明
姓名
 name string

N/A
版本
 version string

N/A
代码
 code string

N/A
描述
 description string

N/A
resultDetails
 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

表示扩充功能的类

名称 路径 类型 说明
deviceAttributes
 deviceAttributes Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.DeviceAttributes

一个类，表示派生自用户设备属性的功能。

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.CalculatedFeatures

表示评估期间计算的特征的类

名称 路径 类型 说明
emailDomain
 emailDomain string

从评估有效负载分析的电子邮件域
emailPattern
 emailPattern string

从电子邮件计算的电子邮件句柄模式。 电子邮件前缀中的所有大写字母都替换为“U”，小写字母替换为“I”，数字替换为“d”。 重复的“I”和“U”已折叠，其余字符保持不变。 例如，电子邮件“kAyla.277@contoso.com”将返回电子邮件模式“lUl.d”

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.DeviceAttributes

一个类，表示派生自用户设备属性的功能。

名称 路径 类型 说明
trueIp
 trueIp string

设备指纹标识的设备的真实 IP 地址
proxyIp
 proxyIp string

设备指纹标识的设备代理的代理 IP 地址
realtimeTimezoneOffset
 realtimeTimezoneOffset string

考虑夏令时计划的时区偏移量
sld
 sld string

与真实 IP 相关的第二级域
timeZone
 timeZone string

格林威治平均时间的时区偏移量
proxyLastDetected
 proxyLastDetected string

将设备 IP 标识为活动代理的最近日期
deviceId
 deviceId string

设备指纹生成的唯一 deviceid
deviceCountryCode
 deviceCountryCode string

真实 IP 的设备位置国家/地区
deviceState
 deviceState string

真实 IP 的设备位置状态
deviceCity
 deviceCity string

真实 IP 的设备位置城市
devicePostalCode
 devicePostalCode string

真实 IP 的设备位置邮政编码
deviceAsn
 deviceAsn string

设备指纹标识的设备 ASN
平台
 platform string

设备的作系统平台
browserUserAgentLanguages
 browserUserAgentLanguages string

存储在用户代理中的语言
browserUserAgent
 browserUserAgent string

会话中使用的浏览器
tcpDistance
 tcpDistance string

连接中的网络跃点数
运营商
 carrier string

标识的真实 IP 的 ISP
ipRoutingType
 ipRoutingType string

IP 的路由类型
代理
 proxy string

确定调用方是否为代理的标志
proxyType
 proxyType string

检测到代理的类型
userAgentPlatform
 userAgentPlatform string

浏览器版本
userAgentBrowser
 userAgentBrowser string

浏览器系列
userAgentOperatingSystem
 userAgentOperatingSystem string

操作系统版本
sdkType
 sdkType string

设备用于进行呼叫的 SDK（Android、iOS 或 Web）
dataNetworkType
 dataNetworkType string

所使用的网络类型（Wifi 或移动）。 对于 Android 和 iOS 设备。
localIpv4
 localIpv4 string

设备的本地 IPV4 地址。 对于 Android 和 iOS 设备。
isDeviceEmulator
 isDeviceEmulator string

指示设备是否模拟。 对于 Android 和 iOS 设备。
isDeviceRooted
 isDeviceRooted string

指示设备是否已根。 对于 Android 和 iOS 设备。
isWifiEnabled
 isWifiEnabled string

指示设备的 wifi 是启用或禁用的。 对于 Android 设备。
deviceSystemVersion
 deviceSystemVersion string

作系统的当前版本。 对于 iOS 设备。
deviceModelName
 deviceModelName string

设备型号名称。 对于 iOS 设备。
localIpv6
 localIpv6 string

设备的本地 IPV6 地址。 对于 iOS 设备。

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccess

Dynamics 欺诈保护成功对象

名称 路径 类型 说明
姓名
 name string

N/A
版本
 version string

N/A
代码
 code string

N/A
描述
 description string

N/A

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccessDetails

Dynamics 欺诈保护 API 的响应对象

名称 路径 类型 说明
姓名
 name string

N/A
版本
 version string

N/A
代码
 code string

N/A
描述
 description string

N/A
resultDetails
 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

AssessmentResultDetail

名称 路径 类型 说明
决定
 decision string

决策的类型
challengeType
 challengeType string

挑战的类型
原因
 reasons array of string

原因列表
规则
 rule string

有效负载匹配的规则
clauseName
 clauseName string

做出决定的规则子句友好名称
supportMessages
 supportMessages array of string

支持决策的消息列表
other
 other object

任何其他数据
分数
 scores array of Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.Score

不同分数的列表
ruleEvaluations
 ruleEvaluations array of Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.RuleEvaluation

协商的规则集的路径，以达到这一决定

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.RuleEvaluation

在指向 a 的路上执行规则集的记录

名称 路径 类型 说明
规则
 rule string

规则集的友好名称
clauseNames
 clauseNames array of string

该规则的子句按顺序触发，最后一个是最后的嘲讽达到

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.Score

Score 对象

名称 路径 类型 说明
scoreType
 scoreType string

评分类型
scoreValue
 scoreValue double

分数值。 最大值为 999
原因
 reason string

评分值的原因

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.BankEventActivity.BankEvent

名称 路径 类型 说明
object

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

结果详细信息

名称 路径 类型 说明
resultDetails
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.BankEventActivity.BankEvent

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.ChargebackActivity.Chargeback

名称 路径 类型 说明
object

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

结果详细信息

名称 路径 类型 说明
resultDetails
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.ChargebackActivity.Chargeback

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.LabelActivity.Label

名称 路径 类型 说明
object

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

结果详细信息

名称 路径 类型 说明
resultDetails
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.LabelActivity.Label

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

结果详细信息

名称 路径 类型 说明
resultDetails
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseActivity.PurchaseWrapper

购买响应有效负载

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseActivity.PurchaseWrapper

购买响应有效负载

名称 路径 类型 说明
riskScore
 riskScore integer

欺诈保护风险模型计算的风险评分范围从 -1 到 1000。 -1 指示确定风险评分的错误。
merchantRuleDecision
 merchantRuleDecision string

在获取交易的风险分数后，商家规则做出的决定。 可能的值“批准” |“拒绝”
ruleEvaluations
 ruleEvaluations array of

包含评估为决定的规则的名称。
clauseName
 clauseName string

包含给出决策的子句的名称。
midFlag
 midFlag string

推荐的商家 ID （MID） 标志。 可能的值“Program” |“Standard” |“Control”
reasonCodes
 reasonCodes string

解释决策的原因代码。
policyApplied
 policyApplied string

导致商家规则决策的商家规则或默认规则的名称。
bankName
 bankName string

DFP 为此交易调用的银行（发行人）。
hashedEvaluationId
 hashedEvaluationId string

由 DFP 计算的 HashedEvaluationId
diagnostics
 diagnostics object

按命名空间键键的诊断对象
purchaseId
 purchaseId string

商家系统中的交易（或采购订单）标识符。
deviceAttributes
 deviceAttributes object

DFP 指纹中的设备属性
成功
 succeeded string

请求成功

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseStatusActivity.PurchaseStatus

名称 路径 类型 说明
object

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

结果详细信息

名称 路径 类型 说明
resultDetails
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseStatusActivity.PurchaseStatus

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.RefundActivity.Refund

名称 路径 类型 说明
object

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

结果详细信息

名称 路径 类型 说明
resultDetails
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.RefundActivity.Refund

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.UpdateAccountActivity.UpdateAccount

UpdateAccount 响应有效负载

名称 路径 类型 说明
deviceAttributes
 deviceAttributes object

DFP 指纹中的设备属性
成功
 succeeded string

请求成功

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

结果详细信息

名称 路径 类型 说明
resultDetails
 resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.UpdateAccountActivity.UpdateAccount

UpdateAccount 响应有效负载