个人银行卡4要素信息比对(国际版)

更新时间:2025-07-18 11:34:58

接口描述

对个人姓名、证件号(护照、港澳居民来往内地通行证、台湾居民来往大陆通行证)、在大陆境内办理的银行卡号和银行预留的大陆手机号的一致性进行检查校验。

接口

/v2/identity/verify/individual/bank4Factors/international

请求方式

POST

请求头

提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。

方式一:请求签名鉴权(优先推荐)

参数名称

类型

必选

参数说明

X-Tsign-Open-App-Id

string

应用ID

Content-Type

string

application/json;charset=UTF-8

X-Tsign-Open-Ca-Timestamp

string

API 调用者传递时间戳,值为当前时间的毫秒数,也就是从1970年1月1日起至今的时间转换为毫秒,时间戳有效时间为15分钟,为了防重放攻击

Accept

string

建议统一填写 */*

X-Tsign-Open-Ca-Signature

string

签名字符串

Content-MD5

string

当请求 Body 非 Form 表单时,可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时,加上此请求头。

X-Tsign-Open-Auth-Mode

string

选择请求方式进行鉴权,固定值,Signature

方式二:OAuth2.0鉴权(不推荐使用)

当安全接入选择OAuth2.0鉴权方式请点击查阅详情。

请求参数

参数名称

类型

必选

参数类型

参数说明

name

string

body

姓名

certType

string

body

证件类型,可选值如下:

INDIVIDUAL_PASSPORT - 护照

INDIVIDUAL_CH_HONGKONG_MACAO - 港澳居民来往内地通行证(回乡证)

INDIVIDUAL_CH_TWCARD - 台湾居民来往大陆通行证(台胞证)

INDIVIDUAL_CH_RESIDENCE_PERMIT_HK_MO_TW - 港澳台居民居住证(18位810开头)

certNo

string

body

证件号(护照、港澳居民来往内地通行证、台湾居民来往大陆通行证,需要与证件类型相对应)

cardNo

string

body

大陆银行卡号

mobileNo

string

body

大陆银行预留手机号(非短信通知手机号)

响应参数

展开全部参数参数名称

类型

必选

参数说明

code

int

接口响应结果码(0代表信息一致,非0请参考下方错误码描述)

message

string

接口响应结果描述

请根据 code 来判断错误情况,不应该依赖message匹配,因为 message 可能会调整。

data

object

接口响应结果数据

verifyId

string

信息比对业务Id(e签宝数据库标识,开发者可保存,无后续接口使用)

请求示例  

{
    "name": "SHE",
    "certType": "INDIVIDUAL_PASSPORT",
    "certNo": "759***350",
    "cardNo": "6222****089253",
    "mobileNo": "150****1234"
}

响应示例

信息一致,比对通过:

{
    "code": 0,
    "message": "成功",
    "data": {
        "verifyId": "536ab48c-e374-4b3a-ac62-fbe4791cce1a"
    }
}

信息不一致,比对不通过:

{
    "code": 30504001,
    "message": "信息比对不通过,请检查信息的正确性",
    "data": {
        "verifyId": "652a04b4-****-49a3-b261-fa16f8173cb4"
    }
}

错误码

错误码

错误描述

解决方案

30500100

缺少参数:姓名不能为空

请核实姓名是否为空

30500100

缺少参数:证件类型不能为空

请核实证件类型是否为空

30500100

缺少参数:证件号不能为空

请核实证件号是否为空

30500100

缺少参数:银行卡号不能为空

请核实银行卡号是否为空

30500100

缺少参数:手机号不能为空

请核实手机号是否为空

30500101

参数错误:请输入正确长度的姓名(2-100位)

请输入真实有效的姓名

30500101

参数错误:请输入正确长度的证件号(不大于20位)

请输入真实有效的证件号

30500101

参数错误:证件号格式不正确

请输入真实有效的证件号

30500101

参数错误:请输入正确的银行卡号

请输入真实有效的银行卡号

30500101

参数错误:请输入正确的手机号码

请输入真实有效的手机号

30500101

参数错误:姓名只支持中文/大小写英文/点符号·/破折号-/半角括号/半角逗号

请输入真实有效的姓名

30504001

信息比对不通过,请检查信息的正确性

信息比对不通过,请核实传入的信息是否匹配

30504002

数据源查询失败,请联系服务人员处理,ID:XXXXXX

数据源没有查询到该笔数据,请联系客服解决

我要纠错