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.