> ## 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.

# API Pihak Kunci KYB: Pemilik Manfaat & Direktur

> Verifikasi UBO, pemegang saham, dan direktur dalam satu alur KYB di Didit, dengan sesi KYC terkait. Mulai $2.00 per pemeriksaan, tanpa kontrak.

**Pihak kunci** adalah model terpadu Didit untuk setiap orang perseorangan dan entitas korporasi yang terkait dengan bisnis yang Anda verifikasi: UBO, pemegang saham (individu dan korporasi), direktur, perwakilan, dan peran pejabat lainnya. Satu alur Pihak Kunci mencakup semuanya, dengan perutean verifikasi berdasarkan peran serta perbandingan lengkap berdampingan antara pihak dari registri dan pihak yang dikirimkan pengguna.

> [!NOTE]
>
> Untuk tampilan entitas bisnis tentang Pihak Kunci, yaitu cara pejabat dan UBO digabungkan lintas sesi, lihat [Bisnis → Pihak Kunci](https://docs.didit.me/id/entities/businesses/key-people.md).

## Cara kerja

**1. Pengisian awal dari registri (opsional)**

Jika alur kerja mengaktifkan pengisian awal registri, layar Pihak Kunci akan terisi otomatis dengan UBO, pemegang saham, dan pejabat yang tersedia dan diekstraksi dari pemeriksaan registri.
Pengguna akhir dapat mengedit, menambah, atau menghapus pihak sebelum mengirimkan, bahkan ketika informasi kepemilikan masih tertunda.
Pejabat yang hasilnya sudah diterima tetap tersedia selama laporan kepemilikan dikumpulkan.
Sebelum pengiriman, hasil yang datang terlambat mengisi kolom yang belum diubah dan menambahkan orang yang belum ada tanpa menimpa perubahan atau memulihkan pihak yang telah dihapus.
Editor yang sedang terbuka tidak berubah; pengisian awal tambahan diterapkan setelah pemohon menutupnya.
Jika pengisian awal registri dinonaktifkan, pemohon memasukkan orang sendiri dan hasil yang terlambat tidak mengisi formulir ini.
Data registri yang tiba setelah pengiriman tetap menjadi bagian dari bukti registri, tetapi tidak mengubah daftar orang yang dikirim atau secara otomatis membuat sesi verifikasi turunan tambahan.

**2. Pengiriman dari alur yang di-hosting**

Pengguna akhir mengirimkan daftar final pihak kunci melalui alur verifikasi yang di-hosting. Secara default, Anda tidak memanggil langkah ini sendiri; langkah ini terjadi di dalam alur KYB yang URL-nya Anda kirimkan dari [Buat Sesi](https://docs.didit.me/id/sessions-api/create-session.md).
Untuk tetap menggunakan antarmuka Anda sendiri, gunakan endpoint [draf pihak](https://docs.didit.me/id/sessions-api/kyb-create-party-draft.md) dan [kirim pihak](https://docs.didit.me/id/sessions-api/kyb-submit-parties.md).

**3. Perutean verifikasi berdasarkan peran**

Untuk setiap pihak yang dikirim, Didit memeriksa pengaturan verifikasi yang dikonfigurasi untuk peran tersebut:

* Menerapkan ambang batas kepemilikan alur kerja: UBO dan pemegang saham di bawah persentase yang dikonfigurasi tidak memerlukan verifikasi individual.
* Menghormati tanda "lewati verifikasi" yang ditetapkan pengguna akhir, jika peran tersebut mengizinkan pelewatan.
* Membuat sesi Verifikasi Pengguna (KYC) turunan untuk pihak perseorangan yang memerlukan KYC.
* Membuat sub-sesi KYB turunan untuk UBO korporasi ketika KYB bersarang diaktifkan pada alur kerja.

**4. Perkembangan status**

Status fitur Pihak Kunci menjadi `Awaiting User` selama sesi turunan yang diperlukan masih berjalan. Ketika setiap sesi turunan selesai, status diagregasi menjadi `Approved`, `Declined`, atau `In Review` berdasarkan hasilnya.

## Peran yang dikumpulkan

Pihak kunci dapat memiliki satu atau beberapa peran berikut; satu orang dapat memegang beberapa peran sekaligus (misalnya, direktur **dan** pemegang saham). Berikut taksonomi lengkapnya:

| Kategori | Peran |
| - | - |
| **Kepemilikan** | `ubo`, `shareholder`, `beneficiary`, `settlor`, `protector`, `investor` |
| **Tata kelola / perwakilan** | `director`, `non_executive_director`, `chairman`, `secretary`, `representative`, `authorized_signatory`, `trustee`, `company_officer`, `founder`, `legal_advisor`, `other` |

Setiap peran dapat dikonfigurasi secara individual dalam alur kerja: diaktifkan atau dinonaktifkan, wajib atau opsional untuk KYC, dipetakan ke alur kerja KYC tertentu, dan dapat dilewati jika diinginkan. Lihat [Kepemilikan](https://docs.didit.me/id/business-verification/ownership.md) untuk detail perutean verifikasi.

## Data yang dikumpulkan per pihak kunci

Alur yang di-hosting meminta sekumpulan kolom default dan kolom kustom tambahan yang dikonfigurasi alur kerja. Lihat [Kepemilikan → Kolom yang dikumpulkan](https://docs.didit.me/id/business-verification/ownership.md#data-yang-dikumpulkan-untuk-setiap-pihak-kunci) untuk daftar lengkap.

## Konfirmasi registri

Sebelum langkah Pihak Kunci, pengguna akhir meninjau data perusahaan yang diekstraksi dari pemeriksaan registri dan secara opsional mengedit kolom apa pun. Alur yang di-hosting kemudian menyimpan:

* **Detail registri** yang dinormalisasi Didit dari pemeriksaan registri (`registry_data`).
* **Data yang dikonfirmasi pengguna** (`user_provided_data`) dengan cap waktu yang menandai kapan pengguna mengonfirmasi.
* Tampilan kanonis gabungan pada kolom perusahaan tingkat atas: menggunakan data yang dikonfirmasi pengguna jika ada, jika tidak, menggunakan data registri sebagai cadangan.

Lihat [Data perusahaan → Data registri vs data yang disediakan pengguna](https://docs.didit.me/id/business-verification/company-data.md#data-registri-vs-data-yang-disediakan-pengguna) untuk model lengkapnya.

## Bentuk dalam respons keputusan

Setelah pengiriman, pihak kunci yang dikumpulkan muncul dalam keputusan KYB di bawah `key_people_checks[]`, dibagi menjadi dua kelompok: **registri** (yang diungkapkan penyedia) dan **dikirim** (yang dikonfirmasi oleh admin bisnis melalui alur), serta `ubo_kyc_summary` yang merangkum progres KYC UBO. Lihat [referensi key\_people\_checks](https://docs.didit.me/id/business-verification/response-schema.md#key_people_checks) lengkap.

## Perilaku pengajuan ulang

* **Pihak Kunci** dan **Pemeriksaan Registri** tidak dapat diajukan ulang secara langsung. Untuk memverifikasi ulang orang tertentu, ajukan ulang sesi KYC turunan individualnya.
* Ketika sesi KYC turunan diajukan ulang, status fitur Pihak Kunci induk otomatis kembali ke `Awaiting User`.
* Ketika sesi turunan yang diajukan ulang selesai, status induk diagregasi ulang berdasarkan status semua turunan.
* Sesi turunan yang dihapus, atau yang kedaluwarsa sebelum orang tersebut memulainya, tidak dapat diajukan ulang: [buat ulang pihak](https://docs.didit.me/id/sessions-api/regenerate-kyb-party.md) untuk menerbitkan tautan baru pada pihak yang sama.

## Berapa lama tautan verifikasi pihak kunci berlaku

Sesi KYC anak milik pihak kunci mengikuti waktu kedaluwarsa sesi dari alur kerja KYC yang dikonfigurasi untuk peran mereka, bukan dari alur kerja KYB. Jika Anda memetakan peran ke alur kerja KYC yang mengizinkan empat minggu, tautan orang tersebut tetap dapat digunakan selama empat minggu, meskipun sesi bisnis diatur untuk kedaluwarsa lebih cepat.

Nilainya adalah pengaturan per alur kerja, dari 1 jam hingga 4 minggu (`session_expiration_time`, dalam detik), di *Workflows → \[Alur kerja KYC] → Settings*.

Kedaluwarsa memengaruhi apa yang dapat Anda lakukan terhadap pihak tersebut. Tautan yang kedaluwarsa sebelum orang tersebut memulai, misalnya tautan dari sesi yang dihapus, dapat diterbitkan ulang dengan [Buat ulang sesi KYC Pihak Kunci](https://docs.didit.me/id/sessions-api/regenerate-kyb-party.md). Sesi yang dihapus memenuhi syarat meskipun orang tersebut sudah memulai atau menyelesaikan verifikasi. Sesi yang diimpor tidak memenuhi syarat melalui kedaluwarsa; sesi tersebut harus sudah dihapus. Sesi yang belum dihapus dan sudah dimulai oleh orang tersebut tidak memenuhi syarat melalui kedaluwarsa.

## Opsi konfigurasi

Semua perilaku Pihak Kunci dikonfigurasi per alur kerja dari Business Console:

| Pengaturan | Fungsi |
| - | - |
| **Registry prefill** | Mengisi otomatis formulir Pihak Kunci dari data registri |
| **Extra fields — persons** | Kolom kustom yang dikumpulkan untuk setiap pihak perorangan |
| **Extra fields — companies** | Kolom kustom yang dikumpulkan untuk setiap pihak perusahaan |
| **Ambang kepemilikan UBO** | Persentase kepemilikan minimum untuk mengklasifikasikan seseorang sebagai UBO |
| **Ambang kepemilikan pemegang saham** | Persentase kepemilikan minimum untuk mengklasifikasikan seseorang sebagai pemegang saham |
| **Pengaturan per peran** | Untuk setiap peran: aktif/nonaktif, wajib KYC, alur kerja KYC yang digunakan, dapat dilewati |
| **Corporate UBO nested KYB** | Jika diaktifkan, UBO perusahaan memicu sesi KYB anak mereka sendiri |
| **Gunakan ulang individu terverifikasi** | Lihat [Menggunakan kembali individu terverifikasi di seluruh pemeriksaan KYB](#menggunakan-kembali-individu-terverifikasi-di-seluruh-pemeriksaan-kyb) di bawah |
| **Beri tahu pihak melalui email** | Secara otomatis mengirim email kepada setiap pihak kunci berisi tautan verifikasi mereka |

Konfigurasikan di *Workflows → \[Alur kerja KYB] → Key People* di konsol.

## Menggunakan kembali individu terverifikasi di seluruh pemeriksaan KYB

Saat **Gunakan ulang individu terverifikasi** diaktifkan pada alur kerja (nilai default), pihak kunci tidak perlu mengulang KYC setiap kali muncul di pemeriksaan KYB baru. Didit mencari KYC yang sudah disetujui dari pemeriksaan KYB sebelumnya, lalu menautkannya ke pihak baru alih-alih membuat sesi KYC anak yang baru.

> [!NOTE]
>
> Mekanisme ini berbeda dari [KYC yang Dapat Digunakan Kembali](https://docs.didit.me/id/core-technology/reusable-kyc/overview.md). Pada KYC yang dapat digunakan kembali, *pengguna akhir* secara sukarela membawa satu sesi yang sudah selesai ke aplikasi terpisah yang terintegrasi dengan Didit melalui token berbagi atau impor. Pengaturan penggunaan ulang KYB pada halaman ini bersifat otomatis, dikonfigurasi di alur kerja, dan berlaku untuk pihak kunci dalam satu aplikasi. Tidak ada token berbagi dan tidak ada tindakan dari pengguna akhir.

**Pencocokan.** Kecocokan kandidat ditemukan dengan membandingkan nama lengkap orang yang diajukan (tidak peka huruf besar-kecil, spasi di awal dan akhir diabaikan) dengan pihak kunci dari pemeriksaan KYB lain milik aplikasi. Tidak ada sinyal pencocokan tambahan: nomor dokumen, email, atau telepon tidak wajib dan tidak diperiksa. Nama dengan ejaan berbeda, nama tengah, atau hasil transliterasi tidak akan cocok. Dalam kasus yang jarang terjadi, dua orang berbeda yang memiliki nama sama dapat cocok, jadi tinjau hasil Pihak Kunci Anda dengan mempertimbangkan hal ini.

**Cakupan.** Pencocokan mencakup setiap pemeriksaan KYB lain yang termasuk dalam *aplikasi yang sama*, bukan hanya pemeriksaan KYB saat ini dan bukan aplikasi lain di organisasi Anda. Orang yang diverifikasi sebagai UBO di Perusahaan A dapat dicocokkan saat kemudian muncul sebagai direktur di Perusahaan B, selama kedua pemeriksaan dijalankan di bawah aplikasi yang sama.

**Status yang memenuhi syarat.** Hanya KYC **Disetujui** terbaru milik pihak yang memenuhi syarat untuk digunakan ulang. KYC **Ditolak** untuk nama tersebut memblokir penggunaan ulang sepenuhnya: pihak ditandai dan KYC baru diminta, bukan kembali ke KYC yang ditolak. KYC yang masih **Dalam Peninjauan** tidak pernah dipertimbangkan sebagai kandidat.

**Retensi.** Pencocokan hanya mempertimbangkan sesi KYC yang dibuat sekitar satu tahun terakhir dan belum dihapus. Jika satu-satunya sesi yang cocok berada di luar jendela waktu tersebut, atau orang atau organisasi telah menghapusnya, pemeriksaan tidak menemukan kecocokan yang memenuhi syarat dan secara diam-diam meminta KYC baru. Proses ini tidak pernah gagal atau memblokir pengiriman Pihak Kunci.

**Penagihan.** KYC yang digunakan ulang tidak ditagih lagi. Menautkan sesi yang sudah disetujui ke pihak baru tidak dikenakan biaya tambahan; Anda hanya ditagih sekali, pada KYC asli.

```txt Example theme={null}
Company A: Jane Doe submitted as UBO, KYC approved.
Company B (same application): Jane Doe submitted as a director.
"Reuse verified individuals" is enabled, so Company B's Key People
check links Jane's existing approved KYC instead of requesting a
new one - free, and instantly Approved for that party.
```

## Langkah berikutnya

> [card] [Kepemilikan](https://docs.didit.me/id/business-verification/ownership.md)
>
> Kolom yang dikumpulkan, data kustom, dan rekonsiliasi data registri dibandingkan dengan data yang dikirim.

> [card] [Pejabat & perwakilan](https://docs.didit.me/id/business-verification/officers.md)
>
> Peran tata kelola dalam model pihak kunci.

> [card] [Skema respons](https://docs.didit.me/id/business-verification/response-schema.md#key_people_checks)
>
> Referensi kolom demi kolom untuk `key_people_checks[]`.


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