Webhook

Webhook mengirim event bertanda tangan ke servermu saat pembayaran berubah, misalnya ketika pembayaran berhasil atau settlement tercatat. Servermu tidak perlu terus-menerus meminta status pembayaran.

1. Tambahkan endpoint

Di dashboard pilih Developer Tools → Webhook → Tambah endpoint, di environment tempat kamu bekerja.

• Alamatnya harus HTTPS publik. Dari laptop, pakai tunnel.

• Pilih event yang kamu mau, atau kosongkan daftarnya untuk semuanya.

• Kamu mendapat signing secret (whsec_…) sekali saja. Simpan seperti password.

  

  

Endpoint milik satu proyek atau seluruh merchant, dan tiap cakupan bisa punya sampai lima. Endpoint dibuat per environment: yang kamu tambahkan di sandbox tidak menerima event live.

2. Terima dan verifikasi

Baiyar mengirim POST dengan body JSON. Periksa header Baiyar-Signature terhadap raw body sebelum kamu mempercayainya (Verifikasi tanda tangan, dengan kode untuk Node.js dan Python), lalu jawab dengan 2xx dalam 10 detik.

3. Tangani duplikat dan urutan event

Event bisa datang dua kali atau tidak berurutan. Abaikan id event yang sudah pernah kamu lihat, dan baca status pembayaran saat ini, jangan berasumsi ada urutan. Lihat Retry, urutan, dan duplikat.

4. Uji

Pindah ke sandbox dan buka Developer Tools → Simulasi. Tombol Kirim event uji mengirim satu event webhook.test. Skenario pembayaran mengirim event sukses, gagal, kedaluwarsa, tidak berurutan, atau duplikat ke endpoint-mu. Halaman Webhook mencatat setiap pengiriman dan respons server. Lihat Pembayaran uji.

Referensi webhook

• Ringkasan webhook: endpoint dan seperti apa pengiriman.
• Verifikasi tanda tangan, Retry, urutan, dan duplikat, Log event.
• Daftar event: semua jenis event.