> For the complete documentation index, see [llms.txt](https://ezybooth-id.gitbook.io/ezybooth.id-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ezybooth-id.gitbook.io/ezybooth.id-docs/pemecahan-masalah.md).

# Pemecahan masalah

Kamera, printer, koneksi, PIN, pembayaran, sesi macet, pengiriman foto, voucher, dan masuk ke Studio.

Setiap masalah ditulis sebagai **gejala → penyebab → yang dilakukan**. Beberapa layar petugas di mesin masih berbahasa Inggris; label itu ditulis apa adanya.

{% hint style="info" %}
Saat menghubungi tim ezybooth (**<halo@ezybooth.id>**), sertakan nama bisnis, nomor sesi (ketuk **Butuh bantuan?** di mesin untuk melihatnya), dan isi **Detail untuk petugas** bila ada. Jangan kirim kata sandi atau kode verifikasi.
{% endhint %}

## Kamera

### Kamera tidak terdeteksi

* **Gejala:** saat aplikasi dibuka atau tamu menekan **Mulai** muncul **Kamera tidak terdeteksi**.
* **Penyebab:** tidak ada kamera terhubung, atau kamera yang dipilih petugas tidak ada.
* **Yang dilakukan:**
  1. Jangan lanjutkan sesi berbayar dulu — tamu bisa tertahan di langkah foto.
  2. Sambungkan kamera (cek kabel USB dan daya).
  3. Buka panel petugas (ikon roda gigi di layar sambutan, masukkan PIN) → **Camera & printing** → **Find cameras**.
  4. Pilih kamera → **Test camera** → **Stop camera test** → **Save device settings**.

### Izin kamera ditolak

* **Gejala:** "Izin kamera ditolak. Izinkan akses kamera di pengaturan sistem, lalu coba lagi."
* **Yang dilakukan:** izinkan akses kamera untuk aplikasi ezybooth di pengaturan privasi sistem operasi, lalu tekan **Hubungkan ulang kamera**.

### Kamera sedang dipakai atau salah kamera

* **Gejala:** "Kamera sedang dipakai atau terputus…", atau gambar berasal dari webcam laptop.
* **Penyebab:** aplikasi lain memakai kamera, atau mesin memakai **System default camera** sehingga sistem operasi yang memilih.
* **Yang dilakukan:** tutup aplikasi kamera lain (Zoom, kamera bawaan, dll.). Di **Camera & printing** pilih kamera yang benar secara eksplisit → **Test camera** → **Save device settings**.

![Camera & printing: pilih kamera booth secara eksplisit, bukan System default camera](https://2252896219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4peErhJ43h9rU9ZP7xVU%2Fuploads%2FDBlUoHSgJ2sNrIxoJ7cc%2F74-panel-camera.png?alt=media)

### Kamera terputus di tengah sesi

* **Gejala:** "Kamera terputus. Foto yang tersimpan tetap aman…"
* **Yang dilakukan:** sambungkan ulang kamera lalu ketuk **Hubungkan ulang kamera**. Foto yang sudah diambil tidak hilang. Pengaturan perangkat tidak bisa diubah selama kamera sedang memotret.

## Printer dan cetak

### Printer tidak mencetak

* **Penyebab umum:** pencetakan belum diaktifkan di mesin, printer belum dipilih, driver belum terpasang, antrean printer dijeda, atau paket memakai cetak berbayar dan tamu memilih **File digital saja — tanpa cetak**.
* **Yang dilakukan:**
  1. Panel petugas → **Camera & printing** → **Find printers** → pilih printer → centang **Enable printing on this booth** → **Save device settings**.
  2. Jika muncul "No printers found", pasang driver printer di sistem operasi dulu.
  3. Cek antrean printer di sistem operasi (kertas, tinta, job dijeda).
  4. Tekan **Print one test photo** (mencetak sungguhan).
  5. Untuk cetak otomatis tanpa biaya tambahan, pakai opsi cetak **Gratis — termasuk dalam paket** di paket foto.

{% hint style="warning" %}
Perilaku printer bergantung pada driver dan perangkat Anda. Uji dulu dengan printer dan kertas yang akan dipakai sebelum acara.
{% endhint %}

### Status cetak "perlu diperiksa"

* **Penyebab:** aplikasi mencatat niat cetak sebelum memanggil printer. Jika aplikasi atau printer error di tengah jalan, hasilnya tidak pasti. Aplikasi **tidak pernah** mencetak ulang otomatis supaya tidak dobel.
* **Yang dilakukan:** periksa baki dan antrean printer dulu. Jika memang perlu cetak lagi: panel petugas → **Camera & printing** → isi **Reprint reason**, centang konfirmasi, lalu **Reprint saved photo**. Di Studio, tandai permintaan di **Pengiriman foto** sebagai selesai setelah dicek.

### Ukuran atau posisi cetak meleset

* **Yang dilakukan:** samakan ukuran kertas driver di mesin dengan **Kertas dan tata letak** di Studio, cetak strip kalibrasi (**Print one test photo**), ukur, lalu atur margin. Bila ragu, gunakan **Ukuran cetak → Otomatis** di bingkai.

## Koneksi dan pemasangan

### Mesin tampil Offline di Studio

* **Penyebab:** mesin tidak melapor selama lebih dari 90 detik (internet atau listrik mati, aplikasi tertutup).
* **Yang dilakukan:** periksa internet dan listrik, pastikan aplikasi ezybooth berjalan, lalu lihat "Terakhir terlihat" di **Mesin photobooth**. Sesi yang sudah dibayar di aplikasi terpasang tetap bisa dilanjutkan saat offline (hingga 12 jam).

### Kode pairing kedaluwarsa atau ditolak

* **Penyebab:** kode berlaku 10 menit dan untuk satu mesin saja; salah ketik (12 karakter, hanya 0–9 dan A–F); kode lama batal karena kode baru dibuat; terlalu banyak percobaan.
* **Yang dilakukan:** tekan **Kode baru** di alur **Siapkan …** di Studio, ketik ulang di kolom **Pairing code**, lalu **Connect kiosk**. Jika diminta menyelesaikan sesi tersimpan, pulihkan atau selesaikan sesi itu dulu. Jika terlalu banyak percobaan, tunggu 15 menit.

### Mesin kembali ke layar pairing

* **Penyebab:** admin menekan **Putuskan** atau **Pasangkan ulang**, atau menonaktifkan mesin.
* **Yang dilakukan:** buat kode baru dari **Tindakan → Hubungkan mesin / Pasangkan ulang**. Untuk memindah mesin ke lokasi lain, daftarkan mesin baru di lokasi tujuan.

## PIN petugas

### Lupa PIN atau "PIN petugas salah"

* PIN diatur **per mesin** dan tidak pernah ditampilkan ulang.
* **Yang dilakukan:** admin bisnis membuka **Mesin photobooth → Tindakan → PIN operator**, memasukkan PIN baru 4–8 digit dua kali, lalu **Simpan PIN operator**. Mesin perlu internet untuk memakai PIN baru.

![Layar Masukkan PIN petugas di mesin; PIN diatur per mesin di Studio](https://2252896219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4peErhJ43h9rU9ZP7xVU%2Fuploads%2FEkyV1fsH1R4C7ZQMhabn%2F71-operator-pin-prompt.png?alt=media)

### Terkunci karena terlalu banyak percobaan

* **Penyebab:** 10 percobaan salah dalam 15 menit pada satu mesin.
* **Yang dilakukan:** tunggu 15 menit, atau admin mengganti PIN mesin itu (mengganti PIN mereset hitungan).

## Pembayaran

### Sesi tertahan "Menunggu pembayaran"

* Checkout QRIS berlaku 15 menit. Setelah itu sesi di Studio berlabel **Kedaluwarsa** dan tidak lagi dihitung di Beranda.
* Tamu bisa menekan **Batalkan sesi** (ketuk dua kali) di langkah email atau pembayaran. Membatalkan di mesin **tidak** membatalkan atau mengembalikan pesanan di penyedia pembayaran.

### Tamu sudah bayar tetapi sesi tidak lanjut

1. Tekan **Periksa status pembayaran** (mesin juga mengecek tiap 5 detik). Pembayaran terverifikasi yang datang setelah timer habis tetap memberi sesi.
2. Jika tamu sudah meninggalkan layar: panel petugas → **Sessions & recovery** → **Pulihkan sesi tersimpan**. Tamu tidak perlu membayar lagi.
3. Cek sesi di **Sesi foto**. Jangan terbitkan voucher atau menagih ulang sebelum statusnya jelas.

### Tombol Bayar sendiri tidak muncul

* **Penyebab:** paket langganan tidak menyertakan QRIS, atau pembayaran belum dikonfigurasi.
* **Yang dilakukan:** pakai **Voucher**, atau ubah paket di **Langganan**.

## Sesi macet

### Menghentikan sesi bermasalah dari Studio

* Admin: **Sesi foto** → buka sesi → **Ada masalah dengan sesi ini?** → isi alasan → **Cabut izin offline**. Mesin yang offline menghentikan sesi itu begitu tersambung lagi.
* Tidak tersedia untuk staf atau untuk sesi yang masih **Menunggu pembayaran**, dan tidak mengembalikan pembayaran.

### Mesin menolak tamu baru: "Masih ada sesi tersimpan"

* Mesin mencegah foto tamu sebelumnya tertimpa.
* Panel petugas → **Sessions & recovery** → **Pulihkan sesi tersimpan** untuk menyelesaikannya, atau **Hapus sesi tersimpan** jika memang tidak dilanjutkan (catatan transaksi di Studio tetap ada).

![Dialog Mohon panggil petugas booth: masih ada sesi tersimpan](https://2252896219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4peErhJ43h9rU9ZP7xVU%2Fuploads%2Fl6kyyQu0gmegle8k6WvE%2F70-saved-session-blocked.png?alt=media)

Langkah lengkap: [Sesi tersimpan dan pemulihan](/ezybooth.id-docs/sesi-tersimpan-dan-pemulihan.md).

### Timer habis: "Waktunya habis!"

* Tamu menekan **Lanjut ke langkah berikutnya** (mesin melanjutkan dengan pilihan yang ada) atau **Panggil petugas**. Pembayaran dan foto pertama tidak bisa dilewati, dan tidak ada tambahan waktu.
* Jika timer terlalu ketat, ubah di **Pengaturan kiosk → Waktu sesi** (berlaku untuk sesi baru).

![Dialog Waktunya habis! dengan Lanjut ke langkah berikutnya dan Panggil petugas](https://2252896219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4peErhJ43h9rU9ZP7xVU%2Fuploads%2FUEbdcsZrl07pM9ODD5by%2F78-recover-02-timeout.png?alt=media)

### Layar selesai: "Menunggu koneksi untuk menyinkronkan sesi"

* Sambungkan internet lalu tekan **Coba sinkronkan lagi** (mesin juga mencoba tiap 15 detik). Tuntaskan juga pilihan cetak yang tertunda.

## Pengiriman foto

### Tamu tidak menerima email foto

1. Cari sesinya di **Sesi foto** dan lihat status pengiriman.
2. Pastikan alamat email benar dan minta tamu memeriksa folder spam.
3. Tamu selalu bisa memakai **QR** di layar selesai.
4. Buka **Pengiriman foto** untuk melihat permintaan yang gagal.

### QR unduhan tidak muncul

* **Penyebab:** mesin offline sehingga foto belum terunggah, atau unggahan gagal.
* **Yang dilakukan:** sambungkan internet lalu tekan **Coba siapkan tautan lagi**. Di mesin: panel petugas → **Sessions & recovery** → **Coba ulang pekerjaan tersimpan**. Di Studio: **Pengiriman foto** → permintaan **Unggah foto** → **Coba ulang**.

![Layar akhir tanpa QR: tombol Coba siapkan tautan lagi, foto tetap tersimpan di booth](https://2252896219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4peErhJ43h9rU9ZP7xVU%2Fuploads%2FRRDvRATY3OuMDcyncIkX%2F78-recover-07-done.png?alt=media)

### Tautan unduhan kedaluwarsa

* Foto dihapus setelah masa simpan di **Pengaturan → Penyimpanan foto**. Foto yang sudah terhapus tidak bisa dipulihkan, dan memperpanjang masa simpan tidak memperpanjang sesi lama.

### Permintaan di Pengiriman foto

* **Coba ulang** untuk permintaan yang akan dicoba ulang atau perlu ditangani.
* **Batal** untuk menghentikan permintaan.
* **Selesaikan** setelah Anda mengecek hasilnya (mis. cetakan sudah keluar).
* Semua tindakan wajib diberi alasan. Staf hanya bisa melihat.

## Voucher

### Kode voucher tidak diterima mesin

* Voucher **hanya berlaku di mesin yang dipilih saat terbit**, sekali pakai, dan punya tanggal kedaluwarsa.
* Kode 8 karakter; huruf O/I dan angka 0/1 tidak dipakai.
* Cek statusnya di **Voucher → Voucher terbaru** (**Siap digunakan**, **Sudah digunakan**, **Kedaluwarsa**, **Dicabut**).
* Voucher salah mesin atau kedaluwarsa yang belum dipakai: **Cabut**, lalu terbitkan pengganti — tanpa menagih tamu lagi.

### Penerbitan voucher terputus

* Jika muncul **Voucher terakhir belum selesai**, tekan **Ulangi konfirmasi** untuk mendapatkan kodenya. Jangan menagih tamu lagi atau menerbitkan voucher kedua.

## Paket atau bingkai tidak muncul di mesin

Cek berurutan:

1. Paket berstatus **Diterbitkan**.
2. Ada bingkai yang **Tampilkan untuk tamu** dan terhubung ke paket itu (**Koleksi bingkai → Ketersediaan → Paket tersedia**).
3. Paket ditambahkan ke mesin (**Mesin photobooth → Tindakan → Ubah → Paket tersedia**).
4. Mesin dan lokasinya **Aktif**, langganan aktif, dan jumlah mesin aktif masih dalam kuota.
5. Mesin memuat ulang katalog saat **Mulai** ditekan dan tiap 30 detik di layar sambutan — tunggu mesin online.

## Batas paket langganan

* **Kiosk aktif: n / maks** berwarna peringatan berarti jumlah mesin **aktif** (termasuk yang offline) sudah mencapai kuota. Nonaktifkan mesin yang tidak dipakai atau upgrade di **Langganan**.
* "Langganan Anda tidak aktif" — sesi baru dan perubahan pengaturan diblokir sampai paket diperpanjang. Sesi yang sudah dibayar tetap bisa diselesaikan.

## Masuk ke Studio

### Kode email tidak diterima

* Cek folder spam, tunggu hitung mundur lalu **Kirim kode baru** (kode lama tidak berlaku lagi). Batas 5 kode per 15 menit.
* Hanya admin bisnis yang menerima kode; staf masuk dengan kata sandi.

### "Kode salah atau sudah kedaluwarsa"

* Kode berlaku 10 menit, sekali pakai, maksimal 5 percobaan. Gunakan kode dari email **terbaru**, atau ulangi dari awal jika sesi masuk sudah berakhir.

### Tidak bisa melihat menu tertentu

* Akun staf tidak melihat **Anggota tim**, **Paket foto**, **Pengaturan kiosk**, **Pengaturan**, dan **Laporan keuangan**, serta hanya melihat sesi lokasi yang ditugaskan. Minta admin menugaskan Anda di **Lokasi**.