Langsung ke konten utama
POST
curl

Ikhtisar

Membuat entitas bisnis secara eksplisit sebelum sesi Verifikasi Bisnis (KYB) mana pun berjalan.

Kapan digunakan

  • Pra-isi metadata (mitra, tingkat, pengenal internal) sebelum sesi Verifikasi Bisnis (KYB) pertama.
  • Migrasi dari vendor KYB lain dengan daftar bisnis yang sudah ada.
  • Registrasi khusus transaksi: kirim transaksi untuk bisnis yang Anda verifikasi melalui proses offline.

Catatan

  • vendor_data wajib diisi dan harus unik per aplikasi. Duplikat akan menghasilkan error konflik. Gunakan PATCH /v3/businesses/{vendor_data}/ untuk memperbarui.
  • Kolom yang berasal dari registri (legal_name, registration_number, country_code) dapat diisi lebih dulu, tetapi akan ditimpa oleh data registri dari sesi Verifikasi Bisnis (KYB) yang disetujui pertama.
  • Jika country_code cocok dengan daftar negara berbahaya pada aplikasi Anda, bisnis dibuat dengan status BLOCKED.
  • Mengirim event business.data.updated.

Izin

Peran harus memberikan izin create:businesses.

Terkait

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Body

application/json
vendor_data
string | null

Pengidentifikasi unik Anda untuk bisnis ini (string bentuk bebas, BUKAN UUID). Opsional tetapi sangat disarankan. Jika diberikan, harus unik di antara bisnis yang tidak dihapus untuk aplikasi tersebut; dicocokkan persis seperti yang dikirim.

display_name
string | null

Nama tampilan yang mudah dipahami yang ditampilkan di konsol (mengambil prioritas di atas legal_name untuk tampilan antarmuka).

Maximum string length: 255

Nama resmi menurut hukum dari perusahaan.

Maximum string length: 255
registration_number
string | null

Nomor registrasi atau nomor pendirian perusahaan.

Maximum string length: 100
country_code
string | null

Negara pendirian (ISO 3166-1 alpha-2, misalnya GB, US).

Maximum string length: 10
status
enum<string>
default:ACTIVE

Status siklus hidup awal. Default-nya adalah ACTIVE.

Opsi yang tersedia:
ACTIVE,
FLAGGED,
BLOCKED
metadata
object | null

Objek JSON arbitrer yang Anda lampirkan ke bisnis. Defaultnya adalah {}.

Respons

Bisnis berhasil dibuat. Data bisnis lengkap dikembalikan (struktur yang sama seperti Dapatkan Bisnis).

Detail bisnis lengkap. Memperluas BusinessListItem dengan metadata dan updated_at.

didit_internal_id
string<uuid>

UUID internal yang stabil dari Didit untuk bisnis ini.

vendor_data
string | null

Pengidentifikasi unik Anda untuk bisnis ini (diteruskan saat membuat sesi). Nilai ini dapat berupa null jika tidak ada pengidentifikasi vendor yang diberikan.

display_name
string | null

Nama tampilan kustom yang Anda tetapkan

Nama resmi menurut hukum dari registri atau entri manual

registration_number
string | null

Nomor registrasi atau nomor pendirian perusahaan

country_code
string | null

Negara pendirian (ISO 3166-1 alpha-2, misalnya GB, US).

effective_name
string | null

Nama terbaik yang tersedia: display_name jika disetel, selain itu legal_name

status
enum<string>

Status siklus hidup rekaman bisnis (BUKAN status sesi). ACTIVE adalah default, FLAGGED menandainya untuk perhatian manual, BLOCKED mencegah sesi baru untuk vendor_data ini.

Opsi yang tersedia:
ACTIVE,
FLAGGED,
BLOCKED
session_count
integer

Jumlah total sesi verifikasi untuk bisnis ini

approved_count
integer

Jumlah sesi yang disetujui

declined_count
integer

Jumlah sesi yang ditolak

in_review_count
integer

Jumlah sesi dalam peninjauan

features
object

Status per-fitur agregat di semua sesi KYB bisnis ini. Saat ini satu-satunya kunci adalah KYB (status pemeriksaan perusahaan di registri). Nilai yang memungkinkan: Approved, Declined, In Review, Not Finished, Resub Requested.

features_list
object[]

Data yang sama dengan features, sebagai array berurutan dari objek {feature, status}.

last_session_at
string<date-time> | null

Cap waktu sesi terbaru

first_session_at
string<date-time> | null

Cap waktu sesi pertama

last_activity_at
string<date-time> | null

Cap waktu aktivitas terbaru (perubahan status, pembaruan sesi, dll.)

tags
object[]

Tag yang ditetapkan untuk bisnis ini

created_at
string<date-time>
metadata
object

JSON metadata kustom yang Anda lampirkan ke bisnis ini. Default adalah {}.

updated_at
string<date-time>
Terakhir diubah pada 7 November 2026