发起银行卡4要素实名认证

接口描述

  • 对个人银行卡四要素信息进行核验,成功后向手机号发送验证码

接口地址

  • /v2/identity/auth/api/individual/{accountId}/bankCard4Factors

请求方式

  • POST
  • 请求报文体采用Json数据格式,编码方式采用UTF-8编码

请求参数

参数名 说明 参数类型 是否必填 类型
accountId 待实名e签宝个人账号Id,详见:创建e签宝个人账号(电子签名场景专用) path string
mobileNo 手机号,仅限中国大陆11位手机号 body string
bankCardNo 银行卡号,仅限大陆银联银行卡 body string
repetition 是否允许账号重复实名(默认允许重复实名) body boolean
contextId 对接方业务上下文id,将在异步通知及跳转时携带返回对接方 body string
notifyUrl 实名结束后异步通知地址,具体见"异步通知"章节说明 body string

请求示例

POST /v2/identity/auth/api/individual/a727244923be4020b9e249257078cb0a/bankCard4Factors HTTP/1.1

{
    "mobileNo":"18888888888",
    "bankCardNo":"6222600260001072444",
    "repetition": true,
    "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": "836551334533533698"
    }
  }

错误码

错误码 错误信息 错误原因
30500101 参数错误:请输入正确的银行卡号! 输入的银行卡号不正确,目前仅支持大陆个人银联卡号
30500156 待实名个人证件类型暂不支持 指定账号证件类型暂时不支持四要素,目前仅支持大陆身份证
30501001 银行卡四要素信息核验失败 银行卡号与个人信息不匹配

results matching ""

    No results matching ""