发起运营商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 待实名个人证件类型暂不支持 指定账号证件类型暂时不支持四要素,目前仅支持大陆身份证

results matching ""

    No results matching ""