跳转到主要内容
WEBHOOK
fixedAddressPaymentNotify
{
  "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\"}"
}
{
  "returnCode": "SUCCESS",
  "returnMessage": ""
}

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.

​
概述

本页说明 webhook fixedAddressPaymentNotify。完整的参数、响应结构与示例由上方关联的 OpenAPI 或 webhook 定义渲染。 静态收款地址到账时，GatePay 向地址配置的 callback URL 发送异步通知（bizType 为 PAY_FIXED_ADDRESS）。

​
说明

  • 建议基于 transactionId 或 bizId 做幂等处理。
  • 验签、重试、data 解析与成功应答见 通知概览；签名规则见 安全与签名。

​
触发情形

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

​
消息结构

字段名类型说明
bizTypestring消息类型，固定为 PAY_FIXED_ADDRESS
bizIdstring订单号
bizStatusstring业务状态，见下表
datastring账单明细 JSON 字符串

​
消息结构示例

{
  "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 枚举值

值说明
PAY_FIXED_ADDRESS静态地址收款通知
风险地址通知（FIXED_ADDRESS_RISK）见 静态地址风险通知文档。

​
bizStatus 枚举值

值说明
PAY_SUCCESS支付成功，且到账
PAY_BLOCKGate 成功接收，但资金有风险，不会入账

​
data 字段说明

data 解析后的字段如下：
字段名类型说明
channel_idstring客户名称 / 渠道标识（蛇形命名，以实际返回为准）
currencystring账单币种
orderAmountstring账单金额
createTimeint64账单创建时间（毫秒）
transactionIdstring交易流水号
transactionTimeint64账单成交时间（毫秒）
chainstring网络
addressstring收款地址
amountstring到账金额
fromAddressstring付款方地址
txHashstring链上交易 Hash

​
回调示例

​
支付成功（bizStatus=PAY_SUCCESS）

{
  "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\"}"
}

​
风险阻塞（bizStatus=PAY_BLOCK）

Gate 已接收资金但因风控未入账时，可能收到如下通知： 
{
  "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\"}"
}
静态收款地址的创建与查询见 静态收款地址 API。

请求体

application/json
​
bizType
enum<string>
必填

业务类型，固定为 PAY_FIXED_ADDRESS。

可用选项:
PAY_FIXED_ADDRESS
​
bizId
string
必填

订单号。

​
bizStatus
enum<string>
必填

业务状态：PAY_SUCCESS 支付成功且到账；PAY_BLOCK Gate 已成功接收但资金有风险，不会入账。

可用选项:
PAY_SUCCESS,
PAY_BLOCK
​
data
string
必填

业务数据 JSON 字符串，解析后结构见 fixedAddressPaymentData。

​
fixedAddressPaymentData
object

data 解析后的账单明细。

​
description
any

响应

200 - application/json

返回 HTTP 200 表示商户已成功接收通知。

商户接收通知后的响应体。

​
returnCode
string
必填

返回状态码，SUCCESS 表示成功。

​
returnMessage
string | null

返回说明，成功时可为空。