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

# Fixed Address Risk Notification

> Sent once when a merchant-bound static collection address is flagged as risky (`is_risk` is `1`).

The callback body includes `bizType`, `bizId`, `bizStatus`, and `data`. After receiving the notification, update the local address risk state and avoid continuing to collect funds to that address.

## Overview

This page documents `webhook fixedAddressRiskWebhook`. The full schema, parameters, and examples are rendered from the linked OpenAPI or webhook definition above.

When a merchant-bound static collection address is flagged as risky, GatePay sends an asynchronous notification to the callback URL configured for that address. The payload includes `bizType` (`FIXED_ADDRESS_RISK`), `bizStatus` (`RISK_ADDRESS`), and `data` (JSON string).

## Notes

* Use `bizId` or the risk address for idempotency.
* Signature verification, retries, parsing `data`, and the success response are covered in [Notifications Overview](/api-reference/version/100/en/common/asyncNotification); see [Security and Signature](/api-reference/version/100/en/common/securityAndSignature) for signing rules.

## Trigger scenarios

* GatePay sends a notification when a merchant-bound static collection address is flagged as risky (`is_risk=1`)
* Stop collecting to that address locally after receiving the notification
* If delivery fails, GatePay retries according to [Notifications overview](/api-reference/version/100/en/common/asyncNotification)

## Message Structure

| Field       | Type   | Description                           |
| ----------- | ------ | ------------------------------------- |
| `bizType`   | string | Always `FIXED_ADDRESS_RISK`           |
| `bizId`     | string | Business ID                           |
| `bizStatus` | string | Always `RISK_ADDRESS`                 |
| `clientId`  | string | Merchant `client_id`                  |
| `data`      | string | Risk address details as a JSON string |

### Parsed `data` Fields

| Field           | Type   | Description                         |
| --------------- | ------ | ----------------------------------- |
| `customer_name` | string | Customer name / channel identifier  |
| `address`       | string | Collection address flagged as risky |

## Callback Example

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


## OpenAPI

````yaml /api-reference/version/100/en/openapi/fixedAddressRiskNotify-openapi.json webhook fixedAddressRiskWebhook
openapi: 3.1.0
info:
  title: Gate Pay Static Collection Address API
  version: 1.0.0
  description: >-
    Static collection address APIs and callbacks. When a merchant-bound static
    collection address is flagged as risky, GatePay sends an asynchronous
    notification (webhook) to the merchant-configured callback URL.


    Verify the signature before processing business logic. The `data` field is a
    JSON string; see the schemas and examples below for field meanings.
servers:
  - url: https://openplatform.gateapi.io
    description: Production
security: []
paths: {}

````