字段名称

数据类型

最大长度

是否必填

默认值

描述

示例值

bizId

String

32

是

-

商户侧的业务唯一标识。建议与业务订单、申请单或流水号一一对应，以便追踪业务。

说明：ZOLOZ不校验该值的唯一性，商户侧需自行保证该业务ID的唯一性。

"VV2026060500000001"

metaInfo

String

512

是

-

SDK与用户设备的元信息。原生App模式下该值由ZOLOZ SDK返回，请直接传入，不要进行任何修改。

"{\"apdidToken\":\"xxx\",\"appName\":\"com.example.app\",\"appVersion\":\"1.0.0\",\"bioMetaInfo\":\"3.46.0:0,2\",\"deviceModel\":\"iPhone13,3\",\"deviceType\":\"ios\",\"osVersion\":\"iOS 26.1\"}"

userId

String

64

是

-

商户侧的用户标识，例如用户ID、手机号、邮箱等。建议在传入前进行哈希或脱敏处理。

"hash_user_001"

sceneCode

String

64

否

null

业务场景码，用于区分不同业务场景的数据表现，例如login、riskVerify、payment、changePassword。

"changePassword"

productConfig

ProductConfig

-

否

null

VideoVerify产品的精细化配置参数。具体可配置项，详见ProductConfig。

{

"riskMode": "STANDARD"

}

字段名称

数据类型

最大长度

是否必填

默认值

描述

示例值

riskMode

String

10

否

STANDARD

VideoVerify中的多维度风控冷却规则校验，用于拦截可疑交易。取值：

• CLOSED：关闭风控冷却规则。该等级适用于测试场景，测试进程不受风控规则的影响。
• STANDARD：推荐的标准等级。
• LOOSE：相对宽松的等级，可用于低风险场景。
• STRICT：相对严格的等级，可用于高风险场景。

"STANDARD"

字段名称

数据类型

必须返回

描述

示例值

result

Result

是

API请求结果，包含结果状态、结果码和结果消息。

{

"resultStatus": "S",

"resultCode": "SUCCESS",

"resultMessage": "Success"

}

transactionId

String

否

ZOLOZ服务器为本次流程生成的交易ID。

说明：仅当交易进入处理阶段后系统才会返回transactionId。如果在开始处理交易之前发生错误，系统不会返回transactionId。包括但不限于以下情况：

• 请求参数非法，例如入参格式错误或缺失必传参数。
• 请求未能成功到达服务器，例如网络问题或网关故障。
• 系统限流导致请求被拒绝。

"G006600016CN2019011400000000957252****"

clientCfg

String

否

客户端配置，包括SDK连接和行为参数。仅当result.resultStatus为S时返回。

"..."

结果码

结果状态

描述

SUCCESS

S

API调用成功。

HIGH_RISK

F

检测到高风险，用户账号被风控冻结。

DEVICE_NOT_SUPPORT

F

当前设备类型不支持。

OS_NOT_SUPPORT

F

当前操作系统不支持。

SDKVERSION_NOT_SUPPORT

F

当前SDK版本不支持。

INVALID_ARGUMENT

F

输入参数无效。关于无效参数的详细信息，请查看返回的resultMessage。

SYSTEM_ERROR

F

系统内部错误。有关错误详情，请查看返回的resultMessage。