Peringatan Verifikasi Bisnis & Kode Error KYB

Verifikasi Bisnis (KYB) menampilkan peringatan pada item fitur yang menghasilkannya. Setiap peringatan memiliki bentuk terstruktur standar yang dipakai di seluruh platform, yaitu feature, risk, log_type, short_description, long_description, additional_data (opsional), dan node_id, sehingga Anda dapat mengarahkan pekerjaan peninjauan ke tim operasional yang tepat.

Ikhtisar

Sesi KYB menghasilkan peringatan di bawah tiga tag fitur inti yang dipetakan ke array fitur khusus dalam respons keputusan V3:

Tag fitur	Kunci respons keputusan	Cakupan
`KYB_REGISTRY`	`registry_checks[].warnings[]`	Pencarian di registri perusahaan resmi. Status aktif, pembatasan negara, kepemilikan yang dapat diturunkan, serta data pejabat/UBO yang tidak ada.
`KYB_DOCUMENTS`	`document_verifications[].warnings[]`	Dokumen pendirian, kepemilikan, alamat, dan pemegang saham yang diunggah pengguna. Konsistensi antardokumen, OCR, metadata, manipulasi, usia, dan aturan subtipe.
`KYB_KEY_PEOPLE`	`key_people_checks[].warnings[]`	Sinyal tingkat orang pada direktur, pejabat, UBO, atau pihak yang diajukan oleh pengguna, termasuk temuan PEP/sanksi yang diteruskan dari AML dan penggunaan ulang penolakan sebelumnya.

Alur kerja KYB yang sama juga dapat menyertakan fitur bersama berikut. Fitur-fitur ini menghasilkan peringatan pada array mereka sendiri:

Tag fitur	Kunci respons keputusan
`AML`	`aml_screenings[].warnings[]`
`PHONE`	`phone_verifications[].warnings[]`
`EMAIL`	`email_verifications[].warnings[]`
`QUESTIONNAIRE`	`questionnaire_responses` (peringatan berada di log sesi)
`LOCATION`	`ip_analyses[].warnings[]`

Peringatan Registri KYB

Peringatan registri menggunakan feature: "KYB_REGISTRY" dan muncul pada registry_checks[].warnings[].

Tag	Deskripsi
`KYB_COUNTRY_RESTRICTED`	Negara perusahaan berada di luar negara yang diizinkan dan dikonfigurasi untuk alur kerja.
`KYB_OFFICERS_DATA_NOT_FOUND`	Data pejabat tidak tersedia dari registri.
`KYB_OWNERSHIP_DATA_NOT_FOUND`	Data kepemilikan tidak tersedia dari registri.
`KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE`	Kepemilikan manfaat akhir tidak dapat ditetapkan dari data registri.
`KYB_COMPANY_NOT_ACTIVE`	Perusahaan tidak aktif menurut registri.
`KYB_COMPANY_NOT_FROM_REGISTRY`	Perusahaan dimasukkan secara manual dan tidak dapat diverifikasi terhadap registri perusahaan.
`KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED`	Nomor registrasi perusahaan yang ditemukan dari registri tidak cocok dengan `expected_details.registration_number` yang Anda kirim saat membuat sesi.
`KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED`	Nomor registrasi yang ditemukan dari registri hanya sebagian cocok dengan nomor yang diharapkan, misalnya sufiks cabang atau anak perusahaan.
`KYB_COMPANY_VAT_INVALID`	Registri pajak resmi tidak memiliki registrasi aktif untuk nomor VAT atau ID pajak perusahaan, atau nomor VAT tidak memenuhi aturan format dan digit pemeriksa negaranya. Tindakan yang dikonfigurasi dalam `kyb_vat_invalid_action` diterapkan (default: dalam peninjauan).
`KYB_COMPANY_VAT_COULD_NOT_VALIDATE`	Nomor VAT atau ID pajak tidak dapat divalidasi karena registri resmi sementara tidak tersedia. Tindakan yang dikonfigurasi dalam `kyb_vat_unverified_action` diterapkan (default: tidak ada efek).
`KYB_COMPANY_VAT_NAME_MISMATCH`	Nama yang terdaftar di registri resmi untuk nomor ini berbeda dengan nama perusahaan yang dikirim. Bersifat informasional. `registry_name`, `registry_source`, dan `submitted_name` disertakan dalam `additional_data`, serta `vies_name` jika registrinya adalah VIES.

