Integrasi Webhook

Webhook memungkinkan sistem Anda menerima notifikasi waktu nyata saat terjadi acara di akun Wink Anda — pemesanan baru, pembatalan, pembaruan pembayaran, dan lainnya. Panduan ini memandu Anda melalui pengaturan dan praktik terbaik.

Audiens

Panduan ini ditujukan untuk pengembang yang mengintegrasikan Wink dengan sistem eksternal seperti sistem manajemen properti (PMS), channel manager, CRM, atau dasbor kustom.

Cara kerja webhook

1. Anda mendaftarkan URL webhook di Wink.
2. Saat sebuah acara terjadi (misalnya, pemesanan baru), Wink mengirim HTTP POST ke URL Anda.
3. Server Anda memproses payload dan merespons dengan 200 OK.

Mengatur webhook

1. Masuk ke akun Anda (Extranet, Studio, atau TripPay — semuanya mendukung webhook).
2. Navigasikan ke Applications lalu Webhooks. Lihat Webhooks.
3. Klik Create webhook.
4. Masukkan nama (misalnya, “Sinkronisasi Pemesanan PMS”).
5. Masukkan URL webhook Anda — endpoint HTTPS di server Anda.
6. Pilih acara — Pilih acara spesifik untuk berlangganan, atau biarkan kosong untuk menerima semua acara.
7. Aktifkan toggle Enabled.
8. Klik Save.

Jenis acara

Wink mendukung lebih dari 64 jenis acara webhook di berbagai kategori termasuk manajemen akun, kontrak pemesanan, pembayaran, pembaruan channel manager, dan pengelolaan entitas administrasi. Acara umum meliputi:

Kategori	Contoh
Pemesanan	booking.create, booking.cancelled
Kontrak pemesanan	booking.contract.created, booking.contract.processing, booking.contract.cancelled
Pembayaran	internal.payment.succeeded, internal.payment.failed
Pengembalian dana	booking.contract.refund.partial, booking.contract.refund.full
Channel manager	channel-manager.update.rate, channel-manager.update.availability
Akun	account.create, account.status.updated

Untuk daftar lengkap setiap jenis acara beserta deskripsinya, lihat Katalog Acara Webhook.

Lihat semua lebih dari 64 jenis acara

Tips

Mulailah dengan berlangganan semua acara selama pengembangan. Setelah Anda memahami payload, batasi hanya ke acara yang dibutuhkan sistem Anda.

Praktik terbaik

• Gunakan HTTPS — Wink hanya mengirim payload ke endpoint HTTPS.
• Respon cepat — Kembalikan 200 OK segera setelah menerima payload. Lakukan pemrosesan berat secara asinkron.
• Idempoten — Handler Anda harus idempoten. Wink mungkin mencoba ulang pengiriman jika tidak menerima respons 200.
• Validasi sumber — Verifikasi bahwa permintaan masuk berasal dari Wink sebelum memproses.
• Logging — Catat setiap payload webhook yang Anda terima. Ini memudahkan debugging masalah integrasi.

Menjeda dan menghapus

Anda dapat menonaktifkan webhook tanpa menghapusnya. Ini menjeda pengiriman sehingga Anda dapat memecahkan masalah tanpa kehilangan konfigurasi. Saat siap, aktifkan kembali.

Menghapus webhook akan menghapusnya secara permanen. Integrasi yang bergantung pada webhook tersebut akan berhenti menerima notifikasi.

Bacaan lanjutan

• Katalog Acara Webhook — Daftar lengkap semua lebih dari 64 jenis acara.
• Webhooks — Referensi lengkap untuk manajemen webhook.
• Applications — Kelola kredensial API Anda.
• Developers > APIs — Dokumentasi API lengkap.