FAQ dan pemecahan masalah#

Jawaban untuk masalah yang paling sering muncul. Setiap bagian bisa dibaca terpisah.

Sebelum menghubungi dukungan, tekan Kirim diagnosa di app RAGH Reader. Tombol ini mengirim keadaan HP ke tim kami, sehingga masalah lebih cepat ditemukan.

Status tagihan tidak berubah padahal pembeli sudah transfer#

Periksa berurutan:

1. Nominalnya tepat? Pembeli harus mentransfer total_amount, sampai 3 digit terakhir. Buka dashboard, menu Mutasi, dan cari nominal yang ditransfer. Bila ada mutasi berstatus no_candidate, lihat bagian pembeli transfer kurang atau tanpa kode unik.
2. Ke rekening yang benar? Tagihan terikat ke satu rekening (bank.account_number). Transfer ke rekening lain milik Anda tidak melunasi tagihan itu.
3. Rekening terpantau? Di dashboard, menu Rekening, lihat status pemantauannya. Bila tidak terpantau, lihat HP mati atau offline.
4. Notifikasi muncul di HP? Lihat panel notifikasi HP Reader. Bila app bank tidak menampilkan notifikasi, Reader tidak bisa membacanya. Nyalakan lagi notifikasi transaksi di app bank (lihat panduan per bank, misalnya BCA).
5. Notifikasi terbaca? Buka layar Riwayat di app Reader. Bila transaksinya ada dengan status parse_failed, lihat notifikasi tidak terbaca setelah update app bank.
6. Tagihannya sudah lunas, tetapi sistem Anda belum tahu? Buka menu Webhook di dashboard dan lihat event payment.paid untuk tagihan itu. Bila gagal, kode errornya menjelaskan penyebabnya (lihat Webhook). Setelah diperbaiki, tekan Kirim ulang sekarang.

Pembeli transfer kurang atau tanpa kode unik#

Contoh: tagihan Rp 200.123, tetapi pembeli mentransfer Rp 200.000.

• Reader tidak menebak. Transfer yang tidak sama persis dengan total mana pun tercatat sebagai mutasi tanpa pasangan (no_candidate).
• Mutasi itu masuk daftar Perlu tindakan sebagai "Mutasi tanpa tagihan". Bila ada tagihan pending dengan nominal dasar yang sama, dashboard menyarankannya.
• Periksa, lalu cocokkan manual dari menu Mutasi. Tagihan menjadi lunas dan webhook payment.paid terkirim seperti biasa.
• Kekurangan bayar (dalam contoh ini Rp 123) Anda putuskan sendiri: ditagih, atau direlakan.

Hal yang sama berlaku bila pembeli membulatkan ke atas (misalnya Rp 201.000).

Untuk mencegahnya:

• tampilkan total dengan jelas, bukan nominal dasar;
• arahkan pembeli ke payment_url, yang menampilkan total besar dengan tombol salin dan pesan "Transfer tepat sampai 3 digit terakhir".

Pembeli bayar dua kali#

• Transfer pertama melunasi tagihan.
• Transfer kedua dengan total yang sama, dalam 48 jam setelah lunas, dicatat sebagai uang dobel (duplicate_payment). Tagihan tidak berubah.
• Sistem Anda menerima webhook payment.duplicate, dan kejadiannya masuk Perlu tindakan.
• Refund dilakukan oleh Anda, langsung ke pembeli. Setelah itu, selesaikan butirnya dengan pilihan "Sudah direfund", atau "Dijadikan pembayaran lain" bila pembeli setuju.

Pembeli sering membayar dua kali karena mengira transfer pertamanya gagal. Halaman bayar menampilkan "Konfirmasi tertunda. Kalau sudah transfer, jangan transfer lagi" saat konfirmasi terlambat, untuk mencegah hal ini.

HP mati atau offline#

Saat HP Reader mati atau tanpa internet, app bank pun tidak menerima notifikasi. Reader tidak bisa melihat apa pun selama itu.

Yang terjadi otomatis:

1. Setelah 15 menit tanpa kabar dari HP, rekening menjadi tidak terpantau. Anda dikabari lewat email (dan WhatsApp bila nomor HP terisi), lalu diingatkan lagi setelah 1 jam dan 6 jam.
2. Tagihan yang sedang berjalan ditahan: tidak kedaluwarsa, dan confirmation_delayed bernilai true. Halaman bayar menampilkan "Konfirmasi tertunda".
3. Tagihan baru tanpa bank_code diarahkan ke rekening lain yang terpantau, bila ada.
4. Saat HP menyala dan tersambung lagi, notifikasi yang tertahan menyusul dan dicocokkan. Rekening kembali terpantau 15 menit setelah semuanya sehat.

