企业对公打款异步通知

更新时间:2024-07-15 17:34:31

【触发条件】当企业通过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"
}
我要纠错