Payment Link vs Embed Checkout vs REST API: Mana untuk Kebutuhanmu?
Bagian dari topik: Integrasi API Pembayaran untuk Developer

Memilih cara integrasi pembayaran sering bikin bingung: apakah cukup pakai payment link yang tinggal dibagikan, atau perlu menulis kode sampai ke REST API? Jawabannya tergantung siapa yang mengerjakan, seberapa dalam kontrol yang kamu butuhkan, dan seberapa besar volume transaksimu. BorderPay menyediakan empat jalur integrasi untuk menerima QRIS dan Virtual Account (VA) — mulai dari tanpa satu baris kode pun sampai kontrol penuh lewat API. Artikel ini membandingkan keempatnya secara jujur supaya kamu bisa memilih yang paling pas, tanpa membayar kerumitan yang tidak kamu perlukan.
Sebelum masuk ke perbandingan, satu hal penting: BorderPay adalah lapisan teknologi (software) di atas mitra Payment Gateway yang berlisensi Bank Indonesia. Pemrosesan dan penyimpanan dana dilakukan oleh mitra berlisensi tersebut — BorderPay bukan payment gateway atau PJP sendiri. Yang BorderPay kerjakan adalah membuat integrasi menerima pembayaran jadi jauh lebih mudah, apa pun tingkat kemampuan teknismu.
Empat Cara Integrasi BorderPay Sekilas
Berikut gambaran cepat keempat jalur, diurutkan dari paling sederhana ke paling teknis:
| Cara | Butuh koding? | Cocok untuk | Kontrol |
|---|---|---|---|
| Dashboard (link manual) | Tidak | Tagihan sesekali, jualan personal | Rendah |
| Payment link | Tidak | UMKM, jualan sosial media & WhatsApp | Rendah–sedang |
| Embed Checkout | Sedikit (tempel 1 snippet) | Website/landing page yang sudah ada | Sedang |
| REST API | Ya | Aplikasi, SaaS, marketplace, volume tinggi | Penuh |
Kabar baiknya, kamu tidak harus memilih satu selamanya. Banyak merchant bisa mulai dari dashboard atau payment link, lalu naik ke Embed Checkout atau REST API saat bisnisnya tumbuh. Data transaksi tetap terpusat di satu dashboard.
1. Dashboard: Buat Link Manual Tanpa Koding
Cara paling dasar. Kamu masuk ke dashboard, isi nominal dan keterangan, lalu BorderPay membuatkan halaman bayar berisi QRIS atau VA. Tinggal salin tautannya dan kirim ke pembeli.
Ini pas untuk kamu yang:
- Menagih sesekali (misalnya jasa, invoice ke klien, atau titipan).
- Belum punya website dan tidak ingin repot.
- Ingin mencoba alur pembayaran dari hari pertama lewat mode test/sandbox.
Keterbatasannya jelas: setiap tagihan dibuat manual satu per satu. Kalau kamu mengirim puluhan tagihan sehari, ini akan melelahkan — dan di situlah payment link atau API masuk.
2. Payment Link: Menerima Uang Tanpa Website
Payment link adalah jalan tengah yang praktis untuk UMKM. Konsepnya mirip dashboard, tapi lebih ramah dibagikan: satu tautan yang bisa kamu sebar di bio Instagram, status WhatsApp, kolom komentar, atau chat langsung. Pembeli tinggal mengetuk, memilih QRIS atau VA, lalu membayar — tanpa kamu perlu punya toko online sendiri.
Kelebihan payment link:
- Nol koding. Cocok untuk pemilik usaha yang bukan developer.
- Fleksibel disebar. Ideal untuk yang berjualan lewat media sosial atau chat.
- Konsisten dengan metode lain. Notifikasi, dashboard, dan penarikan dana sama saja dengan cara integrasi lainnya.
Perlu diingat, QRIS yang dibuat berlaku 60 menit dan VA berlaku 24 jam; setelah itu otomatis kedaluwarsa dan tidak ada pembayaran telat. Jadi kirim link mendekati waktu pembeli siap membayar. Kalau kamu masih menimbang antara QRIS dan VA untuk tagihanmu, baca dulu QRIS vs Virtual Account agar pilihannya pas.
3. Embed Checkout: Satu Snippet, Menempel di Website
Kalau kamu sudah punya website, landing page, atau halaman produk, Embed Checkout adalah pilihan paling efisien. Kamu cukup menempelkan satu snippet ke halamanmu, dan tombol/alur bayar muncul di sana — pembeli tidak perlu pindah ke situs lain. Pengalaman terasa menyatu dengan brand-mu tanpa harus membangun integrasi API dari awal.
Embed Checkout cocok untuk:
- Toko online berbasis CMS, page builder, atau HTML statis.
- Bisnis yang ingin tampilan checkout rapi tanpa tim engineering besar.
- Menerima QRIS langsung di website dengan usaha minimal.
Secara teknis, Embed Checkout menuntut sedikit lebih banyak dari payment link — kamu perlu menaruh snippet dan mungkin mengaturnya sedikit — tapi masih jauh lebih ringan daripada menulis integrasi REST API penuh. Ini titik manis bagi banyak merchant menengah: kontrol tampilan lebih baik, effort tetap rendah.
4. REST API: Kontrol Penuh untuk Developer
Untuk aplikasi, SaaS, marketplace, atau sistem dengan volume tinggi dan alur khusus, REST API memberi kendali penuh. Kamu bisa membuat charge secara terprogram, menentukan metode pembayaran, mengelola VA dan QRIS, serta menyambungkannya ke logika bisnismu sendiri — misalnya membuka fitur otomatis begitu pembayaran masuk.
Beberapa hal yang membuat jalur API layak dipertimbangkan:
Discovery lewat GET /payment-methods
Sebelum menampilkan pilihan bayar, aplikasimu bisa memanggil GET /payment-methods untuk mengetahui metode apa saja yang tersedia. Ini membuat frontend-mu tetap akurat tanpa hard-code daftar metode.
Webhook untuk notifikasi
Alih-alih menanyakan status berulang kali, kamu menerima webhook saat status berubah: payment.paid, payment.expired, atau payment.failed. Notifikasi ini ditandatangani dengan HMAC, dilengkapi log dan fitur kirim ulang. Praktik yang kami sarankan di sisi merchant:
- Verifikasi tanda tangan HMAC setiap payload sebelum diproses.
- Terapkan idempotensi agar event yang terkirim ulang tidak menyebabkan pemrosesan ganda.
Uji dulu di sandbox
Kamu bisa membangun dan menguji seluruh alur di mode test/sandbox sejak hari pertama, tanpa uang sungguhan. Detail endpoint, contoh request, dan panduan integrasi tersedia di dokumentasi teknis kami.
Konsekuensinya, REST API menuntut kemampuan developer dan waktu integrasi lebih banyak. Tapi imbalannya adalah otomatisasi penuh dan pengalaman yang benar-benar sesuai produkmu.
Cara Memilih: Cocokkan dengan Kebutuhanmu
Gunakan panduan singkat ini:
- Tidak punya website, jualan sesekali → Dashboard (link manual).
- Jualan lewat sosmed/WhatsApp, tanpa koding → Payment link.
- Sudah punya website, ingin checkout menyatu tanpa banyak koding → Embed Checkout.
- Punya aplikasi/tim developer, butuh otomatisasi & volume tinggi → REST API.
Pertanyaan pemandu yang membantu: Siapa yang akan mengintegrasikan (kamu sendiri atau developer)? Apakah kamu perlu status pembayaran otomatis masuk ke sistemmu? Seberapa banyak tagihan per hari? Semakin besar volume dan semakin butuh otomatis, semakin condong ke API.
Hal yang Sama di Semua Jalur
Apa pun cara integrasi yang kamu pilih, beberapa hal berlaku seragam:
- Metode pembayaran: QRIS dan Virtual Account.
- Masa berlaku: QRIS 60 menit, VA 24 jam, lalu otomatis kedaluwarsa.
- Settlement: dana tertahan sebentar lalu tersedia sesuai jadwal per metode pada hari kerja (melewati akhir pekan dan libur nasional). Status dan tanggalnya tampil di dashboard.
- Penarikan: otomatis ke rekening bank Indonesia dengan biaya per penarikan; jika gagal, saldo dikembalikan penuh.
- Biaya: tanpa biaya pendaftaran atau langganan — biaya hanya muncul saat transaksi.
- Go-live: untuk menerima uang sungguhan wajib menyelesaikan KYC dulu. Mode test/sandbox bisa langsung dipakai sejak awal, tapi menerima dana nyata baru aktif setelah verifikasi selesai.
Kesimpulan
Tidak ada satu cara "terbaik" — ada cara yang paling pas untukmu saat ini. Dashboard dan payment link membuatmu menerima pembayaran tanpa koding; Embed Checkout memberi tampilan menyatu dengan satu snippet; REST API membuka otomatisasi dan kontrol penuh untuk produk berskala. Kamu bisa mulai dari yang paling sederhana hari ini dan naik tingkat kapan pun, karena semuanya berbagi dashboard, notifikasi, dan alur penarikan yang sama.
Siap mencoba? Daftar dan jalankan alur di mode test sejak hari pertama. Rincian biaya per transaksi bisa kamu cek di halaman pricing sebelum memutuskan.