> ## 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](/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

* 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": "{\"accountId\":10002,\"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](/global/api-reference/version/100/en/endpoint/fixedaddress/fixedAddressRiskNotify).

## bizStatus Enumeration

| Value | Description |
| - | - |
| `PAY_SUCCESS` | Payment successful and funds 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 |
| `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. |

## Callback Example

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

```json theme={null}
{
  "bizType": "PAY_FIXED_ADDRESS",
  "bizId": "79553757252681728",
  "bizStatus": "PAY_SUCCESS",
  "data": "{\"accountId\":10002,\"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\"}"
}
```

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


## OpenAPI

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

````

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