Webhook

Webhook mengirim POST JSON ke URL Anda setiap kali status pesanan berubah, misalnya untuk mencatat penjualan ke sistem akuntansi atau mengirim notifikasi ke grup internal.

#Menambah endpoint

1. Buka Integrasi & aplikasi → tab Webhook, tekan Tambah endpoint.
2. Isi URL (https) penerima.
3. Pilih Event, atau Semua event: pesanan dibuat, dibayar, diterima outlet, diproses, siap, diantar, selesai, dibatalkan, di-void, direfund, dan refund sebagian.
4. Tekan Tambah.
5. Salin Signing secret yang muncul. Nilainya hanya ditampilkan sekali.

#Memverifikasi kiriman

Setiap kiriman membawa header X-Zc-Event, X-Zc-Delivery (pakai untuk mencegah duplikat), dan X-Zc-Signature: t=<unix>,v1=<hex>. Hitung HMAC-SHA256(secret, "<t>.<isi body mentah>") dan bandingkan dengan v1. Tolak kiriman yang t-nya lebih dari 5 menit.

#Pengiriman dan percobaan ulang

• Event dikirim dalam sekitar satu menit. Bila gagal, dicoba lagi setelah 1 menit, 5 menit, 30 menit, 2 jam, dan 12 jam.
• Balas dengan HTTP 2xx secepatnya, lalu proses datanya di belakang.
• Setelah 20 kegagalan berturut-turut, endpoint dinonaktifkan otomatis. Aktifkan lagi setelah server Anda diperbaiki.

#Alat bantu

• Kirim tes mengirim event contoh dan menampilkan kode HTTP balasan.
• Riwayat pengiriman menampilkan setiap kiriman, statusnya, dan galat terakhir. Tekan Kirim ulang untuk mengirim kembali satu kiriman.
• Ganti secret membuat signing secret baru; secret lama langsung tidak berlaku.