FAQ
Pertanyaan yang paling sering ditanyakan merchant saat integrasi.
Bagaimana cara mendapatkan API key?
Login ke dashboard.hashpay.id, buka Settings → API Key. Simpan di server (environment variable/secret manager) dan jangan pernah menaruhnya di kode klien.
Bisakah API key dirotasi?
Ya. Rotasi dari dashboard; key lama langsung tidak berlaku. Pastikan sistem Anda memuat key dari konfigurasi agar rotasi tidak butuh deploy.
Berapa fee transaksinya?
Default 1% per transaksi, diatur admin per merchant. Mode fee bisa ditanggung penjual (dipotong dari penerimaan) atau ditanggung pembeli (ditambahkan ke total). Lihat Rate & fee.
Kapan dana disettle ke wallet saya?
Settlement otomatis berjalan sesuai jadwal (mis. harian). Anda juga bisa memicunya manual lewat endpoint settlement.
Bagaimana bila pelanggan salah mengirim nominal?
Bila kurang dari totalAmount, order dapat berstatus Underpaid dan tidak otomatis sukses. Hubungi tim Hashpay untuk penanganan (pelunasan selisih atau refund manual).
Apakah webhook diulang bila server saya down?
Ya — callback diulang hingga 3 kali dengan backoff eksponensial. Buat handler yang idempoten memakai X-Hashpay-Idempotency-Key. Detail di Webhooks.
Jaringan & wallet apa saja yang didukung?
Ethereum, BNB Chain, Tron, dan Solana dengan wallet MetaMask, WalletConnect, Trust Wallet, dan Phantom. Kombinasi aktif bisa dibaca dari listToken.
Apakah ada minimal transaksi?
Tidak ada minimum khusus untuk pembayaran. Untuk penarikan/settlement, minimum mengikuti konfigurasi disbursement akun Anda.
Bagaimana cara menguji tanpa dana nyata?
Gunakan sandbox /api/v2/testnet/ dan minta token uji dari faucet. Alurnya identik dengan produksi.
Apakah API key boleh dipakai di frontend?
Tidak. API key adalah kredensial server. Untuk alur yang dibuka pelanggan (checkout, payment link), Hashpay menerbitkan kunci scoped berumur 30 menit yang hanya berlaku untuk satu order — tetap simpan di server BFF Anda.
Bagaimana menangani order yang kedaluwarsa?
Order dengan status Expired tidak akan menerima pembayaran. Minta pelanggan membuat order baru agar kurs dan alamat deposit diperbarui.
Apakah ada status page / dukungan?
Untuk insiden produksi dan pertanyaan integrasi, hubungi tim Hashpay melalui kanal dukungan merchant Anda (email/WhatsApp). Sertakan order_no dan waktu kejadian agar cepat ditelusuri.