> ## 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 UBO: Ekstraksi Pemilik Manfaat

> Didit mengekstrak UBO dari registri perusahaan beserta rantai kepemilikan, persentase, dan skrining AML. Mulai dari $2.00 per cek.

Mengidentifikasi siapa yang pada akhirnya memiliki dan mengendalikan sebuah perusahaan adalah inti dari KYB. Didit mengambil struktur kepemilikan dari registri perusahaan jika tersedia, memungkinkan admin bisnis mengonfirmasi dan memperluasnya dalam alur yang di-hosting, lalu menjalankan verifikasi berbasis peran untuk setiap pihak kunci.

## Pemilik manfaat (UBO)

**Pemilik Manfaat Akhir (UBO)** adalah orang perseorangan yang secara akhir memiliki atau mengendalikan badan hukum. UBO muncul dalam keputusan sesi di `key_people_checks[].registry.beneficial_owners[]` (diturunkan dari registri) dan `key_people_checks[].submitted.parties[]` (dikirimkan pengguna), dengan peran lain seperti pemegang saham atau direktur dalam daftar yang sama.

## Data yang dikumpulkan untuk setiap pihak kunci

Alur yang di-hosting mengumpulkan sekumpulan kolom default serta kolom kustom apa pun yang dikonfigurasi dalam alur kerja. Kolom defaultnya:

| Kolom | Orang | Perusahaan |
| - | :-: | :-: |
| `name` atau `first_name` + `last_name` | ✅ wajib | ✅ wajib (`company_name`) |
| `email` | ✅ wajib | ✅ wajib |
| `nationality` / negara | ✅ wajib | ✅ wajib |
| `role` (satu atau lebih per pihak) | ✅ wajib | ✅ wajib |
| `ownership_percent` / `voting_percent` (per peran) | opsional | opsional |
| `date_of_birth` | opsional | - |
| `phone_number` | opsional | - |
| `position` (jabatan dalam teks bebas) | opsional | - |
| `registration_number` | - | opsional |
| `entity_type` | `person` | `company` |

`entity_type` diatur otomatis berdasarkan apakah pihak tersebut orang perseorangan atau entitas korporasi.

### Kolom kustom

Alur kerja dapat mewajibkan kolom tambahan per orang atau per perusahaan, dalam jumlah berapa pun. Kolom ini dikonfigurasi di Business Console pada alur kerja KYB dan masuk ke objek `custom_fields` pada setiap pihak dalam respons keputusan. Gunakan kolom kustom untuk hal-hal seperti deklarasi sumber kekayaan, residensi pajak, ID klien internal, atau pengungkapan khusus industri.

## Pemegang saham korporasi dan kepemilikan bertingkat

Ketika pemegang saham adalah perusahaan (bukan orang perseorangan), Didit mencatat:

* Nama perusahaan dan nomor registrasi.
* Persentase kepemilikan yang dipegang oleh pemegang saham korporasi tersebut.
* Negara tempat perusahaan didirikan.

Hal ini memungkinkan Anda menelusuri rantai melalui beberapa lapisan hingga orang perseorangan yang pada akhirnya memiliki.

### KYB bertingkat untuk UBO korporasi

Ketika alur kerja mengaktifkan KYB bertingkat untuk UBO korporasi, setiap pihak korporasi memicu sub-sesi KYB anak sendiri: perusahaan tersebut diverifikasi dengan proses yang sama seperti yang Anda jalankan di tingkat atas, dan hasilnya dikembalikan ke sesi induk. Fitur ini nonaktif secara default dan dapat diaktifkan secara eksplisit per alur kerja.

## Ambang batas kepemilikan

Sebagian besar yurisdiksi mengklasifikasikan UBO pada **25% atau lebih**. Ambang batas ini dapat dikonfigurasi per alur kerja:

| Yurisdiksi | Ambang batas UBO yang umum |
| - | - |
| EU (AMLD) | 25% kepemilikan atau kendali |
| UK | 25% saham atau hak suara |
| USA (CTA) | 25% kepemilikan atau kendali substansial |
| Singapura | 25% saham atau hak suara |

Atur dari *Workflows → \[KYB workflow] → Risk → UBO threshold*. Alur kerja Anda juga dapat menandai atau mengarahkan untuk peninjauan ketika tidak ada UBO yang memenuhi ambang batas (umum pada perusahaan publik yang sahamnya tersebar luas).

## Hak suara dan hak ekonomi

Pengungkapan kepemilikan membedakan dua jenis kendali:

| Hak | Artinya |
| - | - |
| **Kepemilikan ekonomi (%)** | Porsi nilai ekonomi perusahaan atau hak dividen |
| **Persentase suara (%)** | Porsi hak suara dalam resolusi pemegang saham |

Keduanya biasanya sama, tetapi dapat berbeda ketika perusahaan menerbitkan saham dua kelas atau ekuitas preferen. Didit mencatat keduanya. Aturan dan ambang batas dapat memeriksa salah satunya: sebagian besar yurisdiksi mewajibkan pengungkapan UBO ketika *salah satu* dari keduanya melampaui 25%.

## Kepemilikan efektif melalui rantai

Ketika kepemilikan berjalan melalui pemegang saham korporasi, kepemilikan efektif dari orang perseorangan pada tingkat berikutnya dalam rantai dihitung dengan mengalikan persentase di sepanjang rantai.

### Contoh: rantai 3 lapis

```
Acme Corp (target)
  └─ 60% → Acme Holdings Ltd
              └─ 75% → Jane Doe (natural person)
  └─ 40% → John Smith (natural person)
```

UBO yang dihitung:

