Lewati ke konten

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.

Anda ingin…Mulai di sini
Menampilkan hotel di aplikasi, situs, atau produk AI Anda dan mengirim pelancong untuk memesan, mendapatkan komisiPanduan ini
Memesan atas nama klien Anda sebagai agen perjalanan berlisensiPanduan ini sampai Langkah 5, lalu Memesan sebagai agen perjalanan
Menyematkan hotel yang dapat dipesan tanpa menulis integrasiWeb Components
Membiarkan agen AI mencari dan memesanMCP Servers dan Agentic Payments
Menghubungkan channel manager atau PMSTambahkan Channel Manager Anda

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.

Anda akan membutuhkan:

  • grpcurl, atau Postman atau Insomnia. Partner API menggunakan gRPC, bukan REST.
  • curl.

Staging sepenuhnya terpisah dari produksi, dengan login dan akun sendiri.

  1. Buka staging-app.wink.travel, klik Sign-In / Register dan daftar.

  2. Klik Accounts di sidebar kiri, lalu Create, dan pilih I am an Affiliate. Pemesanan yang Anda kirim dikreditkan ke akun ini. Lihat Buat Akun.

Aplikasi memberi kode Anda kredensialnya.

  1. Pada kartu akun Anda, klik Actions > Manage account, lalu tab Applications.

  2. Klik Create new application, beri nama dan pilih Machine-to-machine sebagai tipe klien.

  3. Di bawah scopes, pilih Inventory & rates (baca). Partner API memeriksa inventory.read.

  4. Klik Create application dan salin Client ID dan Client secret. Secret hanya ditampilkan sekali dan tidak bisa diambil kembali.

Lihat Applications untuk tipe klien dan scopes lainnya.

Terminal window
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:

Terminal window
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:

errorStatus HTTPPenyebab Umum
invalid_client401Client ID atau secret salah, atau kredensial produksi digunakan di staging-iam
invalid_scope400Permintaan meminta scope yang tidak terdaftar pada aplikasi
unauthorized_client400Aplikasi tidak diizinkan menggunakan grant client_credentials
invalid_request400Parameter wajib hilang, misalnya body JSON bukan form

Setiap panggilan Partner API menyebutkan akun yang Anda wakili dalam header managing-entity-id. Daftar akun yang token Anda bisa wakili:

Terminal window
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-d '{}' \
staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccounts

Salin accountId dari akun afiliasi di Langkah 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Staging memiliki hotel uji dengan ketersediaan di Bangkok, jadi pencarian ini menggunakan slug-nya, bangkok-thailand:

Terminal window
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/SearchByCity

Gunakan tanggal check-in di masa depan; tanggal masa lalu akan ditolak. Setiap hasil membawa:

  • name, starRating dan heroImageUrl, 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.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> adalah urlName hotel dari Langkah 5.
  • client-id adalah Client ID aplikasi Anda dari Langkah 2.
  • configuration-id adalah ID kustomisasi Anda: Manage account > Customizations. Kustomisasi juga mengatur branding, bahasa default, dan mata uang di halaman pemesanan.

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
ParameterArtiContoh
sdTanggal check-insd=2027-03-14
n atau edJumlah malam, atau tanggal check-outn=2 atau ed=2027-03-16
rcTamu per kamarrc=a2 (2 dewasa)
lBahasa tampilanl=en
cMata uang tampilanc=USD
pKode promosip=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.

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”
  1. Di Portal, buka Applications > Webhooks dan tambahkan endpoint yang menerima permintaan POST.

  2. Berlangganan ke booking.create, atau biarkan daftar event kosong untuk menerima semuanya selama pengembangan.

  3. 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.

Tidak ada langkah persetujuan untuk pengembang. (Akun agen perjalanan disertifikasi terlebih dahulu; lihat di bawah.) Saat integrasi Anda berfungsi di staging:

  1. Buat akun dan aplikasi di app.wink.travel, seperti di Langkah 1 dan 2. Kredensial tidak dibawa antar lingkungan.

  2. Hilangkan staging- dari setiap host:

    StagingProduksi
    https://staging-iam.wink.travelhttps://iam.wink.travel
    staging-partner.wink.travel:443partner.wink.travel:443
    https://staging-book.wink.travelhttps://book.wink.travel
  3. 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.

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.