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

# 静态地址支付状态通知

> 静态收款地址到账时，GatePay 发送 `bizType` 为 `PAY_FIXED_ADDRESS` 的 webhook 通知。

商户须校验签名，处理成功后返回 `{"returnCode":"SUCCESS","returnMessage":""}`。风险地址通知（`FIXED_ADDRESS_RISK`）见静态地址风险通知文档。

## 概述

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

静态收款地址到账时，GatePay 向地址配置的 callback URL 发送异步通知（`bizType` 为 `PAY_FIXED_ADDRESS`）。

## 说明

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

## 触发情形

* 当商户绑定的收款地址有收入，且收款网络和接收币种在商户营收范围内

## 消息结构

| 字段名         | 类型     | 说明                           |
| ----------- | ------ | ---------------------------- |
| `bizType`   | string | 消息类型，固定为 `PAY_FIXED_ADDRESS` |
| `bizId`     | string | 订单号                          |
| `bizStatus` | string | 业务状态，见下表                     |
| `data`      | string | 账单明细 JSON 字符串                |

### 消息结构示例

```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 枚举值

| 值                   | 说明       |
| ------------------- | -------- |
| `PAY_FIXED_ADDRESS` | 静态地址收款通知 |

风险地址通知（`FIXED_ADDRESS_RISK`）见 [静态地址风险通知文档](/api-reference/version/100/cn/endpoint/fixedaddress/fixedAddressRiskNotify)。

## bizStatus 枚举值

| 值             | 说明       |
| ------------- | -------- |
| `PAY_SUCCESS` | 支付成功，且到账 |

## data 字段说明

`data` 解析后的字段如下：

| 字段名               | 类型     | 说明                                         |
| ----------------- | ------ | ------------------------------------------ |
| `channel_id`      | string | 客户名称 / 渠道标识（蛇形命名，以实际返回为准）                  |
| `currency`        | string | 账单币种                                       |
| `orderAmount`     | string | 账单金额                                       |
| `createTime`      | int64  | 账单创建时间（毫秒）                                 |
| `transactionId`   | string | 交易流水号                                      |
| `transactionTime` | int64  | 账单成交时间（毫秒）                                 |
| `chain`           | string | 网络                                         |
| `address`         | string | 收款地址                                       |
| `amount`          | string | 到账金额                                       |
| `fromAddress`     | string | 付款方地址                                      |
| `txHash`          | string | 链上交易 Hash                                  |
| `accountId`       | int64  | 订单所属的账户ID（商户或机构发起返回其账户ID，机构代子账户发起则返回子账户ID） |

## 回调示例

### 支付成功（`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\"}"
}
```

静态收款地址的创建与查询见 [静态收款地址 API](/api-reference/version/100/cn/endpoint/fixedaddress/chains)。


## OpenAPI

````yaml api-reference/version/100/cn/openapi/fixed-address-payment-callback-openapi.json webhook fixedAddressPaymentNotify
openapi: 3.1.0
info:
  title: Gate Pay 静态收款地址支付回调 API
  version: 1.0.0
  description: >-
    静态收款地址支付到账回调。当商户绑定的收款地址有收入且收款网络、币种在营收范围内时，GatePay 向该地址配置的 callback URL
    发送异步通知；`data` 为 JSON 字符串。
servers:
  - url: https://openplatform.gateapi.io
    description: 生产环境
security: []
paths: {}

````