Di bisnis top up game, payment gateway bukan sekadar cara menerima uang. Dia yang menentukan apakah pesanan pelanggan diteruskan otomatis ke vendor atau berhenti di tengah jalan. Kalau bagian ini salah pasang, gejalanya khas: pelanggan sudah bayar, saldo masuk ke rekening, tapi statusnya tetap "menunggu pembayaran".
Halaman ini menjelaskan alur kerjanya, langkah integrasi secara garis besar, pilihan gateway yang umum dipakai di Indonesia, dan daftar penyebab kegagalan yang paling sering kami temui di lapangan.
Alur yang sebenarnya terjadi
Satu transaksi top up melewati empat tahap, dan payment gateway memegang dua di antaranya:
- Pelanggan memilih produk, websitemu membuat tagihan lewat API gateway.
- Gateway menampilkan cara bayar (QRIS, virtual account, e-wallet, retail).
- Setelah dibayar, gateway memanggil balik websitemu — ini yang disebut callback atau webhook.
- Websitemu menerima callback, menandai pesanan lunas, lalu meneruskan order ke vendor.
Tahap tiga dan empat adalah tempat hampir semua masalah muncul. Tagihan hampir selalu berhasil dibuat; yang sering gagal adalah callback-nya tidak sampai, sampai dua kali, atau sampai tapi tidak diproses dengan benar.
Pilihan gateway: KiosPay dulu, sisanya opsional
Website yang kami buat bisa disambungkan ke gateway mana pun. Tapi yang kami pasang sebagai bawaan adalah KiosPay — payment gateway yang kami bangun dan operasikan sendiri. Kami sebut terus terang bahwa itu produk kami, dan alasan utamanya praktis: kalau pembayaran bermasalah, websitenya dan gatewaynya ditangani tim yang sama. Tidak ada lempar-lemparan antara penyedia web dan penyedia pembayaran.
BAWAAN
KiosPay
- 21 channel dalam satu integrasi. Virtual Account 12 bank (BCA, BNI, BRI, Mandiri, Permata, BSI, CIMB Niaga, Maybank, Sampoerna, BNC, Artha Graha, ATM Bersama), QRIS (NOBU dan ShopeePay), lima e-wallet (DANA, OVO, GoPay, ShopeePay, LinkAja), serta retail Indomaret dan Alfamart.
- Tanpa biaya bulanan. Yang dibayar hanya per transaksi.
- Settlement T+0 sampai T+3 tergantung channel. QRIS Realtime dan DANA Realtime cair di hari yang sama.
- Webhook bisa dikirim ulang manual dari dashboard. Ini yang paling sering menyelamatkan order nyangkut — kalau endpoint websitemu sempat mati saat notifikasi datang, callback-nya tidak hilang, tinggal kirim ulang.
- Dashboard real-time. Transaksi bisa dicari, difilter, dan diekspor, lengkap sampai payload callback-nya — berguna waktu menelusuri satu order yang bermasalah.
- Keamanan. IP allowlist, signature per request, rate limit, dan login 2FA.
Biayanya terbuka per channel di halaman biaya transaksi KiosPay. Sebagai gambaran: QRIS Realtime Rp250 + 2% cair T+0, BCA VA Rp4.500 settlement T+2, DANA 2% settlement T+2. Keterangan lengkapnya ada di kiosweb.co.
Gateway lain — opsional, tetap didukung
Kalau kamu sudah terlanjur punya akun merchant di tempat lain, atau memang lebih sreg dengan penyedia tertentu, websitenya tetap bisa disambungkan ke:
- Duitku — kanal pembayarannya lengkap dan dokumentasinya rapi. Perlu dicatat, kanal yang aktif di akunmu tergantung persetujuan mereka, jadi jangan heran kalau ada metode yang belum muncul di website padahal sudah dinyalakan. Panduan integrasi Duitku.
- Tripay — proses pendaftarannya relatif cepat dan banyak dipakai pemain baru. Cara daftar Tripay.
- Tokopay — sering dipilih karena biaya per transaksinya kompetitif untuk nominal kecil, yang memang porsi terbesar di top up game. Panduan integrasi Tokopay.
- iPaymu — alternatif yang juga didukung.
Saran praktis: pasang lebih dari satu. Kalau satu gateway sedang gangguan, pelanggan masih punya jalan lain untuk membayar, dan kamu tidak kehilangan penjualan seharian.
Langkah integrasi secara garis besar
1. Daftar merchant dan lengkapi verifikasi usaha
Siapkan KTP, rekening atas nama yang sama, dan data usaha. Tahap ini yang paling lama, bisa beberapa hari kerja, jadi urus paling awal.
2. Ambil kredensial dari dashboard merchant
Biasanya berupa merchant code atau project ID plus API key. Simpan yang benar — hampir semua gateway memisahkan kredensial mode uji dan mode produksi, dan tertukar di sini menghasilkan error yang membingungkan.
3. Pasang callback URL dan return URL
Callback URL adalah alamat yang dipanggil gateway saat pembayaran lunas. Isi dengan domain yang benar-benar dipakai sekarang, bukan domain lama.
4. Uji dulu dengan nominal kecil
Lakukan satu transaksi sungguhan bernominal paling kecil, lalu pastikan tiga hal: status pesanan berubah jadi lunas, order diteruskan ke vendor, dan barang masuk ke akun pembeli.
5. Baru aktifkan untuk umum
Setelah satu siklus penuh terbukti jalan, nyalakan metode pembayarannya di halaman depan.
Penyebab gagal yang paling sering terjadi
Ini daftar dari kasus yang benar-benar kami tangani di website pelanggan:
- Callback URL masih menunjuk domain lama. Domain lama yang diarahkan ke domain baru lewat redirect terlihat "masih jalan" di browser, tapi banyak gateway tidak mengikuti redirect saat mengirim callback. Akibatnya notifikasi pembayaran tidak pernah sampai.
- Callback datang bersamaan lalu saling kunci. Saat ramai, dua callback untuk transaksi berbeda bisa saling tunggu di database sampai gagal. Pesanan berhenti di status menunggu padahal uang sudah masuk.
- Status pesanan lunas tapi status pembayaran tertinggal. Dua kolom status yang tidak diperbarui bersamaan membuat laporan tidak cocok dan pesanan sulit ditelusuri.
- Whitelist IP dan rotasi API key. Sebagian gateway dan vendor membatasi akses per IP. Kalau server mengirim permintaan lewat jalur IPv6 sementara yang didaftarkan IPv4, hasilnya ditolak walaupun kamu merasa sudah memasukkan IP yang benar.
- Refund terpotong biaya gateway. Saat transaksi gagal di sisi vendor dan dana harus dikembalikan, biaya gateway sudah terlanjur dipotong. Kalau yang dikembalikan jumlah bersih, pelanggan akan protes; kalau jumlah kotor, margin kamu yang tergerus.
- Metode pembayaran tidak muncul. Umumnya bukan salah kode, melainkan kanal tersebut memang belum disetujui di akun merchant kamu.
Soal biaya per transaksi dan cara menghitungnya supaya margin tidak habis, sudah kami bahas terpisah di cara hitung biaya payment gateway.
Kalau tidak mau mengurus sendiri
Semua yang di atas sudah tertangani di website yang kami buat: multi payment gateway, konfirmasi pembayaran otomatis, penerusan order ke vendor, sampai refund saat transaksi gagal. Kalau memakai KiosPay, langkah 2 sampai 4 di atas praktis hilang dari piringmu — kredensial, callback URL, dan uji transaksinya kami yang urus karena gatewaynya juga milik kami. Kalau kamu memilih gateway lain, kamu cukup mendaftar merchant atas nama usahamu, kirim kredensialnya, dan bagian teknisnya tetap kami yang pasang serta uji.
Lihat daftar fitur atau harga paket. Kalau kamu masih menimbang antara memasang sendiri dari script atau memakai layanan jadi, ada pembahasannya di halaman source code web top up.
Pertanyaan yang sering masuk
Akun payment gateway atas nama siapa, dan dananya lewat mana?
Akunnya tetap atas nama usahamu sendiri. Bedanya di alur dana: kalau pakai gateway pihak ketiga seperti Duitku atau Tripay, dana masuk langsung ke rekening yang kamu daftarkan di sana dan kami tidak menyentuhnya sama sekali. Kalau pakai KiosPay, pembayaran masuk sebagai saldo di dashboard KiosPay milikmu, lalu kamu cairkan ke rekening yang terdaftar lewat menu withdraw — riwayat mutasinya terbuka dan bisa diaudit.
Bisa pakai lebih dari satu gateway sekaligus?
Bisa, dan memang disarankan. Metode pembayaran bisa dinyalakan atau dimatikan satu per satu dari dashboard admin, termasuk mengatur urutan tampilnya.
Apakah bisa terima QRIS sendiri tanpa payment gateway?
Bisa, dengan mekanisme pencocokan mutasi rekening supaya konfirmasi tetap otomatis. Tapi untuk volume yang sudah ramai, gateway resmi lebih tenang karena rekonsiliasinya jelas.
Berapa lama proses pendaftaran merchant?
Tergantung gateway dan kelengkapan dokumen, umumnya beberapa hari kerja. Ini di luar kendali kami karena verifikasinya dilakukan pihak gateway.
