H5接入指南

H5集成方式需要服务端调用获取核验地址的接口，得到前端可跳转的地址。在前端核验地址按引导完成核验后会返回核验结果到申请时配置的回调地址。

1. 集成流程

img

2. 公共参数

2.1 公共请求参数

字段名 字段内容 字段类型 是否必填
version 版本，默认为1.0 String 是
signAlgo 签名算法,目前只支持HMAC和HmacSHA256 String 是
deviceId 由BJCA分配的设备ID String 是
appId 由BJCA分配的应用ID String 是
transId 业务调用方随机生成的唯一标识，支持最大64位，业务流水号 String 是
signature 签名值。对请求报文进行签名计算得到，计算方法参考2.1.3章节 String 是

2.2 公共响应参数

字段名称 字段内容 字段类型 是否必须
status 响应码，200即为成功 String 是
message 响应信息 String 是
trace 错误栈信息 String 否
data 响应内容 String 否

2.3 响应报文

{
    “status”:错误码,//类型为数字，2xx 为成功，其他为失败；3位、4位错误码给应用网关保留；业务错误码8位，其中前三位为系统ID，后五位为错误信息
    “message”:””,
    “trace”:”错误栈信息”,//可选参数，一般用于debug模式描述信息
    “data”:{
    “data1”:””, //业务数据
    “data2”:[],
    “datan”:{}
 }
 
}

3. 签名值计算方法

链接到API的签名值计算方法就行

4. 相关接口

产品名称 产品型号 API接口 计费点
H5个人实人认证 SF-H5-P 三、服务接口 1、个人核验 4、查询个人核验结果 个人核验
H5两项及人像实人认证 SF-H5-P-SR02 三、服务接口 1、个人核验 4、查询个人核验结果 个人核验
H5手机号实人认证 SF-H5-P-SJ 三、服务接口 1、个人核验 4、查询个人核验结果 个人核验
H5银行卡实人认证 SF-H5-P-YHK4 三、服务接口 1、个人核验 4、查询个人核验结果 个人核验
H5企业实人认证 SF-H5-E 三、服务接口 2、企业核验 5、查询企业核验结果 企业核验