银行卡三元素校验[详]

企业专用

校验输入的姓名、身份证号码、银行卡号是否一致,若不一致返回不一致原因。毫秒级响应、直联保障,支持全国所有银联卡,实时验证科学严谨,数据100%可靠。%可靠。

官 稳 保
¥79.2
补贴后单价:
  • 申请赠送05次

    约¥0/次

  • 一元试用150次

    约¥0.02/次

  • 亿元补贴

    体验价99309次

    约¥0.3204/次

  • 新客户首购特惠4993327次

    约¥0.15/次

  • 亿元补贴

    优惠价4992376次

    约¥0.21/次

  • 亿元补贴

    限时价12996495次

    约¥0.2/次

  • 亿元补贴

    采购价299915784次

    约¥0.19/次

  • 接口文档

    接口文档
  • 查询

  • 查询2.0

  • 查询(加密版)

  • 查询2.0(加密版)

  • 查询(加密版RSA+AES)

  • 查询2.0(加密版RSA+AES)

  • 错误码
  • 错误码列表
  • 资源下载
  • 接口文档下载
查询
接口地址:http://v.juhe.cn/verifybankcard3_detail/query
请求方式:http get/post
返回类型:json
接口描述:根据姓名+身份证号+银行卡卡号验证是否匹配
接口调试: API测试工具

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  key string 在个人中心->我的数据,接口名称上方查看
  realname string 姓名
  idcard string 身份证号码
  bankcard string 银行卡卡号
  bankinfo string 是否返回所属银行(bank_name),1返回,不传或其他不返回

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i "http://v.juhe.cn/verifybankcard3_detail/query?key=key&realname=%E6%9D%8E%E8%81%9A%E5%90%88&idcard=370121xxxxxxxx1040&bankcard=6321xxxxxxxx432&bankinfo="

返回参数说明:

名称 类型 说明
  error_code int 返回码
  reason string 返回码描述
  jobid string 本次查询流水号
  res int 匹配结果,1:匹配 2:不匹配
  message string 说明

JSON返回示例:JSON在线格式化工具 >

      {
"reason": "成功",
"result": {
"jobid": "JH2971191112162139847181e7",
"res": 2,
"message": "认证信息不匹配,银行卡无效"
},
"error_code": 0
}
--------------------------------失败示例-----------------------------------------------
{
"reason": "认证失败",
"result": {
"jobid": "JH297117111112213988818111",/*本次查询流水号*/
"error_code_detail": 22970305 /*详情错误码*/
},
"error_code": 229703
}

---------------------------详情错误码列表------------------------------------------
错误码	详情码(error_code_detail)	说明
229701	229701	数据源超时
229702	229702	查无记录
229703	22970304	认证失败,该卡号当日连续多次认证不通过被限制校验,次日恢复
229703	22970305	认证失败
229704      22970401	参数错误:银行卡号格式不正确
229704      22970404	同一银行卡请求过于频繁
229704	22970408	参数错误
229705      29705	参数错误:姓名格式不正确
229706	229706	参数错误:身份证格式不正确
查询2.0
接口地址:http://v.juhe.cn/verifybankcard3_detail/query_v2
请求方式:http get/post
返回类型:json
接口描述:根据姓名、身份证、银行卡、商户名称、场景检测信息是否匹配
接口调试: API测试工具

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  key string 在个人中心->我的数据,接口名称上方查看
  realname string 姓名
  idcard string 证件号码
  bankcard string 银行卡卡号
  idtype string 证件类型,具体见JSON示例。默认:01
  code string 发起交易商户业务编码, 具体见JSON示例,如:01
  customer string 公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户
  bankinfo string 是否返回所属银行(bank_name),1返回,不传或其他不返回

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i "http://v.juhe.cn/verifybankcard3_detail/query_v2?key=key&realname=%E6%9D%8E%E8%81%9A%E5%90%88&idcard=370121xxxxxxxx1040&bankcard=6321xxxxxxxx432&idtype=&code=&customer=&bankinfo="

返回参数说明:

名称 类型 说明
  error_code int 返回码
  reason string 返回码描述
  jobid string 本次查询流水号
  res int 匹配结果,1:匹配 2:不匹配
  message string 说明

JSON返回示例:JSON在线格式化工具 >

      /**code 商户业务编码		|		idtype 证件类型
01 直销银行			|		01	身份证
02 消费金融			|		02	护照
03 银行二三类账户开户		|		03	港澳证
04 征信				|		04	台胞证
05 保险				|		11	回乡证
06 基金				|
07 证券				|
08 租赁				|
09 海关申报			|
99 其他				|
*/
{
"reason": "成功",
"result": {
"jobid": "JH2971191112162139847181e7",
"res": 2,
"message": "认证信息不匹配,银行卡无效"
},
"error_code": 0
}

