Pessoas-chave da empresa: UBOs e administradores

​

Quem é considerado pessoa-chave

​

Como as pessoas-chave se vinculam a uma empresa

• REGISTRY: extraída de um registro oficial.
• USER: adicionada pelo administrador da empresa durante o fluxo de KYB.

​

Como vincular uma pessoa-chave a uma entidade User

• Uma sessão de Verificação de usuário (KYC) é executada para a parte usando o mesmo vendor_data da entidade User.
• Um analista associa manualmente uma pessoa-chave da empresa a um User existente.

​

Como inspecionar as pessoas-chave

• Nome, função, % de propriedade e origem (registro ou inclusão pelo usuário) de cada parte
• Status de KYC dos Users vinculados
• Status da triagem AML de cada pessoa
• Documentos associados (documento de identidade do diretor, declaração de UBO)

"key_people_checks": [
  {
    "status": "Approved",
    "node_id": "feature_kyb_key_people",
    "registry": {
      "officers": [
        { "uuid": "...", "name": "Jane Doe", "role": "director", "kyc_status": "Approved", "kyc_session_url": "..." }
      ],
      "beneficial_owners": [
        { "uuid": "...", "name": "John Smith", "roles": ["ubo"], "ownership_min_shares": 40, "kyc_status": "Pending" }
      ]
    },
    "submitted": {
      "parties": [
        { "uuid": "...", "entity_type": "person", "name": "Alice Chen", "role": "ubo", "ownership_percent": 35.0, "source": "USER", "requires_verification": true, "kyc_session_status": "Not Started", "kyc_session_url": "..." }
      ]
    },
    "ubo_kyc_summary": { "total": 2, "approved": 1, "flagged": 0, "pending": 1 }
  }
]

• registry.officers / registry.beneficial_owners: partes descobertas pela verificação no registro.
• submitted.parties: partes que o administrador da empresa adicionou durante o fluxo de Pessoas-chave (source: USER).
• ubo_kyc_summary: progresso agregado do KYC dos UBOs.

​

Acionistas pessoa jurídica

​

Webhooks de pessoas-chave

• data.updated (com session_kind: "business"): os dados da sessão, incluindo as pessoas-chave, foram atualizados.
• status.updated (com session_kind: "business"): o status da sessão mudou como resultado.

​

Próximos passos