← Pusat bantuan
Setup lanjutan

Webhook untuk integrasi eksternal

Webhook keluarkan event Posz (orderan dibayar, refund dibuat, settings diubah) ke URL eksternal kamu — supaya CRM, accounting, atau internal tool bisa react realtime. HMAC-signed; retry otomatis kalau target down.

Langkah

  1. 01 Dashboard → Settings → Webhooks card. Klik "Add webhook".
  2. 02 Masukkan URL endpoint kamu (HTTPS only). Pilih event yang mau subscribe — chip multiselect: order.paid, refund.created, merchant.settings_update.
  3. 03 Save. Posz generate one-time secret + tampil sekali di reveal box (warna oranye). Copy sekarang — kalau hilang, harus rotate.
  4. 04 Verify HMAC di endpoint kamu: setiap POST datang dengan header X-Posz-Signature (sha256 hex of raw body using secret). Reject request kalau signature tidak match.
  5. 05 Test: trigger event di Posz (misal close one order). Cek log di /settings → Webhooks → row "Last delivery" — last_success_at update kalau berhasil, last_failure_at + error_msg kalau gagal.

Catatan

  • Retry envelope: 1m → 5m → 15m → 60m. Setelah 4 percobaan gagal, Posz mark webhook sebagai unhealthy + email owner. Endpoint kamu HARUS return 2xx untuk dianggap success.
  • Untuk integrasi yang lebih dalam (terima orderan dari delivery aggregator, push menu, dll), lihat /docs/integrations — itu framework partner penuh, bukan webhook satu-arah.

Masih butuh bantuan?

Email tim support langsung — posz@uncle-z.com. Kami baca semua dan balas via email.