{
"reason": "认证失败",
"result": {
"jobid": "JH297117111112213988818111",/*本次查询流水号*/
"error_code_detail": 22970305 /*详情错误码*/
},
"error_code": 229703
}

---------------------------详情错误码列表------------------------------------------
错误码	详情码(error_code_detail)	说明
229701	229701	数据源超时
229702	229702	查无记录
229703	22970304	认证失败,该卡号当日连续多次认证不通过被限制校验,次日恢复
229703	22970305	认证失败
229704      22970401	参数错误:银行卡号格式不正确
229704      22970404	同一银行卡请求过于频繁
229704	22970408	参数错误
229705      29705	参数错误:姓名格式不正确
229706	229706	参数错误:身份证格式不正确
查询(加密版)
接口地址:http://v.juhe.cn/verifybankcard3_detail/queryEncry
请求方式:http get/post
返回类型:json
接口描述:根据姓名+身份证号+银行卡卡号验证是否匹配
接口调试: API测试工具

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  key string 在个人中心->我的数据,接口名称上方查看
  realname string 姓名加密
  idcard string 身份证号码加密
  bankcard string 银行卡卡号加密
  bankinfo string 是否返回所属银行(bank_name),1返回,不传或其他不返回

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i "http://v.juhe.cn/verifybankcard3_detail/queryEncry?key=key&realname=%E6%9D%8E%E8%81%9A%E5%90%88&idcard=370121xxxxxxxx1040&bankcard=6321xxxxxxxx432&bankinfo="

返回参数说明:

名称 类型 说明
  error_code int 返回码
  reason string 返回码描述
  jobid string 本次查询流水号
  res int 匹配结果,1:匹配 2:不匹配
  message string 只有参数isshow不为空且不为0时显示

JSON返回示例:JSON在线格式化工具 >

      
加密算法:AES/ECB/PKCS5Padding,AES结果无需转小写,经过base64
加密后的数据需要urlencode传入
加密的密钥为:客户个人中心的openid经过md5后结果为小写取前16{
"reason": "成功",
"result": {
"jobid": "JH2971191112162139847181e7",
"res": 2,
"message": "认证信息不匹配,银行卡无效"
},
"error_code": 0
}
查询2.0(加密版)
接口地址:http://v.juhe.cn/verifybankcard3_detail/queryEncry_v2
请求方式:http get/post
返回类型:json
接口描述:根据姓名、身份证、银行卡、商户名称、场景检测信息是否匹配
接口调试: API测试工具

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  key string 在个人中心->我的数据,接口名称上方查看
  realname string 姓名加密
  idcard string 证件号码加密
  bankcard string 银行卡卡号加密
  idtype string 证件类型,具体见JSON示例。默认:01
  code string 发起交易商户业务编码, 具体见JSON示例,如:01
  customer string 公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i "http://v.juhe.cn/verifybankcard3_detail/queryEncry_v2?key=key&realname=%E6%9D%8E%E8%81%9A%E5%90%88&idcard=370121xxxxxxxx1040&bankcard=6321xxxxxxxx432&idtype=&code=&customer="

返回参数说明:

名称 类型 说明
  error_code int 返回码
  reason string 返回码描述
  jobid string 本次查询流水号
  res int 匹配结果,1:匹配 2:不匹配
  message string 说明

JSON返回示例:JSON在线格式化工具 >

      /**code 商户业务编码		|		idtype 证件类型
01 直销银行			|		01	身份证
02 消费金融			|		02	护照
03 银行二三类账户开户		|	03	港澳证
04 征信				|		04	台胞证
05 保险				|		11	回乡证
06 基金				|
07 证券				|
08 租赁				|
09 海关申报			|
99 其他				|
*/

加密算法:AES/ECB/PKCS5Padding,AES结果无需转小写,经过base64
加密后的数据需要urlencode传入
加密的密钥为:客户个人中心的openid经过md5后结果为小写取前16{
"reason": "成功",
"result": {
"jobid": "JH2971191112162139847181e7",
"res": 2,
"message": "认证信息不匹配,银行卡无效"
},
"error_code": 0
}
查询(加密版RSA+AES)
接口地址:http://v.juhe.cn/verifybankcard3_detail/queryEncryInfo
请求方式:http get/post
返回类型:json
接口描述:根据姓名+身份证号+银行卡卡号验证是否匹配,查看RSA公钥

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  key string 在个人中心->我的数据,接口名称上方查看
  aesKey string RSA方式加密后的aes秘钥数组再base64(加密前必须为16位)
  realname string 姓名加密
  idcard string 身份证号码加密
  bankcard string 银行卡卡号加密
  bankinfo string 是否返回所属银行(bank_name),1返回,不传或其他不返回

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i "http://v.juhe.cn/verifybankcard3_detail/queryEncryInfo?key=key&aesKey=xxx&realname=257e5ae7xxxxxxxxx9ab8d699&idcard=c9a6bce3xxxxxxxxx9d684cbf&bankcard=ec1a982cxxxxxxxxxc357ee4d&bankinfo="

