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

Semua penanganan error untuk Web SDK dipusatkan di bagian ini. Callback `error` menerima objek `ErrorBio` yang mengekspos `getCode()` dan `getDescription()`.

## Error prepareCamera

| Kode | Deskripsi |
|---|---|
| `73000` | Error yang tidak diketahui dan tidak terduga selama penggunaan normal API SDK |
| `73001` | `<property>` diperlukan |
| `73002` | `<property>` harus merupakan instans dari `<class>` |
| `73003` | `<class>` dengan nama `<name>` tidak tersedia untuk diinjeksikan |
| `73004` | Tipe kelas harus berupa fungsi atau kelas |
| `73005` | Tidak dapat menemukan lokal `<locale>` |
| `73006` | Tidak dapat menemukan teks: `<text>` |
| `73100` | Tidak dapat terhubung ke internet |
| `73200` | Tidak dapat menemukan file JSON SDK Unico |
| `73201` | Tidak dapat memuat file JSON SDK Unico |
| `73202` | File JSON SDK Unico tidak valid |
| `73204` | Tidak dapat menginisialisasi SDK — konfigurasikan lingkungan melalui `setEnvironment` pada build |
| `73300` | Tidak dapat mengautentikasi aplikasi ini |
| `73301` | Tidak dapat mengautentikasi aplikasi ini |
| `73302` | Token autentikasi tidak ditemukan |
| `73303` | Host saat ini tidak terdaftar |
| `73400` | Tidak dapat menginisialisasi kamera |
| `73401` | Tidak dapat memuat model ML untuk kamera ini |
| `73402` | Kunci tidak dapat diverifikasi karena masalah konektivitas pada perangkat pengguna |
| `73403` | Kombinasi perangkat/platform/browser/versi ini tidak didukung oleh SDK |
| `73404` | Perangkat dalam orientasi layar landscape. SDK hanya dapat digunakan dalam mode portrait |
| `73405` | Perangkat diblokir karena beberapa percobaan yang gagal |
| `73406` | Inisialisasi kamera diblokir — SDK dibuka dalam iFrame saat `prepareCamera` |
| `73407` | SDK belum sepenuhnya dimuat |
| `73500` | Tidak dapat mendapatkan sesi |
| `73501` | Tidak dapat mendapatkan sesi |
| `73502` | Token sesi tidak ditemukan |
| `73600` | Tidak dapat menemukan sumber daya kamera |
| `73601` | Tidak dapat memulai kamera dalam mode produksi |
| `74000` | Heksadesimal tidak valid |
| `74001` | Objek bukan `UnicoTheme` |

## Error openCamera

| Kode | Deskripsi |
|---|---|
| `73700` | Tidak dapat mengurai respons kamera |
| `73704` | Pengguna menekan tombol batal dan tidak menyelesaikan sesi |
| `73706` | Akses kamera ditolak — pengguna secara eksplisit menolak izin atau kebijakan perangkat memblokirnya |
| `73707` | Sesi dibatalkan karena aplikasi dihentikan, tidur, notifikasi OS, atau berjalan di latar belakang |
| `73708` | Sesi dibatalkan karena perangkat dalam mode landscape |
| `73710` | Sesi dibatalkan karena pengguna tidak dapat menyelesaikannya dalam batas waktu yang ditentukan |
| `73715` | Sesi dibatalkan karena tidak semua gambar panduan dikonfigurasi |
| `73716` | Sesi dibatalkan karena SDK tidak dapat memulai kamera pada perangkat ini |
| `73717` | Sesi dibatalkan karena pengguna berada dalam keadaan terkunci |
| `73718` | Error yang tidak diketahui dan tidak terduga selama penggunaan normal API SDK |
| `73720` | Developer secara programatik memanggil API pembatalan sesi |
| `73721` | Sesi dibatalkan karena perubahan orientasi perangkat selama sesi |
| `73722` | Sesi dibatalkan karena dokumen belum siap |
| `73723` | Sesi dibatalkan karena ada sesi lain yang sedang berlangsung |
| `73724` | Sesi aktif dibatalkan karena sesi kamera dimulai di dalam iFrame |
| `73728` | Error koneksi — gunakan HTTPS untuk terhubung |
| `73729` | Browser tidak didukung — buka di browser lain |
| `73730` | Tidak dapat menginisialisasi sesi liveness aktif — error lisensi tidak diketahui |
| `73731` | Tidak dapat menginisialisasi sesi liveness aktif — lisensi kedaluwarsa |
| `73732` | Tidak dapat menginisialisasi sesi liveness aktif — asal tidak diizinkan |
| `73750` | Pengambilan gambar gagal karena mata pengguna tertutup |
| `73760` | Pengambilan gambar gagal karena pencahayaan lingkungan (terlalu gelap, terlalu terang, atau tidak merata) |
| `73761` | Pengambilan gambar gagal karena jarak antara wajah pengguna dan layar (terlalu dekat atau terlalu jauh) |
| `73762` | Pengambilan gambar gagal karena kacamata atau aksesori menutupi wajah pengguna |
| `73763` | Pengambilan gambar gagal karena wajah pengguna tidak stabil atau tidak sejajar |
| `73764` | Pengambilan gambar gagal karena pembingkaian wajah (wajah tidak di tengah, lebih dari satu wajah, atau latar belakang ramai) |
| `73800` | Tidak dapat mengenkripsi respons |
| `73900` | Tidak dapat mendapatkan informasi sistem |

:::secondary[Katalog error resmi]
Kode di atas mencerminkan katalog Web SDK. Katalog kode error lintas platform resmi tersedia di [API Reference > Error codes](/dual-api/developers/api-reference/error-codes).
:::

## Menangani callback

```javascript
const callback = {
  on: {
    success: (obj) => {
      console.log(obj.base64);
      console.log(obj.encrypted);
    },
    error: (error) => {
      const code = error.getCode();
      const description = error.getDescription();
      // handle error
    }
  }
};
```

:::danger[Callback wajib]
Objek `callback` bersifat wajib. Jika tidak diimplementasikan dengan benar (mencakup event `success` dan `error`), SDK akan melempar pengecualian yang, jika tidak ditangani, akan ditampilkan di konsol pengguna.
:::