> ## 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 Payment Status Notification

> When a static collection address receives a qualifying payment, GatePay sends a webhook with `bizType` `PAY_FIXED_ADDRESS`.

Verify the signature and return `{"returnCode":"SUCCESS","returnMessage":""}` after successful processing. For risky address notifications (`FIXED_ADDRESS_RISK`), see the fixed address risk notification documentation.

## Overview

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

GatePay sends asynchronous notifications to the address callback URL when funds are credited to a static collection address (`bizType` is `PAY_FIXED_ADDRESS`).

## Notes

* Use `transactionId` or `bizId` 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

* When the merchant-bound collection address receives funds, and the collection network and received currency are within the merchant's revenue scope

## Message Structure

| Field       | Type   | Description                              |
| ----------- | ------ | ---------------------------------------- |
| `bizType`   | string | Message type; always `PAY_FIXED_ADDRESS` |
| `bizId`     | string | Order ID                                 |
| `bizStatus` | string | Business status; see table below         |
| `data`      | string | Bill details as a JSON string            |

### Example Message

```json theme={null}
{
  "bizType": "PAY_FIXED_ADDRESS",
  "bizId": "79553757252681728",
  "bizStatus": "PAY_SUCCESS",
  "data": "{\"address\":\"THGthEF4kxhk6STPSUsQcYsUk3FiHX6FKR\",\"amount\":\"498.7\",\"chain\":\"TRX\",\"channel_id\":\"1956171254260887553\",\"createTime\":1780037680066,\"currency\":\"USDT\",\"fromAddress\":\"TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G\",\"orderAmount\":\"498.7\",\"transactionId\":\"79553757252681730\",\"transactionTime\":1780037680066,\"txHash\":\"6711f98a10b9efdcfd35a281fd53554736e100441902ef1d24ee2fb5bb75f15a\"}"
}
```

## bizType Enumeration

| Value               | Description                                    |
| ------------------- | ---------------------------------------------- |
| `PAY_FIXED_ADDRESS` | Static collection address payment notification |

For risky address notifications (`FIXED_ADDRESS_RISK`), see [Fixed Address Risk Notification](/api-reference/version/100/en/endpoint/fixedaddress/fixedAddressRiskNotify).

## bizStatus Enumeration

| Value         | Description                                               |
| ------------- | --------------------------------------------------------- |
| `PAY_SUCCESS` | Payment successful and funds credited                     |
| `PAY_BLOCK`   | Funds received by Gate but held due to risk; not credited |

## data Field Reference

Parsed `data` fields:

| Field             | Type   | Description                                                          |
| ----------------- | ------ | -------------------------------------------------------------------- |
| `channel_id`      | string | Customer name / channel identifier (snake\_case; use actual payload) |
| `currency`        | string | Bill currency                                                        |
| `orderAmount`     | string | Bill amount                                                          |
| `createTime`      | int64  | Bill creation time (milliseconds)                                    |
| `transactionId`   | string | Transaction ID                                                       |
| `transactionTime` | int64  | Bill settlement time (milliseconds)                                  |
| `chain`           | string | Blockchain network                                                   |
| `address`         | string | Collection address                                                   |
| `amount`          | string | Credited amount                                                      |
| `fromAddress`     | string | Payer address                                                        |
| `txHash`          | string | On-chain transaction hash                                            |

## Callback Example

### Payment success (`bizStatus=PAY_SUCCESS`)

```json theme={null}
{
  "bizType": "PAY_FIXED_ADDRESS",
  "bizId": "79553757252681728",
  "bizStatus": "PAY_SUCCESS",
  "data": "{\"address\":\"THGthEF4kxhk6STPSUsQcYsUk3FiHX6FKR\",\"amount\":\"498.7\",\"chain\":\"TRX\",\"channel_id\":\"1956171254260887553\",\"createTime\":1780037680066,\"currency\":\"USDT\",\"fromAddress\":\"TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G\",\"orderAmount\":\"498.7\",\"transactionId\":\"79553757252681730\",\"transactionTime\":1780037680066,\"txHash\":\"6711f98a10b9efdcfd35a281fd53554736e100441902ef1d24ee2fb5bb75f15a\"}"
}
```

### Risk block (`bizStatus=PAY_BLOCK`)

When Gate receives funds but blocks crediting due to risk control:

```json theme={null}
{
  "bizType": "PAY_FIXED_ADDRESS",
  "bizId": "79553757252681729",
  "bizStatus": "PAY_BLOCK",
  "data": "{\"address\":\"THGthEF4kxhk6STPSUsQcYsUk3FiHX6FKR\",\"amount\":\"498.7\",\"chain\":\"TRX\",\"channel_id\":\"1956171254260887553\",\"createTime\":1780037680066,\"currency\":\"USDT\",\"fromAddress\":\"TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G\",\"orderAmount\":\"498.7\",\"transactionId\":\"79553757252681731\",\"transactionTime\":1780037680066,\"txHash\":\"6711f98a10b9efdcfd35a281fd53554736e100441902ef1d24ee2fb5bb75f15a\"}"
}
```

For static collection address APIs, see [static collection address](/api-reference/version/100/en/endpoint/fixedaddress/chains).


## OpenAPI

````yaml /api-reference/version/100/en/openapi/fixed-address-payment-callback-openapi.json webhook fixedAddressPaymentWebhook
openapi: 3.1.0
info:
  title: Gate Pay Static Collection Address Payment Callback API
  version: 1.0.0
  description: >-
    Callbacks when funds are received on a static collection address. GatePay
    sends an asynchronous notification to the callback URL configured for the
    address when income is detected within the supported network and currency
    scope; `data` is a JSON string.
servers:
  - url: https://openplatform.gateapi.io
    description: Production
security: []
paths: {}

````