Skip to main content
WEBHOOK

​
概述

本页说明 webhook fixedAddressRiskNotify。完整的参数、响应结构与示例由上方关联的 OpenAPI 或 webhook 定义渲染。 当商户绑定的静态收款地址被识别为风险地址时，GatePay 会向该地址配置的 callback URL 发送异步通知。回调载荷包含 bizType（FIXED_ADDRESS_RISK）、bizStatus（RISK_ADDRESS）及 data（JSON 字符串）。

​
说明

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

​
触发情形

  • 当平台识别到商户绑定的静态收款地址存在风险（is_risk=1）时，向该地址配置的 callback URL 发送通知
  • 收到通知后应停止向该地址继续收款，并在本地更新地址风险状态
  • 若通知投递失败，GatePay 将按 通知概览 中的间隔重试

​
消息结构

​
data 字段说明（解析后）

​
回调示例

请求体

application/json
​
bizType
enum<string>

业务类型，固定为 FIXED_ADDRESS_RISK。

可用选项:
FIXED_ADDRESS_RISK
​
bizId
string

业务 ID（如渠道与网络组合标识，以实际返回为准）。

​
bizStatus
enum<string>

业务状态，固定为 RISK_ADDRESS（风险地址）。

可用选项:
RISK_ADDRESS
​
data
string

风险地址明细 JSON 字符串，解析后含 customer_name、address 等字段。

​
clientId
string

商户 client_id。

响应

200 - application/json

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

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

​
returnCode
string
必填

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

​
returnMessage
string | null

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