认证结束异步通知

更新时间:2024-06-06 15:13:53

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方式)。

我要纠错