Chiwa ID
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 2xx hanya 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.