跳转到主要内容
POST
链接UBO
将一个 INDIVIDUAL 实体关联为 COMPANY 实体的最终受益所有人(UBO),并指定持股比例和控制角色。两个实体都必须已存在。
  • 公司处于 PENDING_KYC 或 ACTIVE 状态时允许关联。处于 IN_REVIEW 状态时返回 409 ENTITY_IN_REVIEW;处于 CLOSED、BLOCKED 或 REJECTED 状态时不允许关联。
  • 每家公司最多可有 50 个有效 UBO 关联。同一个人在关联有效期间不能被重复关联。
  • 关联后,对该公司调用获取实体(Get an Entity)会返回 uboCount 和 uboRequirementMet。
错误使用带有稳定 code 的 application/problem+json。完整目录:实体状态与错误码。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求头

Authorization
string
必填

用于身份验证的 Bearer 访问令牌。该令牌可从获取访问令牌或刷新访问令牌endpoint 获取。系统将据此识别您的商户账户和执行操作的用户。

示例:

"Bearer <your_access_token>"

X-Correlation-ID
string

跟踪标识符(UUID)。会在响应中原样返回;如未提供,则由 Localpayment 生成。

示例:

"0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10"

路径参数

companyId
string<uuid>
必填

COMPANY 的 internalId。

示例:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

请求体

application/json
personId
string<uuid>
必填

INDIVIDUAL 的 internalId。

示例:

"c1e384f5-ae1c-475e-9e64-a0abe533a96f"

ownershipPercentage
number | null
必填

0 到 100,最多保留两位小数。当百分比未知时发送 null;对于不持有股份的法定代表人,发送 0。

示例:

60

controlRole
enum<string>

此人的角色,24 个代码之一。区分大小写:director 将返回 422 INVALID_CONTROL_ROLE。法定代表人请使用 LEGAL_REPRESENTATIVE,根据授权委托书签署的人员请使用 AUTHORIZED_SIGNATORY。

可用选项:
CEO,
CFO,
COO,
CTO,
PRESIDENT,
VICE_PRESIDENT,
DIRECTOR,
MANAGING_DIRECTOR,
MANAGING_PARTNER,
GENERAL_PARTNER,
PARTNER,
SECRETARY,
TREASURER,
CHAIRMAN,
BOARD_MEMBER,
AUTHORIZED_SIGNATORY,
GENERAL_COUNSEL,
OWNER,
FOUNDER,
MANAGER,
MEMBER,
COMPTROLLER,
CHIEF_COMPLIANCE_OFFICER,
LEGAL_REPRESENTATIVE
示例:

"CEO"

validFrom
string<date>

YYYY-MM-DD。默认值:今天。

示例:

"2024-01-15"

validTo
string<date>

YYYY-MM-DD,不早于 validFrom。省略此参数表示无截止日期的链接。

示例:

"2025-01-15"

响应

已创建。

id
string

UBO 链接标识符(uboId)。

示例:

"4584b476-ccc6-4e98-be40-0c5082748e35"

companyId
string<uuid>

公司实体。

示例:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

personId
string<uuid>

INDIVIDUAL 实体。此处不会返回该人员的任何个人数据。

示例:

"c1e384f5-ae1c-475e-9e64-a0abe533a96f"

ownershipPercentage
number | null

0 到 100,最多保留两位小数。当百分比未知时为 null。

示例:

60

controlRole
string

职位名称使用大写字母,例如 CEO、PARTNER、DIRECTOR、LEGAL_REPRESENTATIVE。如果未告知,则为 null。

示例:

"CEO"

validFrom
string<date>

链接的有效性。当链接处于活动状态时,validTo 为空。

示例:

"2024-01-15"

validTo
string<date> | null

链接的有效性。当链接处于活动状态时,validTo 为空。

createdAt
string<date-time>

创建时间。

示例:

"2024-01-15T17:20:47Z"

最后修改于 2026年11月10日