Cara Daftar & Integrasi Midtrans di Panel Sewa Kamu

Kalau kamu baru sewa panel di BisnisSMM dan mau pelanggan bisa bayar langsung lewat transfer bank, e-wallet, atau QRIS, integrasi Midtrans di panel sewa jadi langkah yang perlu kamu selesaikan lebih dulu sebelum panel benar-benar siap dipakai jualan. Prosesnya tidak rumit, tapi ada beberapa bagian yang sering bikin bingung kalau baru pertama kali coba, terutama soal Server Key, Client Key, dan Payment Notification URL.

Artikel ini membahas cara daftar akun Midtrans dari nol sampai integrasinya jalan di panel sewa kamu, urut dari langkah paling awal.

Kenapa Panel Sewa Kamu Butuh Payment Gateway Sendiri

Panel sewa yang kamu pakai butuh cara menerima pembayaran otomatis dari pelanggan tanpa kamu harus cek manual satu per satu. Di sinilah Midtrans masuk, sebagai payment gateway yang menghubungkan panel kamu dengan berbagai channel pembayaran populer di Indonesia, dari transfer bank, kartu kredit, e-wallet seperti GoPay dan OVO, sampai QRIS. Begitu terintegrasi, setiap transaksi yang masuk akan otomatis dicatat statusnya di sistem panel, jadi kamu tidak perlu konfirmasi manual lewat chat atau rekening pribadi.

Dari sisi pengalaman tim kami di BisnisSMM menangani permintaan setup panel sewa, kendala yang paling sering muncul justru bukan di pendaftaran akun Midtransnya, tapi di tahap menghubungkan key dan URL notifikasi ke panel dengan benar. Karena itu, urutan langkah di artikel ini disusun sesuai urutan yang paling sering bikin bingung pelanggan baru.

Ringkasan Cepat, 5 Langkah Integrasi Midtrans

Daftar akun Midtrans dan lengkapi data merchant
Ambil Server Key dan Client Key dari dashboard
Pasang kedua key tersebut di pengaturan panel sewa kamu
Atur Payment Notification URL di dashboard Midtrans
Uji coba transaksi di mode sandbox sebelum aktifkan mode live

Langkah 1, Daftar Akun Midtrans

Buka dashboard.midtrans.com lalu buat akun baru dengan email bisnis kamu. Setelah akun jadi, lengkapi data merchant seperti nama usaha dan URL panel kamu di bagian pengaturan umum. Saat pertama daftar, akun kamu otomatis masuk ke environment Sandbox, jadi kamu bisa uji coba dulu tanpa menyentuh transaksi nyata.

Langkah 2, Ambil Server Key dan Client Key

Masuk ke menu Settings, lalu pilih Access Keys. Di halaman ini kamu akan melihat dua jenis key yang fungsinya berbeda. Menurut dokumentasi resmi Midtrans, Client Key dipakai untuk autentikasi di sisi frontend dan aman ditaruh di kode publik, sedangkan Server Key dipakai untuk autentikasi ke API dari backend dan wajib dirahasiakan karena bisa dipakai untuk mengakses operasi transaksi yang sensitif.

Salin kedua key ini baik-baik. Jangan pernah tempel Server Key di kode frontend panel kamu atau bagikan ke pihak yang tidak berkepentingan.

Langkah 3, Pasang Server Key dan Client Key di Panel Sewa

Masuk ke pengaturan payment gateway di panel sewa kamu, lalu tempel Server Key di kolom "Server Key" dan Client Key di kolom "Client Key (opsional)". Kolom Client Key sifatnya opsional dan baru dibutuhkan kalau kamu memakai embedded Snap di halaman pembayaran, bukan redirect biasa.

Langkah 4, Atur Payment Notification URL

Ini bagian yang paling sering terlewat. Di dashboard Midtrans, buka Settings lalu Configuration, cari kolom Payment Notification URL. Isi kolom ini dengan alamat webhook panel kamu sendiri, formatnya kira-kira seperti berikut.