Peringatan VAT berlaku di mana pun nomor VAT atau ID pajak perusahaan dapat divalidasi. Lihat Validasi VAT dan ID pajak untuk negara dan sumber.

Peringatan dokumen KYB

Peringatan dokumen menggunakan feature: "KYB_DOCUMENTS" dan muncul pada document_verifications[].warnings[].

Tag	Deskripsi
`KYB_DOCUMENT_MISSING_REQUIRED_FIELD`	Kolom perusahaan yang wajib diisi, seperti nama perusahaan atau nomor registrasi, tidak ditemukan dalam dokumen.
`KYB_DOCUMENT_NAME_MISMATCH`	Nama perusahaan dalam dokumen tidak sesuai dengan registri.
`KYB_DOCUMENT_REG_NUMBER_MISMATCH`	Nomor registrasi dalam dokumen tidak sesuai dengan registri.
`KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH`	Tanggal pendirian dalam dokumen tidak sesuai dengan registri.
`KYB_DOCUMENT_ADDRESS_MISMATCH`	Alamat terdaftar dalam dokumen tidak sesuai dengan registri.
`KYB_CROSS_DOCUMENT_MISMATCH`	Data perusahaan berbeda di antara dokumen korporasi yang diunggah.
`KYB_DOCUMENT_METADATA_MISMATCH`	Tanda tangan, metadata, atau struktur file dokumen menunjukkan kemungkinan masalah.
`KYB_ASSOCIATED_PARTY_MISMATCH`	Direktur atau pemegang saham dalam dokumen tidak sesuai dengan registri.
`KYB_DOCUMENT_GRAPHIC_EDITOR`	Dokumen tampaknya telah diproses dengan perangkat lunak pengeditan grafis.
`KYB_DOCUMENT_SUSPECTED_MANIPULATION`	Sistem mendeteksi tanda-tanda kemungkinan manipulasi dokumen korporasi.
`KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT`	Sebuah kolom teks pada dokumen korporasi dikosongkan lalu diketik ulang dengan font lain, dan file tidak memuat bukti apakah isinya berubah. Peringatan ini juga muncul untuk file yang tidak dapat diperiksa sepenuhnya, dengan `additional_data.detection_method` diisi `analysis_incomplete`, karena bagian yang tidak diperiksa mungkin memuat kolom semacam itu. Diatur oleh `kyb_document_unproven_text_replacement_action` (default Tinjauan). Alur kerja yang tidak pernah melakukan tinjauan menggunakan `kyb_document_tampering_action`-nya sendiri jika nilainya Tolak; jika tidak, tindakannya adalah Tidak ada tindakan.
`KYB_ADDITIONAL_DATA_NOT_FOUND`	Sebuah kolom dokumen tidak dapat diverifikasi karena data registri yang sesuai tidak tersedia.
`KYB_DOCUMENT_EXPIRED`	Dokumen korporasi melebihi usia maksimum yang dikonfigurasi.
`KYB_DOCUMENT_UNSUPPORTED_SUBTYPE`	Subtipe dokumen yang diunggah dinonaktifkan untuk alur kerja.
`KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED`	Jumlah maksimum percobaan unggah dokumen korporasi telah terlampaui.

Untuk manipulasi teks overlay pada PDF, KYB_DOCUMENT_SUSPECTED_MANIPULATION dapat menyertakan additional_data.manipulated_regions. Kolom teks yang dikosongkan lalu diketik ulang dengan font lain memunculkan KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT dengan bentuk manipulated_regions yang sama, dan tidak pernah KYB_DOCUMENT_SUSPECTED_MANIPULATION saja: editor daring juga mengetik ulang teks yang tidak diubah, sehingga peringatan ini tidak menyatakan bahwa isinya berubah. Jika sinyal lain memunculkan KYB_DOCUMENT_SUSPECTED_MANIPULATION pada dokumen yang sama, tindakan yang lebih ketat di antara kedua tindakan tersebut yang berlaku. Ini adalah persegi panjang-persegi panjang dengan koordinat halaman yang menandai area yang diduga diedit dan sesuai dengan persegi panjang-persegi panjang yang dikembalikan dalam document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions.

Peringatan pihak kunci KYB

Peringatan pihak kunci menggunakan feature: "KYB_KEY_PEOPLE" dan muncul pada key_people_checks[].warnings[]. Peringatan ini menunjukkan masalah tingkat individu pada direktur, pejabat, UBO, dan pihak yang diajukan oleh pengguna.

