【触发条件】当企业通过API发起对公账户打款认证时,可以通过回调通知获取打款申请被银行受理成功还是失败。
- 目前通过HTTP协议,以POST方法进行通知调用;
开发者在对接时,需注意:
如果认证过程选择刷脸方式进行认证,进入到刷脸页面的时候,会主动通过GET方式去访问接口设置的异步回调地址,开发者在接收到GET方式请求过去的记录时,可以直接忽略或者不做GET接收;开发者对于异步回调通知只需通过POST方式进行接收即可,认证结果以实际POST方式接收的异步通知为准。
- 调用超时时间5秒,首次调用失败后,1s后重试;再次失败后间隔5s再次重试,再次失败则不再通知;
- 对接方在接收到回调请求时,需返回HTTP 状态码 200;
回调参数:
参数名 | 类型 | 说明 |
msg | string | 打款通知信息 |
result | string | 打款结果 (1)PAY_SUCCESS:打款成功 (2)PAY_FAIL:打款申请失败 (3)FAIL:银行受理失败 |
payedTime | string | 交易时间 |
pizId | string | 业务方业务上下文id,接口传入的contextId |
flowId | string | 实名认证流程ID |
serviceId | string | 对公打款服务ID |
projectId | string | 应用ID,即调用接口的应用ID |
action | string | 标记该通知的业务类型,该通知固定为:identity_org_payed 注意:该字段只有在「开放平台」的应用配置-消息订阅-独立实名认证服务中勾选了“企业对公打款通知”才会触发 |
通知示例:
{
"result": "PAY_SUCCESS",
"payedTime": 1721035680000,
"pizId": "X0000000000001",
"serviceId": "675bf01e-b4f3-1111-8c89-14a2b0e61320",
"flowId": "34611111116021953",
"projectId": "511111141",
"action": "identity_org_payed"
}