跳转到主要内容
WEBHOOK
fixedAddressRiskNotify
{
  "bizType": "FIXED_ADDRESS_RISK",
  "bizId": "79547404996050989",
  "bizStatus": "RISK_ADDRESS",
  "clientId": "RLSfEKlmvLXYyAVX",
  "data": "{\"customer_name\":\"5418020260513\",\"address\":\"TT91qAWcHf2xRcev5U3DiQRQ5v3GKxt89E\"}"
}
{
  "returnCode": "SUCCESS",
  "returnMessage": ""
}

Documentation Index

Fetch the complete documentation index at: https://docs.gate.com/llms.txt

Use this file to discover all available pages before exploring further.

​
概述

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

​
说明

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

​
触发情形

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

​
消息结构

字段名类型说明
bizTypestring固定为 FIXED_ADDRESS_RISK
bizIdstring业务 ID
bizStatusstring固定为 RISK_ADDRESS
clientIdstring商户 client_id
datastring风险地址明细 JSON 字符串

​
data 字段说明（解析后）

字段名类型说明
customer_namestring客户名称 / 渠道标识
addressstring被识别为风险的收款地址

​
回调示例

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

请求体

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

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