Langsung ke konten utama
POST
cURL
Gunakan endpoint ini saat Anda perlu memisahkan trafik verifikasi, kredensial, branding, atau pelaporan dalam organisasi yang sama. Ini sangat berguna untuk reseller yang membuat satu aplikasi per pelanggan. Endpoint ini juga cocok ketika perusahaan Anda memiliki beberapa produk, merek, wilayah, lingkungan staging/produksi, atau kasus penggunaan yang tidak boleh berbagi kunci API dan pengaturan tingkat aplikasi yang sama.
Semua endpoint Auth API menggunakan https://apx.didit.me/auth/v2. Gunakan api_key yang dikembalikan sebagai x-api-key saat memanggil endpoint https://verification.didit.me/v3/... seperti sesi dan alur kerja.

Lokasi data

Setiap aplikasi menyimpan dan memproses data verifikasinya di satu tempat, yaitu lokasi datanya, yang dipilih saat Anda membuat aplikasi dengan data_location. Saat ini satu-satunya lokasi yang tersedia adalah eu, Uni Eropa (Irlandia), yang juga menjadi nilai default jika Anda tidak mengisi kolom ini. Australia (Sydney, au) dan Meksiko (mx) segera hadir: permintaan yang menyebut lokasi tersebut akan menerima jawaban 400 This data location is not available yet. dan tidak ada aplikasi yang dibuat. Setiap kali aplikasi dibaca, respons menyertakan data_location, dan nilai ini tidak dapat diubah setelah aplikasi dibuat. Lihat Lokasi data.

Otorisasi

Authorization
string
header
wajib

access_token JWT bertanda tangan RS256 yang dikembalikan oleh POST /programmatic/login/ atau POST /programmatic/verify-email/. Kirim sebagai Authorization: Bearer <access_token>. Masa berlaku default adalah 86400 detik (24 jam). Token ini hanya valid untuk endpoint Manajemen Akun di apx.didit.me/auth/v2. Sebagai gantinya, API verifikasi (verification.didit.me/v3) menggunakan api_key berjangka panjang sebagai x-api-key.

Parameter Path

org_id
string<uuid>
wajib

UUID organisasi. Cari tahu menggunakan GET /organizations/me/.

Contoh:

"a1b2c3d4-5678-90ab-cdef-111111111111"

Body

application/json

Semua kolom bersifat opsional. Menghilangkan isi permintaan akan membuat aplikasi dengan nama default "<organization name> App" dan tanpa URL publik yang dikonfigurasi.

Semua kolom bersifat opsional. Mengirimkan isi permintaan kosong akan membuat aplikasi dengan nama default, di Uni Eropa.

name
string

Nama tampilan aplikasi. Default ke "<organization name> App".

Contoh:

"Acme Customer App"

website_url
string

URL situs web atau aplikasi yang terkait dengan aplikasi ini.

Contoh:

"https://acme.example"

redirect_uris
string[]

URI pengalihan yang diizinkan untuk alur pengalihan gaya OAuth dan verifikasi.

Contoh:
terms_url
string

URL ketentuan layanan yang ditampilkan dalam alur verifikasi.

Contoh:

"https://acme.example/terms"

privacy_url
string

URL kebijakan privasi yang ditampilkan dalam alur verifikasi.

Contoh:

"https://acme.example/privacy"

description
string

Deskripsi internal untuk aplikasi (tidak ditampilkan kepada pengguna akhir).

data_location
enum<string>

Tempat data verifikasi aplikasi disimpan dan diproses, dipilih saat aplikasi dibuat. eu adalah Uni Eropa (Irlandia), sebagai default. au (Australia, Sydney) dan mx (Meksiko) akan segera hadir: permintaan yang mencantumkannya akan menghasilkan respons 400 This data location is not available yet. Aplikasi Sandbox suatu organisasi selalu berada di Uni Eropa.

Opsi yang tersedia:
eu,
au,
mx
Contoh:

"eu"

Respons

Aplikasi dibuat. Respons menyertakan api_key jangka panjang; simpan sekarang dan gunakan sebagai header x-api-key pada setiap panggilan https://verification.didit.me/v3/....

Catatan aplikasi lengkap. Nilai uuid, client_id, dan api_key tidak pernah berubah setelah pembuatan. Begitu pula dengan data_location, kecuali satu kali pada aplikasi produksi yang dibuat bersama organisasi Anda, sebelum digunakan (lihat permintaan pembaruan).

uuid
string<uuid>

UUID aplikasi. Gunakan sebagai {app_id} dalam panggilan berikutnya.

Contoh:

"b2c3d4e5-6789-01bc-defg-222222222222"

name
string

Nama tampilan aplikasi yang ditampilkan di konsol Didit.

Contoh:

"Acme Production App"

client_id
string

Pengenal klien publik, aman untuk disematkan dalam alur bergaya OAuth.

Contoh:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

Rahasia jangka panjang (juga disebut client_secret). Gunakan sebagai header x-api-key untuk setiap panggilan ke https://verification.didit.me/v3/... (sesi, alur kerja, AML, dll.). Perlakukan sebagai kredensial; jangan pernah mengeksposnya di sisi klien. Kunci baru diawali dengan sk_live_ (aplikasi produksi) atau sk_test_ (aplikasi sandbox), diikuti oleh 43 karakter aman-URL (huruf, angka, -, dan _). Kunci yang dibuat sebelum format ini tidak memiliki awalan dan tetap berfungsi tanpa perubahan. Selama 72 jam setelah Anda memulihkan akun, operasi daftar, ambil, dan perbarui mengembalikan string kosong di sini alih-alih kunci.

Contoh:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

URL situs web atau aplikasi yang terkait dengan aplikasi ini.

Contoh:

"https://acme.example"

redirect_uris
string[]

URI pengalihan yang diizinkan untuk alur pengalihan gaya OAuth dan verifikasi.

Contoh:
terms_url
string | null

URL ketentuan layanan yang ditampilkan dalam alur verifikasi.

Contoh:

"https://acme.example/terms"

privacy_url
string | null

URL kebijakan privasi yang ditampilkan dalam alur verifikasi.

Contoh:

"https://acme.example/privacy"

description
string | null

Deskripsi internal untuk aplikasi (tidak ditampilkan kepada pengguna akhir).

created_at
string<date-time>
Contoh:

"2025-06-01T10:00:00Z"

data_location
enum<string>

Tempat data verifikasi aplikasi disimpan dan diproses, dipilih saat aplikasi dibuat. eu adalah Uni Eropa (Irlandia), sebagai default. au (Australia, Sydney) dan mx (Meksiko) akan segera hadir: permintaan yang mencantumkannya akan menghasilkan respons 400 This data location is not available yet. Aplikasi Sandbox suatu organisasi selalu berada di Uni Eropa.

Opsi yang tersedia:
eu,
au,
mx
Contoh:

"eu"

products
object[]
read-only

Produk aplikasi. Selalu ketiganya, dalam urutan ini: identity, transactions, authentication. Aplikasi baru memiliki identity yang diaktifkan dengan semua modul aktif, serta transactions dan authentication dinonaktifkan. Hanya baca: kunci products dalam body pembuatan atau pembaruan akan diabaikan.

Contoh:
Terakhir diubah pada 7 November 2026