> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Pihak Kunci Bisnis: UBO & Direktur

> Hubungkan UBO, direktur, dan pemilik manfaat ke entitas Bisnis Didit. Tiap orang menjalani KYC sebagai entitas Pengguna. KYB dalam satu platform.

Setiap entitas Bisnis memiliki **pihak kunci**, yaitu orang perseorangan yang secara hukum bertanggung jawab atas perusahaan atau yang memiliki kepemilikan manfaat atas perusahaan tersebut. Didit mengidentifikasi mereka selama KYB dan memungkinkan Anda menautkan setiap orang ke entitas pengguna untuk KYC individual.

## Siapa yang termasuk pihak kunci

| Peran | Deskripsi |
| - | - |
| **Direktur** | Tercantum di registri sebagai direktur perusahaan |
| **Pejabat** | Sekretaris, perwakilan, atau pejabat terdaftar lainnya |
| **Pemegang Saham** | Pemegang saham terdaftar (perusahaan atau perseorangan) |
| **UBO (Pemilik Manfaat Akhir)** | Individu yang pada akhirnya memiliki atau mengendalikan 10/25/50%+ (ambang batas dapat dikonfigurasi) |
| **Penandatangan resmi** | Orang yang berwenang bertindak atas nama perusahaan |

Lihat halaman [Pejabat KYB](https://docs.didit.me/id/business-verification/officers.md) dan [Kepemilikan](https://docs.didit.me/id/business-verification/ownership.md) untuk taksonomi peran lengkap dan perhitungan rantai kepemilikan.

## Bagaimana pihak kunci dikaitkan dengan Bisnis

**1. Diidentifikasi dari registri**

Selama KYB, Didit melakukan kueri ke registri perusahaan dan mengekstrak semua pejabat dan pemegang saham yang tercantum. Setiap orang menjadi **catatan pihak kunci** yang ditautkan ke sesi Verifikasi Bisnis (KYB).

**2. Ditambahkan oleh pengguna (diisi pelanggan)**

Alur kerja dapat menyertakan langkah "Pihak Kunci" tempat admin bisnis menambahkan orang yang tidak ada di registri (misalnya UBO yang diidentifikasi melalui pernyataan perusahaan).

**3. Digabungkan pada entitas Bisnis**

Daftar pihak kunci Bisnis adalah gabungan pihak yang diekstrak dari registri dan pihak yang ditambahkan oleh pengguna, dengan duplikat dihapus berdasarkan identitas.

Setiap pihak kunci memiliki kolom `source`:

* `REGISTRY`: diekstrak dari registri resmi.
* `USER`: ditambahkan oleh admin bisnis selama alur KYB.

## Menautkan pihak kunci ke entitas pengguna

Jika KYC diperlukan untuk pihak kunci (biasanya UBO dan direktur), pihak tersebut dapat ditautkan ke entitas pengguna:

```mermaid theme={null}
flowchart LR
    B[Business: biz-acme]
    P1[Key Person: Jane Doe, Director]
    P2[Key Person: John Smith, UBO 40%]
    U1[User: user-jane]
    U2[User: user-john]
    P1 --> B
    P2 --> B
    P1 -.linked.-> U1
    P2 -.linked.-> U2
```

Tautan dibuat ketika:

* Sesi Verifikasi Pengguna (KYC) dijalankan untuk pihak tersebut menggunakan `vendor_data` yang sama dengan entitas pengguna.
* Seorang analis secara manual mengaitkan pihak bisnis dengan pengguna yang sudah ada.

Setelah ditautkan, status KYC pengguna akan diteruskan ke tampilan pihak kunci pada Bisnis.

## Memeriksa pihak kunci

Dari halaman detail Bisnis di konsol, tab **Pihak Kunci** menampilkan:

* Nama, peran, persentase kepemilikan, dan sumber setiap pihak (registri atau ditambahkan oleh pengguna)
* Status KYC dari pengguna yang ditautkan
* Status skrining AML per orang
* Dokumen terkait (ID direktur, pernyataan UBO)

Secara terprogram, pihak kunci tampil di dalam array `key_people_checks[]` pada keputusan sesi Verifikasi Bisnis (KYB), yang dibagi menjadi dua kelompok:

```json theme={null}
"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`**: pihak yang ditemukan melalui pemeriksaan registri.
* **`submitted.parties`**: pihak yang ditambahkan admin bisnis selama langkah Pihak Kunci (`source: USER`).
* **`ubo_kyc_summary`**: ringkasan agregat progres KYC UBO.

Array datar lama `officers[]` dan `beneficial_owners[]` tetap ada di respons untuk kompatibilitas mundur selama satu rilis lagi. Integrasi baru sebaiknya menggunakan bentuk dua kelompok di atas. Lihat [skema respons KYB](https://docs.didit.me/id/business-verification/response-schema.md#key_people_checks) lengkap untuk setiap kolom.

## Pemegang saham perusahaan

Ketika pemegang saham adalah perusahaan (bukan orang), Didit menelusuri rantai kepemilikan secara rekursif untuk mengidentifikasi pemilik manfaat akhir. Pihak perusahaan dapat secara opsional memicu sesi Verifikasi Bisnis (KYB) turunan.

Lihat [Struktur kepemilikan](https://docs.didit.me/id/business-verification/ownership.md) untuk contoh lengkap rantai kepemilikan multi-lapis.

## Webhook pihak kunci

Perubahan pada pihak kunci tampil melalui event sesi induk:

* `data.updated` (dengan `session_kind: "business"`): data sesi termasuk pihak kunci telah diperbarui.
* `status.updated` (dengan `session_kind: "business"`): status sesi berubah sebagai akibatnya.

Lihat [webhook KYB](https://docs.didit.me/id/business-verification/webhooks.md) untuk payload.

## Langkah selanjutnya

> [card] [Pejabat](https://docs.didit.me/id/business-verification/officers.md)
>
> Identifikasi direktur dan taksonomi peran.

> [card] [Kepemilikan](https://docs.didit.me/id/business-verification/ownership.md)
>
> UBO, pemegang saham perusahaan, dan perhitungan rantai.

> [card] [Alur Pihak Kunci](https://docs.didit.me/id/business-verification/key-people.md)
>
> Langkah KYB yang mengumpulkan pihak kunci.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.