用于 KYCaaS 的账户状态事件 | Alpaca 简体中文

使用 Alpaca KYC 服务的合作伙伴可以通过 Account Status Events 实时接收账户状态变更。账户变更为 ACTION_REQUIRED 或 APPROVAL_PENDING 时，可能在开立之前需要额外的审核、信息或文件。

KYC 结果载荷

账户状态事件仅包含发生变更的属性，因此当事件与 KYC 无关时，kyc_results 可能会被省略。当存在时，kyc_results 或其任何结果类别可能为 null。

accept、indeterminate 和 reject 字段是以 JSON 对象表示集合。每个属性名都是一个 KYC 原因标识，其值始终是不携带任何附加数据的空对象（{}）：

{
  "account_id": "4db36989-6565-4011-9126-39fe6b3d9bf6",
  "status_to": "ACTION_REQUIRED",
  "kyc_results": {
    "accept": {},
    "indeterminate": {
      "IDENTITY_VERIFICATION": {}
    },
    "reject": null,
    "additional_information": "Please provide a valid government-issued identity document.",
    "summary": "fail"
  }
}

从属性名读取原因标识，而不是从空对象值中读取。结合每个原因所属的结果类别和 additional_information 来解释每个原因。标识符集合是可扩展的，因此集成必须容忍并保留下面未列出的标识符。

结果类别

类别	含义
`accept`	除非 Alpaca 单独要求，否则该原因无需采取行动。
`indeterminate`	在账户开立之前，可能需要额外的审核、信息或文件。
`reject`	KYC 结果被拒绝。某些原因可能无法补救；请遵循 `additional_information` 或 Alpaca 的其他指示。

所属类别决定所需的响应。例如，accept 中的某个原因不需要采取行动，即使同一原因出现在 indeterminate 中时会要求提供信息。

文件要求

当其中某个原因出现在 indeterminate 或 reject 中时，在收集或提交文件之前，请使用 additional_information 确认具体请求。

KYC 原因标识	政府签发的身份证件	税务 ID 文件	对账单（如公用事业账单）	实时自拍
`IDENTITY_VERIFICATION`	必需
`TAX_IDENTIFICATION`		必需
`ADDRESS_VERIFICATION`	可能被要求		可能被要求
`DATE_OF_BIRTH`	必需
`SELFIE_VERIFICATION`				必需

附加信息要求

KYC 原因标识	可能需要的附加信息
`PEP`	职位、职业和地址
`FAMILY_MEMBER_PEP`	政治敏感人物直系亲属的姓名
`CONTROL_PERSON`	公司名称、地址和电子邮件
`AFFILIATED`	公司名称、地址和电子邮件
`VISA_TYPE_OTHER`	签证类型和到期日期
`W8BEN_CORRECTION`	包含更正信息的更新版 W-8BEN
`OTHER`	`additional_information` 中要求的信息

有关已记录的 KYC 原因标识及其含义的完整且持续更新的列表，请参阅 Account Status Events API 参考。