风险识别 RCE 数据结构

AddPromotionEvent

参加营销活动事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
PromotionId	String	是	营销活动ID 示例值：pro*************01
PromotionName	String	否	营销活动名称示例值：双十一购物节大促活动
Description	String	否	营销活动描述示例值：年度最大促销活动，全场商品享受优惠
InviterUserId	String	否	邀请人ID 示例值：b5********a2
Coupon	Coupon	否	营销活动关联的优惠券
Point	CreditPoint	否	营销活动关联的积分活动
Result	Result	否	参加营销活动结果
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

Address

地址

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Country	String	否	国家参数格式：符合ISO 3166标准示例值：US
Region	String	否	省份示例值：NY
City	String	否	城市示例值：New York
District	String	否	地区示例值：Manhattan
Detail	String	否	详细地址示例值：456 Broadway
ZipCode	String	否	邮政编码示例值：10001

Amount

金额

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Currency	String	是	原始货币类型参数格式：符合ISO 4217标准示例值：USD
OriginalAmount	Float	是	原始金额示例值：299.99
ExchangeRateUSD	Float	否	当前币种对美金的汇率示例值：1
ExchangeRateCNY	Float	否	当前币种对人民币的汇率示例值：7.0413

App

应用程序信息

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
OS	String	否	应用程序运行的移动设备的操作系统类型示例值：ios
OSVersion	String	否	应用程序运行的移动设备的操作系统版本示例值：16.0
DeviceManufacturer	String	否	应用程序运行的移动设备的生产厂商示例值：Apple
DeviceModel	String	否	应用程序运行的移动设备的型号示例值：iPhone 14 Pro
DeviceId	String	否	应用程序运行的移动设备的唯一ID，对于iOS为IFV标识，对于Android为Android ID 示例值：de*************23
AppName	String	否	应用程序名称示例值：MyShoppingApp
AppVersion	String	否	应用程序版本示例值：3.2.1
ClientLanguage	String	否	应用程序提供的语言示例值：zh-CN

AssessDeviceRiskPremiumRsp

设备风险评估高级版返回结果

被如下接口引用：AssessDeviceRiskPremiumPro。

名称	类型	描述
Decision	Decision	决策信息
Score	DataScore	设备风险分信息
Device	Device	设备基础信息
Environment	Environment	IP环境基础信息注意：此字段可能返回 null，表示取不到有效值。

AssessDeviceRiskRsp

设备风险评估基础版返回结果

被如下接口引用：AssessDeviceRiskPro。

名称	类型	描述
Score	DataScore	设备风险分信息
Device	Device	设备基础信息
Environment	Environment	IP环境基础信息注意：此字段可能返回 null，表示取不到有效值。

AssessEnvironmentRiskRsp

环境风险评估返回结果

被如下接口引用：AssessEnvironmentRisk。

名称	类型	描述
Score	DataScore	IP环境风险分信息
Environment	Environment	IP环境基础信息

AssessRiskRsp

事件风险评估返回结果

被如下接口引用：AssessRisk。

名称	类型	描述
Decision	Decision	决策信息
Score	Score	风险分，根据您开启的产品服务计算的评分结果
ExtraInfo	Array of Cust	扩展信息注意：此字段可能返回 null，表示取不到有效值。

Billing

账单信息

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Address	Address	否	账单地址
Phone	String	否	账单联系电话参数格式：符合E.164标准的带“+”、地区编码和号码的格式示例值：+86131********
Email	String	否	账单邮箱示例值：***************.com
Recipient	String	否	账单接收人姓名示例值：Zh******n

BrowseEvent

浏览事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
PageType	String	否	当前浏览网页的类型，例如主页、搜索页等示例值：主页
PageUrl	String	否	当前浏览的网页URL 示例值：http://*********.com
Duration	Integer	否	浏览耗时单位：毫秒示例值：50
ContentType	String	否	网页内容类型，例如广告、视频、文章等示例值：文章
ContentId	String	否	网页内容ID 示例值：550e8400-**--**-446655440000
ReferPageType	String	否	上一个网页的类型，例如主页、搜索页等示例值：搜索页
ReferPageUrl	String	否	上一个网页URL 示例值：http://****.com
GuestId	String	否	游客账号ID 示例值：oUp*******************6o
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

