静态地址支付状态通知

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

{
  "returnCode": "SUCCESS",
  "returnMessage": ""
}

WEBHOOK

fixedAddressPaymentNotify

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

{
  "returnCode": "SUCCESS",
  "returnMessage": ""
}

概述

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

说明

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

触发情形

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

消息结构

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

消息结构示例

{
  "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）见静态地址风险通知文档。

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`）

{
  "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。

请求体

application/json

bizType

enum<string>

必填

业务类型，固定为 PAY_FIXED_ADDRESS。

可用选项:

PAY_FIXED_ADDRESS

bizId

string

必填

订单号。

bizStatus

enum<string>

必填

业务状态：PAY_SUCCESS 支付成功且到账。

可用选项:

PAY_SUCCESS

data

string

必填

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

fixedAddressPaymentData

object

data 解析后的账单明细。

Show child attributes

description

any

响应

200 - application/json

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

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

returnCode

string

必填

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

returnMessage

string | null

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

地址支付状态通知

Gate 支付状态通知

⌘I

公共

余额

机构

支付

OTC

闪兑

出金

礼品卡

订阅

对账

通知

静态地址支付状态通知

概述

说明

触发情形

消息结构

消息结构示例

bizType 枚举值

bizStatus 枚举值

data 字段说明

回调示例

支付成功（`bizStatus=PAY_SUCCESS`）

请求体

响应

​概述

​说明

​触发情形

​消息结构

​消息结构示例

​bizType 枚举值

​bizStatus 枚举值

​data 字段说明

​回调示例

​支付成功（bizStatus=PAY_SUCCESS）

请求体

响应

概述

说明

触发情形

消息结构

消息结构示例

bizType 枚举值

bizStatus 枚举值

data 字段说明

回调示例

支付成功（`bizStatus=PAY_SUCCESS`）