跳至主内容

prod

New

9:00-21:00
  • #CARD_INITIALS#

    产品特点

    #CARD_SUBTITLE#

    •精准度高


    直连银联专属通道,实时调用,数据库动态及时更新,结果更精准可信,已经支持上亿用户规模使用。


    •技术保障


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

  • #CARD_INITIALS#

    应用场景

    #CARD_SUBTITLE#

    •支付场景


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


    •身份核验


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

  • #CARD_INITIALS#

    覆盖体量

    #CARD_SUBTITLE#

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

    产品标签

    #CARD_SUBTITLE#

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

业务参数

羽山数据API产品详细介绍

分类 : 输入字段
名称说明备注
name
姓名
必填
cardId
银行卡号
必填
cardNo
身份证号
必填
phone
手机号
选填
分类 : 返回字段
名称说明备注
name
姓名
cardNo
身份证号
cardId
卡号
phone
手机号
respDesc
验证结果信息
code    desc
2000    认证一致
2001    认证不一致
2003    不支持验证
respCode
验证结果代码
code    desc
2000    认证一致
2001    认证不一致
2003    不支持验证
respDetail
验证结果详情
code    respDetail
0101    认证不一致:已超过最大查询次数或操作过于频繁
0102    认证不一致:风险受限(黑名单)
0103    认证不一致:无效卡号
0104    认证不一致:卡状态不正常
0105    认证不一致:输入的密码、有效期或CVN2有误,交易失败
0106    认证不一致:户名、证件信息或手机号等验证失败
0107    认证不一致:密码输入次数超限
0108    认证不一致:无效的关联交易
0109    认证不一致:有作弊嫌疑
0110    认证不一致:您的银行卡未预留手机号
0111    认证不一致:卡状态不正常(睡眠卡/未初始化卡)
0112    认证不一致:卡状态不正常(过期卡)
0113    认证不一致:卡状态不正常(挂失卡)
0114    认证不一致:卡状态不正常(被窃卡)
0115    认证不一致:户名验证失败
0116    认证不一致:证件信息验证失败
0117    认证不一致:手机号验证失败
0118    认证不一致:银行卡号验证失败
0119    认证不一致:卡已锁
0120    认证不一致:卡未初始化
0301    不支持验证:交易失败,发卡银行不支持该商户
cardType
卡类型
cardCategory
卡等级
cardName
银行名称

返回码

羽山数据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_B145",
  "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