RAGH Reader#

RAGH Reader mengonfirmasi transfer bank secara otomatis. Pembeli mentransfer langsung ke rekening Anda. Reader membaca notifikasi dari aplikasi bank di HP Android Anda, mencocokkan nominalnya dengan tagihan, lalu mengabari sistem Anda lewat webhook.

Halaman ini menjelaskan cara kerjanya dalam lima menit baca. Untuk langsung mencoba, buka Mulai cepat.

Apa yang dilakukan Reader#

• Uang masuk (tagihan). Sistem Anda membuat tagihan. Reader memberi kode unik 3 digit, sehingga totalnya khas. Saat uang dengan total itu masuk, tagihan menjadi lunas dan Anda menerima webhook payment.paid.
• Uang keluar (payout). Sistem Anda mencatat transfer yang akan Anda lakukan, misalnya pencairan dana mitra. Reader memberi kode unik. Saat notifikasi uang keluar dengan total itu muncul, payout menjadi terkirim dan Anda menerima webhook payout.sent.
• Pencatatan. Semua mutasi yang terbaca tercatat di dashboard, lengkap dengan status pencocokannya: cocok, telat, dobel, atau tidak ada pasangannya.

Uang tidak pernah lewat RAGH#

RAGH tidak memegang, menampung, atau memindahkan dana siapa pun.

• Pembeli mentransfer langsung ke rekening Anda.
• Untuk payout, Anda sendiri yang mentransfer dari app bank Anda.
• Reader hanya membuktikan bahwa transfer itu benar-benar terjadi, dengan membaca notifikasi bank di HP Anda.

Karena itu tidak ada biaya per transaksi yang dipotong dari dana Anda. Biaya layanan dibayar terpisah dari Kredit Layanan (lihat Paket).

Cara kerja#

Pembeli ──transfer Rp 200.123──▶ Rekening BCA Anda
                                        │ notifikasi dari app BCA
                                        ▼
                         HP Android Anda: app BCA + RAGH Reader
                                        │ dikirim ke server Reader (ditandatangani)
                                        ▼
Sistem Anda ──POST /api/v1/payments──▶ Server Reader ──webhook payment.paid──▶ Sistem Anda
                                         membaca → mencocokkan → mencatat   ◀── balasan ack ──┘

1. Sistem Anda membuat tagihan Rp 200.000 lewat API.
2. Reader membalas dengan total unik, misalnya Rp 200.123, nomor rekening tujuan, dan payment_url (halaman bayar siap pakai).
3. Pembeli mentransfer tepat Rp 200.123.
4. App bank di HP Anda menampilkan notifikasi "dana masuk".
5. App RAGH Reader di HP yang sama membaca notifikasi itu dan mengirimnya ke server Reader.
6. Server membaca nominal dan arah transaksi, lalu mencari tagihan dengan total Rp 200.123 di rekening itu.
7. Tagihan menjadi lunas. Server mengirim webhook payment.paid ke sistem Anda.
8. Sistem Anda membalas dengan JSON ack. Pesanan diproses.

Kode unik 3 digit#

Banyak pembeli bisa membayar nominal yang sama pada saat yang sama. Kode unik membuat setiap tagihan punya total yang berbeda.

• Kode unik bernilai 1 sampai 999, dan ditambahkan ke nominal.
• Yang dijaga unik adalah total per rekening, bukan kodenya.
• Total dikunci selama tagihan berjalan, ditambah masa jeda 48 jam sesudahnya. Transfer yang telat tidak akan nyasar ke tagihan lain.
• Pembeli harus mentransfer tepat sampai 3 digit terakhir. Transfer yang kurang atau tanpa kode unik tidak dicocokkan otomatis (lihat FAQ).

Rincian lengkap ada di Konsep.

Yang Anda butuhkan#

Batasan yang perlu Anda tahu#

• Hanya Android. iPhone tidak didukung, karena iOS tidak mengizinkan app membaca notifikasi app lain.
• Hanya notifikasi app bank. SMS tidak dipakai, karena nama pengirim SMS bisa dipalsukan.
• Bergantung pada notifikasi bank. Bila HP mati atau offline, Reader tidak bisa melihat apa pun. Sistem menahan batas bayar tagihan selama rekening tidak terpantau, supaya pembeli yang sudah bayar tidak dirugikan. Rinciannya di Konsep.
• Dukungan bank masih diuji. Cara membaca notifikasi setiap bank sedang diverifikasi dengan notifikasi asli (tahap uji Fase 0). Status per bank ada di halaman bank masing-masing, misalnya BCA.
• Satu rekening per bank, satu HP per rekening. Satu HP boleh membaca beberapa rekening dari bank yang berbeda.
• Transfer massal (bulk) tidak didukung untuk verifikasi payout otomatis.
• Tanpa ganti rugi. Reader tidak menjamin 100% dan tidak menanggung kerugian akibat konfirmasi yang salah. Untuk transaksi besar, cocokkan juga dengan mutasi resmi bank Anda. Lihat Keamanan.

Mulai dari mana#