Browser

浏览器信息

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
UserAgent	String	否	与网站交互的浏览器的用户代理示例值：Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
AcceptLanguage	String	否	浏览器支持的用户请求语言参数格式：符合ISO 3166标准示例值：zh-CN,zh;q=0.9,en;q=0.8
ContentLanguage	String	否	浏览器当前网站内容的语言参数格式：符合ISO 3166标准示例值：zh-CN

名称

类型

必选

描述

UserAgent

String

否

与网站交互的浏览器的用户代理

示例值：Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36

AcceptLanguage

String

否

浏览器支持的用户请求语言

参数格式：符合ISO 3166标准

示例值：zh-CN,zh;q=0.9,en;q=0.8

ContentLanguage

String

否

浏览器当前网站内容的语言

参数格式：符合ISO 3166标准

示例值：zh-CN

Card

银行卡

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
CardBin	String	是	发卡行识别码卡号前6位参数格式：符合ISO 13616-1标准示例值：C*****
LastFourDigits	String	是	发卡行识别码卡号后4位参数格式：符合ISO 13616-1标准示例值：1**2
Country	String	否	发行国家示例值：US
Bank	String	否	发行银行示例值：Chase Bank
Type	String	否	支付卡类型枚举值： credit：信用卡 debit：借记卡 charge：签账卡示例值：credit
Brand	String	否	支付卡品牌示例值：Visa
Level	String	否	支付卡等级示例值：Platinum
HolderName	String	否	持有者姓名示例值：ZH******
ExpireTime	String	否	过期日期参数格式：YYYY-MM-DD 示例值：2028-12-31

ChargeBackEvent

拒付事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
TransactionId	String	是	交易ID 示例值：tr**************01
OrderId	Array of String	是	订单 ID，当一笔交易关联多个订单（合并支付）时请输入所有订单ID 示例值：["13********34"]
ChargeBackCode	String	是	拒付理由码，参考各卡组织定义的拒付码，例如：10.1、13.1、 4870、4871等示例值：4871
ChargeBackReason	String	是	拒付原因，参考各卡组织定义的拒付原因，例如：未收到商品、欺诈等示例值：fraud
ChargeBackProcess	String	否	拒付申诉阶段枚举值： need_response：需要商家回应 information_supplied：商家已提供信息 chargeback_reversed：拒付已撤销 chargeback_sustained：拒付已成立示例值：need_response
ChargeBackAmount	Amount	否	拒付金额
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

ClaimRedPacketEvent

领红包事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
PromotionId	String	否	营销活动ID 示例值：CA**********86
PromotionName	String	否	营销活动名称示例值：夏日狂欢邀新领红包
Description	String	否	营销活动描述示例值：邀请好友完成首单，双方各得红包奖励
InviterUserId	String	否	邀请人ID 示例值：U******27
RedPacketId	String	否	红包ID 示例值：RP********5
RedPacketType	String	否	红包类型，如手气红包、口令红包、均分红包等示例值：均分红包
RedPacketAmount	Amount	否	红包金额
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

Coupon

优惠券

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
CouponId	String	否	优惠券ID 示例值：C*********01
CouponName	String	否	优惠券名称示例值：全场八折优惠券
StartTime	String	否	优惠券开始时间参数格式：符合ISO 8601标准的带UTC时区的毫秒级时间示例值：2026-01-01T00:00:00.000+08:00
ExpireTime	String	否	优惠券过期时间参数格式：符合ISO 8601标准的带UTC时区的毫秒级时间示例值：2026-01-01T23:59:59.999+08:00
PercentageRate	Float	否	折扣百分比，如果折扣为 10%，则发送“0.1” 示例值：0.2
DiscountAmount	Amount	否	折扣金额
Threshold	Float	否	优惠券门槛示例值：300

CreateOrderEvent

