tencent cloud

APIs

文档APIsRisk Control EngineData Types

数据结构

下载
聚焦模式
字号
最后更新时间： 2026-09-28 14:26:41

AddPromotionEvent

参加营销活动事件详情

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

名称 类型 必选 描述
PromotionId String 是

营销活动ID
PromotionName String 否

营销活动名称
Description String 否

营销活动描述
InviterUserId String 否

邀请人ID
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标准
Region String 否

省份
City String 否

城市
District String 否

地区
Detail String 否

详细地址
ZipCode String 否

邮政编码

Amount

金额

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

名称 类型 必选 描述
Currency String 是

原始货币类型

参数格式：符合ISO 4217标准
OriginalAmount Float 是

原始金额
ExchangeRateUSD Float 否

当前币种对美金的汇率
ExchangeRateCNY Float 否

当前币种对人民币的汇率

App

应用程序信息

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

名称 类型 必选 描述
OS String 否

应用程序运行的移动设备的操作系统类型
OSVersion String 否

应用程序运行的移动设备的操作系统版本
DeviceManufacturer String 否

应用程序运行的移动设备的生产厂商
DeviceModel String 否

应用程序运行的移动设备的型号
DeviceId String 否

应用程序运行的移动设备的唯一ID，对于iOS为IFV标识，对于Android为Android ID
AppName String 否

应用程序名称
AppVersion String 否

应用程序版本
ClientLanguage String 否

应用程序提供的语言

AssessDeviceRiskPremiumRsp

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

被如下接口引用：AssessDeviceRiskPremiumPro。

名称 类型 描述
Decision Decision

决策信息
Score DataScore

设备风险分信息
Device Device

设备基础信息
Environment Environment

IP环境基础信息

AssessDeviceRiskRsp

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

被如下接口引用：AssessDeviceRiskPro。

名称 类型 描述
Score DataScore

设备风险分信息
Device Device

设备基础信息
Environment Environment

IP环境基础信息

AssessEnvironmentRiskRsp

环境风险评估返回结果

被如下接口引用：AssessEnvironmentRisk。

名称 类型 描述
Score DataScore

IP环境风险分信息
Environment Environment

IP环境基础信息

AssessRiskRsp

事件风险评估返回结果

被如下接口引用：AssessRisk。

名称 类型 描述
Decision Decision

决策信息
Score Score

风险分，根据您开启的产品服务计算的评分结果
ExtraInfo Array of Cust

扩展信息

Billing

账单信息

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

名称 类型 必选 描述
Address Address 否

账单地址
Phone String 否

账单联系电话

参数格式：符合E.164标准的带“+”、地区编码和号码的格式
Email String 否

账单邮箱
Recipient String 否

账单接收人姓名

BrowseEvent

浏览事件详情

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

名称 类型 必选 描述
PageType String 否

当前浏览网页的类型，例如主页、搜索页等
PageUrl String 否

当前浏览的网页URL
Duration Integer 否

浏览耗时

单位：毫秒
ContentType String 否

网页内容类型，例如广告、视频、文章等
ContentId String 否

网页内容ID
ReferPageType String 否

上一个网页的类型，例如主页、搜索页等
ReferPageUrl String 否

上一个网页URL
GuestId String 否

游客账号ID
Cust Array of Cust 否

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

Browser

浏览器信息

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

名称 类型 必选 描述
UserAgent String 否

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

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

参数格式：符合ISO 3166标准
ContentLanguage String 否

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

参数格式：符合ISO 3166标准

Card

银行卡

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

名称 类型 必选 描述
CardBin String 是

发卡行识别码卡号前6位

参数格式：符合ISO 13616-1标准
LastFourDigits String 是

发卡行识别码卡号后4位

参数格式：符合ISO 13616-1标准
Country String 否

发行国家
Bank String 否

发行银行
Type String 否

支付卡类型

