Panduan Integrasi Payment Gateway untuk Sekolah: QRIS, Midtrans, dan Xendit

Payment gateway adalah jembatan antara sistem sekolah dan dunia perbankan — yang membuat orang tua bisa membayar via Virtual Account, QRIS, e-wallet, atau kartu kredit dengan satu integrasi terpusat. Panduan ini menjelaskan apa itu payment gateway, perbandingan singkat pilihan untuk sekolah Indonesia, arsitektur teknis, dan langkah integrasi dari setup akun hingga rekonsiliasi otomatis.

Apa Itu Payment Gateway dan Mengapa Sekolah Perlu?

Payment gateway adalah penyedia infrastruktur yang menghubungkan sistem sekolah dengan berbagai metode pembayaran. Tanpa gateway, sekolah harus integrasi terpisah ke setiap bank dan e-wallet — kompleks dan mahal. Dengan gateway, satu integrasi memberi akses ke semua metode populer di Indonesia.

Manfaat utamanya: orang tua punya banyak pilihan pembayaran, transaksi tercatat real-time, dan sekolah tidak perlu mengurus kepatuhan PCI DSS karena gateway yang menangani. Untuk konteks pemilihan aplikasi yang umumnya sudah include gateway, baca tips memilih aplikasi pembayaran sekolah.

Pilihan Payment Gateway untuk Sekolah Indonesia

Tiga gateway yang umum dipakai sekolah di Indonesia:

• Midtrans. Bagian dari GoTo Group, ekosistem Gopay. Cocok untuk sekolah yang banyak orang tua-nya pakai e-wallet. Dokumentasi lengkap, dukungan komunitas besar.
• Xendit. Fokus Southeast Asia, kuat di Virtual Account multi-bank. Cocok untuk sekolah dengan kebutuhan VA dari banyak bank. API dianggap relatif developer-friendly.
• Doku. Salah satu gateway tertua di Indonesia, integrasi dengan banyak bank lokal. Cocok untuk sekolah yang prioritas bank konvensional.

Pilihan tergantung kebutuhan spesifik: dukungan metode pembayaran, biaya per transaksi, dan kualitas dokumentasi/support. Sekolah yang tidak ingin urus integrasi langsung biasanya pakai platform terpadu yang sudah include gateway terbaik.

Arsitektur Teknis: Cara Kerja Payment Gateway

Alur tipikal:

1. Orang tua memilih bayar di sistem sekolah, memilih metode (VA, QRIS, dll).
2. Sistem sekolah memanggil API gateway dengan detail tagihan (nominal, ID siswa).
3. Gateway menerbitkan kode pembayaran (nomor VA, QR code, link bayar).
4. Orang tua menyelesaikan pembayaran via aplikasi banking/e-wallet.
5. Gateway menerima notifikasi dari bank, kirim webhook ke sistem sekolah.
6. Sistem sekolah mencatat pembayaran dan mengirim konfirmasi ke orang tua.

Semua data sensitif (kartu, kredensial bank) ditangani gateway — sekolah hanya menerima token/referensi. Untuk konteks keamanan lebih dalam, baca keamanan data siswa di sekolah.

Langkah 1 — Persiapan Akun dan API Key

Daftar di gateway pilihan. Dokumen yang dibutuhkan: akta yayasan/sekolah, NPWP, rekening operasional, dan KTP penanggung jawab. Setelah KYC selesai, akan diberikan API key untuk sandbox (testing) dan production. Jangan campur — sandbox untuk uji coba, production untuk transaksi nyata.

Langkah 2 — Integrasi Frontend

Tampilan untuk orang tua: halaman pembayaran dengan pilihan metode (radio button untuk VA bank, QRIS, e-wallet). Setelah orang tua pilih dan klik bayar, sistem memanggil API gateway dan menampilkan halaman pembayaran (nomor VA atau QR code).

UI sederhana, satu klik, tidak ada friksi. Untuk konteks QRIS lebih dalam, baca QRIS pembayaran SPP modern.

Langkah 3 — Integrasi Backend: Webhook

Webhook adalah callback URL yang dipanggil gateway saat ada perubahan status pembayaran. Sistem sekolah harus menerima dan memproses webhook ini untuk:

• Mencatat pembayaran sukses → update status tagihan.
• Menangani pembayaran gagal/expired → notifikasi ulang ke orang tua.
• Memicu notifikasi konfirmasi → kirim WhatsApp/email ke orang tua. Pelajari setup di notifikasi WhatsApp SPP otomatis.

Penting: webhook harus idempotent — bila gateway kirim notifikasi sama dua kali (karena retry), sistem tidak boleh mencatat pembayaran dobel. Verifikasi signature webhook untuk mencegah spoofing.

Langkah 4 — Rekonsiliasi: Otomatis vs Manual

Rekonsiliasi adalah memastikan setiap transaksi di sistem sekolah match dengan mutasi rekening bank. Dengan gateway dan webhook yang baik, rekonsiliasi 95%+ otomatis. Yang perlu ditangani manual hanya exception: pembayaran tidak terverifikasi, dispute, atau refund yang tidak ter-otomasi.

Sistem sekolah sebaiknya menyediakan dashboard rekonsiliasi yang menampilkan: transaksi auto-match, transaksi pending, dan transaksi exception. Bendahara cukup review exception, tidak perlu input manual.

Studi Kasus: Integrasi dalam 1 Minggu

Sebuah sekolah dengan SIM existing mengintegrasikan payment gateway via API dalam 1 minggu:

• Hari 1-2: pendaftaran gateway dan KYC.
• Hari 3-4: integrasi frontend (halaman pembayaran).
• Hari 5: integrasi backend (webhook handler).
• Hari 6: testing dengan 10 transaksi di sandbox.
• Hari 7: production go-live dengan satu metode dulu (VA BCA), lalu ekspansi.

Pola yang sama bisa diadaptasi sekolah lain bila tim developer atau partner teknis sudah siap.

Perbandingan Biaya

Biaya umum:

• Biaya pendaftaran: Rp 0-3jt (sekali bayar, sering dibebaskan untuk volume tinggi).
• Biaya per transaksi VA: Rp 1.000-5.000 (fixed atau persentase).
• Biaya per transaksi QRIS/e-wallet: 0,5%-2% dari nominal.
• Biaya kartu kredit: 2,5%-3,5% (jarang relevan untuk SPP).

Sekolah bisa menanggung biaya atau meneruskan ke orang tua. Kebijakan ini harus jelas di SOP dan komunikasi ke orang tua.

Payment Gateway: Fondasi Infrastruktur Pembayaran

Bila sekolah punya tim developer, integrasi langsung ke gateway memberi fleksibilitas. Bila tidak, pakai platform terpadu yang sudah include gateway pilihan — lebih cepat go-live dengan kompromi fleksibilitas yang minimal. Eksplor fitur pembayaran Seqolah yang sudah include integrasi dengan gateway populer.

Pertanyaan yang Sering Diajukan