Autentikasi Bertahap

Apa yang diselesaikan oleh kasus penggunaan ini

Mendeteksi apakah biometrik wajah sudah dikaitkan dengan akun aktif lain dalam basis operator Anda — prinsip "One Face, One Contract". Dengan satu panggilan API, cocokkan wajah yang ditangkap terhadap basis pendaftaran Anda dan blokir akun duplikat pada titik tindakan.

Gunakan kasus penggunaan ini ketika:

• Pengguna mencoba menjalankan tindakan (meminta penarikan pertama, cash-out) dan Anda ingin memvalidasi apakah biometrik tersebut sudah milik akun aktif lain dalam sistem Anda.
• Anda perlu melakukan penyerapan retroaktif basis historis selfie untuk mengidentifikasi duplikat yang ada (mode batch). Ini adalah alur Impor Basis Biometrik.
• Model bisnis Anda mengharuskan setiap individu memiliki maksimal satu akun aktif per operator (atau per negara).
• Anda ingin mengurangi beban pada meja tinjauan video manual, mengganti analisis manusia dengan keputusan otomatis dan deterministik.

Jangan gunakan kasus penggunaan ini ketika:

• Anda perlu memvalidasi keaslian dokumen identitas → lihat kasus penggunaan onboarding.
• Anda perlu mengonfirmasi bahwa orang yang melakukan transaksi adalah pemilik akun (verifikasi 1:1) → lihat kasus penggunaan transaksional.
• Produk Anda mengizinkan beberapa akun per orang secara desain (misalnya, akun pribadi dan bisnis) → evaluasi konfigurasi clientReferenceSegment dengan tim Unico sebelum mengaktifkan aturan ini. Field ini mendefinisikan cakupan pencarian: perbandingan 1:N hanya berjalan terhadap catatan yang terdaftar di bawah segmen yang sama, sehingga segmen yang berbeda dapat berdampingan dalam satu operator tanpa memicu false positive.

Kemampuan yang terlibat

Pipeline yang dijalankan dalam satu proses:

LivenessMulti akun 1:N

Kemampuan	Diperlukan	Peran dalam alur
Liveness	Opsional untuk API; wajib untuk Web dan Native	Pemeriksaan liveness pada saat pengambilan gambar.
Multi akun 1:N	Wajib	Melakukan pencarian biometrik tersegmentasi dalam basis operator, mencocokkan wajah yang diterima terhadap semua catatan dalam segmen yang sama.

Prasyarat

• Bearer token — lihat Autentikasi.
• Kredensial sandbox — lihat Lingkungan.
• SDK atau komponen Web terpasang — hanya untuk integrasi Web dan SDK. Lihat SDK dan Alat.
• Field clientReference diisi di semua permintaan — mengidentifikasi pengguna secara unik dalam sistem operator. Harus unik dalam basis data klien, maksimal 256 karakter, dan tidak mengandung spasi. Field ini adalah pengidentifikasi utama untuk keperluan Multi akun.

Implementasi langkah demi langkah

Native

Integrasi melalui SDK native — pengambilan gambar berjalan di dalam aplikasi Anda menggunakan Unico SDK untuk Android, iOS, atau Flutter.

1. Instal SDK — tambahkan dependensi Unico SDK untuk platform Anda. Lihat panduan penyiapan untuk Android, iOS, atau Flutter.
2. Buat proses — panggil Create Process dengan nilai flow yang sesuai dan pengenal pengguna. Gunakan token yang dikembalikan untuk menginisialisasi SDK.
3. Mulai pengambilan gambar — SDK merender UI kamera dan melakukan deteksi liveness di perangkat, mengembalikan payload yang diambil.
4. Kueri hasilnya — panggil Get Process untuk mengambil hasil capability.
5. Terapkan aturan bisnis — evaluasi kolom respons untuk menyetujui, menolak, atau mengekskalasi.

Android

SDK Android native untuk pengambilan gambar di dalam aplikasi.

Lihat ikhtisar

iOS

SDK iOS native untuk pengambilan gambar di dalam aplikasi.

Lihat ikhtisar

Flutter

SDK Flutter lintas platform untuk pengambilan gambar di dalam aplikasi.

Lihat ikhtisar

Web

Integrasi melalui iFrame, Redirect, atau Native — Unico meng-host UI pengambilan gambar, dan Anda menerima hasilnya melalui polling.

1. Buat proses — panggil Create Process dengan nilai flow yang sesuai dan pengenal pengguna. Respons menyertakan userRedirectUrl.
2. Arahkan pengguna — kirim pengguna ke userRedirectUrl. Unico merender perjalanan pengambilan gambar. Atau gunakan webAppToken di aplikasi native.
3. Pengguna menyelesaikan perjalanan — setelah pengambilan gambar, pengguna diarahkan kembali ke callbackUri Anda.
4. Kueri hasilnya — panggil Get Process untuk mengambil hasil capability.
5. Terapkan aturan bisnis — evaluasi kolom respons untuk menyetujui, menolak, atau mengekskalasi.

Web

Integrasi cepat melalui browser, tidak perlu instalasi.

Lihat ikhtisar

API

Integrasi API langsung — ambil selfie menggunakan Unico SDK atau UI Anda sendiri mengikuti Capture Standard, lalu kirim gambar langsung ke Unico API.

1. Ambil selfie — gunakan Unico SDK untuk platform Anda, atau buat UI Anda sendiri mengikuti Capture Standard, untuk mendapatkan gambar selfie yang memenuhi persyaratan liveness.
2. Buat proses — panggil Create Process dengan identifier pengguna dan selfie sebagai imagebase64.
3. Kueri hasilnya — panggil Get Process untuk mengambil hasil capability.
4. Terapkan aturan bisnis — evaluasi kolom respons untuk menyetujui, menolak, atau mengekskalasi.

API

Kontrol penuh atas alur dengan integrasi back-to-back.

Lihat ikhtisar