【触发条件】当个人认证完成后触发(认证方式包含刷脸、运营商3要素、银行卡4要素认证)。
- 目前通过HTTP协议,以POST方法进行通知调用;
开发者在对接时,需注意:
如果认证过程选择刷脸方式进行认证,进入到刷脸页面的时候,会主动通过GET方式去访问接口设置的异步回调地址,开发者在接收到GET方式请求过去的记录时,可以直接忽略或者不做GET接收;开发者对于异步回调通知只需通过POST方式进行接收即可,认证结果以实际POST方式接收的异步通知为准。
- 调用超时时间5秒,首次调用失败后,1s后重试;再次失败后间隔5s再次重试,再次失败则不再通知;
- 对接方在接收到回调请求时,需返回HTTP 状态码 200;
回调参数:
参数名 | 类型 | 说明 |
flowId | string | 个人认证流程id |
accountId | string | 个人账户id,核身认证不返回,开发者可忽略 |
success | boolean | 认证是否成功. true - 成功; false - 失败 |
contextId | string | 业务上下文Id |
verifycode | string | 认证结果校验码,用于串联e签宝其他业务 |
serviceId | string | 历史版本兼容字段,新用户忽略,等价于flowId |
status | boolean | 历史版本兼容字段,新用户忽略,等价于success |
failReasonCode | string | 刷脸失败的错误码(需要开启认证失败通知且刷脸失败时才可能返回) 1445034 - 当前浏览器不支持该认证方式,请使用其他浏览器操作 1445035 - 当前设备不支持该认证方式,请使用其他设备操作 1445700 - 认证表达结果与标准答案不一致 1445902 - 姓名或身份证号有误 1445813 - 眼睛被遮挡,请检测眼镜或周围光线 1445900 - 无法判断为同一人,请确认身份后重试 1445702 - 语音识别服务异常 1445910 - 证件号格式有误 1445701 - 认证视频用户回答音频无声音 1445409 - 网络不给力,请稍后再试 1445909 - 姓名格式有误 1445011 - 认证失败 1445907 - 比对相似度未达到通过标准 注意:目前仅刷脸方式使用智能视频认证时支持返回当前错误码 |
action | string | 标记该通知的业务类型,该通知固定为:identity_psn_end 注意:该字段只有在「开放平台」的应用配置-Webhook-独立实名认证服务中勾选了“个人实名完成”才会触发 |
通知示例:
{
"flowId": "346106111111066430",
"success": true,
"contextId": "1234455",
"verifycode": "04009140111111123078b1755",
"serviceId": "3461111111119066430",
"status": true,
"action": "identity_psn_end"
}