Mengatasi masalah unggah dan pembacaan dokumen

Sebagian besar masalah unggah dokumen dan OCR disebabkan oleh kualitas gambar, gambar belakang yang hilang, subtipe yang tidak diizinkan, atau foto salinan alih-alih dokumen asli - berikut cara memperbaiki masing-masing.

Ditulis oleh Dukungan Didit · Diperbarui 15 September 2026

Jika sebuah dokumen gagal diunggah atau kolom-kolom pentingnya tidak terbaca dengan benar, hampir selalu penyebabnya adalah salah satu dari beberapa penyebab yang sudah dikenal. Berikut cara menelusurinya.

#Pertama: apakah dokumennya memang diizinkan?

Sebelum menelusuri kualitas gambar, pastikan alur kerja Anda menerima subtipe dokumen yang persis sama untuk negara tersebut. Subtipe yang tidak diizinkan gagal dengan cara yang terlihat seperti masalah pembacaan padahal bukan - dan itu gagal untuk setiap pengguna yang memegang format tersebut, bukan hanya satu orang. Lihat subtipe adalah alasan umum sebuah dokumen ditolak.

#Gambar buram, gelap, atau terlalu terang

Didit memeriksa kualitas gambar sebelum memproses dokumen dan meminta pengguna mengambil ulang foto jika terlalu buram, terlalu gelap, atau terlalu terang. Minta pengguna untuk:

• Menggunakan pencahayaan yang baik dan merata tanpa silau langsung
• Memegang kamera dengan stabil dan membiarkannya fokus sebelum mengambil gambar
• Menjaga keempat sudut dokumen tetap terlihat dalam bingkai
• Mengeluarkan dokumen dari sampul plastik - pantulannya mengganggu pengambilan otomatis

Pengguna mendapat jumlah pengambilan ulang yang terbatas; pada percobaan terakhir yang diizinkan, gambar akan tetap diterima sehingga mereka tidak pernah benar-benar terblokir, tetapi pengambilan gambar berkualitas rendah tetap bisa membuat sejumlah kolom tidak terbaca. Periksa peringatan sesi untuk IMAGE_TOO_BLURRY, IMAGE_TOO_DARK, atau IMAGE_TOO_BRIGHT untuk memastikan ini penyebabnya.

Jika dokumen buram lolos dan bahkan disetujui, ambangnya terlalu rendah untuk selera risiko Anda. Dua pengaturan di langkah verifikasi ID alur kerja memperbaikinya:

• Kualitas gambar minimum (penggeser kualitas): setiap foto dokumen diberi skor oleh model kualitas saat diambil, dan tangkapan di bawah minimum Anda langsung ditolak dengan permintaan mengambil ulang. Nilai default sengaja longgar; naikkan dan sisi belakang kartu buram yang mendapat 33 tidak pernah mencapai pemeriksaan.
• Layar tinjauan gambar yang diambil (di bawah Lanjutan): menampilkan foto yang baru diambil kepada orang tersebut dan meminta konfirmasi atau pindai ulang sebelum diunggah. Berlaku untuk pemindaian kamera saja, karena unggahan sudah menampilkan pratinjau file.

Skor kualitas itu sendiri ada di laporan sesi, jadi Anda bisa melihat sesi yang mengkhawatirkan dan memilih ambang tepat di atasnya.

#Kolom tidak terdeteksi, atau salah terbaca (nama, tanggal lahir, nomor dokumen)

Ketika OCR tidak dapat mengekstrak kolom tertentu, hal itu saja biasanya tidak membuat sesi ditolak - secara bawaan sesi tersebut diarahkan ke peninjauan manual agar bisa diperiksa oleh manusia.

Jika ini sering terjadi untuk satu jenis dokumen atau satu bahasa tertentu, periksa pengaturan Format karakter yang dipilih pada alur kerja Anda: pilih apakah nama yang diekstrak harus dinormalkan ke huruf Latin atau dipertahankan dalam aksara asli dokumen. Ketidakcocokan di sini adalah penyebab umum kolom nama yang berantakan atau hilang pada dokumen beraksara Sirilik, Arab, Yunani, atau Han.

