/kyc-status-poa

PoA 文件校验结果通知

用户上传 PoA(Proof of Address,地址证明)文件后,Legend 会立刻发起校验,并通过该 Webhook 把校验结果推送给交易所。此 API 为可选,交易所可以选择是否希望收到 PoA 校验结果。

PoA 文件的上传接口见 /kyc/individual/file/poa。

字段说明

  • review_answer:本次校验结论,approved 通过 / rejected 未通过。
  • review_status:整体审核状态,pending 表示用户仍可再上传一次,completed 表示已终结(通过,或两次均未通过)。
  • reject_reason:review_answer 为 rejected 时给出的具体原因,通过时为空字符串。
⚠️

同一用户最多上传 2 次 PoA 文件。第一次未通过时 review_status 为 pending,用户可重新上传;两次均未通过后 review_status 变为 completed,该用户无法再上传 PoA 文件,需改为直接提交 KYC 表单转人工审核。

PoA Webhook 示例

第一次校验未通过(用户仍可重新上传):

{
  "uid": "3243890vxSfskflMDSL2",
  "review_answer": "rejected",
  "review_status": "pending",
  "reject_reason": "Provide a valid proof of address. Documents must: contain your full address",
  "created_at": "2025-11-21T13:45:30Z",
  "updated_at": "2025-11-21T13:45:30Z"
}

校验通过:

{
  "uid": "3243890vxSfskflMDSL2",
  "review_answer": "approved",
  "review_status": "completed",
  "reject_reason": "",
  "created_at": "2025-11-21T13:45:30Z",
  "updated_at": "2025-11-21T14:02:11Z"
}

第二次校验仍未通过(不可再上传):

{
  "uid": "3243890vxSfskflMDSL2",
  "review_answer": "rejected",
  "review_status": "completed",
  "reject_reason": "Provide a valid proof of address. Documents must: contain your full address",
  "created_at": "2025-11-21T13:45:30Z",
  "updated_at": "2025-11-21T15:10:04Z"
}
Body Params
string
required

encrypted User id

string
enum
required

PoA 文件审核结果

Allowed:
string
enum
required

PoA 文件审核状态

Allowed:
string
required
string
required

ISO 8601 格式

string
required

ISO 8601 格式

Headers
string
Defaults to 123456

交易所分配的API Key

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json