跳至主内容

prod

New

9:30-17:30
  • -

    产品特点

    -

    •便民高效


    彻底有效地解决网上注册难、不能自助办理、人工识别验证慢、提交辅助证明材料多、办事流程周期长等让人头大的问题,并一定程度上保护了华侨们的财产安全。


    •全量数据


    直连出入境管理局官方数据库,覆盖全量注册用户信息,实现全范围实时精准调用,有效提高用户体验。


    •高识别率


    提供企业级稳定、精准的全球大流量数据源,实时查询、比对,降低误识率,结果精准可靠。

  • -

    应用场景

    -

    •华侨身份核验


    按照《中华人民共和国出境入境管理法》规定,定居国外的中国公民在中国境内办理金融、教育、医疗、交通、电信、社会保险、财产登记等事务需要对其身份及证件进行核实。


    •全场景身份核查


    适用于全行业场景服务,具体服务场景包括:互联网注册、购买火车票、入住酒店、网上预约就诊、办理电话卡、使用公共交通设备、开通银行账户等。有效与同类身份核验产品(公民、港澳台胞、在华居住外国人口核验等)互补,实现全客户身份核验。

  • -

    覆盖体量

    -

    中国华侨护照持有用户全覆盖
  • -

    产品标签

    -

    身份认证、KYC

业务参数

羽山数据API产品详细介绍

分类 : 输入字段
名称说明备注
cardNo
证件号
必填
idType
证件类型
必填,
414 华侨及中国护照
511 台湾居民来往大陆通行证、台胞证
516 港澳居民来往内地通行证
553 外国人永久居留身份证
mode
认证模式
必填
0:二要素核验(姓名+证件号)
1:人像三要素核验(姓名+证件号+人像)
2:出生日期+证件号
3:出生日期+证件号+人像
4:出生日期+性别+有效期至+证件号+姓名
5:出生日期+性别+有效期至+证件号+姓名+人像
nation
国籍
必填,国家名英文缩写,参照国籍三位 ISO3166 标准,华侨和港澳人员 使用 CHN
image
人像
非必填,Base64 字符串,5-40KB 以内
name
姓名
非必填
birthDate
出生日期
非必填,格式 19900102
sex
性别
非必填,男:1; 女:2
expiryDate
证件有效期至
非必填,格式 20180105
分类 : 返回字段
名称说明备注
result
"result":{
           "final_auth_result": "0XXXXXXX"
        }
最终核验结果,八位字符串:0XXXXXXX 以前四位为准

第一字符:认证文本信息匹配比对
0 文本信息比对一致 
1 参数错误 
7 文本信息比对不一致(不存在该证或该人,或证件与人)
8 文本信息比对一致但证件失效(证件失效) 
W 系统内部错误 
X 未执行

第二字符:人像比对
0 同一人
1 比对不是同一人(1、 照片为本人,但是照片可能有角 度、光线过暗、脸部区域有亮斑 2、 照片为本人,但是该照片尺寸太小 3、 两人长相类似) 
D 人像数据未录入(数据库中无该人像模板 )
E 现场照片质量不足或格式不对(1、 照片可能有角度、光线过暗、脸部 区域有亮斑、模糊 2、照片尺寸太小 3、非 JPEG 格式的图像) 
H 活体检测控件版本过期或检测数据校验失败 (1、活体检测控件版本过期 2、活体检测数据校验失败)
W 系统内部错误 
X 未执行

第三字符:保留

第四字符:户籍状态标识
0 无户籍 (如华侨人员)
1 有户籍 
X 未执行或不确定有无户籍

返回码

羽山数据API产品接入信息

报表设置

分类 : 业务异常(retcode)
名称说明
warn_001公安认证失败:****
分类 : 系统代码(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: ACCT_ID
必填,开户后将获得接入账号APP_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样例
{
  "prod_id": "P_C_B608",
  "req_data": {
    这里是业务入参
  },
  "req_time": 1545270159122,
  "request_sn": "4df1e3c9583d40a9a57f63e4ab153189"
}
明文Request JSON样例说明
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 '{"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
分类 : 公共参数
名称说明
request_sn
请求序列号
acct_id
账号
prod_id
产品ID
req_data
传入参数
req_time
请求时间

羽山数据助力企业数字化