枚举值：

  • credit： 信用卡
  • debit： 借记卡
  • charge： 签账卡
Brand String 否

支付卡品牌
Level String 否

支付卡等级
HolderName String 否

持有者姓名
ExpireTime String 否

过期日期

参数格式：YYYY-MM-DD

ChargeBackEvent

拒付事件详情

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

名称 类型 必选 描述
TransactionId String 是

交易ID
OrderId Array of String 是

订单 ID，当一笔交易关联多个订单（合并支付）时请输入所有订单ID
ChargeBackCode String 是

拒付理由码，参考各卡组织定义的拒付码，例如：10.1、13.1、 4870、4871等
ChargeBackReason String 是

拒付原因，参考各卡组织定义的拒付原因，例如：未收到商品、欺诈等
ChargeBackProcess String 否

拒付申诉阶段

枚举值：

  • need_response： 需要商家回应
  • information_supplied： 商家已提供信息
  • chargeback_reversed： 拒付已撤销
  • chargeback_sustained： 拒付已成立
ChargeBackAmount Amount 否

拒付金额
Cust Array of Cust 否

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

ClaimRedPacketEvent

领红包事件详情

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

名称 类型 必选 描述
PromotionId String 否

营销活动ID
PromotionName String 否

营销活动名称
Description String 否

营销活动描述
InviterUserId String 否

邀请人ID
RedPacketId String 否

红包ID
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
CouponName String 否

优惠券名称
StartTime String 否

优惠券开始时间

参数格式：符合ISO 8601标准的带UTC时区的毫秒级时间
ExpireTime String 否

优惠券过期时间

参数格式：符合ISO 8601标准的带UTC时区的毫秒级时间
PercentageRate Float 否

折扣百分比，如果折扣为 10%，则发送“0.1”
DiscountAmount Amount 否

折扣金额
Threshold Float 否

优惠券门槛

CreateOrderEvent

创建订单事件详情

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

名称 类型 必选 描述
OrderId String 是

订单ID
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 是

积分分值
PointType String 是

积分类型

Cust

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

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

名称 类型 必选 描述
Key String 否

标识符
Value String 否

数据

CustEvent

自定义事件

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

名称 类型 必选 描述
Cust Array of Cust 否

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

DataScore

风险分信息

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

名称 类型 描述
RiskLevel Integer

风险等级
RiskLabels Array of RiskLabel

风险标签
RiskScore Integer

综合风险分数。

取值范围：[1, 1000]

数值越大，风险越大。

Decision

决策信息

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

名称 类型 描述
DecisionResult String

决策结果

  • pass：通过
  • review：复审
  • reject：拒绝
Disposition String

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

Delivery

物流信息

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

名称 类型 必选 描述
DeliveryMethod String 否

物流方式

  • physical：物理投送
  • electonic：电子投送
DeliveryAmount Amount 否

物流费用
DeliveryAddress Address 否

收货地址
ConsigneePhone String 否

收货人电话

参数格式：符合E.164标准的带“+”、地区编码和号码的格式
ConsigneeEmail String 否

收货人邮箱
ConsigneeName String 否

收货人姓名
Expedited Boolean 否

是否加急
DeliveryCarrier String 否

物流厂商，一般是物流的公司
DeliveryTracking String 否

物流追踪单号

Device

设备基础信息

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

名称 类型 描述
DeviceId String

设备ID
AppVersion String

App版本信息
Brand String

品牌
ClientIp String

客户端IP
Model String

机型
NetworkType String

网络类型
PackageName String

应用包名
Platform String

平台

枚举值：

  • 2： Android
  • 3： IOS
  • 4： H5
  • 5： 微信小程序
SystemVersion String

系统版本
SdkBuildVersion String

SDK版本
SignToken String

验签token，验签功能启用请联系我们。
TokenTime String

token生成时间戳，毫秒级。

DigitalOrder

数字订单

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

名称 类型 必选 描述
DigitalAsset String 否

