e签宝认证业务在认证流程成功结束或失败时(例如企业对公打款,在填完打款金额提交之后如果这个金额校验成功,实名认证成功触发异步通知),会通过流程发起时指定的notifyUrl参数,向调用方发送异步通知。
- 目前通过HTTP协议,以POST方法进行通知调用;
开发者在对接时,需注意:
如果认证过程选择刷脸方式进行认证,进入到刷脸页面的时候,会主动通过GET方式去访问接口设置的异步回调地址,开发者在接收到GET方式请求过去的记录时,可以直接忽略或者不做GET接收;开发者对于异步回调通知只需通过POST方式进行接收即可,认证结果以实际POST方式接收的异步通知为准。
- 调用超时时间5秒,首次调用失败后,3s后重试;再次失败后间隔6s再次重试,再次失败则不再通知;
- 对接方在接收到回调请求时,需返回HTTP 状态码 200;
- 为了保障异步通知的可靠性,建议业务方在回调请求处理中,尽可能减少业务操作,改用异步方式处理后续业务流程。
- 通知参数如下:
个人认证流程结束通知参数:
参数名 | 类型 | 说明 |
flowId | string | 个人认证流程id |
accountId | string | 个人账户id,核身认证时为null |
success | boolean | 认证是否成功. true - 成功; false - 失败 |
contextId | string | 业务上下文Id |
verifycode | string | 认证结果校验码,用于串联e签宝其他业务 |
serviceId | string | 历史版本兼容字段,新用户忽略,等价于flowId |
status | boolean | 历史版本兼容字段,新用户忽略,等价于success |
action | string | 标记该通知的业务类型,该通知固定为:identity_psn_end 注意:该字段只有在「开放平台」的应用配置-消息订阅-独立实名认证服务中勾选了“个人实名完成”才会触发 |
组织认证流程结束通知参数:
参数名 | 类型 | 说明 |
flowId | string | 组织认证流程id |
agentFlowId | string | 办理人认证流程id,无经办理人认证是为null |
accountId | string | 组织账户id,核身认证时为null |
agentAccountId | string | 办理人账户id,核身认证时为null |
success | boolean | 认证是否成功. true - 成功; false - 失败 |
contextId | string | 业务上下文Id |
verifycode | string | 认证结果校验码,用于串联e签宝其他业务 |
orgAccountId | string | 历史版本兼容字段,新用户忽略,等价于accountId |
serviceId | string | 历史版本兼容字段,新用户忽略,等价于flowId |
agentServiceId | string | 历史版本兼容字段,新用户忽略,等价于agentFlowId |
status | boolean | 历史版本兼容字段,新用户忽略,等价于success |
action | string | 标记该通知的业务类型,该通知固定为:identity_org_end 注意:该字段只有在「开放平台」的应用配置-消息订阅-独立实名认证服务中勾选了“企业实名完成”才会触发 |
企业对公打款异步通知参数:
参数名 | 类型 | 说明 |
msg | string | 打款通知信息 |
result | string | 打款结果 (1)PAY_SUCCESS:打款受理成功(真实的打款状态需根据实际到账来判断) (2)PAY_FAIL:打款申请失败 (3)FAIL:银行受理失败 |
payedTime | string | 交易时间 |
pizId | string | 银行流水交易号 |
flowId | string | 实名认证流程ID |
serviceId | string | 对公打款服务ID |
projectId | string | 应用ID,即调用接口的应用ID |
action | string | 标记该通知的业务类型,该通知固定为:identity_org_payed 注意:该字段只有在「开放平台」的应用配置-消息订阅-独立实名认证服务中勾选了“企业对公打款通知”才会触发 |
注意:实名认证接口 - 选择刷脸方式,完成认证后会多推送一个body为空的get方式异步回调,导致客户验签不通过导致报错,建议是异步通知新增判断,只接收POST请求的回调(过滤掉GET方式)。