23 Juni 2026/1 min read
Mengatur Webhook Chiwa Pay
Penjelasan webhook Chiwa Pay, kenapa dibutuhkan, dan apa yang dilakukan jika sistem belum mendukung webhook.
webhookintegrationdeveloper
Mengatur Webhook Chiwa Pay
Webhook adalah notifikasi server-to-server yang dikirim Chiwa Pay ke endpoint merchant saat status transaksi berubah.
Kenapa Webhook Dibutuhkan
Webhook membuat sistem merchant tidak perlu polling terlalu sering hanya untuk mengetahui transaksi sudah dibayar atau belum.
Gunakan webhook untuk:
- Mengubah status order menjadi paid.
- Menandai transaksi expired atau cancelled.
- Mencatat refund.
- Menyimpan log event untuk audit.
- Memicu proses internal setelah pembayaran berhasil.
Praktik yang Disarankan
- Gunakan HTTPS.
- Simpan secret webhook dengan aman.
- Verifikasi signature setiap request.
- Terapkan idempotency karena event dapat dikirim ulang.
- Balas
2xxhanya setelah event berhasil diproses.
Jika Sistem Belum Mendukung Webhook
Jika sistem Anda berjalan pada environtment yang tidak memungkinkan untuk mengekpose HTTP, Anda tetap dapat menggunakan layanan kami dengan melakukan pooling status transaksi. Untuk detail signature, event, dan delivery, buka dokumentasi webhook.