数字资产
AssetType String 否

数字资产类型

枚举值：

  • coin： 代币
  • commodity： 大宗商品
  • crypto： 加密货币
  • fiat： 法币
  • token： 通证
  • stock： 股票
  • bond： 债券
OrderType String 否

订单类型

枚举值：

  • limit： 限价单
  • market： 市价单
  • stop_limit： 止损限价单
  • stop_loss： 止损单
  • take_profit： 止盈单
  • take_profit_limit： 止盈限价单
Volume Float 否

数字资产的数量

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地址所属国家
Region String

IP地址所属省份
City String

IP地址所属城市
District String

IP地址所属地区
Longitude String

IP地址的经度
Latitude String

IP地址的纬度
Timezone String

IP地址所属时区
ZipCode String

IP地址的邮政编码

IPNetwork

IP基础网络信息

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

名称 类型 描述
ISP String

互联网服务提供商
ASN String

自治系统号
Organization String

IP注册组织名称
IsReserved Boolean

是否保留IP
IsGateway Boolean

是否网关IP
IsAnycast Boolean

是否任播网络
IsMobile Boolean

是否移动网络
IsDynamic Boolean

是否动态IP
IsEgress Boolean

是否网络出口
IsDNS Boolean

是否域名解析
IsEducation Boolean

是否教育机构
IsInstitution Boolean

是否组织机构
IsCompany Boolean

是否企业专线
IsResidence Boolean

是否家用宽带
IsCloudService Boolean

是否云服务
IsInfrastructure Boolean

是否基础设施
IsMXServer Boolean

是否邮箱服务

InvitationEvent

邀请事件详情

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

名称 类型 必选 描述
InviteeUserId String 是

受邀请人ID
PromotionId String 否

营销活动ID
PromotionName String 否

营销活动名称
Description String 否

营销活动描述
InviteePhone String 否

受邀请人电话号码

参数格式：符合E.164标准的带“+”、地区编码和号码的格式
InvitationCode String 否

邀请码
InvitationUrl String 否

邀请链接
InvitationChannel String 否

邀请渠道，如微信、抖音、小红书等
Cust Array of Cust 否

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

Inviter

邀请人信息

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

名称 类型 必选 描述
InviterUserId String 是

邀请人ID
InviterPhone String 否

邀请人电话号码

参数格式：符合E.164标准的带“+”、地区编码和号码的格式
InviteCode String 否

邀请码
InviteChannel String 否

邀请渠道

Item

商品信息

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

名称 类型 必选 描述
ItemId String 是

商品ID
ItemName String 否

商品名称
Category String 否

商品类别
Price Amount 否

商品单价
UPC String 否

如果商品有UPC码（Universal Product Code），请提供
EAN String 否

如果商品有EAN码（European Article Number），请提供
SKU String 否

如果商品有SKU码（Stock Keeping Unit），请提供
ISBN String 否

如果商品有ISBN码（International Standard Book Number ），请提供
Brand String 否

商品品牌
Quantity Integer 否

商品数量
Manufacturer String 否

生产厂商
Tags String 否

商品标签

LoginEvent

登录事件详情

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

名称 类型 必选 描述
UserInfo User 否

用户基础信息
UserLoginName String 否

用户登录时输入的用户名
LoginResult Result 否

登录结果
RegisterTime String 否

用户注册时间。

参数格式：要求符合ISO 8601标准的带时区的毫秒级时间，格式"YYYY-MM-DDTHH:mm:ss.sssZ" ，例如"2025-10-19T09:11:10.145+08:00"
IsPaidUser Boolean 否

是否付费用户。

枚举值：

  • true： 付费用户
  • false： 非付费用户
Cust Array of Cust 否

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

LogoutEvent

登出事件详情

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

名称 类型 必选 描述
UserInfo User 否

用户基础信息
UserLoginName String 否

用户登录时输入的用户名
Cust Array of Cust 否

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

