跳至主内容

prod

New

9:00-21:00
  • #CARD_INITIALS#

    产品特点

    #CARD_SUBTITLE#

    ·安全合规


    符合我国网络安全法要求,官方授权数据通道,落实国家网络可信身份战略,权威合规, 标准安全。


    · 迅速响应


    直连CTID,提供毫秒级响应速度,每秒万次认证服务能力。平均耗时600毫秒,高效核验、查询,无需等待。


    ·高效稳定


    产品成熟并提供24/7不间断信息数据维护、确保调用稳定、安全、高效。


    · 简单接入


    产品接简单,通过API调用即可,并配有成熟的在线接口文档体系。


    · 覆盖面广


    全国境内两百余家银行授权银行卡全覆盖。
  • #CARD_INITIALS#

    应用场景

    #CARD_SUBTITLE#

    ·互联网金融


    广泛运用于P2P行业,可对借贷人及投资人的身份、银行卡及手机信息进行验证,除此之外,直销银行、基金、证券、信托、保险等领域的业务场景对银行卡四要素鉴权的需求量同样多而广。


    · 征信业务


    常用于征信公司对被吊用户身份信息以及银行卡验证场景,以及当企业与其客户对接具有资金流动业务时,需对客户相关真实信息进行筛选、核验。


    · 用户端实名


    当用户注册或使用系统中特定服务时需对银行卡进行鉴权;另外,此产品还被广泛应用在佣金发放前的信息核验环节。


    · 全支付环节


    支付场景下,用户需进行绑卡操作,银行卡四要素鉴权,可以有效的对用户的姓名、身份证号、银行卡卡号以及手机号进行一致性验证,保证用户信息准确无误、操作过程安全合规。
  • #CARD_INITIALS#

    覆盖体量

    #CARD_SUBTITLE#

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

    产品标签

    #CARD_SUBTITLE#

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

业务参数

羽山数据API产品详细介绍

分类 : 输入字段
名称说明备注
name
姓名
必填
cardNo
身份证号
必填
cardId
卡号
必填
phone
手机号
选填
分类 : 返回字段
名称说明备注
name
姓名
cardNo
身份证号
cardId
卡号
phone
手机号
respDesc
验证结果信息
2000:认证一致
2001:认证不一致
2003:不支持验证
respCode
验证结果代码
2000:认证一致
2001:认证不一致
2003:不支持验证
detailRespCode
验证结果详情
0101  认证不一致:已超过最大查询次数或操作过于频繁
0102  认证不一致:风险受限(黑名单)
0103  认证不一致:无效卡号
0104  认证不一致:卡状态不正常
0105  认证不一致:输入的密码、有效期或CVN2有误,交易失败
0106  认证不一致:户名、证件信息或手机号等验证失败
0107  认证不一致:密码输入次数超限
0108  认证不一致:无效的关联交易
0109  认证不一致:有作弊嫌疑
0110  认证不一致:您的银行卡未预留手机号
0111  认证不一致:卡状态不正常(睡眠卡/未初始化卡)
0112  认证不一致:卡状态不正常(过期卡)
0113  认证不一致:卡状态不正常(挂失卡)
0114  认证不一致:卡状态不正常(被窃卡)
0115  认证不一致:户名验证失败
0116  认证不一致:证件信息验证失败
0117  认证不一致:手机号验证失败
0118  认证不一致:银行卡号验证失败
0119  认证不一致:卡已锁
0120  认证不一致:卡未初始化
0301  不支持验证:交易失败,发卡银行不支持该商户
0302  不支持验证:您的银行卡暂不支持该业务
0303  不支持验证:交易失败或银行拒绝交易,请联系发卡行
0304  不支持验证:受限制的卡或卡不在白名单中,无法进行交易
0305  不支持验证:您的银行卡暂不支持手机号验证
0306  不支持验证:您的手机未开通无卡支付服务
0307  不支持验证:请开通无卡支付服务
0308  不支持验证:未知商户,不予通过

返回码

羽山数据API产品接入信息

报表设置

分类 : 业务异常(retcode)
名称说明
warn_130银行卡鉴权失败!
warn_111您输入的为无效身份证号码,请核对后重新输入!
warn_059您输入的手机号码无效,请核对后重新输入!
warn_302您输入的银行卡号无效,请核对后重新输入!
warn_303您输入的姓名无效,请核对后重新输入!
warn_304您输入的多个参数无效,请核对后重新输入!
分类 : 系统代码(retcode)
名称说明
000000交易成功
200000调用远程数据异常
200010用户不存在或者状态不存在
200011产品/接口,没有映射关系,或者产品/接口状态不正确
200012未找到账号与产品的订购关系
200013账号冻结,请联系羽山数据
200014您的账户被销户
200015Account 没有AES key 请联系羽山数据运维人员
err_000交易失败
err_008客户端回调失败
err_011无合适的适配产品
err_012传入参数不正确
err_014模型请求失败
err_015数据源请求时出现异常
err_016模型计算时出现异常
err_017数据源请求超时
err_018模型请求超时
-99999系统处理异常,请联系羽山数据

羽山数据API产品接入信息

报表设置

分类 : 1.对接信息
名称说明
IP白名单
本系统具有IP白名单限制,需要先请确认自身服务器公网IP已由羽山数据运维工程师加入
协议
HTTP/HTTPS POST
编码格式
UTF8
HEAD: X_GLAD_ACCT_ID
必填,开户后将获得接入账号acct_id,如“yushan_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样例
{
  "acct_id": "yushan_test_user",
  "prod_id": "P_C_B142",
  "req_data": {
    这里是业务入参
  },
  "req_time": 1545270159122,
  "request_sn": "4df1e3c9583d40a9a57f63e4ab153189"
}
明文Request JSON样例说明
acct_id 需要使用自己的账户。inf_id&prod_id 为产品编号。req_data 为业务入参,请参考下面详细信息。
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 '{"acct_id":"yushan_test_user","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
csbiSsLIsORrJVXVvuAPKKYhPKeJhe6XYolGa6VvfXK7irFcohKmcMVxokNba1+
o4GQkjMXxQdVC1Lqx2Q9XeVS2pGcFrzJKlOHRt7yJWVahURpEmXL8IA2d
ozEhrG5bBnWc3jTZYO50OQBH0jCOsjRE8q5qI5UQCA42gNposviVrVfcnZJRqqyrvVW
kOGF8uqc57sKLzVVzgvdTZuoHWWwoyPmKUXq9dNw==' | base64 -d | openssl aes-128-cbc -d -K 8f781ee51319e00535de09525af6068b -iv 30303030303030303030303030303030 -p