Menyalakan pembayaran online lewat payment gateway
Untuk bendahara dan admin: menghubungkan Midtrans atau iPaymu agar wali bisa membayar tagihan dari Cek Santri lewat QRIS, Virtual Account, atau e-wallet, dan tagihan langsung lunas tanpa verifikasi manual.
Untuk: Bendahara, Admin & Operator
Diperbarui 9 Oktober 2026
Panduan ini untuk bendahara dan admin yang memiliki akses menu Keuangan. Setelah selesai, wali bisa memilih Bayar Online di aplikasi Cek Santri, dan tagihan yang dibayar penuh langsung berstatus Lunas di E-Pesantren tanpa perlu diverifikasi.
Siapkan akun penyedia pembayaran (Midtrans atau iPaymu) atas nama pesantren beserta kunci aksesnya dari dashboard penyedia. Sebaiknya coba dulu dengan kunci uji coba (sandbox) sebelum memakai kunci asli.
-
Buka halaman Payment Gateway
Di menu samping, klik Keuangan > Payment Gateway. Tabel menampilkan daftar penyedia beserta kolom Environment dan sakelar Status Aktif. Penyedia yang kuncinya belum diisi bertanda Belum dikonfigurasi.
Tips: BCA Direct API, BSI Direct API, dan BRI Direct API (BRIVA) masih bertanda Simulasi dan belum bisa menerima pembayaran sungguhan. Gunakan Midtrans atau iPaymu.
-
Buka konfigurasi penyedia
Pada baris Midtrans Payment Gateway atau iPaymu Payment Gateway, klik Konfigurasi. Jendela konfigurasi penyedia itu terbuka.
-
Pilih mode uji coba atau mode asli
Pada Environment, pilih Sandbox (Testing) untuk uji coba tanpa uang sungguhan, atau Production (Live) untuk menerima pembayaran asli. Kunci akses sandbox dan production dari penyedia berbeda, jadi pastikan kuncinya sesuai pilihan ini.
-
Isi kunci akses dari penyedia
Untuk Midtrans, isi Server Key dan Client Key. Untuk iPaymu, isi Virtual Account (VA) dan API Key. Salin semuanya dari dashboard penyedia.
Tips: Kunci akses ini sama pentingnya dengan kata sandi. Jangan membagikannya di grup percakapan.
-
Daftarkan alamat pemberitahuan (khusus Midtrans)
Di bagian bawah jendela ada kotak Webhook URL. Untuk Midtrans, salin alamat itu ke Dashboard Midtrans > Settings > Payment > Notification URL, terpisah untuk sandbox dan production. Untuk iPaymu, alamat ini sudah dikirim otomatis pada setiap transaksi.
Tips: Bila pemberitahuan dari Midtrans terlewat, E-Pesantren tetap mengecek status pembayaran ke Midtrans setiap 10 menit.
-
Aktifkan penyedia lalu simpan
Nyalakan Aktifkan Provider, lalu klik Simpan Konfigurasi. Hanya satu penyedia yang bisa aktif: mengaktifkan satu penyedia otomatis menonaktifkan yang lain, sedangkan pembayaran lama lewat penyedia sebelumnya tetap diproses.
-
Atur biaya admin bila perlu
Bila biaya transaksi ingin ditanggung wali, nyalakan Biaya admin pembayaran online ditanggung wali di bagian atas halaman, isi Biaya per transaksi, lalu klik Simpan. Penjelasan lengkapnya ada di Biaya admin pembayaran online.
-
Pahami yang dilihat wali
Di Cek Santri, wali membuka Tagihan, menekan Bayar Sekarang, lalu memilih Bayar Online. Wali bisa membayar penuh atau sebagian (minimal Rp 10.000), lalu menyelesaikan pembayaran di halaman yang terbuka lewat QRIS, Virtual Account, atau e-wallet. Wali juga bisa membayar beberapa tagihan dalam satu transaksi; lihat Bayar beberapa tagihan sekaligus.
Tips: Pembayaran yang belum selesai bisa dilanjutkan, dicek, atau dibatalkan wali dari kartu tagihannya selama masih berlaku (bawaan 24 jam).
-
Coba satu pembayaran
Selagi Environment masih Sandbox (Testing), lakukan satu pembayaran percobaan dari akun wali di Cek Santri. Setelah selesai, buka Keuangan > Data Pembayaran: tagihan yang dibayar penuh berstatus Lunas dan tombol Kwitansi tersedia. Bila hasilnya sudah benar, ganti ke Production (Live) dengan kunci asli.
Tips: Bila wali melihat pesan bahwa pembayaran online sedang tidak bisa dibuat, periksa apakah ada penyedia yang aktif dan kuncinya sudah benar.
Apakah panduan ini membantu?
Masih ada yang belum jelas?
Hubungi tim kami dari menu Bantuan & Dukungan di aplikasi E-Pesantren, atau lewat WhatsApp.