发起运营商3要素实名认证
接口描述
- 对个人运营商三要素信息进行核验,成功后向手机号发送验证码
接口地址
/v2/identity/auth/api/individual/{accountId}/telecom3Factors
请求方式
- POST
- 请求报文体采用Json数据格式,编码方式采用UTF-8编码
请求参数
参数名 | 说明 | 参数类型 | 是否必填 | 类型 |
---|---|---|---|---|
accountId | 待认证的e签宝账号id,详见:创建e签宝个人账号(电子签名场景专用) | path | 是 | string |
mobileNo | 手机号,仅限中国大陆3大运营商开通的手机号 | body | 是 | string |
repetition | 是否允许账号重复实名(默认允许重复实名) | body | 否 | boolean |
contextId | 对接方业务上下文id,将在异步通知及跳转时携带返回对接方 | body | 否 | string |
notifyUrl | 认证结束后异步通知地址,具体见"异步通知"章节说明 | body | 否 | string |
请求示例
POST /v2/identity/auth/api/individual/{accountId}/telecom3Factors HTTP/1.1
{
"mobileNo": "18888888888",
"repetition": false,
"contextId": "f0a7927d-c5f9-4652-a053-1130d86c8fa8",
"notifyUrl": "http://xxx.xx.cn/esign/realname/callback"
}
响应参数
参数名 | 说明 | 类型 |
---|---|---|
code | int | 接口响应结果码 |
message | string | 接口响应结果描述 |
data | object | 接口响应结果数据 |
flowId | string | 实名流程Id |
响应示例
{
"code": 0,
"message": "成功”,
"data":{
"flowId": "793857367581143859"
}
}
错误码
错误码 | 错误信息 | 错误原因 |
---|---|---|
30500101 | 参数错误:实名账号Id不能为空 | 在uri中未包含accountId |
30500101 | 参数错误:请输入正确的银行卡号! | 输入的银行卡号不正确,目前仅支持大陆个人银联卡号 |
30500153 | 当前账号已实名,无需重新实名 | 设置账号不重复实名情况下,指定账号已实名 |
30500154 | 待实名个人姓名未设置 | 指定账号在实名前中未预先设置姓名属性 |
30500155 | 待实名个人身份证号未设置 | 指定账号在实名前中未预先设置身份证号属性 |
30500156 | 待实名个人证件类型暂不支持 | 指定账号证件类型暂时不支持四要素,目前仅支持大陆身份证 |
30500156 | 待实名个人证件类型暂不支持 | 指定账号证件类型暂时不支持四要素,目前仅支持大陆身份证 |