LuckyDrawEvent

抽奖事件详情

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

名称 类型 必选 描述
PromotionId String 否

营销活动ID
PromotionName String 否

营销活动名称
Description String 否

营销活动描述
InviterUserId String 否

邀请人ID
LuckyDrawCount Integer 否

抽奖次数

单位：次数
LuckyDrawType String 否

抽奖类型
Cust Array of Cust 否

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

Merchant

商家信息

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

名称 类型 必选 描述
MerchantId String 是

商家ID
Name String 否

商家名称
RegisterTime String 否

商家的注册时间

参数格式：符合ISO 8601标准的带UTC时区的毫秒级时间
Category String 否

商家类别代码

参数格式：符合ISO 18245标准的4位编号
Phone String 否

商家电话

参数格式：符合E.164标准的带“+”、地区编码和号码的格式
Email String 否

商家邮件
URL String 否

商家店铺网址
Address Address 否

商家地址
Level String 否

商家等级
BusinessType String 否

经营类型

枚举值：

  • person： 个人
  • company： 企业
GoodsQuantity Integer 否

商家在售商品数量
HistoricSalesQuantity Integer 否

商家历史销售数量
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： 系统强制重置
Cust Array of Cust 否

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

Order

订单信息

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

名称 类型 必选 描述
OrderId String 是

订单ID
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信用转账
PaymentChannel String 否

支付渠道
Card Card 否

银行卡信息，当用支付方式是credit_card、debit_card时必填
SEPADirectDebitMandate Boolean 否

SEPA直接借记授权

枚举值：

  • true： 是
  • false： 否
DigitalWallet Wallet 否

数字钱包

PaymentResult

支付结果

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

名称 类型 必选 描述
Status String 是

支付状态

枚举值：

  • success： 成功
  • failure： 失败
FailureReason String 否

支付失败原因
ThreeDomainSecure Boolean 否

是否使用3DS，枚举值：

  • 是：true
  • 否：false
ECICode String 否

ECI返回码
AVSCode String 否

AVS响应结果（地址验证）
CVCCode String 否

CVC验证结果（交易真实性验证）

Person

个人信息

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

名称 类型 必选 描述
Name String 否

姓名全称
Gender String 否

性别
Birthday String 否

出生日期

参数格式：YYYY-MM-DD
Degree String 否

学历
Occupation String 否

职业

Promotion

营销活动

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

名称 类型 必选 描述
PromotionId String 是

营销活动ID
PromotionName String 否

营销活动名称
Description String 否

营销活动描述
InviterUserId String 否

邀请人ID
Coupon Coupon 否

优惠券
CreditPoint CreditPoint 否

积分

PromotionCode

营销活动码

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

名称 类型 必选 描述
Id String 是

活动码ID
Type String 否

活动码类型，例如：qrcode-二维码、barcode-条形码、miniprogram_code-小程序码
ImageLink String 否

活动码图片URL或链接
Address Address 否

营销活动码使用地址
Items Array of Item 否

营销活动码关联的商品

RedeemEvent

兑奖事件详情

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

名称 类型 必选 描述
PromotionId String 是

营销活动ID
PromotionName String 否

营销活动名称
Description String 否

营销活动描述
InviterUserId String 否

邀请人ID
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： 失败
FailureReason String 否

失败原因

RiskLabel

风险标签

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

名称 类型 描述
Id String

风险ID
Reason String

风险描述

SMSEvent

短信事件详情

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

名称 类型 必选 描述
UserInfo User 否

用户基础信息
SMSId String 否

本次短信发送标识 ID
ReceivedTime String 否

用户实际完成验证码时间

参数格式：符合ISO 8601标准的带UTC时区的毫秒级时间
Action String 否

记录用户收到短信的动作

  • no_action：用户无动作
  • safe：用户确认本人操作
  • compromised：用户反馈为第三方操作
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
PromotionName String 否

营销活动名称
Description String 否

