updateTwoFaInfo

2026-10-14 12:28

概览

API URL：/api/v1/zoloz/smile/updateTwoFaInfo
API 描述：用于在不注销用户、不重新采集人脸的前提下，直接更新 Smile 用户绑定的手机号。
说明：本接口为服务端调用（Server-to-Server），无需客户端 SDK。

请求参数

字段名称	数据类型	最大长度	是否必填	默认值	描述	示例值
bizId	String	32	是	-	业务 ID，用于链路追踪和幂等。例如，商户业务相关数据库中的序列 ID。说明：ZOLOZ 不验证此值的唯一性；商户侧必须保证业务 ID 的唯一性。	"20260922000000000001"
userId	String	64	是	-	商户用户 ID，或其他可用于标识已注册用户的标识。例如手机号、邮箱等。强烈建议对 `userId` 字段的值进行预先脱敏处理，例如对该值进行哈希处理。	"user_1234567890"
newTwoFaInfo	String	32	是	-	新手机号。必须为纯数字。说明：不需要传入旧手机号（`oldTwoFaInfo`），服务端自行查询当前值做比较。	"8613800138000"

返回参数

字段名称

数据类型

必须返回

描述

示例值

result

Result

是

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

{

"resultStatus": "S",

"resultCode": "SUCCESS",

"resultMessage": "Success"

}

transactionId

String

否

本次注册生成的唯一交易ID。

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

请求参数非法，例如入参格式错误或缺失必传参数。

请求未能成功到达服务器，例如网络问题或网关故障。

系统限流导致请求被拒绝。

"G000000001FSE2025070100000001308203****"

处理结果

API通用结果码

有关通用结果码的完整列表，请参见API通用结果码。

API特有结果码

Smile verify initialize API的结果码见下表。

结果码	结果状态	描述
SUCCESS	S	更新成功。
SAME_TWO_FA_INFO	F	新手机号与当前一致，无需更新。

代码示例

请求示例

copy
{
    "bizId": "20260922000000000001",
    "userId": "user_1234567890",
    "newTwoFaInfo": "8613800138000"
}

返回示例

copy
{
    "result": {
        "resultStatus": "S",
        "resultCode": "SUCCESS",
        "resultMessage": "Success"
    },
    "transactionId": "G000000001FSU20260922000000013082032459"
}