创建订单事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
OrderId	String	是	订单ID 示例值：OI*********th
Amount	Amount	是	订单金额
Merchant	Merchant	是	商家信息
Billing	Billing	否	账单信息
Items	Array of Item	否	商品信息
Delivery	Delivery	否	物流信息
Promotions	Array of Promotion	否	营销活动信息
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

CreditPoint

账号积分

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Point	Float	是	积分分值示例值：10
PointType	String	是	积分类型示例值：credit_point

Cust

与RCE约定的定制化参数，K:V 格式的对象数组

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Key	String	否	标识符示例值：registration_channel
Value	String	否	数据注意：此字段可能返回 null，表示取不到有效值。示例值：web

CustEvent

自定义事件

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

DataAuthorization

数据授权信息

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
DataProviderName	String	否	数据委托方，客户主体名称示例值：**公司
DataRecipientName	String	否	数据受托方，腾讯云主体名称，固定填：腾讯云计算（北京）有限责任公司示例值：腾讯云计算（北京）有限责任公司
UserDataType	Array of Integer	否	客户请求RCE所提供的用户数据类型，支持多选枚举值： 1：手机号 2：微信开放账号 3： QQ开放账号 4： IP地址 5： URL网址 999：其他示例值：[4]
IsAuthorized	Boolean	否	客户是否已按合规指南要求获取用户授权，同意客户委托腾讯云处理入参信息枚举值： true：已授权 false：未授权示例值：true
IsOrderHanding	Boolean	否	客户是否已按合规指南要求获取用户授权，同意腾讯云结合客户提供的信息，对已合法收集的用户数据进行必要处理得出服务结果，并返回给客户枚举值： true：已授权 false：未授权示例值：true
AuthorizationDeadline	Integer	否	客户获得的用户授权期限Unix时间戳（单位秒），不填默认无固定期限示例值：1793070635
PrivacyPolicyLink	String	否	客户获得用户授权所依赖的协议地址示例值：http:*********.com

DataScore

风险分信息

被如下接口引用：AssessDeviceRiskPremiumPro, AssessDeviceRiskPro, AssessEnvironmentRisk。

名称	类型	描述
RiskLevel	Integer	风险等级示例值：1
RiskLabels	Array of RiskLabel	风险标签
RiskScore	Integer	综合风险分数。取值范围：[1, 1000] 数值越大，风险越大。注意：此字段可能返回 null，表示取不到有效值。示例值：150

名称

类型

描述

RiskLevel

Integer

风险等级

示例值：1

RiskLabels

Array of RiskLabel

风险标签

RiskScore

Integer

综合风险分数。

取值范围：[1, 1000]

数值越大，风险越大。

注意：此字段可能返回 null，表示取不到有效值。
示例值：150

Decision

决策信息

被如下接口引用：AssessDeviceRiskPremiumPro, AssessRisk。

名称	类型	描述
DecisionResult	String	决策结果 pass：通过 review：复审 reject：拒绝示例值：pass
Disposition	String	命中策略后的决策动作，可在控制台配置注意：此字段可能返回 null，表示取不到有效值。示例值：通过

名称

类型

描述

DecisionResult

String

决策结果

pass：通过
review：复审
reject：拒绝

示例值：pass

Disposition

String

命中策略后的决策动作，可在控制台配置

注意：此字段可能返回 null，表示取不到有效值。
示例值：通过

Delivery

物流信息

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
DeliveryMethod	String	否	物流方式 physical：物理投送 electonic：电子投送示例值：physical
DeliveryAmount	Amount	否	物流费用
DeliveryAddress	Address	否	收货地址
ConsigneePhone	String	否	收货人电话参数格式：符合E.164标准的带“+”、地区编码和号码的格式示例值：+86131********
ConsigneeEmail	String	否	收货人邮箱示例值：***************.com
ConsigneeName	String	否	收货人姓名示例值：李*
Expedited	Boolean	否	是否加急示例值：true
DeliveryCarrier	String	否	物流厂商，一般是物流的公司示例值：顺丰速运
DeliveryTracking	String	否	物流追踪单号示例值：SF12******90

