2 menit baca
Panduan Integrasi Payment Gateway untuk Aplikasi di Indonesia
Payment Gateway Menyelesaikan Masalah Apa
Tanpa gateway, Anda harus membuat integrasi ke setiap bank dan penyedia dompet digital sendiri — kontrak, sertifikat, dan pemeliharaan per kanal. Gateway seperti Midtrans atau Xendit merangkumnya jadi satu API: pelanggan bebas memilih metode bayar, aplikasi Anda tinggal merespons status pembayarannya.
Kanal Pembayaran yang Relevan di Indonesia
- Virtual Account (VA) — paling dominan untuk e-commerce dan SaaS B2B; nominal pasti, konfirmasi otomatis, biaya per transaksi flat dan murah.
- QRIS — kuat untuk pelanggan mobile dan transaksi offline-ke-online; scan dari aplikasi bank/e-wallet apa pun.
- Dompet digital (GoPay,OVO, ShopeePay, DANA) — penting kalau basis pelanggan Anda pembeli ritel lewat HP.
- Kartu kredit — perlu untuk B2B SaaS dan nilai transaksi besar; risiko chargeback dan biaya persentase lebih tinggi.
- Gerai/toko fisik (Alfamart, Indomaret) — relevan saat pelanggan Anda belum punya rekening bank.
Aturan praktis: mulai dari 2–3 kanal yang benar-benar dipakai target pasar Anda. Setiap kanal menambah biaya, alur uji, dan kompleksitas laporan.
Yang Sering Salah: Percaya Respons Frontend
Ini kesalahan paling umum dan paling berbahaya. Ketika pelanggan menekan "Bayar", browser memberi tahu "berhasil" — tapi yang bisa dipercaya hanya notifikasi dari server gateway, bukan callback frontend.
Alur yang benar:
- Aplikasi membuat transaksi ke gateway (server-side) dan menyimpan ID-nya.
- Pelanggan menyelesaikan pembayaran di halaman/overlay gateway.
- Gateway mengirim webhook ke server Anda: "transaksi X status paid".
- Server memverifikasi tanda tangan keamanan (signature/HMAC) webhook, mencocokkan nominal, lalu baru menandai pesanan lunas.
- Frontend hanya menampilkan status yang diminta dari server Anda — bukan dari respons browser.
Tanpa langkah 3–4, pesanan bisa "dibayar" dengan memutar halaman sukses.
Rekonsiliasi dan Status Tertunda
Beberapa kanal (terutama transfer manual dan gerai) punya konfirmasi tertunda. Karena itu:
- Simpan status transaksi sebagai state machine (
pending → paid / expired / failed / refunded), bukan booleansudah_bayar. - Jalankan pencocokan harian antara order di database Anda dan laporan settlement gateway — selisih kecil yang tidak ditemukan minggu ini jadi sulit dilacak bulan depan.
- Siapkan alur refund dan batalkan hak akses/fulfillment saat status berubah menjadi refund.
Uji Sebelum Produksi
Semua gateway menyediakan mode sandbox. Minimal uji skenario ini sebelum live:
- Bayar sukses penuh (sampai webhook masuk).
- Transaksi kedaluwarsa.
- Webhook dikirim dua kali (harus idempoten — status tidak boleh berubah dua kali).
- Webhook dengan nominal tidak cocok (harus ditolak).
Biaya yang Perlu Diasumsikan
Struktur biaya tiap penyedia berbeda (flat per VA, persentase per kartu, MDR QRIS). Angka pastinya berubah, jadi cek tabel tarif terbaru di situs resmi Midtrans/Xendit dan masukkan ke estimasi biaya proyek — jangan menyalin angka dari artikel mana pun, termasuk ini.
Kesimpulan
Integrasi pembayaran itu 20% hookup API, 80% disiplin status: webhook terverifikasi sebagai satu-satunya sumber kebenaran, state machine yang jelas, dan rekonsiliasi rutin. Kalau Anda butuh implementasinya, kami membahasnya di layanan Payment Integration.