* **Jane Doe**: kepemilikan efektif atas Acme Corp = 60% × 75% = **45%** (UBO).
* **John Smith**: kepemilikan efektif atas Acme Corp = **40%** (UBO).

Dengan ambang batas UBO 25%, Jane dan John sama-sama diungkapkan. Dengan ambang batas 50%, tidak ada UBO yang memenuhi batas tersebut, dan Didit menandainya sebagai masalah transparansi.

## Cara pengaturan peran memengaruhi verifikasi

Setiap peran dikonfigurasi secara individual per alur kerja KYB: diaktifkan atau dinonaktifkan, apakah memerlukan KYC, alur kerja KYC mana yang digunakan untuk peran tersebut, dan apakah pengguna akhir dapat memilih untuk melewatinya. Ketika pihak kunci dikirimkan:

1. Didit memeriksa peran pihak yang dikirimkan terhadap pengaturan peran dalam alur kerja.
2. Untuk peran yang ditandai memerlukan verifikasi, sesi verifikasi anak akan dimulai:
   * **Pihak individu** → sesi Verifikasi Pengguna (KYC) anak, menggunakan alur kerja KYC khusus peran atau alur kerja default.
   * **UBO korporasi** (ketika KYB bertingkat diaktifkan) → sub-sesi Verifikasi Bisnis (KYB) anak.
3. Untuk peran yang ditandai dapat dilewati, pengguna akhir melihat opsi "lewati verifikasi" dan dapat memilih untuk tidak menjalani verifikasi. Pihak yang dilewati tetap dicatat, tetapi tidak menghalangi sesi induk.
4. Pihak yang berada di bawah ambang batas kepemilikan alur kerja tidak memicu verifikasi individual, meskipun perannya memerlukan verifikasi tersebut.

Atur semuanya dari *Workflows → \[KYB workflow] → Key People* di Business Console.

## Pemantauan pemegang saham dan UBO

> [!NOTE]
>
> Pemantauan registri **segera hadir**. Tidak ada negara dalam katalog ritel staging yang diperiksa pada 7 September 2026 yang sudah mengaktifkan pemantauan. Tarif yang dikonfigurasi adalah USD 2.00 per perusahaan per tahun; harga tidak berarti fitur ini tersedia. Perilaku di bawah ini menjelaskan layanan yang direncanakan setelah peluncuran.

Perusahaan yang sudah diverifikasi pada tingkat **Shareholders** atau **UBO** dapat terus dipantau melalui **pemantauan registri berkelanjutan**. Registri mengirimkan perubahan status perusahaan, pejabat, kepemilikan, dan alamat terdaftar. Pada setiap perubahan, Didit akan:

* memindahkan sesi bisnis dari *Disetujui* kembali ke *Dalam peninjauan*, dengan perubahan tercatat pada sesi;
* mengirim [webhook](https://docs.didit.me/id/business-verification/webhooks.md) `data.updated` dengan `trigger: "kyb_registry_change"`;
* menjaga agar catatan registri perusahaan tetap mutakhir.

Pemantauan **hanya tersedia di negara yang mengizinkannya**: penyedia registri harus menawarkan pemantauan untuk yurisdiksi tersebut. Daftar lengkapnya ada di [tabel negara pemantauan berkelanjutan](https://docs.didit.me/id/business-verification/supported-countries.md#pemantauan-registri-berkelanjutan). Perusahaan yang diverifikasi pada tingkat Lite, atau di negara di luar daftar tersebut, tidak didaftarkan, dan halaman bisnis menampilkan alasannya.

Aktifkan per alur kerja dari *Workflows → KYB Registry Check → Advanced → Continuous registry monitoring*. Biayanya **\$2.00 per perusahaan per tahun**, ditagihkan saat pendaftaran dan pada setiap perpanjangan tahunan. Jika saldo dompet tidak dapat menutupi biaya perpanjangan, pemantauan dihentikan untuk perusahaan tersebut dan tidak berjalan tanpa pembayaran. Anda dapat membatalkannya kapan saja dari halaman bisnis (*KYB Registry Check → Registry monitoring*).

## Rekonsiliasi registri vs data yang diajukan pengguna

Respons menampilkan kedua sumber secara berdampingan di bawah `key_people_checks[]`:

* `registry.officers[]` dan `registry.beneficial_owners[]`: yang diungkapkan oleh penyedia.
* `submitted.parties[]`: yang secara eksplisit diajukan oleh admin bisnis melalui alur, dengan `source: "USER"`.

Analis membandingkan kedua kelompok secara visual di konsol untuk menemukan UBO yang hilang, pihak tambahan yang tidak diungkapkan, atau persentase kepemilikan yang tidak sesuai. Tidak ada endpoint diff otomatis. Anda dapat melakukan rekonsiliasi di sisi Anda dengan mencocokkan nama, peran, dan kepemilikan jika berlaku.

## Skrining AML

Setiap pihak kunci yang teridentifikasi secara otomatis menjalani skrining terhadap daftar pantauan AML global, baik dari sisi registri maupun dari data yang diajukan. Lihat [Skrining AML bisnis](https://docs.didit.me/id/business-verification/aml.md) untuk mengetahui cara pemeriksaan AML tingkat perusahaan dan tingkat individu digabungkan.

## Langkah selanjutnya

> [card] [Pihak kunci](https://docs.didit.me/id/business-verification/key-people.md)
>
> Alur Pihak Kunci dari awal hingga akhir.

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

> [card] [Penilaian risiko](https://docs.didit.me/id/business-verification/risk-assessment.md)
>
> Faktor yang memengaruhi hasil KYB.


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