> ## 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.

# 静态地址风险通知

> 当商户绑定的静态收款地址被识别为风险地址（`is_risk` 为 `1`）时，向对应商户发送一次 webhook 通知。

回调体包含 `bizType`、`bizId`、`bizStatus` 与 `data`。商户收到通知后应更新本地地址风险状态，并避免继续向该地址收款。

## 概述

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

当商户绑定的静态收款地址被识别为风险地址时，GatePay 会向该地址配置的 callback URL 发送异步通知。回调载荷包含 `bizType`（`FIXED_ADDRESS_RISK`）、`bizStatus`（`RISK_ADDRESS`）及 `data`（JSON 字符串）。

## 说明

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

## 触发情形

* 当平台识别到商户绑定的静态收款地址存在风险（`is_risk=1`）时，向该地址配置的 **callback URL** 发送通知
* 收到通知后应停止向该地址继续收款，并在本地更新地址风险状态
* 若通知投递失败，GatePay 将按 [通知概览](/api-reference/version/100/cn/common/asyncNotification) 中的间隔重试

## 消息结构

| 字段名         | 类型     | 说明                       |
| ----------- | ------ | ------------------------ |
| `bizType`   | string | 固定为 `FIXED_ADDRESS_RISK` |
| `bizId`     | string | 业务 ID                    |
| `bizStatus` | string | 固定为 `RISK_ADDRESS`       |
| `clientId`  | string | 商户 `client_id`           |
| `data`      | string | 风险地址明细 JSON 字符串          |

### data 字段说明（解析后）

| 字段名             | 类型     | 说明                                         |
| --------------- | ------ | ------------------------------------------ |
| `accountId`     | int64  | 订单所属的账户ID（商户或机构发起返回其账户ID，机构代子账户发起则返回子账户ID） |
| `customer_name` | string | 客户名称 / 渠道标识                                |
| `address`       | string | 被识别为风险的收款地址                                |

## 回调示例

```json theme={null}
{
  "bizType": "FIXED_ADDRESS_RISK",
  "bizId": "79547404996050989",
  "bizStatus": "RISK_ADDRESS",
  "clientId": "RLSfEKlmvLXYyAVX",
  "data": "{\"accountId\":10002,\"customer_name\":\"5418020260513\",\"address\":\"TT91qAWcHf2xRcev5U3DiQRQ5v3GKxt89E\"}"
}
```


## OpenAPI

````yaml api-reference/version/100/cn/openapi/fixedAddressRiskNotify-openapi.json webhook fixedAddressRiskNotify
openapi: 3.1.0
info:
  title: Gate Pay 静态收款地址 API
  version: 1.0.0
  description: >-
    静态收款地址相关接口与回调。当商户绑定的静态收款地址被识别为风险地址时，GatePay 会向商户配置的 callback URL
    发送异步通知（webhook）。


    收到通知后须先校验签名再处理业务；`data` 为 JSON 字符串，字段含义见下方 Schema 与示例。
servers:
  - url: https://openplatform.gateapi.io
    description: 生产环境
security: []
paths: {}

````