Fixed Address Payment Status Notification

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

fixedAddressPaymentWebhook

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

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; see Security and Signature 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

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

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

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

Body

application/json

bizType

enum<string>

required

Business type; always PAY_FIXED_ADDRESS.

Available options:

PAY_FIXED_ADDRESS

bizId

string

required

Order ID.

bizStatus

enum<string>

required

Business status: PAY_SUCCESS payment successful and credited.

Available options:

PAY_SUCCESS

data

string

required

Business data as a JSON string; parsed structure see fixedAddressPaymentData.

fixedAddressPaymentData

object

Parsed bill details from data.

Show child attributes

description

any

Response

200 - application/json

HTTP 200 indicates the merchant successfully received the notification.

Response body returned by the merchant after receiving the notification.

returnCode

string

required

Return status code; SUCCESS indicates success.

returnMessage

string | null

Return message; may be empty on success.

Address Payment Status Notification

Gate Payment Status Notification

⌘I

Common

Balance

Institution

Payment

OTC

Convert

Payout

Gift Card

Subscription

Reconciliation

Notifications

Fixed Address Payment Status Notification

Overview

Notes

Trigger Scenarios

Message Structure

Example Message

bizType Enumeration

bizStatus Enumeration

data Field Reference

Callback Example

Payment success (`bizStatus=PAY_SUCCESS`)

Body

Response

​Overview

​Notes

​Trigger Scenarios

​Message Structure

​Example Message

​bizType Enumeration

​bizStatus Enumeration

​data Field Reference

​Callback Example

​Payment success (bizStatus=PAY_SUCCESS)

Body

Response

Overview

Notes

Trigger Scenarios

Message Structure

Example Message

bizType Enumeration

bizStatus Enumeration

data Field Reference

Callback Example

Payment success (`bizStatus=PAY_SUCCESS`)