跳至主内容

prod

H5认证网关

H5认证网关API (IVG000)


本产品通过集成H5视频采集、视频防伪、活体检测、数据核验、等专业认证技术，生成URL或者二维码，嵌入在企业业务场景中，便于终端用户远程实名、实人认证。基于公安部授权的官方数据接口，覆盖身份证、港澳通行证、台胞证、中国护照等多种身份证件的核验，有效防范不法分子利用虚假信息或伪假证件违法违规办理各类业务；也可使得拥有在华护照的港澳台同胞在内地的生活便利。整个方案采用了H5技术，流程完整，可根据客户需求定制化，企业接入快捷，极大的节省了企业的研发成本。

New

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

    产品特点

    -

    •便民高效

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

    •全量数据

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


    •高识别率


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


  • -

    应用场景

    -

    •华侨、护照、身份核验


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


    •全场景身份核查


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

  • -

    覆盖体量

    -

    身份证件、华侨护照、港澳台居民等持有用户全覆盖
  • -

    产品标签

    -

    身份认证、KYC、OCR

出入参数

羽山数据API产品详细介绍

分类 : 输入字段
名称说明
name
姓名
card
证件号
card_type
证件类型
callback_url
回调地址
redirect_url
跳转地址
result_qrcode_display
是否显示认证结果二维码
result_qrcode_expire
二维码过期时间,单位:秒
require_auth_url_qrcode
是否需要生成身份认证页面url二维码
auto_redirect
认证完成后自动跳转时间(单位: 秒)
ext_col
扩展参数
分类 : 返回字段
名称说明
auth_url
身份认证页面url
auth_url_qrcode
身份认证页面二维码(base64格式)
token
token

羽山数据API产品接入信息

报表设置

分类 : 业务异常(retcode)
名称说明
warn_001认证请求失败
分类 : 系统代码(retcode)
名称说明
000000交易成功（收费）
200000调用远程数据异常
200010账号不存在
200012未找到账号与产品的订购关系
200014加解密错误
200013该产品测试条数已用完，请联系羽山数据
err_015数据源请求时出现异常
err_012传入参数不正确
  • -

    结果示例

    -

    {
    "response_sn": "20240708************Q",
    "retdata": {
    "auth_url": "https://passport.yushanshuju.com/ords/f?p=9*********tQU09KV1VTRFdZRF",
    "token": "R0FBTkpCU*************QRVhWR09WTUJMVE9DQVdFR0tQU09KV1VTRFdZRF",
    "auth_url_qrcode": ""
    },
    "version": "1.0",
    "request_sn": "20240708***********F",
    "retmsg": "交易成功",
    "retdate": 172040978**6,
    "retcode": "000000"
    }

羽山数据API产品接入信息

报表设置

分类 : 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": "IVG000",  
 "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 系统代码。
技术支持
400-110-8298
分类 : 2.加解密方法
名称说明
私钥
登录系统或联系技术支持获得接入KEY，
加密JSON Request 和解密response密文时需要使用。
注意要严格保密使用，请勿外泄，如有遗失，自行负责！
请求报文加密算法
将request JSON明文aes-128-cbc 加密后base64编码,随后POST提交.
接收报文解密算法
将response JSON使用base64解码后,aes-128-cbc解密为明文.
分类 : 公共参数
名称说明
request_sn
请求序列号
acct_id
账号
prod_id
产品ID
req_data
传入参数
req_time
请求时间
response_sn
返回单号
retdata
返回参数
retcode
返回代码
retmsg
返回信息
retdate
返回时间戳
  • -

    常见问题

    -

    1.低版本Android包括6.0在内，ios包括14.2版本在内(低版本时，用户需要自己拍摄3-5S视频上传认证）。

    2.假设Android手机，当用户点击禁止访问摄像头时，如再想认证需全部退出界面重新进入再认证。

    3.网络波动较大情况下，认证可能延迟。

    4.录制时应保持面部清晰，否则人脸识别将不准确。

    5.验证必须本人验证，与输入信息保持一致。

    6.录制视频时手机保持平稳，身体不要过度摇晃。

    在Android手机中使用webview调用摄像头注意事项：
    1. 未出现摄像头但是可以进行人脸核验，需开启webview的硬件加速。

    2. 调取摄像头黑屏时无法进行核验（oppo手机或者华为手机：相机权限询问时），需在后端开启相关权限，参考文章：https://www.ngui.cc/zz/802146.html?action=onClick
    -

API推荐

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