RFI 状态

您可以开通 RFI（Request For Information，补充材料请求）Webhook 通知服务。当用户的 RFI 被发起或状态发生变化时，Legend 会通过 /rfi-status 自动将变更通知推送到您指定的接口。

该 Webhook 仅用于同步状态，不影响 Legend 向用户发送 RFI 邮件。

注意：RFI Webhook 为可选开通项。如未开通，Legend 不会主动向平台推送 RFI 状态变更——RFI 审批通过后，用户本人会收到邮件通知，其交易/充值/提现锁定同步解除。此时平台可主动调用 GET /app/kyc-status 读取 events.RFI 获取当前状态。EDD 状态变更则没有任何 Webhook 推送——请通过同一接口的 events.EDD 查询。

触发时机

向用户发起 RFI 时

当合规审核发现用户资料不完整，或您调用重发接口时触发，RFI 状态 rfi_status 为：requested。

用户提交补充材料时

当用户按 RFI 要求提交材料后触发，RFI 状态 rfi_status 为：in_review。

用户补充材料被拒绝时

当用户提交的某项材料未通过审核、需要重新提交时触发，RFI 状态 rfi_status 为：declined。

用户补充材料审核通过时

当 RFI 全部事项审核通过、流程结束时触发，RFI 状态 rfi_status 为：accepted。

RFI 被取消或关闭时

当合规团队主动关闭该 RFI（不再要求用户补充材料）时触发，RFI 状态 rfi_status 为：closed。

状态说明

`rfi_status`	含义	是否终态
`requested`	已向用户发起 RFI，等待用户补充材料	否
`in_review`	用户已提交，合规审核中	否
`declined`	某项材料被拒，用户需重新提交	否
`accepted`	审核通过，RFI 完成	是
`closed`	RFI 被取消 / 关闭	是

通知内容

Legend 会以 POST 方式请求您提供的回调地址，推送以下信息：

字段	类型	说明
`uid`	string	用户在您平台的唯一标识
`rfi_unique_id`	string	本次 RFI 的唯一编号，建议用作幂等主键
`rfi_status`	string	当前 RFI 状态，取值见上表
`rfi_url`	string	RFI 页面地址，可直接提供给用户填写材料
`created_at`	string	RFI 创建时间，UTC，格式 `YYYY-MM-DDTHH:mm:ssZ`
`updated_at`	string	RFI 最近更新时间，格式同上

如您同时开通了 RFI 事件通知，Legend 还会在 RFI 发起 / 重发 / 通过 / 关闭时，额外推送一条包含用户基本信息与待补充事项的通知：

字段	类型	说明
`user_external_id`	string	用户在您平台的唯一标识
`rfi_id`	int	RFI 编号
`rfi_unique_id`	string	RFI 唯一编号，建议优先用作幂等主键
`email`	string	用户账号邮箱
`first_name` / `middle_name` / `last_name`	string	用户姓名
`additional_item`	string	待补充事项列表，为 JSON 字符串，需二次解析
`created_at` / `updated_at`	string	RFI 创建时间与最近更新时间，UTC 格式
`rfi_status`	string	可选字段，仅在开通该选项时下发，值为原始状态，如 `In Review`

接口要求

请求成功以 HTTP 状态码 200 判定，响应内容不参与判定，建议返回 {"code":0,"message":"ok"}。
请在 3 秒内返回，业务逻辑建议异步处理。
Legend 会在通知失败（网络异常或非 200 响应）时通过队列重试，最多尝试 3 次，重试间隔 60 秒。仍失败时会记录错误日志；如需补推历史事件，请联系 Legend 技术支持。
同一 RFI 可能因多次状态变更或队列重试收到重复通知。请按 rfi_unique_id + rfi_status 做幂等处理。
异步通知可能乱序到达，请按 updated_at 判断是否为最新状态，避免旧状态覆盖新状态。
Legend 会在请求头中携带约定的鉴权信息，请务必校验后再处理。

开通方式

请联系 Legend 对接人员，提供以下信息：

回调服务的基础地址（Base URL）；
需要开通的通知类型（RFI 状态通知 / RFI 事件通知）；
是否需要由交易所接管 RFI 用户通知。开通 RFI 事件通知后，Legend 不再发送 RFI 相关邮件与短信；
如需自定义回调路径，请一并提供。