Device

设备基础信息

被如下接口引用：AssessDeviceRiskPremiumPro, AssessDeviceRiskPro。

名称	类型	描述
DeviceId	String	设备ID 示例值：30****************087270
AppVersion	String	App版本信息示例值：1.0.8
Brand	String	品牌示例值：OP**
ClientIp	String	客户端IP 示例值：43.*.*.20
Model	String	机型示例值：PC****
NetworkType	String	网络类型示例值：4g
PackageName	String	应用包名示例值：com.h5.test
Platform	String	平台枚举值： 2： Android 3： IOS 4： H5 5：微信小程序示例值：4
SystemVersion	String	系统版本示例值：10.0.0
SdkBuildVersion	String	SDK版本示例值：200700
SignToken	String	验签token，验签功能启用请联系我们。示例值：-75016888***Ux8XhJzSTZI=
TokenTime	String	token生成时间戳，毫秒级。示例值：1785490616309

DigitalOrder

数字订单

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
DigitalAsset	String	否	数字资产示例值：BTC
AssetType	String	否	数字资产类型枚举值： coin：代币 commodity：大宗商品 crypto：加密货币 fiat：法币 token：通证 stock：股票 bond：债券示例值：crypto
OrderType	String	否	订单类型枚举值： limit：限价单 market：市价单 stop_limit：止损限价单 stop_loss：止损单 take_profit：止盈单 take_profit_limit：止盈限价单示例值：limit
Volume	Float	否	数字资产的数量示例值：0.5

Environment

环境基础信息

被如下接口引用：AssessDeviceRiskPremiumPro, AssessDeviceRiskPro, AssessEnvironmentRisk。

名称	类型	描述
Location	IPLocation	IP地理位置信息
Network	IPNetwork	IP基础网络信息

EventDetail

事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Login	LoginEvent	否	登录
Register	RegisterEvent	否	注册（变更用户信息）
CreateOrder	CreateOrderEvent	否	创建订单
Transaction	TransactionEvent	否	交易支付
Sms	SMSEvent	否	短信
ChargeBack	ChargeBackEvent	否	拒付
Logout	LogoutEvent	否	登出
ModifyAccount	ModifyAccountEvent	否	修改账号
ModifyPassword	ModifyPasswordEvent	否	修改密码
SecurityVerification	SecurityVerificationEvent	否	安全验证
AddPromotion	AddPromotionEvent	否	参加营销活动
Redeem	RedeemEvent	否	兑奖
Withdraw	WithdrawEvent	否	提现
CustEvent	CustEvent	否	自定义事件
ScanCode	ScanCodeEvent	否	扫码
LuckyDraw	LuckyDrawEvent	否	抽奖
Task	TaskEvent	否	做任务
Invitation	InvitationEvent	否	邀请
ClaimRedPacket	ClaimRedPacketEvent	否	领红包
Browse	BrowseEvent	否	浏览

IPLocation

IP地理位置信息

被如下接口引用：AssessDeviceRiskPremiumPro, AssessDeviceRiskPro, AssessEnvironmentRisk。

名称	类型	描述
Country	String	IP地址所属国家示例值：BR
Region	String	IP地址所属省份示例值：Espírito Santo
City	String	IP地址所属城市示例值：Guarapari
District	String	IP地址所属地区示例值：Todos os Santos
Longitude	String	IP地址的经度示例值：*.36
Latitude	String	IP地址的纬度示例值：*.*136
Timezone	String	IP地址所属时区示例值：UTC-3
ZipCode	String	IP地址的邮政编码示例值：29200-080

IPNetwork

IP基础网络信息

被如下接口引用：AssessDeviceRiskPremiumPro, AssessDeviceRiskPro, AssessEnvironmentRisk。

