← Semua artikel

Teknis • • 6 menit baca

Midtrans & Xendit dengan Saklar .env: Cara Saya Merancang Payment Gateway Anti-Macet di Proyek Saya

Kenapa di B-Games dan Rajendra Pintar saya memasang Midtrans sekaligus mempertahankan jalur Xendit di balik saklar .env — lengkap dengan perbandingan praktis keduanya dan arsitektur webhook di lapangan.

Setiap kali berdiskusi dengan pemilik bisnis yang ingin memasang pembayaran otomatis di aplikasinya, pertanyaan pertama hampir selalu seragam. Kebanyakan bertanya apakah lebih bagus memakai Midtrans atau Xendit, dan mana yang potongan per transaksinya paling murah seratus-dua ratus perak. Pertanyaan itu wajar, tetapi pengalaman menjalankan transaksi sungguhan di lapangan mengajarkan satu hal yang jauh lebih krusial. Selisih biaya admin beberapa ratus rupiah tidak ada artinya dibanding kehilangan pelanggan gara-gara jalur pembayarannya sedang gangguan.

Awalnya saya membangun jalur pembayaran otomatis memakai Xendit di lini produk saya, mulai dari Portal Klien DevRAB, B-Games, hingga Rajendra Pintar. Namun seiring bertambahnya variasi transaksi ritel harian, di B-Games dan Rajendra Pintar saya menambahkan integrasi Midtrans sebagai jalur aktif tanpa membuang kode Xendit sedikit pun. Keduanya hidup berdampingan dan bisa dialihkan kapan saja cukup lewat satu saklar konfigurasi di berkas .env. Artikel ini membedah alasan teknis dan bisnis di balik arsitektur jalur ganda tersebut.

Kenapa Tidak Cukup Bergantung pada Satu Jalur Pembayaran?

Perilaku membayar pengguna di Indonesia sangat beragam tergantung nominal dan konteks transaksinya. Untuk pembelian mikro puluhan ribu rupiah dari layar ponsel seperti di Rajendra Pintar atau B-Games, QRIS dan dompet digital (GoPay, OVO, DANA, ShopeePay) adalah raja mutlak karena selesai dipindai dalam sepuluh detik. Sebaliknya, untuk tagihan uang muka proyek bernilai jutaan rupiah di DevRAB, bagian keuangan perusahaan hampir selalu meminta Virtual Account bank besar (BCA, Mandiri, BNI, BRI, Permata).

Masalahnya, di dunia infrastruktur finansial tidak ada penyedia tunggal yang kebal seratus persen dari gangguan eksternal. Kadang satu bank mitra atau jaringan perantara QRIS mengalami pemeliharaan terjadwal malam hari. Kadang pula kebijakan kanal pembayaran tertentu berubah, atau skema pencairan dana (settlement) di satu penyedia sedang lebih cocok untuk arus kas produk tertentu.

Kalau kode aplikasimu terikat mati hanya ke satu payment gateway, setiap kali terjadi kendala di sisi penyedia, pilihannya cuma dua. Kamu terpaksa pasrah menolak pembeli sampai gangguan selesai, atau lembur membongkar kode backend dan men-deploy ulang di tengah kepanikan.

Cara Kerja Saklar .env: Pindah Midtrans ke Xendit Tanpa Bongkar Kode

Agar tidak terjebak ketergantungan tunggal, di B-Games dan Rajendra Pintar saya memisahkan logika bisnis aplikasi dari kode spesifik penyedia pembayaran menggunakan pola adaptor yang dikendalikan variabel lingkungan (.env).

1. Kontrak Pembuatan Tagihan yang Seragam. Saat pengguna menekan tombol bayar, frontend tidak pernah peduli sedang terhubung ke Midtrans atau Xendit. Ia hanya meminta backend menyiapkan sesi pembayaran untuk ID pesanan dan nominal tertentu. Di sisi server, variabel konfigurasi di .env menentukan apakah permintaan itu diteruskan ke Midtrans Snap API atau ke Xendit Invoice API, lalu mengembalikan layar pembayaran yang siap dipakai.

2. Dua Pintu Webhook dengan Sabuk Pengaman Masing-Masing. Pantangan terbesar sistem pembayaran adalah menandai pesanan lunas hanya dari halaman redirect di browser karena URL sangat mudah dimanipulasi. Status lunas wajib berasal dari panggilan server-ke-server (webhook). Endpoint Midtrans memverifikasi tanda tangan kriptografi SHA-512, sementara endpoint Xendit memeriksa kecocokan header x-callback-token rahasia.