Saat nilai yang diekstrak salah (nama belakang dengan satu huruf keliru, alamat di kolom nama), lihat memperbaiki nama atau kolom yang salah terbaca: dukungan tidak bisa mengeditnya untuk Anda, tetapi langkah tinjauan data oleh pengguna, API update-data, dan pengiriman ulang masing-masing bisa.

#Tangkapan layar, hasil cetak, dan foto layar ditolak

Didit mewajibkan foto asli dan waktu-nyata dari dokumen fisik - bukan tangkapan layar, hasil pindai, salinan cetak, atau foto dokumen di layar lain. Pemeriksaan liveness dokumen dirancang khusus untuk menangkap kasus-kasus ini dan akan menandai atau menolak sesi tersebut. Minta pengguna untuk memotret dokumen fisik secara langsung.

Ini memang disengaja: menerima foto-dari-foto menghilangkan sebagian besar nilai dari pemeriksaan dokumen itu sendiri.

Detektor tangkapan layar kadang bisa terpicu pada dokumen asli yang difoto dengan latar belakang ramai: keyboard, meja bermotif, monitor di belakang kartu. Jika Anda sudah melihat gambarnya dan dokumen jelas asli, setujui sesinya sendiri: tag itu mengarahkan ke tinjauan justru agar manusia yang memutuskan. Setiap sinyal liveness dokumen (tangkapan layar, salinan cetak, penggantian potret) punya ambang tinjau dan tolak sendiri di pengaturan pemalsuan langkah tersebut, jika salah satunya terlalu sensitif untuk lalu lintas Anda.

#Gambar belakang hilang

Kartu identitas dan SIM bersifat dua sisi - Didit membutuhkan gambar depan maupun belakang untuk menyelesaikan ekstraksi. Jika hanya gambar depan yang dikirim untuk salah satu jenis dokumen ini, sesi tidak akan memiliki data yang dibutuhkan.

Jika pengguna terus-menerus terhenti di langkah sisi belakang, periksa apakah dokumen yang Anda maksud memang benar-benar membawa data yang bisa dibaca di sisi belakangnya untuk negara tersebut. Mewajibkan gambar belakang yang tidak berisi apa pun hanya membuat pengguna gagal di sebuah langkah tanpa manfaat apa pun.

#Kamera tidak pernah terbuka

Ini terlihat seperti masalah dokumen tetapi sebenarnya masalah lingkungan:

• Peramban dalam aplikasi. Tautan yang dibuka di dalam peramban bawaan aplikasi lain (misalnya aplikasi chat) sering kali tidak bisa mengakses kamera. Membuka tautan yang sama di peramban biasa pada ponsel akan mengatasinya.
• Izin yang sebelumnya ditolak. Setelah seseorang menolak akses kamera untuk sebuah situs, peramban akan mengingatnya. Mereka harus mengaktifkannya kembali di pengaturan situs; alur ini tidak bisa meminta izin lagi.
• Kamera sedang digunakan. Tab atau aplikasi lain yang sedang menggunakan kamera akan memblokirnya. Pada beberapa perangkat, memberikan akses mikrofon juga bisa membuat kamera terkunci.

#Teks pada alur terlihat berantakan

Jika pengguna melaporkan kata-kata yang acak atau tidak masuk akal pada antarmuka (bukan pada dokumen), penyebab umumnya adalah ekstensi penerjemah halaman pada peramban yang menulis ulang tampilan layar. Minta mereka mematikan penerjemahan untuk halaman tersebut - alur ini sudah menyediakan pilihan bahasanya sendiri. Lihat mengatur bahasa verifikasi.

#Berapa banyak bahasa yang didukung OCR?

OCR Didit membaca dokumen dalam lebih dari 130 bahasa sebagai bagian dari cakupan dokumen dan negara. Ini terpisah dari bahasa layar verifikasi itu sendiri, yang diatur otomatis oleh peramban pengguna kecuali Anda menetapkannya secara eksplisit.

#Masih mengalami kendala?

Hubungi dukungan dengan ID sesi untuk verifikasi yang terdampak - ini adalah cara tercepat bagi tim untuk menyelidiki kasus tertentu, karena mereka bisa melihat langsung gambar dan peringatan yang Anda maksud.