Ikhtisar
Memilih kontrak
Pilihan kontrak adalah konsekuensi dari di mana pengambilan biometrik terjadi — bukan keputusan yang independen. Gunakan tabel di bawah sebagai panduan.
| Kontrak | Gunakan saat… | Pengambilan | Alur |
|---|---|---|---|
| Web & SDK | Perjalanan pengambilan dihosting oleh Unico (Web iFrame, Redirect, atau SDK native) | Unico yang mengendalikan | Proses dibuat sebelum pengambilan → pengguna menjalani perjalanan → hasil dikembalikan melalui callback atau polling |
| API | Aplikasi Anda mengendalikan pengambilan (dengan atau tanpa Unico SDK) dan mengirimkan gambar langsung dalam panggilan | Klien yang mengendalikan | Gambar dikirim bersamaan dengan pembuatan proses → hasil dikembalikan secara sinkron |
Host dan environment
| Kontrak | Host Sandbox | Host Production |
|---|---|---|
| Web & SDK | https://api.idcloud.uat.unico.app | https://api.idcloud.unico.app |
| API | https://api.id.uat.unico.app | https://api.id.unico.app |
| OAuth2 / Token | https://identityhomolog.acesso.io | https://identity.acesso.io |
Detail lengkap di Environments.
Autentikasi
Semua kontrak Unico menggunakan Bearer token (JWT) yang diperoleh melalui OAuth2 dengan urn:ietf:params:oauth:grant-type:jwt-bearer.
Detail lengkap di Authentication.
Perbedaan payload antar kontrak
Operasi konseptual yang sama ("membuat proses verifikasi identitas") terlihat berbeda di setiap kontrak. Gunakan tabel di bawah sebagai referensi cepat saat bermigrasi antar integrasi.
Pembuatan proses
| Aspek | Web & SDK | API |
|---|---|---|
| Endpoint | POST /client/v1/process | POST /processes/v1 |
| Auth | Authorization: Bearer <jwt> | Authorization: Bearer <jwt> + APIKEY |
| Gambar | Tidak dikirim (diambil oleh perjalanan Unico) | Dikirim sebagai imageBase64 |
| Identifikasi pengguna | person.duiType + person.duiValue | subject.code (CPF / CURP) |
| Jenis dokumen | CPF, CURP, SSN, NIN, DNI, NIK | Hanya CPF, CURP |
| Definisi pipeline | flow (enum, 30+ nilai) | Implisit dalam APIKEY (kemampuan) |
| Callback | callbackUri (redirect pengguna) | Tidak ada (sinkron) |
| Webhook | Webhook v1 (hasil akhir) | Webhook v1 (opsional) |
| Mengembalikan URL perjalanan | Ya (userRedirectUrl) | Tidak |
| Hasil | Asinkron (polling GET atau webhook) | Sinkron (dalam respons) |
| SDK token | Ya (token, webAppToken) | Tidak |
Pengambilan hasil
| Aspek | Web & SDK | API |
|---|---|---|
| Endpoint | GET /client/v1/process/\{id\} | GET /processes/v1/\{id\} (juga dalam respons pembuatan) |
| Status | state + result (enum dengan awalan) | status (1, 3, 5) |
| Struktur hasil | Bersarang di bawah process.authenticationInfo.{capability}Result | Datar: unicoId, liveness, government, identityFraudsters |
| Dokumen | services[].documents[] (RG/CNH dengan OCR) | Endpoint terpisah (GET /processes/v1/\{id\}/document) |
Langkah berikutnya
- Authentication — alur OAuth2 dan pembuatan JWT
- Environments — sandbox vs production
- Postman Collection — koleksi siap pakai
- Webhooks and Events — pengiriman hasil asinkron
- SDKs and Tools — Web SDK, Android, iOS, Flutter