返回参数说明:

名称 类型 说明
  error_code int 返回码
  reason string 返回码描述
  jobid string 本次查询流水号
  res int 匹配结果,1:匹配 2:不匹配
  message string 信息

JSON返回示例:JSON在线格式化工具 >

       
1.RSA公钥由云客私下提供给客户用来加密aes密钥,aes密钥rsa加密后再base64传入
(aes密钥由用户随机生成,加密前必须为16位)
2.AES算法用来加密身份证、姓名和银行卡参数(结果base64),算法/模式/补码方式为:AES/CBC/PKCS5Padding
,其中用openid经过md5过后的32位小写取前16位作为向量iv


{
    "reason": "成功",
    "result": {
        "jobid": "JH2971191112162139847181e7",
        "res": 2,
        "message": "认证信息不匹配,银行卡无效"
    },
    "error_code": 0
}
查询2.0(加密版RSA+AES)
接口地址:http://v.juhe.cn/verifybankcard3_detail/queryEncry_v2Info
请求方式:http get/post
返回类型:json
接口描述:根据姓名、身份证、银行卡、商户名称、场景检测信息是否匹配,查看RSA公钥

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  key string 在个人中心->我的数据,接口名称上方查看
  aesKey string RSA方式加密后的aes秘钥数组再base64(加密前必须为16位)
  realname string 姓名加密
  idcard string 证件号码加密
  bankcard string 银行卡卡号加密
  idtype string 证件类型,具体见JSON示例。默认:01
  code string 发起交易商户业务编码, 具体见JSON示例,如:01
  customer string 公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户
  bankinfo string 是否返回所属银行(bank_name),1返回,不传或其他不返回

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i "http://v.juhe.cn/verifybankcard3_detail/queryEncry_v2Info?key=key&aesKey=xxx&realname=257e5ae7xxxxxxxxx9ab8d699&idcard=c9a6bce3xxxxxxxxx9d684cbf&bankcard=ec1a982cxxxxxxxxxc357ee4d&idtype=&code=&customer=&bankinfo="

返回参数说明:

名称 类型 说明
  error_code int 返回码
  reason string 返回码描述
  jobid string 本次查询流水号
  res int 匹配结果,1:匹配 2:不匹配
  message string 信息

JSON返回示例:JSON在线格式化工具 >

      /**code 商户业务编码		|		idtype 证件类型
01 直销银行			|		01	身份证
02 消费金融			|		02	护照
03 银行二三类账户开户		|		03	港澳证
04 征信				|		04	台胞证
05 保险				|		11	回乡证
06 基金				|
07 证券				|
08 租赁				|
09 海关申报			|
99 其他				|
*/
 
1.RSA公钥由云客私下提供给客户用来加密aes密钥,aes密钥rsa加密后再base64传入
(aes密钥由用户随机生成,加密前必须为16位)
2.AES算法用来加密身份证、姓名和银行卡参数(结果base64),算法/模式/补码方式为:AES/CBC/PKCS5Padding
,其中用openid经过md5过后的32位小写取前16位作为向量iv


{
    "reason": "成功",
    "result": {
        "jobid": "JH2971191112162139847181e7",
        "res": 2,
        "message": "认证信息不匹配,银行卡无效"
    },
    "error_code": 0
}

服务级错误码参照(error_code):

  错误码 说明
  229801 数据源超时
  229802 查无记录
  229803 认证失败

认证失败,请稍后重试
认证失败,该卡当日连续多次认证不通过被限制校验,次日恢复
  229806 参数错误

参数错误:姓名格式不正确
参数错误:手机号格式不正确
参数错误:身份证格式不正确
参数错误:银行卡号格式不正确
同一银行卡请求过于频繁

系统级错误码参照:

  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常 (调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121

错误码格式说明(示例:200201):

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码
银行卡三元素校验[详]

推荐API

  • 银行卡三元素校验[详] [详]

    核验手机运营商三要素(手机号码、姓名、身份证号)信息是否一致,返回验证结果和错误原因。
  • 银行卡五元素校验

    验证银行卡、身份证、姓名、手机号是否一致并返回账户类型
  • 全球银行卡三元素校验[详]

    支持全球约2.4万个城市地区天气查询,如:天气实况、逐日银行卡三元素校验[详] 、24小时银行卡三元素校验[详] 等
  • 购物小票识别

    支持识别各类商场、超市及药店的购物小票,包括店名、单号、总金额、消费时间、明细商品名称、单价、数量、金额等信息,可用于商品售卖信息统计、购物中心用户积分兑换及企业内部报销等场景
  • 涉农贷款地址识别

    涉农贷款地址识别,支持对私和对公两种方式。输入地址的行政区划越完整,识别准确度越高。

API资讯

数 据 驱 动 未 来
Data Drives The Future
13774491084
数 据 驱 动 未 来
Data Drives The Future