Payment
Fixed Address Risk Notification
Sent once when a merchant-bound static collection address is flagged as risky (is_risk is 1).
The callback body includes bizType, bizId, bizStatus, and data. After receiving the notification, update the local address risk state and avoid continuing to collect funds to that address.
WEBHOOK
Overview
This page documentswebhook 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
bizIdor 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 |
|---|---|---|
customer_name | string | Customer name / channel identifier |
address | string | Collection address flagged as risky |
Callback Example
Body
application/json
Business type; always FIXED_ADDRESS_RISK.
Available options:
FIXED_ADDRESS_RISK Business ID (for example a channel and network composite identifier; actual value is as returned).
Business status; always RISK_ADDRESS (risky address).
Available options:
RISK_ADDRESS Risk address details as a JSON string; includes customer_name, address, etc. after parsing.
商户 client_id。
Response
200 - application/json
HTTP 200 indicates the merchant successfully received the notification.