Memulai

Daftar singkat untuk pengguna yang kembali. Panduan setup pertama kali ada di Instalasi.

1. Daftar di /register dengan nama pengguna, email, kata sandi (12+ karakter).
2. Verifikasi email Anda dengan mengklik tautannya.
3. Tunggu admin mengaktifkan tenant Anda. Anda akan diberi tahu melalui email.
4. Masuk. Buka Integration di sidebar.
5. Atur Webhook URL yang menunjuk ke endpoint callback DHRU Anda, mis. https://yourdhru.com/modules/gateways/callback/triapay.php.
6. Putar API key dan Webhook secret. Keduanya hanya ditampilkan sekali, segera salin.
7. Unduh dua berkas plugin dari halaman Integration yang sama:
   • triapay.php → letakkan di modules/gateways/ pada server DHRU Anda
   • triapay-callback.php → ganti nama menjadi triapay.php dan letakkan di modules/gateways/callback/ pada server DHRU Anda
8. Di admin DHRU, aktifkan gateway TriaPay dan tempelkan API URL, API key, serta webhook secret TriaPay Anda.
9. Konfigurasi metode penerimaan (master wallet address untuk TRC20/BEP20, Pay ID untuk Binance Pay) di tab Crypto dan Binance Pay.
10. Kirim deposit uji $1 dari akun pelanggan DHRU. Pastikan order berpindah pending → matched → credited dalam hitungan detik (latensi deteksi tipikal 3 sampai 7 detik ditambah konfirmasi chain).

Latensi deteksi

Kredit ujung-ke-ujung biasanya selesai jauh di bawah satu menit. Variabel dominan adalah konfirmasi chain dan polling tick yang memindai kecocokan.

Chain	Polling tick	Tipikal ujung-ke-ujung
TRC20	3 d	3 sampai 7 d
BEP20	3 d	3 sampai 7 d
Binance Pay	5 d	5 sampai 10 d

Angka-angka ini mengecualikan waktu broadcast dompet di sisi pelanggan. Irama polling di atas adalah laju pindai listener; order yang cocok berpindah ke credited segera setelah webhook mengakui. Push eth_subscribe BSC dan merchant-webhook Binance Pay ada di roadmap untuk deteksi sub-detik tapi belum dirilis.

Keamanan login

Sign-in mengalir melalui /auth/login dengan opsi OTP berikut:

• Email OTP (default).
• WhatsApp OTP, tersedia bila nomor telepon disetel di profil.
• Bypass step-up TOTP saat 2FA telah didaftarkan.

Cookie "remember this device" (kedaluwarsa 7 hari, terikat pada fingerprint browser dan kelas IP /24) melewati OTP pada login berikutnya dari kelas jaringan yang sama. Cabut perangkat individual kapan saja dari /me/devices.

Pengujian dengan mode sandbox

Mode sandbox memungkinkan Anda menjalankan putaran penuh order → webhook → DHRU tanpa menyentuh chain nyata, dana nyata, atau invoice DHRU nyata Anda. Gunakan setiap kali Anda mengubah konfigurasi plugin, memutar kunci, atau memindahkan DHRU ke host baru.

Setup sekali pakai

1. Dashboard → tab Integration → kartu API Key → beralih ke tab Sandbox → klik Generate sandbox key. Salin nilai tpk_test_....
2. Kartu yang sama, subseksi Webhook Secret → tab Sandbox → Generate sandbox secret. Salin nilai tersebut.
3. Di admin DHRU → Setup → Payment Gateways → TriaPay, tempelkan sandbox key ke API Key (Sandbox) dan sandbox secret ke Webhook Secret (Sandbox).
4. Centang kotak Sandbox Mode di form yang sama. Simpan.

Picu pembayaran uji

1. Dashboard → API Playground → ubah toggle mode ke Sandbox (banner akan muncul mengonfirmasi sandbox aktif).
2. Jalankan Create order dengan kombinasi chain/asset apa pun. Salin idempotencyKey yang dikembalikan.
3. Jalankan Force credit dengan idempotency key tersebut. Simulator mengirim webhook melalui jalur crediter yang sama dengan produksi.
4. Verifikasi server DHRU Anda menerima POST dengan X-Payment-Mode: sandbox (periksa error_log).

Handler callback plugin DHRU Anda otomatis memutus webhook sandbox: ia mencatat event, mengembalikan 200 OK, dan tidak pernah memanggil addPayment. Tidak ada invoice live yang dikredit, tidak ada baris tblUsers.credit_left yang berubah.

Saat Anda siap beralih ke trafik nyata, hapus centang Sandbox Mode di form admin DHRU. API key live dan webhook secret live tetap di tempatnya; tidak ada yang perlu diubah.