Langsung ke konten utama
POST
curl
Gunakan ini ketika tautan sebelumnya tidak lagi berfungsi: sesi telah dihapus, atau telah kedaluwarsa sebelum orang tersebut memulainya. Sesi yang dihapus memenuhi syarat meskipun orang tersebut sudah memulai atau menyelesaikan verifikasi. Sesi yang diimpor tidak memenuhi syarat berdasarkan kedaluwarsa; sesi tersebut harus telah dihapus. Sesi yang belum dihapus dan sudah dimulai oleh orang tersebut tidak memenuhi syarat berdasarkan kedaluwarsa. Sesi baru ditautkan ke pihak yang sama, sehingga hasilnya masuk ke pemeriksaan Pihak Kunci seperti yang akan terjadi pada sesi asli, dan tautannya berlaku selama waktu kedaluwarsa sesi dari alur kerja KYC yang dijalankannya (1 jam hingga 4 minggu), bukan waktu kedaluwarsa sesi bisnis. Baca pihak dan sesi turunannya di keputusan sesi bisnis. Jika orang tersebut tidak boleh diverifikasi sama sekali, lewati pihak sebagai gantinya. Lihat Pihak Kunci untuk penjelasan tentang cara pihak dan verifikasinya bekerja.

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.

Parameter Path

sessionId
string<uuid>
wajib

UUID dari sesi induk Verifikasi Bisnis (KYB).

Contoh:

"33333333-4444-5555-6666-777777777777"

partyUuid
string<uuid>
wajib

UUID pihak kunci (key_people_checks[].submitted.parties[].uuid pada keputusan sesi bisnis). Harus dimiliki oleh sesi yang dirujuk oleh sessionId.

Contoh:

"0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"

Respons

Sesi KYC baru dibuat. Mengembalikan pihak yang diperbarui beserta sesi turunan barunya, yang kedaluwarsa setelah waktu kedaluwarsa sesi alur kerja KYC tersebut.

Pihak dari pihak kunci pada sesi Verifikasi Bisnis (KYB), beserta verifikasi turunannya. Pihak yang sama muncul di key_people_checks[].submitted.parties[] dari keputusan sesi bisnis.

uuid
string<uuid>
wajib

Pengidentifikasi pihak.

entity_type
enum<string>
wajib

Apakah pihak tersebut adalah individu atau perusahaan.

Opsi yang tersedia:
person,
company
source
enum<string>
wajib

REGISTRY: diambil dari registri perusahaan. USER: dimasukkan di layar Key People.

Opsi yang tersedia:
REGISTRY,
USER
name
string
wajib

Nama tampilan pihak.

is_active
boolean
wajib

Apakah pihak tersebut aktif.

is_skipped
boolean
wajib

Apakah pihak tersebut dikecualikan dari verifikasi. Pembuatan ulang akan menghapusnya.

requires_verification
boolean
wajib

Apakah aturan peran dan kepemilikan mewajibkan verifikasi untuk pihak ini.

roles
object[]
wajib

Peran yang dipegang pihak terkait di dalam perusahaan.

kyc_session_deleted
boolean
wajib

Sesi KYC turunan telah dihapus, sehingga tidak akan pernah dapat diselesaikan.

kyb_sub_session_deleted
boolean
wajib

Padanan pihak perusahaan untuk kyc_session_deleted.

first_name
string | null

Nama depan (individu).

last_name
string | null

Nama belakang (individu).

company_name
string | null

Nama perusahaan (pihak perusahaan).

registration_number
string | null

Nomor registrasi perusahaan (pihak perusahaan).

email
string<email> | null

Alamat email tujuan pengiriman tautan verifikasi.

nationality
string | null

Kewarganegaraan untuk perorangan, negara pendirian untuk perusahaan.

phone_number
string | null

Nomor telepon yang dikumpulkan untuk pihak tersebut.

date_of_birth
string<date> | null

Tanggal lahir (perorangan).

position
string | null

Jabatan berupa teks bebas (individu).

custom_fields
object

Kolom kustom yang ditentukan alur kerja yang dikumpulkan untuk pihak tersebut, dengan kunci berupa kunci kolom.

kyc_session_id
string<uuid> | null

Sesi KYC individu turunan (perorangan).

kyc_session_status
enum<string> | null

Status sesi KYC turunan. Sesi yang dihapus tetap mempertahankan status yang dimilikinya saat dihapus.

Opsi yang tersedia:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyc_session_url
string<uri> | null

Tautan yang di-hosting untuk sesi KYC turunan. null jika tidak ada atau telah dihapus, dan untuk kunci API yang dibatasi tanpa sessions: write.

kyb_sub_session_id
string<uuid> | null

Sesi KYB turunan (pihak perusahaan).

kyb_sub_session_status
enum<string> | null

Status sesi KYB turunan.

Opsi yang tersedia:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyb_sub_session_url
string<uri> | null

Tautan yang di-hosting untuk sesi KYB turunan, dengan aturan null yang sama seperti kyc_session_url.

verification_workflow_type
enum<string> | null

Jenis alur kerja yang dijalankan oleh sesi turunan.

Opsi yang tersedia:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
verification_workflow_id
string<uuid> | null

Alur kerja yang dijalankan oleh sesi anak.

verification_workflow_label
string | null

Label alur kerja tersebut.

verification_workflow_features
object[] | null

Fitur dari alur kerja sesi turunan beserta statusnya saat ini.

didit_internal_id
string<uuid> | null

Pengidentifikasi Didit untuk orang yang terverifikasi, setelah diketahui.

Terakhir diubah pada 7 November 2026