Langsung ke konten utama
GET
Dapatkan step-up
Autentikasi adalah fitur baru. Endpoint-endpoint ini dilayani oleh penerbit aplikasi Anda, misalnya https://<name>.auth.didit.me, dan tidak pernah menggunakan kunci API Didit Anda.
Step-up menjadi milik sesi yang membuatnya: token akses dari sesi lain akan mendapatkan 404. Step-up dengan status pending akan terbaca sebagai expired setelah 30 menit berlalu.

Otorisasi

Authorization
string
header
wajib

Token akses orang tersebut dari POST /token/: JWT ES256 dengan header typ: at+jwt, berlaku paling lama 5 menit. Bukan kunci API Didit Anda.

Parameter Path

step_up_id
string<uuid>
wajib

id dari POST /step-up/, juga parameter kueri step_up pada return_to Anda. Nilai yang bukan UUID akan menerima halaman 404, bukan JSON.

Respons

Step-up.

Verifikasi yang harus dilewati seseorang sebelum tindakan dilakukan.

id
string<uuid>
wajib
Contoh:

"94efc2c3-ca84-42fe-900b-6fb61669a7a1"

rule
enum<string>
wajib

Aturan yang memintanya. Jika beberapa aturan berlaku, aturan dengan metode terkuat yang digunakan.

Opsi yang tersedia:
payout,
device,
bank,
contact
Contoh:

"payout"

method
enum<string>
wajib

Tindakan yang dilakukan orang tersebut: liveness, selfie (liveness yang dicocokkan dengan wajah yang sudah dimiliki Didit) atau full_id (dokumen dan swafoto). Ketika Didit belum memiliki data wajah orang tersebut, selfie menjadi full_id setelah mereka membuka verification_url.

Opsi yang tersedia:
liveness,
selfie,
full_id
Contoh:

"selfie"

status
enum<string>
wajib

Bertindaklah hanya pada approved. review menunggu peninjauan tim Anda. declined tidak bersifat final selama verification_url berfungsi: orang tersebut dapat mencoba lagi, dan peningkatan verifikasi kembali ke pending. superseded berarti pemeriksaan lain mengambil alih verifikasinya, atau hasilnya bukan untuk peningkatan verifikasi ini: buat yang baru.

Opsi yang tersedia:
pending,
review,
approved,
declined,
expired,
superseded
Contoh:

"pending"

level
enum<string> | null
wajib

Tingkat yang dicapai verifikasi, setelah disetujui.

Opsi yang tersedia:
liveness,
liveness_face_match,
full_id,
null
Contoh:

null

amount
string | null
wajib

Jumlah pembayaran keluar, dua desimal.

Contoh:

"900.00"

currency
string | null
wajib
Contoh:

"USD"

created_at
string<date-time>
wajib
Contoh:

"2026-10-17T10:41:14.894632Z"

completed_at
string<date-time> | null
wajib
Contoh:

null

expires_at
string<date-time>
wajib

30 menit setelah pembuatan. Pembacaan step-up terlebih dahulu mengumpulkan hasil apa pun yang dicapai verifikasinya, sehingga masih dapat terbaca approved, review, atau declined setelah waktu ini; yang masih pending akan terbaca expired.

Contoh:

"2026-10-17T11:11:14.894581Z"

Terakhir diubah pada 7 November 2026