3. Satu Fungsi Penyelesaian Idempoten di Database. Begitu tanda tangan digital dari salah satu penyedia dinyatakan sah, keduanya bermuara ke satu fungsi penyelesaian yang persis sama di PostgreSQL. Fungsi ini mengecek kunci idempotency agar bila server payment gateway mengirim ulang sinyal webhook yang sama saat jaringan padat, saldo koin pemain atau status VIP tidak pernah bertambah dua kali.

Hasil praktisnya sangat menenangkan. Bila suatu hari salah satu penyedia sedang pemeliharaan kanal QRIS, saya cukup mengubah satu baris nilai variabel di .env server untuk mengalihkan transaksi baru ke jalur cadangan dalam hitungan detik tanpa menyentuh kode antarmuka.

Perbandingan Jujur di Lapangan: Kapan Midtrans Unggul, Kapan Xendit Bersinar

Karena memakai keduanya secara langsung di produksi, saya melihat masing-masing penyedia punya titik manisnya sendiri.

• Midtrans sangat bersinar untuk transaksi konsumen ritel harian (B2C). Antarmuka pop-up Midtrans Snap sudah sangat akrab di mata pengguna belanja online Indonesia dan menyatu mulus di atas halaman aplikasi web tanpa memaksa pengguna berpindah tab jauh. Ekosistem pembayaran ritelnya, terutama QRIS dan GoPay deep-link di ponsel, terasa sangat natural untuk nominal kecil hingga menengah seperti di B-Games dan Rajendra Pintar.

• Xendit sangat tangguh untuk penagihan B2B, invoice korporat, dan fleksibilitas API. Struktur REST API serta payload JSON milik Xendit terasa sangat bersih dan konsisten bagi developer, ditambah simulasi pembayarannya di mode sandbox sangat cepat diuji. Halaman tagihan bawaannya juga tampil profesional saat dikirimkan sebagai tautan pembayaran kontrak bernilai jutaan rupiah ke klien perusahaan di DevRAB.

Tiga Pola Produksi Nyata di B-Games, Rajendra Pintar, dan DevRAB

Dari kombinasi di atas, arsitektur pembayaran di tiga proyek saya terbagi menjadi tiga pola yang menyesuaikan aturan main tiap platform.

1. B-Games memakai Midtrans dengan saklar .env Xendit dan Mobile IAP. Di versi Web/PWA, pembelian item virtual dan koin dilayani cepat lewat Midtrans dengan jalur Xendit yang tetap siaga di balik saklar .env, sedangkan toko aplikasi mobile terhubung ke Google Play Billing. Begitu QRIS terbayar, webhook langsung mengisi dompet pemain secara real-time saat mereka masih berada di lobi permainan.

2. Rajendra Pintar menerapkan routing cerdas Web vs Android di balik Parent Gate. Jika dibuka lewat browser atau PWA, sistem memakai jalur web Midtrans aktif dengan Xendit standby di .env. Namun jika dibuka dari aplikasi Android (.APK) resmi Google Play Store, sistem otomatis beralih ke Google Play Billing demi mematuhi kebijakan produk digital Google. Seluruhnya tetap dikunci di balik gerbang soal hitung orang tua (Parent Gate) agar anak usia 4–8 tahun tidak pernah tidak sengaja bertransaksi.

3. DevRAB memadukan Xendit Invoice dengan bukti transfer manual korporat. Begitu klien menandatangani kontrak proyek secara digital, tagihan Xendit (Virtual Account, QRIS, e-Wallet) langsung siap dibayar otomatis. Khusus untuk perusahaan yang birokrasi keuangannya mewajibkan transfer bank manual berlapis, portal tetap menyediakan unggah bukti bayar manual untuk diverifikasi sebelum kuitansi resmi terbit.

Hal Administratif yang Perlu Disiapkan dan Kesimpulan

Sebelum memasang satu atau dua payment gateway sekaligus, pemilik bisnis perlu menyiapkan dokumen verifikasi usaha (KYC). Dokumen ini mencakup KTP dan NPWP untuk usaha perorangan, atau akta badan usaha PT/CV agar seluruh kanal Virtual Account aktif penuh, sekaligus memperhitungkan jadwal pencairan dana (settlement) ke rekening operasional.

Pada akhirnya, arsitektur pembayaran yang matang bukan soal menjadi penggemar fanatik satu merek payment gateway. Yang terpenting adalah memastikan pembayaran pelanggan selalu bisa masuk dengan aman, terverifikasi otomatis, dan punya jalur cadangan saat dibutuhkan. Kalau kamu sedang merancang aplikasi bisnis dan ingin mendiskusikan skema pembayaran paling tahan banting untuk transaksimu, silakan ngobrol dulu dengan Zannah atau hubungi saya lewat WhatsApp.

Artikel Terkait