Step by step menerima webhook Azul303
Webhook payment.success adalah sinyal utama untuk mengubah status order atau saldo user client di sistem client.
Terakhir diperbarui 23 Juli 2026
Step 1 — Buat endpoint webhook di backend client
URL dashboard setting: https://aerovault.top/api-integration. Endpoint webhook dibuat di backend client dan menerima event dari Azul303. Jangan proses webhook di frontend.
- Contoh URL: https://client.com/webhook/Azul303.
- Method: POST.
- Content-Type: application/json.
Step 2 — Daftarkan URL di dashboard Azul303
URL: https://aerovault.top/api-integration. Webhook URL harus diisi dari dashboard client Azul303.
- Buka sidebar → API Integration → Webhook Configuration.
- Isi Webhook URL.
- Pilih event payment.success dan payment.failed.
- Simpan webhook secret di backend client.
Step 3 — Verifikasi signature
URL docs: https://aerovault.top/api/index.html. Signature membuktikan webhook berasal dari Azul303.
- Ambil raw body request.
- Ambil header X-Azul303-Timestamp.
- Ambil header X-Azul303-Signature.
- Hitung HMAC memakai webhook secret.
- Tolak request jika signature tidak cocok.
Step 4 — Cegah double process
Monitoring: https://aerovault.top/transactions. Webhook bisa dikirim ulang jika endpoint client timeout atau error.
- Simpan payment_id dan event.
- Jika payment_id + event sudah pernah diproses, balas 200 tanpa update ulang.
- Update saldo/order hanya satu kali.
Step 5 — Update status internal client
Monitoring: https://aerovault.top/transactions dan https://aerovault.top/wallet. Setelah signature valid dan event belum diproses, ubah status transaksi di sistem client.
- payment.success: tandai deposit/order sukses.
- payment.failed: tandai gagal.
- payment.expired: tandai expired jika event tersedia.
- Simpan payload webhook untuk audit.