FAQ

Pertanyaan yang paling sering ditanyakan merchant saat integrasi QoinHub.

Bagaimana cara mendapatkan access key?

Buat access key melalui dashboard merchant QoinHub. Simpan key di server (environment variable atau secret manager), dan jangan pernah menaruhnya di kode yang berjalan di sisi pelanggan. Langkah lengkapnya ada di Membuat Access Key Akun Merchant.

Metode pembayaran apa saja yang didukung?

QRIS, Virtual Account (AGI, Permata, dan bank lain), e-money (OVO, LinkAja, Yukk), serta kartu kredit/debit Visa, Mastercard, dan JCB. Daftar lengkap payment channel beserta kodenya ada di Callback Notification.

Apa perbedaan integrasi BI-SNAP dan Non-SNAP?

BI-SNAP mengikuti standar BI-SNAP — access token B2B, asymmetric signature, dan credential exchange. Lihat Overview BI-SNAP. Non-SNAP menggunakan alur yang lebih sederhana dengan signature SHA256withRSA per request, tersedia opsi Webview dan Host to Host.

Bagaimana cara menguji integrasi sebelum produksi?

Gunakan base URL sandbox https://sandbox-api.qoinhub.id. Format request dan respons identik dengan produksi. Mulai dari Getting Started.

Bagaimana header Signature dibuat?

Signature menggunakan SHA256 with RSA: tanda tangani payload dengan private key merchant Anda, lalu kirim hasilnya pada header Signature di setiap request. Detail per endpoint ada di halaman API Reference masing-masing.

Apa fungsi Idempotency-Key?

Idempotency-Key mencegah order ganda ketika request di-retry. Kirim nilai unik per order (misalnya nomor invoice) pada header saat Create Order.

Bagaimana saya menerima notifikasi pembayaran?

QoinHub mengirim callback ke endpoint notifikasi yang Anda konfigurasi. Status transaksi: 1 = success, 2 = failed, 3 = expired. Spesifikasi lengkap ada di Callback Notification.

Bagaimana jika callback tidak diterima?

Gunakan endpoint Check Order Status untuk memeriksa status order secara berkala sebagai fallback.

Apakah bisa membatasi akses berdasarkan IP?

Ya. Tambahkan daftar IP server Anda pada konfigurasi IP whitelist di dashboard merchant. Lihat Konfigurasi IP Whitelist.

Browser atau webview apa yang didukung?

Halaman pembayaran mendukung browser modern dan webview umum. Daftar lengkapnya ada di Supported Browser.

Bagaimana konfigurasi URL redirect setelah pembayaran?

Atur Redirection URL di dashboard merchant agar pelanggan kembali ke halaman Anda setelah menyelesaikan pembayaran. Lihat Konfigurasi Redirection URL.

Apakah access key boleh dipakai di frontend?

Tidak. Access key adalah kredensial server. Semua request API harus dikirim dari backend Anda.

Masih ada pertanyaan? Mulai dari Getting Started untuk mencoba alur lengkap di sandbox, atau hubungi tim QoinHub melalui kanal dukungan merchant Anda.