名称	类型	描述
ISP	String	互联网服务提供商示例值：Telefonica
ASN	String	自治系统号示例值：18881
Organization	String	IP注册组织名称示例值：Telefonica
IsReserved	Boolean	是否保留IP 示例值：false
IsGateway	Boolean	是否网关IP 示例值：false
IsAnycast	Boolean	是否任播网络示例值：false
IsMobile	Boolean	是否移动网络示例值：false
IsDynamic	Boolean	是否动态IP 示例值：false
IsEgress	Boolean	是否网络出口示例值：false
IsDNS	Boolean	是否域名解析示例值：false
IsEducation	Boolean	是否教育机构示例值：false
IsInstitution	Boolean	是否组织机构示例值：false
IsCompany	Boolean	是否企业专线示例值：false
IsResidence	Boolean	是否家用宽带示例值：false
IsCloudService	Boolean	是否云服务示例值：false
IsInfrastructure	Boolean	是否基础设施示例值：false
IsMXServer	Boolean	是否邮箱服务示例值：false

InvitationEvent

邀请事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
InviteeUserId	String	是	受邀请人ID 示例值：U*********04
PromotionId	String	否	营销活动ID 示例值：CA**********86
PromotionName	String	否	营销活动名称示例值：夏日狂欢老带新立减20元
Description	String	否	营销活动描述示例值：邀请好友完成首单，邀请人可得20元无门槛优惠券
InviteePhone	String	否	受邀请人电话号码参数格式：符合E.164标准的带“+”、地区编码和号码的格式示例值：+86138********
InvitationCode	String	否	邀请码示例值：IN*********2P
InvitationUrl	String	否	邀请链接示例值：https://*******************************2P
InvitationChannel	String	否	邀请渠道，如微信、抖音、小红书等示例值：WeChat
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

Inviter

邀请人信息

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
InviterUserId	String	是	邀请人ID 示例值：ub****x
InviterPhone	String	否	邀请人电话号码参数格式：符合E.164标准的带“+”、地区编码和号码的格式示例值：+86131********
InviteCode	String	否	邀请码示例值：INV*****4
InviteChannel	String	否	邀请渠道示例值：微信好友

Item

商品信息

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
ItemId	String	是	商品ID 示例值：c509************************20dc
ItemName	String	否	商品名称示例值：Bear doll
Category	String	否	商品类别示例值：toy
Price	Amount	否	商品单价
UPC	String	否	如果商品有UPC码（Universal Product Code），请提供示例值：96782361357
EAN	String	否	如果商品有EAN码（European Article Number），请提供示例值：12345231953
SKU	String	否	如果商品有SKU码（Stock Keeping Unit），请提供示例值：TOY-BLACK-1554
ISBN	String	否	如果商品有ISBN码（International Standard Book Number ），请提供示例值：1425546
Brand	String	否	商品品牌示例值：July
Quantity	Integer	否	商品数量示例值：1
Manufacturer	String	否	生产厂商示例值：Ford Toy Company
Tags	String	否	商品标签示例值：funny,doll

LoginEvent

登录事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
UserInfo	User	否	用户基础信息
UserLoginName	String	否	用户登录时输入的用户名示例值：u_dscv
LoginResult	Result	否	登录结果
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

LogoutEvent

登出事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
UserInfo	User	否	用户基础信息
UserLoginName	String	否	用户登录时输入的用户名示例值：zh*********90
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

LuckyDrawEvent

抽奖事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
PromotionId	String	否	营销活动ID 示例值：CA**********86
PromotionName	String	否	营销活动名称示例值：夏日狂欢幸运大转盘
Description	String	否	营销活动描述示例值：完成每日任务即可获得抽奖机会
InviterUserId	String	否	邀请人ID 示例值：U*******7
LuckyDrawCount	Integer	否	抽奖次数单位：次数示例值：3
LuckyDrawType	String	否	抽奖类型示例值：TURN_TABLE
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

Merchant

