银行卡认证接口

2024.04.18 10:26:18

    通过对比权威数据源,对用户上传的姓名、身份证号、银行卡号、手机号进行验证,校验是否一致

    接口说明

    该接口返回结果状态分以下两种:

    • 银行卡认证不通过会返回相应原因,包括信息不一致、身份证格式不正确,银行卡卡号不存在等
    • 银行卡认证后通过后会返回对应的认证结果
    • 同一信息一天最多校验10次,超过会触发银行风控,导致校验失败

    鉴权说明

    易盾信息认证服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权

    请求

    请求地址

    名称
    HTTP URL https://verify.dun.163.com/v1/bankcard/check
    HTTP Method POST

    请求头

    名称 类型 必填 描述
    Content-Type String 固定值:"application/x-www-form-urlencoded"

    请求参数

    请求参数由请求公共参数和请求业务参数两部分组成,通用参数见请求通用字段

    名称 类 型 必填 最大长度 描述
    bankCardNo String 32 用户银行卡卡号
    name String 32 用户真实姓名,以身份证上姓名为准
    idCardType String 32 证件类型(默认为身份证),02:军官证,03:护照,05:士兵证,06:内地居民来往港澳通行证,07:台湾同胞来往内地通行证,10:警官证,15:港澳居民来往内地通行证(回乡证),18:台湾居民居住证,19:港澳居民居住证,20:外国护照。
    idCardNo String 18 用户身份证号码,目前支持一代/二代身份证,号码必须为18位或15位,末尾为x的需要大写为X
    phone String 18 用户该银行卡的预留手机号码。注意:若使用银行卡四要素业务该字段必填否则会调用失败
    dataId String 64 数据标识,可传入用户标识等数据,便于数据查询

    请求体示例

    bankCardNo=6222123412343569&name=张三&idCardNo=341622123456784317&phone=13358123456&version=v1&businessId=xxx&timestamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx
    

    响应

    响应结果

    响应字段如下,响应通用字段已省略,详细见响应公共字段

    名称 类型 必须返回 描述
    status Number 认证结果,1-通过 2-不通过(原因见reasonType) 0-待定
    reasonType Number 原因详情
    2-持卡人信息与输入信息不一致
    3-查无此银行卡
    4-查无此身份证
    5-手机号码格式不正确
    6-银行卡号不正确
    7-其他出错,请联系客服。
    taskId String 本次请求数据标识,可以根据该标识在控制台进行数据查询
    isPayed Number 本次请求是否收费标识,1代表收费,0代表不收费

    响应体示例

    {
        "code": 200,
        "msg": "ok",
        "result": {
            "status": 1,
            "taskId": "xxxxxxxxxxxxxx",
            "reasonType": 2,
            "isPayed": 1
        }
    }
    

    响应返回码

    响应返回码见:响应返回码

    在线咨询 电话咨询:95163223 免费试用