Tag	Deskripsi
`KYB_PREVIOUSLY_DECLINED_INDIVIDUAL`	Seseorang yang terkait dengan perusahaan sebelumnya ditolak dalam verifikasi bisnis lain untuk aplikasi yang sama.
`KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS`	Direktur atau pemegang saham yang dinyatakan di layar Pihak Kunci tidak sesuai dengan orang yang disebutkan dalam dokumen korporasi yang diunggah: orang yang disebutkan dalam dokumen tidak pernah dinyatakan, sebuah nama hampir cocok, pemegang saham yang tercantum dalam dokumen dinyatakan tanpa peran kepemilikan, atau persentase kepemilikan yang dinyatakan bertentangan dengan dokumen. `kyb_key_people_document_mismatch_action` yang dikonfigurasi diterapkan (default: Dalam peninjauan).

Temuan PEP / sanksi pada pihak kunci dilaporkan sebagai temuan AML standar pada item aml_screenings[] yang sesuai, bukan sebagai peringatan pihak kunci KYB. Pemeriksaan Pihak Kunci meneruskan status Declined atau In Review yang dihasilkan ke setiap pihak terkait, sehingga keputusan pihak kunci secara keseluruhan mencerminkan hasil AML.

Peringatan fitur bersama

Fitur-fitur di bawah ini dapat berjalan di dalam alur kerja KYB. Fitur-fitur tersebut menggunakan katalog peringatan yang sama dengan Verifikasi Pengguna. Referensi lengkap untuk setiap fitur ada di halaman peringatan masing-masing.

AML

feature: "AML" pada aml_screenings[].warnings[].

Tag	Deskripsi
`POSSIBLE_MATCH_FOUND`	Skrining AML menemukan kemungkinan kecocokan yang memerlukan peninjauan.
`COULD_NOT_PERFORM_AML_SCREENING`	Didit tidak dapat melakukan skrining AML karena data skrining yang diperlukan tidak tersedia atau hilang.

Telepon

feature: "PHONE" pada phone_verifications[].warnings[].

Tag	Deskripsi
`DISPOSABLE_NUMBER_DETECTED`	Nomor telepon bersifat sekali pakai.
`VERIFICATION_CODE_ATTEMPTS_EXCEEDED`	Jumlah maksimum percobaan kode verifikasi telah terlampaui.
`VOIP_NUMBER_DETECTED`	Nomor telepon merupakan nomor VoIP.
`DUPLICATED_PHONE_NUMBER`	Nomor telepon digunakan dalam proses verifikasi lain.
`HIGH_RISK_PHONE_NUMBER`	Nomor telepon memiliki risiko tinggi.
`PHONE_NUMBER_IN_BLOCKLIST`	Nomor telepon cocok dengan entri dalam daftar blokir Anda.

Email

feature: "EMAIL" pada email_verifications[].warnings[].

Tag	Deskripsi
`BREACHED_EMAIL_DETECTED`	Alamat email muncul dalam kebocoran data yang diketahui.
`DISPOSABLE_EMAIL_DETECTED`	Alamat email bersifat sekali pakai.
`UNDELIVERABLE_EMAIL_DETECTED`	Alamat email tidak dapat menerima email.
`DUPLICATED_EMAIL`	Alamat email digunakan dalam proses verifikasi lain.
`EMAIL_IN_BLOCKLIST`	Alamat email cocok dengan entri dalam daftar blokir Anda.
`EMAIL_CODE_ATTEMPTS_EXCEEDED`	Jumlah maksimum percobaan kode verifikasi email telah terlampaui.

Kuesioner

feature: "QUESTIONNAIRE".

Tag	Deskripsi
`CUSTOM_STATUS_RULE_TRIGGERED`	Aturan status alur kerja mengevaluasi jawaban kuesioner dan mengubah status fitur.

Analisis Perangkat & IP

feature: "LOCATION" pada ip_analyses[].warnings[].

