---
title: Penanganan error
canonical: https://developer.unico.io/id/developers/sdks-and-tools/flutter/error-handling
locale: id
generated_by: markdown-export
---

- [/id/](/id/)
- [SDK dan Alat](/id/developers/sdks-and-tools/overview)
- [Flutter SDK](/id/developers/sdks-and-tools/flutter/requirements)
- Penanganan error

# Penanganan error

Semua penanganan error untuk Flutter SDK dipusatkan di bagian ini. Callback `onErrorUnico`, `onErrorSelfie`, dan `onErrorDocument` menerima objek `UnicoError` dengan field `code` (`int`), `description` (`String`) dan `info` (`String?`). `info` membawa tahap alur yang gagal di iOS dan selalu `null` di Android.

Error codes
| Kode | Deskripsi |
| --- | --- |
| `73001` | Konteks tidak valid |
| `73002` | Tidak memberikan izin untuk membuka kamera |
| `73003` | Level API minimum adalah 21 (LOLLIPOP) |
| `73004` | Tidak dapat menemukan implementasi antarmuka callback `iAcessoBioSelfie` |
| `73005` | Tidak dapat menemukan implementasi antarmuka callback `iAcessoBioDocument` |
| `73006` | Tidak dapat membuka kamera pada emulator |
| `73100` | Tidak dapat terhubung ke internet |
| `73200` | Harap berikan nama file JSON |
| `73202` | Tidak dapat mengurai file JSON |
| `73300` | Tidak dapat mendapatkan objek autentikasi unico |
| `73301` | Tidak dapat mengurai objek |
| `73302` | Tidak dapat menemukan token unico |
| `73303` | Host saat ini tidak terdaftar |
| `73400` | Tidak dapat menginisialisasi kamera |
| `73500` | Tidak dapat mendapatkan token sesi — error respons layanan |
| `73501` | Tidak dapat mengurai objek |
| `73502` | Tidak dapat mendapatkan token sesi |
| `73701` | Tidak dapat menemukan impor active liveness |
| `73702` | Tidak dapat menginisialisasi active liveness dalam mode produksi |
| `73703` | Tidak dapat mendapatkan sesi active liveness |
| `73704` | Pengguna menekan tombol batal dan tidak menyelesaikan sesi |
| `73705` | Sesi tidak berhasil diselesaikan dan FaceScan tidak dihasilkan |
| `73706` | Akses kamera ditolak — pengguna secara eksplisit menolak izin atau kebijakan perangkat membloknya |
| `73707` | Sesi dibatalkan karena aplikasi dihentikan, tidur, notifikasi OS, atau berjalan di latar belakang |
| `73708` | Sesi dibatalkan karena perangkat dalam mode lanskap |
| `73709` | Sesi dibatalkan karena perangkat dalam mode potret terbalik |
| `73710` | Sesi dibatalkan karena pengguna tidak dapat menyelesaikannya dalam batas waktu yang ditentukan |
| `73712` | Sesi dibatalkan karena tekanan memori / aplikasi tidak dalam produksi memerlukan jaringan |
| `73713` | Sesi dibatalkan karena kunci Anda perlu divalidasi ulang |
| `73714` | Sesi dibatalkan karena kunci enkripsi yang dikonfigurasi pengembang tidak valid |
| `73715` | Sesi dibatalkan karena tidak semua gambar panduan dikonfigurasi |
| `73716` | Sesi dibatalkan karena SDK tidak dapat memulai kamera di perangkat ini |
| `73717` | Sesi dibatalkan karena pengguna dalam kondisi terkunci |
| `73718` | Error tidak dikenal dan tidak terduga selama penggunaan normal API native |
| `73719` | Sesi dibatalkan karena pengguna menekan pesan subteks layar Bersiaplah |
| `73800` | Tidak dapat membuat kunci terenkripsi |
| `74001` | Callback `onSuccess` tidak diimplementasikan saat membuka kamera dengan `webAppToken` |

Katalog error resmiKode-kode di atas mencerminkan katalog Flutter SDK. Katalog kode error lintas platform resmi tersedia di [API Reference > Error codes](/id/developers/start/error-codes).

Handling the callback
```
@override**void onErrorUnico(UnicoError error) {  final code = error.code;  final description = error.description;  // handle error}
```

Lifecycle callbacks
Selain `onErrorUnico`, SDK juga memicu:

`onUserClosedCameraManually()` — pengguna menutup kamera secara manual.
`onSystemClosedCameraTimeoutSession()` — sesi berakhir karena timeout (default 45 d, minimum 40 d).
`onSystemChangedTypeCameraTimeoutFaceInference()` — deteksi wajah melebihi ambang batas 13 d; pengambilan beralih ke mode manual.
Terakhir diperbarui pada 22 Okt 2026**