Langsung ke konten utama
POST
curl

Dukungan KYC dan KYB

Berlaku untuk sesi Verifikasi Pengguna (KYC) dan Verifikasi Bisnis (KYB). Didit mencocokkan session_id dengan kedua jenis sesi dan membuat token JWT untuk berbagi yang mencakup:
Saat mitra penerima mengimpor token, Didit menduplikasi sesi yang sesuai (KYC atau KYB) beserta relasinya.

Persyaratan

  • Sesi harus berada dalam status selesai (APPROVED, DECLINED, IN_REVIEW).
  • Anda harus memiliki izin write:sessions.
  • for_application_id harus berupa aplikasi Didit yang valid (biasanya aplikasi milik mitra).

Contoh

Respons:

Batas TTL

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.

Parameter Path

sessionId
string<uuid>
wajib

UUID sesi verifikasi sumber untuk mencetak token.

Contoh:

"11111111-2222-3333-4444-555555555555"

Body

application/json
for_application_id
string<uuid>
wajib

UUID aplikasi Didit yang akan menukarkan token. Harus ada, tidak boleh dihapus, dan harus berbeda dari aplikasi pemanggil. Temukan di Business Console di bawah Settings → Application.

Contoh:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

ttl_in_seconds
integer
default:3600

Masa berlaku token, dalam detik. Minimum 60, maksimum 86400 (24 jam). Defaultnya 3600 (1 jam).

Rentang yang diperlukan: 60 <= x <= 86400
Contoh:

3600

Respons

Token berbagi telah dicetak.

share_token
string

JWT bertanda tangan HS256. Teruskan ini secara persis apa adanya sebagai share_token ke POST /v3/session/import-shared/ pada aplikasi target.

Contoh:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

for_application_id
string<uuid>

Menampilkan kembali UUID aplikasi target yang terikat dengan token tersebut.

Contoh:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

session_kind
enum<string>

Apakah sesi sumber merupakan sesi Verifikasi Pengguna (KYC) atau Verifikasi Bisnis (KYB).

Opsi yang tersedia:
user,
business
Terakhir diubah pada 7 November 2026