Jika Anda pernah mendengar tim developer menyebut kata “webhook” dan langsung melewatkannya karena terdengar terlalu teknis, artikel ini untuk Anda. Konsepnya sebenarnya sederhana, dan memahaminya berguna meski Anda tidak menulis kode sama sekali — terutama jika bisnis Anda bergantung pada notifikasi pembayaran yang cepat dan akurat.
Analogi paling sederhana: bukan Anda yang bertanya, tapi dipanggil balik
Bayangkan Anda menunggu paket datang. Cara pertama: Anda terus-menerus menelepon kurir setiap beberapa menit untuk bertanya “paketnya sudah sampai mana?”. Cara kedua: Anda memberi nomor telepon Anda ke kurir, dan merekalah yang akan menelepon Anda begitu paket sampai. Cara kedua jelas lebih efisien — Anda tidak perlu terus bertanya, cukup menunggu sampai dihubungi.
Webhook adalah cara kedua itu, tapi antar sistem komputer. Alih-alih aplikasi Anda harus terus-menerus bertanya ke sistem lain “ada transaksi baru belum?” (disebut polling), sistem lain itu yang akan otomatis “memanggil balik” aplikasi Anda begitu ada kejadian baru — misalnya begitu ada mutasi masuk di rekening bank.
Polling (bertanya berulang)
Webhook (dipanggil otomatis)
Kenapa ini penting untuk notifikasi pembayaran
Dalam konteks bisnis yang menerima transfer dari pelanggan, webhook berarti sistem Anda — atau grup Telegram tim Anda — bisa langsung mendapat notifikasi begitu ada dana masuk, tanpa harus ada orang yang membuka aplikasi bank secara manual atau sistem yang bertanya berulang kali. Pesanan bisa diproses lebih cepat karena konfirmasi pembayaran datang hampir bersamaan dengan waktu transaksi terjadi.
Mutasiku menggunakan mekanisme ini: begitu ada mutasi baru di rekening yang terhubung, sistem mengirim data tersebut ke webhook yang Anda daftarkan, atau ke Telegram tim Anda. Jika pengiriman webhook sempat gagal — misalnya karena server tujuan sedang tidak bisa diakses — pengiriman tersebut akan diantrekan dan dicoba ulang secara otomatis, bukan hilang begitu saja.
Anda tidak perlu memahami detail teknis format data webhook untuk mendapatkan manfaatnya. Jika tim Anda punya developer, merekalah yang akan menyiapkan alamat tujuan (endpoint) untuk menerima data ini. Jika tidak, notifikasi lewat Telegram adalah alternatif yang sama praktisnya tanpa perlu pengaturan teknis.
Apa yang sebenarnya dikirim lewat webhook
Saat sebuah kejadian terjadi — misalnya mutasi baru masuk — sistem pengirim webhook biasanya mengirimkan sepotong data terstruktur berisi detail kejadian itu: nominal transaksi, waktu terjadinya, dan keterangan singkat dari bank. Data ini dikirim ke sebuah alamat (disebut endpoint) yang sudah didaftarkan sebelumnya. Bagi non-developer, yang perlu dipahami bukan format persis datanya, melainkan konsepnya: begitu alamat tujuan sudah didaftarkan sekali, semua kejadian berikutnya akan otomatis terkirim ke sana tanpa perlu pengaturan ulang.
Hal ini berbeda dengan proses yang sepenuhnya manual, di mana setiap informasi harus dicari dan diambil sendiri. Webhook membalik arah proses itu — informasi yang mendatangi sistem Anda, bukan sistem Anda yang harus mencarinya.
Kenapa pengiriman ulang otomatis itu penting
Jaringan internet tidak selalu sempurna. Server tujuan bisa saja sedang sibuk, sedang dalam proses pembaruan, atau mengalami gangguan sesaat ketika sebuah webhook coba dikirim. Jika sistem pengirim tidak punya mekanisme pengiriman ulang, notifikasi yang gagal terkirim pada momen itu akan hilang begitu saja — dan bisnis tidak akan pernah tahu bahwa ada transaksi yang sebenarnya sudah terjadi tapi notifikasinya tidak sampai.
Inilah kenapa mekanisme antre dan coba ulang otomatis menjadi penting. Alih-alih mengandalkan satu kali percobaan pengiriman yang bisa gagal karena sebab-sebab di luar kendali, sistem yang baik akan menyimpan notifikasi yang gagal terkirim dalam antrean, dan mencobanya kembali beberapa saat kemudian sampai berhasil diterima. Dengan begitu, bisnis tidak kehilangan informasi penting hanya karena gangguan jaringan sesaat.
Webhook vs cek manual: gambaran praktis
| Situasi | Tanpa webhook | Dengan webhook |
|---|---|---|
| Mengetahui pembayaran masuk | Menunggu seseorang membuka aplikasi bank | Notifikasi dikirim otomatis saat transaksi terjadi |
| Memproses pesanan | Berisiko diproses sebelum dana benar-benar masuk | Diproses setelah konfirmasi otomatis diterima |
| Kegagalan pengiriman data | Tidak relevan, karena dicek manual | Diantrekan dan dicoba ulang otomatis |
| Beban kerja staf | Berulang sepanjang hari | Hanya menanggapi notifikasi yang masuk |
Kapan webhook relevan untuk bisnis Anda
Webhook paling relevan untuk bisnis yang memproses pesanan berdasarkan konfirmasi pembayaran — toko online, bisnis jasa dengan sistem pemesanan, atau tim keuangan yang perlu tahu status pembayaran secepat mungkin. Jika Anda ingin memahami lebih dulu kenapa pengecekan mutasi manual bisa menjadi beban, kami membahasnya di 5 tanda bisnis Anda butuh sistem cek mutasi otomatis.
Untuk mencoba notifikasi otomatis semacam ini pada rekening bisnis Anda, silakan daftar di Mutasiku dan hubungkan rekening BCA, BRI, BNI, atau Mandiri yang Anda gunakan.
Webhook dan Telegram: dua pilihan tujuan notifikasi
Tidak semua bisnis punya sistem internal yang siap menerima data webhook secara teknis. Untuk itu, notifikasi lewat Telegram menjadi alternatif yang sama bergunanya tanpa perlu keahlian teknis sama sekali — pesan notifikasi masuk ke grup Telegram tim persis seperti pesan chat biasa, cukup dibaca begitu muncul. Bisnis yang sudah punya sistem sendiri (misalnya aplikasi kasir atau e-commerce custom) bisa memilih webhook agar data mutasi langsung masuk ke sistem tersebut dan memicu proses lain secara otomatis, seperti mengubah status pesanan menjadi lunas.
Keduanya bisa dipakai bersamaan. Sebagian bisnis memilih mengatur webhook untuk kebutuhan integrasi sistem, sekaligus tetap mengaktifkan notifikasi Telegram sebagai cara cepat bagi tim untuk memantau transaksi secara langsung tanpa harus membuka sistem lain. Kombinasi ini memastikan informasi tersampaikan baik ke sistem maupun ke manusia yang perlu mengambil keputusan berdasarkan informasi itu.
Hal yang perlu didiskusikan dengan tim developer
Jika bisnis Anda punya developer dan memilih menggunakan webhook, ada beberapa hal praktis yang perlu didiskusikan bersama mereka: alamat endpoint mana yang akan menerima data, bagaimana sistem internal akan memproses data begitu diterima, dan apa yang terjadi jika data yang diterima ternyata tidak lengkap atau formatnya tidak sesuai ekspektasi. Diskusi semacam ini biasanya hanya perlu dilakukan sekali di awal integrasi, dan hasilnya akan menjadi fondasi yang dipakai selama sistem berjalan.
Bagi pemilik bisnis yang tidak terlibat langsung dalam detail teknis ini, cukup penting untuk memastikan ada satu orang di tim yang bertanggung jawab memantau apakah webhook masih berjalan sebagaimana mestinya, terutama di periode-periode awal setelah integrasi pertama kali diaktifkan. Setelah berjalan stabil, pemantauan rutin biasanya tidak lagi memerlukan banyak perhatian.