> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 子账户认证结果通知

> 当子账户 KYB 认证审核完成（通过或驳回）时，GatePay 会向商户在后台配置的 callback URL 发送异步 POST 通知。

回调数据包含 `bizType`、`bizId`、`bizStatus`、`clientId` 和 `data` 字段，其中 `data` 为认证结果对象的 JSON 字符串。商户需在该地址上接收并解析，并返回 HTTP 200 表示接收成功。

## 概述

本页说明 `webhook institutionVerifyResultNotify`。完整的参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。

当子账户 KYB 认证审核完成（通过或驳回）时，GatePay 会向商户在后台配置的 callback URL 发送通知。商户应在该地址接收并解析消息，并返回 HTTP 200 表示已成功接收。

## 说明

* 建议基于 `bizId` 做幂等处理。
* 验签、重试、`data` 解析与成功应答见 [通知概览](/api-reference/version/100/cn/common/asyncNotification)；签名规则见 [安全与签名](/api-reference/version/100/cn/common/securityAndSignature)。

## 触发情形

* 子账户提交 KYB 认证后，审核完成且状态变为通过或驳回时触发
* GatePay 向商户配置的 **callback URL** 发送通知
* 若通知投递失败，重试规则见 [通知概览](/api-reference/version/100/cn/common/asyncNotification)

## 消息结构

| 字段名         | 类型       | 说明                           |
| ----------- | -------- | ---------------------------- |
| `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` | 驳回原因，通过时为空               |

## 回调示例

认证通过通知：

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

`data` 解析后内容：

```json theme={null}
{
  "subAccountId": "53695180",
  "authStatus": "PASSED",
  "accountType": "KYB",
  "auditTime": 1780036714339,
  "rejectReason": null
}
```

### 认证驳回通知

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


## OpenAPI

````yaml api-reference/version/100/cn/openapi/institutional-openapi.json webhook institutionVerifyResultNotify
openapi: 3.1.0
info:
  title: GatePay 机构 API
  description: Gate Pay 机构 API 接口文档
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://openplatform.gateapi.io
security: []
paths: {}

````