Yang perlu Anda lakukan:

• nyalakan HP, pastikan internet menyala, dan buka app RAGH Reader;
• periksa Status HP ini di app (lihat Pasang RAGH Reader);
• bila HP sering mati sendiri, atur penghemat baterai sesuai panduan merek HP Anda, misalnya Samsung atau Xiaomi.

Bank kadang merangkum atau membuang notifikasi yang tertahan terlalu lama. Bila ada transfer yang tidak pernah tercatat, cocokkan dengan mutasi resmi bank, lalu tandai lunas manual dari dashboard.

Webhook INVALID_ACK#

Artinya endpoint Anda membalas HTTP 2xx, tetapi tanpa ack yang valid. Reader menganggapnya gagal dan mengirim ulang.

Penyebab yang paling sering:

Uji perbaikannya dengan tombol Uji endpoint di dashboard, lalu kirim ulang event yang gagal. Aturan lengkap ada di Webhook.

Notifikasi tidak terbaca setelah update app bank#

Bank kadang mengganti kalimat notifikasinya setelah update app. Reader membaca notifikasi dengan pola kalimat yang pasti, jadi kalimat baru bisa tidak dikenali.

Yang terjadi otomatis:

1. Notifikasi bernominal yang tidak dikenali dicatat parse_failed, dan masuk Perlu tindakan sebagai "Notifikasi tidak terbaca".
2. Rekening itu menjadi tidak terpantau (format berubah). Tagihannya ditahan dan tidak kedaluwarsa, supaya pembeli yang sudah bayar tidak dirugikan.
3. Tim kami menerima alarm, memperbaiki pola bacaan, lalu memproses ulang notifikasi yang tertahan. Tagihan yang cocok menjadi lunas, dan webhook terkirim seperti biasa.

Yang perlu Anda lakukan:

• tidak ada yang wajib. Pantau halaman status (lihat Status layanan);
• bila perlu cepat, cocokkan pembayaran dengan mutasi resmi bank, lalu tandai lunas manual dari dashboard. Reader memverifikasinya setelah notifikasi diproses ulang;
• jangan hapus notifikasi bank di HP sebelum masalahnya selesai.

Perbaikan dilakukan pada jam jaga 07.00–22.00 WIB.

iPhone tidak didukung#

RAGH Reader hanya tersedia untuk Android. iOS tidak mengizinkan app membaca notifikasi dari app lain, jadi Reader tidak bisa dibuat untuk iPhone.

Yang bisa Anda lakukan: pakai HP Android terpisah (tidak harus baru) khusus untuk app bank dan Reader. Pembeli Anda tetap bisa membayar dari HP apa pun, termasuk iPhone.

Pertanyaan lain#

Apakah uang pembeli lewat RAGH? Tidak. Pembeli mentransfer langsung ke rekening Anda. RAGH tidak pernah memegang atau memindahkan dana.

Kenapa SMS banking tidak dipakai? Nama pengirim SMS bisa dipalsukan, jadi SMS tidak cukup aman sebagai bukti transfer. Reader hanya membaca notifikasi dari app bank resmi.

Bisakah dua rekening dari bank yang sama? Belum. Paling banyak satu rekening per bank, karena notifikasi dari app bank yang sama tidak bisa dibedakan per rekening dengan andal.

Rekening lain di app bank yang sama ikut tercatat? Bisa. Bila notifikasi memuat potongan nomor rekening, transaksi rekening lain disaring. Bila tidak, transaksinya tercatat sebagai mutasi tanpa pasangan. Bila app bank mengizinkan, nyalakan notifikasi hanya untuk rekening yang didaftarkan.

Transfer uji tidak kunjung terbaca. Pastikan: nominal persis sampai 3 digit terakhir, notifikasi transaksi masuk di app bank menyala, notifikasi itu benar-benar muncul di HP Reader, dan Status HP ini menunjukkan akses notifikasi "Diizinkan" dan pendengar "Tersambung". Untuk Livin', periksa juga nominal minimum notifikasi.

Pembuatan tagihan ditolak 409 unique_code_exhausted. Semua 999 kode unik untuk nominal itu di rekening itu sedang terkunci. Ini terjadi bila sangat banyak tagihan dengan nominal dasar yang sama dibuat dalam waktu dekat. Perpendek masa berlaku tagihan, variasikan nominal, atau tambah rekening.

Tagihan sudah lunas manual, lalu notifikasinya datang. Apakah dihitung dobel? Tidak. Notifikasi itu menjadi verifikasi pelunasan manual, dan webhook payment.verified terkirim.