接口描述
对个人姓名、身份证号、银行卡号和银行预留手机号的一致性进行检查校验。
开发者需注意:
- 详情版信息比对接口,当信息比对不通过时,会返回具体不一致的响应结果。例如:“姓名与身份证号不一致”;
- 详情版信息比对接口相对于其他信息比对接口费用会高一点,具体报价可联系e签宝工作人员进行咨询;
- 详情版信息比对接口需要单独购买,具体购买方式可联系e签宝工作人员进行咨询。
接口
/v2/identity/verify/individual/bank4Factors/detail
请求方式
POST
请求头
提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。
请求参数
参数名称 | 类型 | 必选 | 参数类型 | 参数说明 |
idNo | string | 是 | body | 身份证号(仅支持大陆二代身份证) |
name | string | 是 | body | 姓名 |
cardNo | string | 是 | body | 银行卡号(银联卡号) |
mobileNo | string | 是 | body | 银行预留手机号(非短信通知手机号) |
响应参数
参数名称 | 类型 | 必选 | 参数说明 |
code | int | 是 | 接口响应结果码(0代表信息一致,非0请参考下方错误码描述) |
message | string | 是 | 接口响应结果描述 请根据 code 来判断错误情况,不应该依赖message匹配,因为 message 可能会调整。 |
data | object | 否 | 接口响应结果数据 |
verifyId | string | 否 | 信息比对业务Id(e签宝数据库标识,开发者可保存,无后续接口使用) |
请求示例
{
"idNo":"320926xxxxx75276",
"name":"**",
"cardNo":"",
"mobileNo":"188xxxxx888"
}
响应示例
信息一致,比对通过:
{
"code": 0,
"message": "成功",
"data": {
"verifyId": "536ab48c-e374-4b3a-ac62-fbe4791cce1a"
}
}
信息不一致,比对不通过:
{
"code": 30504038,
"message": "您输入的银行卡号与办理银行卡时预留的身份信息不一致,请检查后重新输入",
"data": {
"verifyId": "16819b24-784b-47cb-ab63-2bfcb5dc0f1a"
}
}
错误码
错误码 | 错误描述 | 排查建议 |
30500103 | 姓名不能为空 | 请核实输入的姓名是否为空 |
30500104 | 身份证号不能为空 | 请核实输入的身份证号是否为空 |
30500106 | 手机号不能为空 | 请核实输入的手机号是否为空 |
30500107 | 银行卡号不能为空 | 请核实输入的银行卡号是否为空 |
30504031 | 姓名输入有误,请检查后重新输入 | 请核实输入的姓名长度 |
30504032 | 身份证号码输入有误,请检查后重新输入 | 请输入真实有效的身份证号 |
30504033 | 手机号码输入有误,请检查后重新输入 | 请输入真实有效的手机号 |
30504034 | 银行卡号输入有误,请检查后重新输入 | 请输入真实有效的银行卡号 |
30504035 | 个人信息错误,请检查后重新输入 | 信息比对不通过,请核实传入的信息是否匹配 |
30504036 | 姓名与⾝份证号码不⼀致,请检查后重新输入 | 请检查身份证号与姓名 |
30504037 | 您输入的手机号与银行预留手机号码不一致,请检查后重新输入 | 请检查手机号和账户信息是否匹配 |
30504038 | 您输入的银行卡号与办理银行卡时预留的身份信息不一致,请检查后重新输入 | 请检查银行卡开户时的卡号与当前证件信息是否匹配 |