Tag	Deskripsi
`COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP`	Negara dokumen tidak cocok dengan negara dari alamat IP.
`PRIVATE_NETWORK_DETECTED`	Terdeteksi sinyal jaringan pribadi, VPN, proxy, atau Tor.
`EXPECTED_IP_ADDRESS_MISMATCH`	Alamat IP tidak cocok dengan alamat IP yang diharapkan untuk sesi tersebut.
`IP_ADDRESS_IN_BLOCKLIST`	Alamat IP cocok dengan entri dalam daftar blokir Anda.
`DEVICE_FINGERPRINT_IN_BLOCKLIST`	Sidik jari perangkat cocok dengan entri dalam daftar blokir Anda.
`DUPLICATED_IP_ADDRESS`	Alamat IP yang sama digunakan dalam verifikasi lain dengan `vendor_data` yang berbeda.
`DUPLICATED_DEVICE_FINGERPRINT`	Sidik jari perangkat yang sama digunakan dalam verifikasi lain dengan `vendor_data` yang berbeda.

Contoh

Registri perusahaan: perusahaan tidak aktif

{
  "registry_checks": [
    {
      "node_id": "feature_kyb_registry",
      "status": "Declined",
      "warnings": [
        {
          "feature": "KYB_REGISTRY",
          "risk": "KYB_COMPANY_NOT_ACTIVE",
          "log_type": "error",
          "short_description": "Company is not active",
          "long_description": "The company is not active according to the registry.",
          "additional_data": null,
          "node_id": "feature_kyb_registry"
        }
      ]
    }
  ]
}

Dokumen: dugaan manipulasi lapisan

{
  "document_verifications": [
    {
      "node_id": "feature_kyb_documents",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_DOCUMENTS",
          "risk": "KYB_DOCUMENT_SUSPECTED_MANIPULATION",
          "log_type": "warning",
          "short_description": "Possible document manipulation",
          "long_description": "The system detected signs of possible corporate-document manipulation.",
          "additional_data": {
            "manipulated_regions": [
              { "page": 1, "x": 120, "y": 240, "width": 180, "height": 22, "page_width": 612, "page_height": 792 }
            ]
          },
          "node_id": "feature_kyb_documents"
        }
      ]
    }
  ]
}

Pihak kunci: individu yang sebelumnya ditolak

{
  "key_people_checks": [
    {
      "node_id": "feature_kyb_key_people",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_KEY_PEOPLE",
          "risk": "KYB_PREVIOUSLY_DECLINED_INDIVIDUAL",
          "log_type": "warning",
          "short_description": "Previously declined individual",
          "long_description": "A person associated with the company was previously declined in another business verification for the same application.",
          "additional_data": null,
          "node_id": "feature_kyb_key_people"
        }
      ]
    }
  ]
}

Terkait

Skema respons

Lihat di mana peringatan muncul di setiap array fitur KYB.

Status

Pahami bagaimana tingkat keparahan peringatan dipetakan ke status verifikasi.

Dokumen

Tinjau grup dokumen, OCR, dan perilaku pemeriksaan silang.

Pihak kunci

Alur verifikasi petugas, UBO, dan pihak yang diajukan.

Laporan AML

Struktur tingkat temuan untuk skrining AML perusahaan dan individu.

Model data referensi

Bentuk kanonis untuk peringatan dan array fitur.

Memulai

Fitur

Profil Bisnis

Referensi

Konsol

Peringatan Verifikasi Bisnis & Kode Error KYB

Ikhtisar

Peringatan Registri KYB

Peringatan dokumen KYB

Peringatan pihak kunci KYB

Peringatan fitur bersama

AML

Telepon

Email

Kuesioner

Analisis Perangkat & IP

Contoh

Registri perusahaan: perusahaan tidak aktif

Dokumen: dugaan manipulasi lapisan

Pihak kunci: individu yang sebelumnya ditolak

Terkait

Skema respons

Status

Dokumen

Pihak kunci

Laporan AML

Model data referensi

​Ikhtisar

​Peringatan Registri KYB

​Peringatan dokumen KYB

​Peringatan pihak kunci KYB

​Peringatan fitur bersama

​AML

​Telepon

​Email

​Kuesioner

​Analisis Perangkat & IP

​Contoh

​Registri perusahaan: perusahaan tidak aktif

​Dokumen: dugaan manipulasi lapisan

​Pihak kunci: individu yang sebelumnya ditolak

​Terkait

Skema respons

Status

Dokumen

Pihak kunci

Laporan AML

Model data referensi

Ikhtisar

Peringatan Registri KYB

Peringatan dokumen KYB

Peringatan pihak kunci KYB

Peringatan fitur bersama

AML

Telepon

Email

Kuesioner

Analisis Perangkat & IP

Contoh

Registri perusahaan: perusahaan tidak aktif

Dokumen: dugaan manipulasi lapisan

Pihak kunci: individu yang sebelumnya ditolak

Terkait