营销活动描述
InviterUserId String 否

邀请人ID
Cust Array of Cust 否

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

Score

风险分

被如下接口引用：AssessRisk。

名称 类型 描述
RiskScore Integer

风险分值，范围[1, 1000]，分值越大，风险越高
RiskLabels Array of RiskLabel

风险标签

SecurityVerificationEvent

安全验证事件详情

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

名称 类型 必选 描述
VerificationEvent String 是

安全验证所处的事件类型

枚举值：

  • register： 注册
  • login： 登录
  • modify_account： 修改账号
  • modify_password： 修改密码
  • create_order： 创建订单
  • transaction： 交易支付
  • modify_order： 修改订单
  • withdraw： 提现
  • add_promotion： 参加营销活动
  • redeem： 兑奖
VerificationType String 是

安全验证类型，sms-短信、phone_call-电话、email-邮件、captcha-验证码、shared_knowledge-共享知识、face-人脸、fingerprint-指纹等
VerificationContent String 否

安全验证的内容，例如：用于验证的电话号码、邮件、验证码或者问题，当安全验证类型是sms、phone_call、email、captcha、shared_knowledge时输入
VerificationResult Result 否

安全验证结果
Cust Array of Cust 否

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

TaskEvent

做任务事件详情

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

名称 类型 必选 描述
PromotionId String 否

营销活动ID
PromotionName String 否

营销活动名称
Description String 否

营销活动描述
InviterUserId String 否

邀请人ID
TaskId String 否

任务ID
TaskName String 否

任务名称
TaskType String 否

任务类型，如签到打卡、观看广告、累计步数等
TaskCostTime Integer 否

任务完成耗时

单位：毫秒
Cust Array of Cust 否

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

TransactionEvent

交易事件详情

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

名称 类型 必选 描述
TransactionId String 是

交易唯一标识
OrderId Array of String 是

您系统中的订单 ID，当一笔交易关联多个订单（合并支付）时请输入所有订单ID
PaymentAmount Amount 是

交易金额
PaymentMethod PaymentMethod 是

支付方式，支持多种支付方式
TransactionType String 否

交易类型

枚举值：

  • sale： 一次性完成授权与扣款（最常见）
  • authorize： 仅授权（冻结金额）
  • capture： 执行扣款（在授权后）
  • void： 取消待处理的授权或扣款
  • refund： 退款（部分或全部）
  • deposit： 向账户存款
  • withdrawal： 从账户提现
  • transfer： 账户间转账
  • buy： 购买资产（如加密货币）
  • sell： 出售资产
  • send： 发送资金/资产（如跨钱包转账）
  • receive： 接收资金/资产

默认值：sale
Billing Billing 否

账单信息
Delivery Delivery 否

物流信息
Merchant Merchant 否

商家信息
PaymentResult PaymentResult 否

支付结果
TransferRecipientUserId String 否

接收方的用户ID，适用于 transfer 交易类型
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 否

用户等级
UserPoint CreditPoint 否

用户积分
UserType String 否

用户类型

Wallet

数字钱包

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

名称 类型 必选 描述
WalletType String 是

钱包类型

枚举值：

  • crypto： 加密货币
  • digital： 数字货币
  • fiat： 法币
WalletAddress String 是

钱包地址，通常为钱包的唯一标识
WalletHolderName String 否

钱包归属人姓名
WalletProvider String 否

钱包供应商，wechat、alipay、paypal等

WithdrawEvent

提现事件详情

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

名称 类型 必选 描述
Amount Amount 是

提现金额
Method String 是

提现方式

枚举值：

  • card： 银行卡
  • wallet： 电子钱包
Card Card 否

提现银行卡，当提现方式是card时必填
Wallet Wallet 否

提现数字钱包，当提现方式是wallet时必填
Result Result 否

提现结果
Cust Array of Cust 否

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

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈

搜索
    请输入关键词搜索文档