跳转到主要内容
最终受益所有人(UBO)是指拥有或控制公司的自然人。在 Entities 中,UBO 并非独立对象,而是 COMPANY 实体与 INDIVIDUAL 实体之间的链接。

先决条件

  • 已注册为 COMPANY 实体的公司。参见创建实体。
  • 每位所有者均已注册为 INDIVIDUAL 实体,并拥有各自的文档和文件。
  • 公司及每位所有者的 internalId。

流程

链接需要两个 internalId 值,因此请先创建实体。公司仍处于 PENDING_KYC 状态时,即可链接所有者。 将 Jane Doe 链接为 CEO,持股 60%:
Request
Response
将 John Doe 链接为合伙人,持股 40%。角色请使用大写发送;小写或大小写混合(Partner)将返回 422 INVALID_CONTROL_ROLE:
Request
Response
链接后,对该公司调用获取实体将返回 uboCount 和 uboRequirementMet。

规则

两次链接同一人时出错:
重试链接时,请将 UBO_ALREADY_LINKED 视为成功,并通过列出公司的 UBO读取当前链接。
  • 更改百分比或角色:更新 UBO。角色无法清除:请将其更改为其他代码,或使用结束 UBO 链接结束该链接,然后在不带 controlRole 的情况下重新链接该人员。
  • 终止所有权:结束 UBO 链接会将 validTo 设置为今天。历史记录会保留,并可通过 includeEnded=true 查看。
  • 从人员角度查看:列出人员的公司。
每位所有者都是一个拥有独立 KYC 的实体,由 Localpayment 与公司一并审核。uboRequirementMet 仅表示至少已链接一位所有者,并不表示所有者已获批准。

下一步

跟踪审核并修复拒绝问题

跟进公司及每位所有者的审核进度。

链接 UBO 参考

所有请求字段、响应字段和错误代码。
最后修改于 2026年11月12日