Fixed Address Risk Notification

{
  "bizType": "FIXED_ADDRESS_RISK",
  "bizId": "79547404996050989",
  "bizStatus": "RISK_ADDRESS",
  "clientId": "RLSfEKlmvLXYyAVX",
  "data": "{\"accountId\":10002,\"customer_name\":\"5418020260513\",\"address\":\"TT91qAWcHf2xRcev5U3DiQRQ5v3GKxt89E\"}"
}

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

WEBHOOK

fixedAddressRiskWebhook

{
  "bizType": "FIXED_ADDRESS_RISK",
  "bizId": "79547404996050989",
  "bizStatus": "RISK_ADDRESS",
  "clientId": "RLSfEKlmvLXYyAVX",
  "data": "{\"accountId\":10002,\"customer_name\":\"5418020260513\",\"address\":\"TT91qAWcHf2xRcev5U3DiQRQ5v3GKxt89E\"}"
}

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

Overview

This page documents webhook fixedAddressRiskWebhook. The full schema, parameters, and examples are rendered from the linked OpenAPI or webhook definition above. When a merchant-bound static collection address is flagged as risky, GatePay sends an asynchronous notification to the callback URL configured for that address. The payload includes bizType (FIXED_ADDRESS_RISK), bizStatus (RISK_ADDRESS), and data (JSON string).

Notes

Use bizId or the risk address 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

GatePay sends a notification when a merchant-bound static collection address is flagged as risky (is_risk=1)
Stop collecting to that address locally after receiving the notification
If delivery fails, GatePay retries according to Notifications overview

Message Structure

Field	Type	Description
`bizType`	string	Always `FIXED_ADDRESS_RISK`
`bizId`	string	Business ID
`bizStatus`	string	Always `RISK_ADDRESS`
`clientId`	string	Merchant `client_id`
`data`	string	Risk address details as a JSON string

Parsed `data` Fields

Field	Type	Description
`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.
`customer_name`	string	Customer name / channel identifier
`address`	string	Collection address flagged as risky

Callback Example

{
  "bizType": "FIXED_ADDRESS_RISK",
  "bizId": "79547404996050989",
  "bizStatus": "RISK_ADDRESS",
  "clientId": "RLSfEKlmvLXYyAVX",
  "data": "{\"accountId\":10002,\"customer_name\":\"5418020260513\",\"address\":\"TT91qAWcHf2xRcev5U3DiQRQ5v3GKxt89E\"}"
}

Body

application/json

bizType

enum<string>

Business type; always FIXED_ADDRESS_RISK.

Available options:

FIXED_ADDRESS_RISK

bizId

string

Business ID (for example a channel and network composite identifier; actual value is as returned).

bizStatus

enum<string>

Business status; always RISK_ADDRESS (risky address).

Available options:

RISK_ADDRESS

data

string

Risk address details as a JSON string; includes customer_name, address, etc. after parsing.

clientId

string

商户 client_id。

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.

Unresolved Payment Notification

OTC Order Status Update Notification

⌘I

Common

Balance

Institution

Payment

OTC

Convert

Payout

Gift Card

Subscription

Reconciliation

Notifications

Fixed Address Risk Notification

Overview

Notes

Trigger scenarios

Message Structure

Parsed `data` Fields

Callback Example

Body

Response

​Overview

​Notes

​Trigger scenarios

​Message Structure

​Parsed data Fields

​Callback Example

Body

Response

Overview

Notes

Trigger scenarios

Message Structure

Parsed `data` Fields

Callback Example