Memulai Cepat
Panduan ini membawa Anda dari nol hingga integrasi yang berfungsi dalam sekitar 30 menit. Pada akhirnya Anda akan memiliki:
- harga langsung untuk hotel di sebuah kota, dari Partner API,
- tautan pemesanan yang mengkreditkan pemesanan ke akun Anda,
- pemesanan uji, dan webhook yang memberi tahu Anda bahwa itu terjadi.
Semua terjadi di staging, lingkungan pengujian kami. Anda tidak perlu meminta akses kepada kami, dan pindah ke produksi nanti juga tidak memerlukan persetujuan.
Apakah panduan ini tepat untuk Anda?
Section titled “Apakah panduan ini tepat untuk Anda?”| Anda ingin… | Mulai di sini |
|---|---|
| Menampilkan hotel di aplikasi, situs, atau produk AI Anda dan mengirim pelancong untuk memesan, mendapatkan komisi | Panduan ini |
| Memesan atas nama klien Anda sebagai agen perjalanan berlisensi | Panduan ini sampai Langkah 5, lalu Memesan sebagai agen perjalanan |
| Menyematkan hotel yang dapat dipesan tanpa menulis integrasi | Web Components |
| Membiarkan agen AI mencari dan memesan | MCP Servers dan Agentic Payments |
| Menghubungkan channel manager atau PMS | Tambahkan Channel Manager Anda |
Cara kerjanya
Section titled “Cara kerjanya”Anda menggunakan Partner API untuk menemukan hotel dan harga langsungnya. Setiap hotel memiliki urlName yang stabil. Anda mengubahnya menjadi tautan ke Wink Booking Engine, book.wink.travel, yang membawa ID Anda. Pelancong memesan dan membayar di sana, dan pemesanan dikreditkan ke akun Anda.
Sebelum Anda mulai
Section titled “Sebelum Anda mulai”Anda akan membutuhkan:
grpcurl, atau Postman atau Insomnia. Partner API menggunakan gRPC, bukan REST.curl.
Langkah 1: Buat akun staging
Section titled “Langkah 1: Buat akun staging”Staging sepenuhnya terpisah dari produksi, dengan login dan akun sendiri.
-
Buka staging-app.wink.travel, klik
Sign-In / Registerdan daftar. -
Klik
Accountsdi sidebar kiri, laluCreate, dan pilih I am an Affiliate. Pemesanan yang Anda kirim dikreditkan ke akun ini. Lihat Buat Akun.
Langkah 2: Buat aplikasi
Section titled “Langkah 2: Buat aplikasi”Aplikasi memberi kode Anda kredensialnya.
-
Pada kartu akun Anda, klik
Actions>Manage account, lalu tabApplications. -
Klik
Create new application, beri nama dan pilih Machine-to-machine sebagai tipe klien. -
Di bawah scopes, pilih Inventory & rates (baca). Partner API memeriksa
inventory.read. -
Klik
Create applicationdan salin Client ID dan Client secret. Secret hanya ditampilkan sekali dan tidak bisa diambil kembali.
Lihat Applications untuk tipe klien dan scopes lainnya.
Langkah 3: Dapatkan token akses
Section titled “Langkah 3: Dapatkan token akses”curl -X POST https://staging-iam.wink.travel/oauth2/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_credentials" \ -d "client_id=<YOUR_CLIENT_ID>" \ -d "client_secret=<YOUR_CLIENT_SECRET>" \ -d "scope=inventory.read"Simpan access_token dari respons:
export WINK_TOKEN=<access_token>Token memiliki masa berlaku. Dalam kode Anda sendiri, gunakan pustaka OAuth2 untuk mengambil dan memperbaruinya. Lihat Authentication.
Jika permintaan token ditolak, respons berupa body JSON dengan kode error:
error | Status HTTP | Penyebab Umum |
|---|---|---|
invalid_client | 401 | Client ID atau secret salah, atau kredensial produksi digunakan di staging-iam |
invalid_scope | 400 | Permintaan meminta scope yang tidak terdaftar pada aplikasi |
unauthorized_client | 400 | Aplikasi tidak diizinkan menggunakan grant client_credentials |
invalid_request | 400 | Parameter wajib hilang, misalnya body JSON bukan form |
Langkah 4: Temukan ID akun Anda
Section titled “Langkah 4: Temukan ID akun Anda”Setiap panggilan Partner API menyebutkan akun yang Anda wakili dalam header managing-entity-id. Daftar akun yang token Anda bisa wakili:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsSalin accountId dari akun afiliasi di Langkah 1:
export WINK_ACCOUNT_ID=<accountId>Langkah 5: Cari hotel di sebuah kota
Section titled “Langkah 5: Cari hotel di sebuah kota”Staging memiliki hotel uji dengan ketersediaan di Bangkok, jadi pencarian ini menggunakan slug-nya, bangkok-thailand:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -H "managing-entity-id: $WINK_ACCOUNT_ID" \ -d '{ "urlName": "bangkok-thailand", "userSession": { "itinerary": { "startDate": "2026-12-01", "nights": 2, "room": { "adults": 2 } }, "currencyCode": "USD", "languageCode": "en" } }' \ staging-partner.wink.travel:443 wink.partner.v1.Search/SearchByCityGunakan tanggal check-in di masa depan; tanggal masa lalu akan ditolak. Setiap hasil membawa:
name,starRatingdanheroImageUrl, cukup untuk menampilkan baris hasil,roomTypes, penawaran langsung, kamar termurah pertama,urlName, slug yang Anda butuhkan untuk tautan pemesanan.
Harga adalah bilangan bulat dalam satuan kecil: bagi dengan 10 pangkat currencyExponent dari respons (2 untuk USD, jadi 12500 adalah $125,00).
Tidak tahu slug kota? Cari dengan wink.partner.v1.Lookup/Search. Untuk konten lengkap properti, gunakan layanan Content. Referensi Partner API mendokumentasikan setiap panggilan.
Langkah 6: Bangun tautan pemesanan
Section titled “Langkah 6: Bangun tautan pemesanan”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>adalahurlNamehotel dari Langkah 5.client-idadalah Client ID aplikasi Anda dari Langkah 2.configuration-idadalah ID kustomisasi Anda:Manage account>Customizations. Kustomisasi juga mengatur branding, bahasa default, dan mata uang di halaman pemesanan.
Sertakan pencarian pelancong
Section titled “Sertakan pencarian pelancong”Tambahkan tanggal, tamu, bahasa, dan mata uang pelancong ke tautan yang sama agar halaman hotel terbuka dengan data tersebut terisi:
https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>&sd=2027-03-14&n=2&rc=a2&l=en&c=USD| Parameter | Arti | Contoh |
|---|---|---|
sd | Tanggal check-in | sd=2027-03-14 |
n atau ed | Jumlah malam, atau tanggal check-out | n=2 atau ed=2027-03-16 |
rc | Tamu per kamar | rc=a2 (2 dewasa) |
l | Bahasa tampilan | l=en |
c | Mata uang tampilan | c=USD |
p | Kode promosi | p=ABC123 |
Parameter ini menggantikan default yang diatur dalam kustomisasi Anda. Panduan Tombol Pesan Sekarang menjelaskan format lengkap rc, termasuk anak-anak dan beberapa kamar.
Tautan membuka halaman hotel; tidak bisa memilih kamar atau tarif secara otomatis. Pelancong memilih kamar di halaman hotel, dengan harga langsung.
Lihat Menghubungkan langsung untuk menghubungkan ke halaman utama booking engine daripada hotel tunggal.
Langkah 7: Buat pemesanan uji
Section titled “Langkah 7: Buat pemesanan uji”Buka tautan Anda, pilih tanggal dan kamar, dan lakukan pembayaran dengan kartu uji Stripe, misalnya 4242 4242 4242 4242 dengan tanggal kedaluwarsa masa depan dan CVC apa saja. Tidak ada kartu nyata yang dikenakan biaya di staging. Catat kode pemesanan di halaman konfirmasi; dimulai dengan WNK.
Langkah 8: Dapatkan notifikasi tentang pemesanan
Section titled “Langkah 8: Dapatkan notifikasi tentang pemesanan”-
Di Portal, buka
Applications > Webhooksdan tambahkan endpoint yang menerima permintaanPOST. -
Berlangganan ke
booking.create, atau biarkan daftar event kosong untuk menerima semuanya selama pengembangan. -
Kirimkan event uji ke diri sendiri, lalu buat pemesanan uji lain dan lihat notifikasi tiba.
Verifikasi tanda tangan setiap pengiriman sebelum mempercayainya. Lihat Integrasi Webhook dan Katalog Event Webhook.
Langkah 9: Pindah ke produksi
Section titled “Langkah 9: Pindah ke produksi”Tidak ada langkah persetujuan untuk pengembang. (Akun agen perjalanan disertifikasi terlebih dahulu; lihat di bawah.) Saat integrasi Anda berfungsi di staging:
-
Buat akun dan aplikasi di app.wink.travel, seperti di Langkah 1 dan 2. Kredensial tidak dibawa antar lingkungan.
-
Hilangkan
staging-dari setiap host:Staging Produksi https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
Cari lagi ID akun produksi (Langkah 4) dan ID kustomisasi (Langkah 6). Mereka berbeda dari staging.
Penggunaan Partner API dihitung berdasarkan malam hotel, dengan kuota gratis bulanan. Lihat Partner API untuk harga dan batasan.
Memesan sebagai agen perjalanan
Section titled “Memesan sebagai agen perjalanan”Jika akun Anda adalah agen perjalanan berlisensi, Anda tidak perlu mengirim pelancong ke book.wink.travel: Anda dapat membuat pemesanan langsung dengan wink.partner.v1.Booking/CreateBooking, dan mengelolanya dengan panggilan Booking lainnya. Akun lain mengirim pelancong ke tautan pemesanan.
Akun agen perjalanan disertifikasi: Wink meninjau pendaftaran setiap agen sebelum dapat memesan. Agen yang ingin mengumpulkan pembayaran dari klien sendiri, sebagai merchant of record, harus memesan melalui Partner API dan mendapatkan persetujuan tertulis dari Wink. Lihat Memulai sebagai Agen Perjalanan dan referensi Partner API.
Langkah berikutnya
Section titled “Langkah berikutnya”- Hasilkan klien bertipe dari skema
.protodaripada memanggilgrpcurlsecara manual. - Hubungkan server MCP dan gunakan AI Skills agar asisten pengkodean Anda menulis integrasi terhadap API langsung.
- Baca daftar lengkap lingkungan dan host.