商家信息

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
MerchantId	String	是	商家ID 示例值：M****
Name	String	否	商家名称示例值：July's Toy
RegisterTime	String	否	商家的注册时间参数格式：符合ISO 8601标准的带UTC时区的毫秒级时间示例值：2023-01-01T10:00:00.000+08:00
Category	String	否	商家类别代码参数格式：符合ISO 18245标准的4位编号示例值：5945
Phone	String	否	商家电话参数格式：符合E.164标准的带“+”、地区编码和号码的格式示例值：+86131********
Email	String	否	商家邮件示例值：****************.com
URL	String	否	商家店铺网址示例值：https://julytoy.com
Address	Address	否	商家地址
Level	String	否	商家等级示例值：金牌商家
BusinessType	String	否	经营类型枚举值： person：个人 company：企业示例值：person
GoodsQuantity	Integer	否	商家在售商品数量示例值：10
HistoricSalesQuantity	Integer	否	商家历史销售数量示例值：500
HistoricSalesAmount	Amount	否	商家历史销售总额

ModifyAccountEvent

修改账号事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
UserInfo	User	否	用户基础信息
Person	Person	否	用户填写的个人信息
BillingAddress	Address	否	用户填写的账单地址
DeliveryAddress	Address	否	用户填写的收货地址
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

ModifyPasswordEvent

修改密码事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Reason	String	否	修改原因枚举值： user_modify：用户主动修改 forgot_password：忘记密码 forced_reset：系统强制重置示例值：user_modify
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

名称

类型

必选

描述

Reason

String

否

修改原因

枚举值：

user_modify：用户主动修改
forgot_password：忘记密码
forced_reset：系统强制重置

示例值：user_modify

Cust

Array of Cust

否

与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

Order

订单信息

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
OrderId	String	是	订单ID 示例值：20*************01
Amount	Amount	是	订单金额
Items	Array of Item	否	商品信息
Delivery	Delivery	否	物流信息

PaymentMethod

支付方式，支持多种支付方式

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
PaymentType	String	是	支付方式枚举值： cash：现金 check：支票 credit_card：信用卡 debit_card：借记卡 crypto_currency：加密货币 digital_wallet：数字钱包 gift_card：礼品卡 points：积分 in_app_purchase： APP内购买 electronic_fund_transfer：电子资金转账 financing：融资 invoice：发票 prepaid_card：预付卡 sepa_credit： SEPA信用转账示例值：credit_card
PaymentChannel	String	否	支付渠道示例值：stripe
Card	Card	否	银行卡信息，当用支付方式是credit_card、debit_card时必填
SEPADirectDebitMandate	Boolean	否	SEPA直接借记授权枚举值： true：是 false：否示例值：true
DigitalWallet	Wallet	否	数字钱包

PaymentResult

支付结果

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Status	String	是	支付状态枚举值： success：成功 failure：失败示例值：failure
FailureReason	String	否	支付失败原因示例值：交易被拒
ThreeDomainSecure	Boolean	否	是否使用3DS，枚举值：是：true 否：false 示例值：true
ECICode	String	否	ECI返回码示例值：05
AVSCode	String	否	AVS响应结果（地址验证）示例值：Y
CVCCode	String	否	CVC验证结果（交易真实性验证）示例值：M

Person

个人信息

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Name	String	否	姓名全称示例值：Tom Smith
Gender	String	否	性别示例值：male
Birthday	String	否	出生日期参数格式：YYYY-MM-DD 示例值：1990-10-01
Degree	String	否	学历示例值：bachelor
Occupation	String	否	职业示例值：engineer

Promotion

营销活动

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
PromotionId	String	是	营销活动ID 示例值：p******01
PromotionName	String	否	营销活动名称示例值：注册福利
Description	String	否	营销活动描述示例值：2026新用户注册福利
InviterUserId	String	否	邀请人ID 示例值：e0*****b
Coupon	Coupon	否	优惠券
CreditPoint	CreditPoint	否	积分

PromotionCode

营销活动码

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Id	String	是	活动码ID 示例值：A8******M5
Type	String	否	活动码类型，例如：qrcode-二维码、barcode-条形码、miniprogram_code-小程序码示例值：qrcode
ImageLink	String	否	活动码图片URL或链接示例值：https://********************************
Address	Address	否	营销活动码使用地址
Items	Array of Item	否	营销活动码关联的商品

