跳转到主要内容
PATCH
更新 UBO
更改有效关联的持股比例和/或控制角色。
  • 请求体为空时返回 400 VALIDATION_ERROR。
  • personId、validFrom 和 validTo 无法更改;请结束该关联并创建新的关联。
错误使用 application/problem+json 格式,并附带固定的 code。完整目录:实体状态和错误代码。

授权

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"

uboId
string<uuid>
必填

UBO 链接 ID。

示例:

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

请求体

application/json
ownershipPercentage
number

0 到 100,最多保留两位小数。

示例:

55.5

controlRole
enum<string>

新角色,为链接 UBO(Link a UBO)中的代码之一。空字符串会返回 422 INVALID_CONTROL_ROLE;角色不能被清空。

可用选项:
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
示例:

"PARTNER"

响应

OK。

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,最多保留两位小数。

示例:

55.5

controlRole
string | null

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

validFrom
string<date>

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

示例:

"2024-01-15"

validTo
string<date> | null

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

createdAt
string<date-time>

创建时间。

示例:

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

最后修改于 2026年11月10日