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

# Daftar Blokir Bisnis: Blokir KYB & Negara

> Blokir entitas Didit Business berdasarkan vendor_data atau negara: cara blokir diperiksa, serta rute konsol dan API untuk menambah atau menghapusnya.

Blocklists mencegah bisnis yang gagal pemeriksaan kepatuhan Anda, atau yang berlokasi di yurisdiksi berbahaya, menjalankan sesi Verifikasi Bisnis (KYB) baru atau melakukan transaksi di platform Anda.

## Jenis identifier yang didukung untuk Bisnis

| Jenis | Kunci | Cocok saat… |
| - | - | - |
| Bisnis | `BUSINESS` | Sesi baru atau transaksi menggunakan `vendor_data` yang masuk daftar blokir |
| Negara | (dikonfigurasi secara terpisah) | Negara bisnis cocok dengan daftar negara berbahaya |
| IP | `IP_ADDRESS` | Alamat IP pengirim (atau rentang CIDR) cocok |
| Sidik jari perangkat | `DEVICE_FINGERPRINT` | Perangkat pengirim cocok |
| Alamat dompet | `WALLET_ADDRESS` | Dompet kripto yang terkait dengan bisnis cocok |
| Rekening bank | `BANK_ACCOUNT` | IBAN / rekening bank cocok |

> [!NOTE]
>
> Daftar blokir untuk wajah dan dokumen berlaku di tingkat **individu** (Pengguna), bukan di tingkat Bisnis. Untuk memblokir direktur atau UBO, masukkan mereka ke daftar blokir sebagai Pengguna. Keterlibatan mereka dengan bisnis mana pun kemudian akan diteruskan ke peninjauan pihak kunci bisnis tersebut.

## Cara pemblokiran terjadi

> [!NOTE]
>
> Sesi Verifikasi Bisnis (KYB) yang ditolak tidak memasukkan bisnis ke daftar blokir. Sesi berakhir dengan status `Declined`, Bisnis tetap `ACTIVE`, dan tidak ada entri daftar yang dibuat. Pemblokiran adalah langkah manual: tambahkan entri dari [halaman Blocklist](https://docs.didit.me/id/console/blocklist-users.md) atau dengan [Lists API](https://docs.didit.me/id/management-api/lists/overview.md). Entri `BUSINESS` (`vendor_data`) juga akan mengubah status Bisnis menjadi `BLOCKED`.

**1. Otomatis: jika negara berbahaya**

Jika negara pendirian bisnis tercantum dalam daftar negara berbahaya yang Anda konfigurasi, sesi Verifikasi Bisnis (KYB) ditolak.

**2. Otomatis: pada entitas yang dikenai sanksi**

Sesi ditolak jika temuan AML perusahaan melebihi ambang penolakan. Tidak ada entri daftar yang dibuat. Blokir bisnis tersebut sendiri jika Anda ingin `vendor_data`-nya ditolak sejak saat itu.

**3. Manual: dari konsol**

Seorang analis memblokir bisnis dari *Businesses → \[business] → Actions → Add to blocklist*.

**4. Terprogram: melalui Lists API**

Gunakan [Lists API](https://docs.didit.me/id/management-api/lists/overview.md) untuk menambahkan entri langsung ke daftar blokir Bisnis.

## Negara berbahaya

Setiap aplikasi dilengkapi daftar **negara berbahaya** bawaan (dapat dikonfigurasi dari *Settings → Blocklist → Countries*). Contoh kode ISO yang disertakan secara default: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR` (dapat berubah, karena daftar default mengikuti panduan FATF dan OFAC).

Saat bisnis dibuat dengan `country_code` yang cocok:

* Sesi Verifikasi Bisnis (KYB) ditolak.
* Tidak ada tautan sesi yang diterbitkan.
* Entitas Bisnis dibuat dengan status `BLOCKED`.

## Menambahkan bisnis ke daftar blokir melalui API

Gunakan [Lists API](https://docs.didit.me/id/management-api/lists/overview.md) untuk menambahkan entri daftar blokir secara terprogram:

1. [Daftar semua daftar](https://docs.didit.me/id/management-api/lists/list.md) dengan filter `entry_type=business` dan `is_system=true` untuk menemukan daftar blokir Bisnis milik sistem.
2. [Buat entri](https://docs.didit.me/id/management-api/lists/create-entry.md) pada daftar tersebut dengan `value` diisi `vendor_data` bisnis, ditambah `display_label` dan `comment` opsional untuk keperluan audit.

## Penerapan pada saat transaksi

Bisnis yang masuk daftar blokir otomatis diteruskan ke Pemantauan Transaksi:

* Transaksi dengan **bisnis pemohon yang masuk daftar blokir** ditolak otomatis.
* Transaksi dengan **bisnis pihak lawan yang masuk daftar blokir** ditandai atau ditolak, bergantung pada konfigurasi aturan Anda.

Aturan preset seperti "Sanctioned counterparty" terpicu oleh kecocokan ini.

## Menghapus bisnis dari daftar blokir

* **Konsol**: *Blocklist → Businesses → tindakan pada baris → Remove*.
* **API**: gunakan endpoint [Hapus entri](https://docs.didit.me/id/management-api/lists/delete-entry.md) dengan UUID daftar dan UUID entri.

Penghapusan tidak secara otomatis mengubah `status` Bisnis. Gunakan `PATCH /v3/businesses/{vendor_data}/update-status/` untuk mengembalikan bisnis ke `ACTIVE`.

## Jejak audit

Setiap penambahan dan penghapusan dicatat di [log audit](https://docs.didit.me/id/console/audit-logs.md) dengan:

* Pelaku (email pengguna atau `'system'`, `'api'`).
* Stempel waktu.
* Komentar opsional.
* Referensi sesi jika dibuat otomatis.

## Langkah selanjutnya

> [card] [Lists API](https://docs.didit.me/id/management-api/lists/overview.md)
>
> Referensi lengkap API daftar blokir.

> [card] [Daftar blokir di konsol](https://docs.didit.me/id/console/blocklist-users.md)
>
> Kelola daftar blokir dari antarmuka.

> [card] [Operasi](https://docs.didit.me/id/entities/businesses/operations.md)
>
> Ubah status bisnis.


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