> ## 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](/global/api-reference/version/100/en/common/asyncNotification); see [Security and Signature](/global/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](/global/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 |
| - | - | - |
| `accountId` | int64 | Account ID that owns the order. Returns the merchant or institution's own account ID when the merchant or institution initiates the order; returns the sub-account ID when the institution initiates on behalf of a sub-account. |
| `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": "{\"accountId\":10002,\"customer_name\":\"5418020260513\",\"address\":\"TT91qAWcHf2xRcev5U3DiQRQ5v3GKxt89E\"}"
}
```


## OpenAPI

````yaml global/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: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.