Skip to Main Content

prod

银行卡认证详情版API (PCB146)


直连银行体系权威全量实时接口，毫秒级响应，权威数据库动态更新，覆盖全国3000多家银行。 基于银行卡授权三要素（姓名、身份证号、卡号），极速鉴权并返回验证详情，同时查询银行名称、银行卡类型、等级等银行卡信息。

New

400-110-8298
9:30-17:30
bd@yushanshuju.com
  • -

    产品特点

    -

    •精准度高


    可以返回核验的详细结果。直连银联专属通道，实时调用，数据库动态及时更新，结果更精准可信，已经支持上亿用户规模使用。

    •技术保障


    同时支持传统人工录入及人工智能信息识别双形式，可对多种银行卡种类及号码进行整体识别。

  • -

    应用场景

    -

    •支付场景


    适用于各行业中对费用支付场景的需求，目前广泛应用于互联网金融、银行、保险、电商、游戏等领域。


    •身份核验


    当用户提交开户、信贷申请等业务场景下，迅速对提交的个人基本信息进行核验，发现异常潜在风险，并实时返回验证结果。

  • -

    覆盖体量

    -

    全国银行卡持有用户全覆盖
  • -

    产品标签

    -

    身份认证、银行卡认证、KYC

出入参数

羽山数据API产品详细介绍

Report Settings

分类 : 输入字段
名称说明备注
name
姓名
必填
cardId
银行卡号
必填
cardNo
身份证号
必填
phone
手机号
选填
分类 : 返回字段
名称说明备注
respCode
验证结果代码
2000：认证一致
2001：认证不一致
2002:不支持验证
respDesc
验证结果信息
2000：认证一致
2001：认证不一致
2002:不支持验证
respDetail
验证结果详情
2001	姓名不正确
2001	卡号无效或卡状态异常
2001	证件号不正确
2001	手机号不正确
2001	证件号码或类型有误
2001    姓名与身份证号不一致
2002	暂不支持该银行卡
2002	认证次数超限，请次日重试
2002	银行卡未开通无卡支付功能
2002	暂不支持该银行卡种
2002	该卡片暂不支持或权限受限
2002	银行卡暂不支持该业务，请咨询您的发卡行
bankCode
英文简写
bankName
银行名称
cardCategory
卡等级
cardType
卡类型







  
羽山数据API产品接入信息








Report Settings












分类 : 业务异常(retcode)


名称说明



warn_130银行卡鉴权失败:*****
warn_111您输入的为无效身份证号码，请核对后重新输入!
warn_059您输入的手机号码无效，请核对后重新输入!
warn_302您输入的银行卡号无效，请核对后重新输入!
warn_303您输入的姓名无效，请核对后重新输入!
warn_304您输入的多个参数无效，请核对后重新输入!
分类 : 系统代码(retcode)


名称说明


000000交易成功（收费）
200000调用远程数据异常
200010账号不存在
200012未找到账号与产品的订购关系
200014加解密错误
200013该产品测试条数已用完，请联系羽山数据
err_015数据源请求时出现异常
err_012传入参数不正确







   

   

    

    

   

 








 






  
羽山数据API产品接入信息








Report Settings












分类 : 1.对接信息


名称说明



IP白名单
本系统具有IP白名单限制，需要先请确认自身服务器公网IP已由羽山数据运维工程师加入
协议
HTTP/HTTPS POST
编码格式
UTF8
HEAD: ACCT_ID
必填，开户后将获得接入账号APP_ID，如“test_user”
HEAD: CONTENT-TYPE
application/json
测试环境URL
http://122.152.195.249:21000/credit-gw/service
生产环境URL
https://api.yushanshuju.com/credit-gw/service
明文Request JSON样例
{  "prod_id": "PCB146",  "req_data": {    这里是业务入参  },  "req_time": 1545270159122,  "request_sn": "4df1e3c9583d40a9a57f63e4ab153189"}
明文Request JSON样例说明
prod_id 为产品编号。req_data 为业务入参，请参考下面详细信息。小于br大于req_time 为Linux 毫秒时间，可使用echo `date +%s`"000" 命令获得最新时间。request_sn为请求单号，不可重复，需自行生成。
明文Response JSON样例
{
    "response_sn": "20190602020740639KIBG",
    "retdata": {
        "final_auth_result": "1"   },
    "version": "1.0",
    "request_sn": "4a5f3f52e5324a87b96e16c0585",
    "retmsg": "交易成功",
    "retdate": 1559412461182,
    "retcode": "000000"
}
明文Response JSON样例说明
response_sn 返回单号。 retdata 返回业务json。 retmsg 返回描述。 retcode 系统代码。
技术支持
13764219628 阿南
分类 : 2.加解密方法


名称说明


私钥
登录系统或联系技术支持获得接入KEY，加密JSON Request 和解密response密文时需要使用。注意要严格保密使用，请勿外泄，如有遗失，自行负责！
请求报文加密算法
将request JSON明文aes-128-cbc 加密后base64编码,随后POST提交.
接收报文解密算法
将response JSON使用base64解码后,aes-128-cbc解密为明文.
加解密样例(Linux 命令)
##加密命令实现
echo -n '{"prod_id":"P_C_B008","req_data":{"cardNo":"120105198504090312","name":"刘北"},
"req_time":1545270159122,"request_sn":"4df1e3c9583d40a9a57f63e4ab153189"}' | 
openssl  aes-128-cbc  -K 8f781ee51319e00535de09525af6068b -iv 30303030303030303030303030303030 |base64  -w 0

##解密命令实现
echo -n 'lQCG4JX7L0VwyAMBP7v05DwqdgVRiKEp6ExdIvlyCVpvDCSc671小于br大于csbiSsLIsORrJVXVvuAPKKYhPKeJhe6XYolGa6VvfXK7irFcohKmcMVxokNba1+小于br大于o4GQkjMXxQdVC1Lqx2Q9XeVS2pGcFrzJKlOHRt7yJWVahURpEmXL8IA2d小于br大于ozEhrG5bBnWc3jTZYO50OQBH0jCOsjRE8q5qI5UQCA42gNposviVrVfcnZJRqqyrvVW小于br大于kOGF8uqc57sKLzVVzgvdTZuoHWWwoyPmKUXq9dNw等于等于' | base64 -d  | 
openssl aes-128-cbc -d    -K 8f781ee51319e00535de09525af6068b -iv 30303030303030303030303030303030  -p
分类 : 公共参数


名称说明


request_sn
请求序列号
acct_id
账号
prod_id
产品ID
req_data
传入参数
req_time
请求时间
response_sn
返回单号
retdata
返回参数
retcode
返回代码
retmsg
返回信息
retdate
返回时间戳













 

  

    
    
API推荐

  

  

 

 

   

    

    

   

   

     
     
   

   

    

    

   

 













      

      

        

          




 











 














          

              

  

    公司新闻  隐私政策
       沪ICP备19015600号-1
    
       Copyright © 2018-2019 羽山数据 格兰德上海 版权所有
    
        监督电话：400-110-8298