个人认证流程结束通知

更新时间:2026-01-09 16:12:46

【触发条件】当个人认证完成后触发(认证方式包含刷脸、运营商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"
}
我要纠错