Konfigurasi Webhook

Atur URL

1. Di dashboard, buka sebuah project lalu masuk ke tab Notifications.
2. Masukkan callback URL Anda — harus https://, ditegakkan di server-side — lalu simpan.
3. Salin signing secret yang ditampilkan. Seperti secret API key, ini hanya ditampilkan sekali — simpan bersama kode yang memverifikasi webhook masuk.

Perhatian

Mengatur atau mengganti URL selalu menerbitkan secret baru, jadi tidak pernah ada URL yang menunjuk ke secret lama yang masih aktif. Kalau Anda mengganti URL, update handler Anda dengan secret baru pada saat yang sama.

Sandbox dan production dikonfigurasi terpisah

Tab Notifications terikat pada environment mana pun yang sedang dipilih di top bar dashboard — sandbox dan production masing-masing punya callback URL dan signing secret sendiri, bukan yang dibagi bersama. Mengonfigurasi webhook saat di Sandbox tidak berpengaruh apa-apa untuk Production, begitu juga sebaliknya; ganti environment dan ulangi langkah di atas untuk mengaktifkan webhook di keduanya.

Tips

Sering terlewat saat go live: webhook sandbox Anda berfungsi tidak berarti production sudah siap juga. Konfigurasi secara terpisah — lihat Go Live.

Menghapus webhook

Remove webhook di tab Notifications yang sama memutus URL sepenuhnya — Baiyar berhenti mengirim event, dan project akan menampilkan status belum ada webhook yang dikonfigurasi sampai Anda mengaturnya lagi.

Selanjutnya

Setelah punya URL dan secret, lanjut ke Verifikasi Signature Webhook untuk memastikan request benar-benar dari Baiyar sebelum Anda mempercayainya.