https://domainkamu.com/webhook/midtrans/ID-PANEL-KAMU

Ganti domainkamu.com dan ID-PANEL-KAMU dengan alamat panel dan ID unik milik kamu sendiri, bisa dicek di menu integrasi payment gateway pada panel sewa. URL ini yang dipakai Midtrans untuk mengirim notifikasi setiap kali status transaksi berubah, jadi kalau salah isi atau kosong, panel kamu tidak akan tahu transaksi mana yang sudah lunas.

Langkah 5, Uji Coba di Mode Sandbox Sebelum Live

Menurut dokumentasi akun Midtrans, environment Sandbox bisa dipakai untuk membuat transaksi uji coba yang sifatnya tidak nyata dan tidak memerlukan pembayaran sungguhan, jadi manfaatkan mode ini untuk memastikan notifikasi masuk dengan benar ke panel kamu. Coba beberapa metode pembayaran sekaligus, lalu cek apakah status order di panel berubah otomatis setelah transaksi sandbox selesai.

Kalau semua berjalan lancar, baru pindah ke environment Production. Sesuai panduan switching ke Production dari Midtrans, Server Key dan Client Key untuk Sandbox dan Production berbeda satu sama lain, jadi pastikan kamu mengganti kedua key tersebut dengan versi Production sebelum benar-benar menerima pembayaran dari pelanggan asli.

Kesalahan yang Sering Terjadi Saat Integrasi

Beberapa hal ini yang paling sering bikin integrasi gagal di tahap awal.

Masih memakai Server Key Sandbox padahal sudah pindah ke Production
Payment Notification URL kosong atau salah ketik ID panel
Server Key sempat tertempel di kode frontend atau dibagikan lewat chat tanpa enkripsi
Lupa update key setelah pindah environment, jadi transaksi ditolak dengan pesan otorisasi gagal

Tanya Jawab Seputar Integrasi Midtrans di Panel Sewa

Apakah Client Key aman dilihat orang lain? Aman. Client Key memang dirancang untuk dipasang di sisi frontend/publik, beda dengan Server Key yang harus tetap dirahasiakan.

Kenapa transaksi sandbox saya tidak masuk ke panel? Kemungkinan besar Payment Notification URL belum diisi atau ID panel di URL tersebut salah, jadi Midtrans tidak tahu ke mana harus mengirim notifikasi status transaksi.

Perlu daftar ulang kalau mau pindah dari Sandbox ke Production? Tidak perlu daftar ulang, cukup lengkapi verifikasi merchant di dashboard yang sama, lalu ganti key dan environment dari Sandbox ke Production.

Kalau Kamu Nggak Mau Setup Manual

Semua langkah integrasi Midtrans di atas sebenarnya opsional. Panel sewa dari BisnisSMM sudah auto-terintegrasi dengan BayarOn, payment gateway milik kami sendiri, begitu panel kamu aktif. Jadi kamu bisa langsung terima pembayaran dari pelanggan, transfer bank, e-wallet, sampai QRIS, tanpa perlu daftar akun Midtrans, ambil Server Key, atau atur Payment Notification URL sama sekali.

Setup Midtrans manual di atas cocok kalau kamu memang mau pakai merchant milik sendiri, misalnya untuk kebutuhan pelaporan keuangan yang terpisah dari akun BisnisSMM. Tapi kalau tujuan kamu cuma supaya panel bisa langsung terima pembayaran tanpa proses tambahan, BayarOn sudah aktif dan siap dipakai sejak panel kamu pertama kali jalan.

Kesimpulan

Integrasi Midtrans di panel sewa pada dasarnya cuma soal mengambil dua key yang tepat dan menaruhnya di tempat yang benar, ditambah satu URL notifikasi yang mengarah balik ke panel kamu. Selesaikan dulu tahap sandbox sampai benar-benar lancar sebelum pindah ke mode live, supaya begitu pelanggan mulai bayar, prosesnya langsung otomatis tanpa kamu harus cek manual satu per satu.