子账户认证结果通知

{
  "bizType": "INSTITUTION",
  "bizId": "2060249001916727298",
  "bizStatus": "PASSED",
  "clientId": "caoLHPyfvjtnJPJe",
  "data": "{\"subAccountId\":\"53695180\",\"authStatus\":\"PASSED\",\"accountType\":\"KYB\",\"auditTime\":1780036714339,\"rejectReason\":null}"
}

{
  "returnCode": "SUCCESS",
  "returnMessage": null
}

WEBHOOK

institutionVerifyResultNotify

{
  "bizType": "INSTITUTION",
  "bizId": "2060249001916727298",
  "bizStatus": "PASSED",
  "clientId": "caoLHPyfvjtnJPJe",
  "data": "{\"subAccountId\":\"53695180\",\"authStatus\":\"PASSED\",\"accountType\":\"KYB\",\"auditTime\":1780036714339,\"rejectReason\":null}"
}

{
  "returnCode": "SUCCESS",
  "returnMessage": null
}

概述

本页说明 webhook institutionVerifyResultNotify。完整的参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。当子账户 KYB 认证审核完成（通过或驳回）时，GatePay 会向商户在后台配置的 callback URL 发送通知。商户应在该地址接收并解析消息，并返回 HTTP 200 表示已成功接收。

说明

建议基于 bizId 做幂等处理。
验签、重试、data 解析与成功应答见通知概览；签名规则见安全与签名。

触发情形

子账户提交 KYB 认证后，审核完成且状态变为通过或驳回时触发
GatePay 向商户配置的 callback URL 发送通知
若通知投递失败，重试规则见通知概览

消息结构

字段名	类型	说明
`bizType`	`string`	描述通知类别，INSTITUTION-机构通知
`bizId`	`string`	通知业务单号
`bizStatus`	`string`	业务状态 PASSED-认证通过 FAILED-认证驳回
`clientId`	`string`	机构商户 client_id
`data`	string	消息内容 JSON 字符串

`data` 解析后内容

字段名	类型	说明
`subAccountId`	`string`	子账户 ID
`authStatus`	`string`	认证结果 PASSED-通过 FAILED-驳回
`accountType`	`string`	认证类型，固定为 `KYB`
`auditTime`	`int64`	审核完成时间（毫秒）
`rejectReason`	`string`	驳回原因，通过时为空

回调示例

认证通过通知：

{
  "bizType": "INSTITUTION",
  "bizId": "2060249001916727298",
  "bizStatus": "PASSED",
  "clientId": "caoLHPyfvjtnJPJe",
  "data": "{\"subAccountId\":\"53695180\",\"authStatus\":\"PASSED\",\"accountType\":\"KYB\",\"auditTime\":1780036714339,\"rejectReason\":null}"
}

data 解析后内容：

{
  "subAccountId": "53695180",
  "authStatus": "PASSED",
  "accountType": "KYB",
  "auditTime": 1780036714339,
  "rejectReason": null
}

认证驳回通知

{
  "bizType": "INSTITUTION",
  "bizId": "2060249001916727299",
  "bizStatus": "FAILED",
  "clientId": "caoLHPyfvjtnJPJe",
  "data": "{\"subAccountId\":\"53695180\",\"authStatus\":\"FAILED\",\"accountType\":\"KYB\",\"auditTime\":1780036714339,\"rejectReason\":\"证件照片不清晰\"}"
}

请求体

application/json

子账户认证结果回调通知体

bizType

string

必填

描述通知类别，INSTITUTION-机构通知

bizId

string

必填

通知业务单号

bizStatus

string

必填

业务状态 PASSED-认证通过 FAILED-认证驳回

clientId

string

必填

机构商户 client_id

data

string

必填

消息内容 JSON 字符串，解析后参见 InstitutionVerifyResultCallbackData。

响应

200 - application/json

返回 HTTP 200 表示商户已成功接收回调。

商户接收回调后的返回结果。

returnCode

string

必填

返回状态码，例如 SUCCESS。

returnMessage

string | null

返回消息。

创建子账户结果通知

地址支付状态通知

⌘I

公共

余额

机构

支付

OTC

闪兑

出金

礼品卡

订阅

对账

通知

子账户认证结果通知

概述

说明

触发情形

消息结构

`data` 解析后内容

回调示例

认证驳回通知

请求体

响应

​概述

​说明

​触发情形

​消息结构

​data 解析后内容

​回调示例

​认证驳回通知

请求体

响应

概述

说明

触发情形

消息结构

`data` 解析后内容

回调示例

认证驳回通知