RedeemEvent

兑奖事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
PromotionId	String	是	营销活动ID 示例值：pro*************01
PromotionName	String	否	营销活动名称示例值：双十一购物节大促活动
Description	String	否	营销活动描述示例值：年度最大促销活动，全场商品享受优惠
InviterUserId	String	否	邀请人ID 示例值：b5********a2
Order	Order	否	兑奖关联的订单信息
Result	Result	否	兑奖结果
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

RegisterEvent

注册事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
RegisterResult	Result	否	注册结果
UserInfo	User	否	用户基础信息
Person	Person	否	用户注册时填写的个人信息
BillingAddress	Address	否	用户注册时填写的账单地址
DeliveryAddress	Address	否	用户注册时填写的收货地址
Inviter	Inviter	否	邀请人信息
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

Result

事件结果

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Status	String	是	实际是否完成状态枚举值： success：成功 failure：失败示例值：failure
FailureReason	String	否	失败原因示例值：登录用户名或密码错误

名称

类型

必选

描述

Status

String

是

实际是否完成状态

枚举值：

success：成功
failure：失败

示例值：failure

FailureReason

String

否

失败原因

示例值：登录用户名或密码错误

RiskLabel

风险标签

被如下接口引用：AssessDeviceRiskPremiumPro, AssessDeviceRiskPro, AssessEnvironmentRisk, AssessRisk。

名称	类型	描述
Id	String	风险ID 示例值：202008
Reason	String	风险描述示例值：Network Attack IP

SMSEvent

短信事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
UserInfo	User	否	用户基础信息
SMSId	String	否	本次短信发送标识 ID 示例值：sms_***********01
ReceivedTime	String	否	用户实际完成验证码时间参数格式：符合ISO 8601标准的带UTC时区的毫秒级时间示例值：2026-07-07T11:07:31.000+08:00
Action	String	否	记录用户收到短信的动作 no_action：用户无动作 safe：用户确认本人操作 compromised：用户反馈为第三方操作示例值：no_action
SMSResult	Result	否	短信回执结果
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

ScanCodeEvent

扫码事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
PromotionCode	PromotionCode	是	营销活动码
PromotionId	String	否	营销活动ID 示例值：CA**********86
PromotionName	String	否	营销活动名称示例值：夏日狂欢老带新立减20元
Description	String	否	营销活动描述示例值：邀请好友完成首单，邀请人可得20元无门槛优惠券
InviterUserId	String	否	邀请人ID 示例值：U*******7
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

Score

风险分

被如下接口引用：AssessRisk。

名称	类型	描述
RiskScore	Integer	风险分值，范围[1, 1000]，分值越大，风险越高示例值：20
RiskLabels	Array of RiskLabel	风险标签

SecurityVerificationEvent

安全验证事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
VerificationEvent	String	是	安全验证所处的事件类型枚举值： register：注册 login：登录 modify_account：修改账号 modify_password：修改密码 create_order：创建订单 transaction：交易支付 modify_order：修改订单 withdraw：提现 add_promotion：参加营销活动 redeem：兑奖示例值：add_promotion
VerificationType	String	是	安全验证类型，sms-短信、phone_call-电话、email-邮件、captcha-验证码、shared_knowledge-共享知识、face-人脸、fingerprint-指纹等示例值：sms
VerificationContent	String	否	安全验证的内容，例如：用于验证的电话号码、邮件、验证码或者问题，当安全验证类型是sms、phone_call、email、captcha、shared_knowledge时输入示例值：+86138********
VerificationResult	Result	否	安全验证结果
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

TaskEvent

做任务事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
PromotionId	String	否	营销活动ID 示例值：CA**********86
PromotionName	String	否	营销活动名称示例值：夏日狂欢积分大放送
Description	String	否	营销活动描述示例值：完成指定任务可获得双倍积分
InviterUserId	String	否	邀请人ID 示例值：U*******7
TaskId	String	否	任务ID 示例值：TA******12
TaskName	String	否	任务名称示例值：每日签到打卡
TaskType	String	否	任务类型，如签到打卡、观看广告、累计步数等示例值：签到打卡
TaskCostTime	Integer	否	任务完成耗时单位：毫秒示例值：5000
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

