Webhooks

Woalz mengirim webhook keluar ke URL kamu saat ada event pada produkmu. Daftarkan satu atau lebih URL webhook per aplikasi di /developer/<appId>/webhooks.

Semua event berbagi envelope yang sama:

{ "id": "evt01H8XZT...", // ID event unik (kunci idempotensi) "type": "purchase.completed", "createdat": "2026-04-22T10:34:12.123Z", "appid": "uuid-of-your-app", "data": { // payload spesifik per event (lihat di bawah) } }

Pakai id sebagai kunci idempotensi. Jika kamu melihat id yang sama dua kali, proses sekali saja.

Setiap webhook menyertakan tanda tangan HMAC-SHA256 dari raw request body, memakai webhook secret kamu (ditampilkan sekali saat kamu membuat webhook; bisa di-regenerate dari /developer/<appId>/webhooks).

Header yang dikirim:

Daftar Isi / Sections

Katalog event
Bentuk payload
Signing
Kebijakan retry
Payload event
Menguji webhook secara lokal
Praktik keamanan terbaik
Changelog
Dukungan