TransactionEvent

交易事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
TransactionId	String	是	交易唯一标识示例值：tx******************01
OrderId	Array of String	是	您系统中的订单 ID，当一笔交易关联多个订单（合并支付）时请输入所有订单ID 示例值：["OI**********h"]
PaymentAmount	Amount	是	交易金额
PaymentMethod	PaymentMethod	是	支付方式，支持多种支付方式
TransactionType	String	否	交易类型枚举值： sale：一次性完成授权与扣款（最常见） authorize：仅授权（冻结金额） capture：执行扣款（在授权后） void：取消待处理的授权或扣款 refund：退款（部分或全部） deposit：向账户存款 withdrawal：从账户提现 transfer：账户间转账 buy：购买资产（如加密货币） sell：出售资产 send：发送资金/资产（如跨钱包转账） receive：接收资金/资产默认值：sale 示例值：sale
Billing	Billing	否	账单信息
Delivery	Delivery	否	物流信息
Merchant	Merchant	否	商家信息
PaymentResult	PaymentResult	否	支付结果
TransferRecipientUserId	String	否	接收方的用户ID，适用于 transfer 交易类型示例值：re*************89
TransferSentAddress	Address	否	发送方的物理地址，适用于 transfer 交易类型
TransferReceivedAddress	Address	否	接收方的物理地址，适用于 transfer 交易类型
DigitalOrders	Array of DigitalOrder	否	数字订单列表
ReceiverWallet	Wallet	否	接收加密货币的钱包
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

User

账号信息

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
UserLevel	String	否	用户等级示例值：golden
UserPoint	CreditPoint	否	用户积分
UserType	String	否	用户类型示例值：person

Wallet

数字钱包

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
WalletType	String	是	钱包类型枚举值： crypto：加密货币 digital：数字货币 fiat：法币示例值：crypto
WalletAddress	String	是	钱包地址，通常为钱包的唯一标识示例值：0x74******************c1
WalletHolderName	String	否	钱包归属人姓名示例值：Li**
WalletProvider	String	否	钱包供应商，wechat、alipay、paypal等示例值：metamask

WithdrawEvent

提现事件详情

被如下接口引用：AssessRisk, ReportEvent。

名称	类型	必选	描述
Amount	Amount	是	提现金额
Method	String	是	提现方式枚举值： card：银行卡 wallet：电子钱包示例值：card
Card	Card	否	提现银行卡，当提现方式是card时必填
Wallet	Wallet	否	提现数字钱包，当提现方式是wallet时必填
Result	Result	否	提现结果
Cust	Array of Cust	否	与RCE约定的定制化信息，为K:V 格式的对象数组，示例：[{"Key": "ApproverName", "Value": "bob"},{"Key":"ApproverPhone","Value": "+86131****5678"}]

数据结构

本页目录：

AddPromotionEvent

Address

Amount

App

AssessDeviceRiskPremiumRsp

AssessDeviceRiskRsp

AssessEnvironmentRiskRsp

AssessRiskRsp

Billing

BrowseEvent

Browser

Card

ChargeBackEvent

ClaimRedPacketEvent

Coupon

CreateOrderEvent

CreditPoint

Cust

CustEvent

DataAuthorization

DataScore

Decision

Delivery

Device

DigitalOrder

Environment

EventDetail

IPLocation

IPNetwork

InvitationEvent

Inviter

Item

LoginEvent

LogoutEvent

LuckyDrawEvent

Merchant

ModifyAccountEvent

ModifyPasswordEvent

Order

PaymentMethod

PaymentResult

Person

Promotion

PromotionCode

RedeemEvent

RegisterEvent

Result

RiskLabel

SMSEvent

ScanCodeEvent

Score

SecurityVerificationEvent

TaskEvent

TransactionEvent

User

Wallet

WithdrawEvent