Apa yang perlu disokong oleh API tempahan hotel?

Kadar dan ketersediaan langsung, penciptaan tempahan, pembayaran, dan pengesahan dengan webhooks. API kandungan baca sahaja hanya merangkumi yang pertama dan tidak boleh melengkapkan transaksi.

Adakah API Wink percuma untuk digunakan?

API Consumer dan Booking Engine adalah percuma. API Partner termasuk 10,000 malam hotel percuma setiap bulan, kemudian dikenakan bayaran per unit.

Adakah saya perlu menjadi pedagang rekod?

Tidak. Hotel kekal sebagai pedagang rekod dan pembayaran dikutip untuk hotel. Susunan pedagang rekod wujud untuk integrasi API yang benar-benar perlu menerima pembayaran sendiri, dengan keperluan pelesenan tersendiri.

Bolehkah ejen AI menempah melalui keupayaan yang sama?

Ya. Pelayan MCP mendedahkan carian, penetapan harga dan tempahan kepada ejen, supaya pembantu boleh melengkapkan tempahan tanpa menyerahkan pengguna ke laman web.

Bagaimana saya dibayar sebagai integrator?

Komisen lalai 10% dikenakan ke atas tempahan yang dipacu oleh produk anda, dikira selepas yuran platform hotel dan pemprosesan kad, dengan atribusi berlangsung selama 6 bulan setiap klik.

Adakah saya perlu membina UI?

Tidak semestinya. Komponen web menyediakan carian boleh tempah, senarai bilik dan checkout yang boleh dimasukkan ke dalam halaman sedia ada; REST API ada apabila aliran itu sepatutnya milik anda.

API Tempahan Hotel — Cara Menambah Tempahan Hotel ke Produk

Empat keupayaan yang penting

Keupayaan	Maksudnya	Kenapa produk terhenti tanpa ini
Kadar dan ketersediaan langsung	Harga semasa dan apa yang benar-benar boleh ditempah, mengikut julat tarikh	Kadar yang disimpan dalam cache gagal semasa pengesahan dan merosakkan kepercayaan
Penciptaan tempahan	Membuat tempahan sebenar yang diterima oleh hotel	Tanpanya anda hanyalah pautan rujukan, bukan produk
Pembayaran	Menerima wang sebagai sebahagian daripada tempahan	Penyerahan kepada laman lain menyebabkan kehilangan penukaran
Pengesahan dan webhooks	Memberitahu tetamu, hotel dan sistem anda apa yang berlaku	Menyokong beban dan mengisi jurang penyelarasan

Kebanyakan “API hotel” yang ditemui pembangun merangkumi yang pertama dan kadang-kadang yang kedua. Transaksi adalah bahagian yang sukar, dan ia menentukan sama ada anda mempunyai produk.

Bekalan siapa yang anda integrasikan?

Soalan ini membentuk segala-galanya selepas ini. Bekalan yang dijual semula melalui rantaian datang dengan markup dalam kadar, ketersediaan yang lebih lama, dan tiada laluan kembali ke hotel untuk soalan tempahan. Bekalan yang datang terus dari hotel membawa kadar hotel sendiri, ketersediaan langsung, dan hotel yang tahu tempahan itu wujud.

Untuk apa sahaja di mana pengembara akan membandingkan dengan laman web hotel sendiri — yang kebanyakan perkara — bekalan yang dikawal hotel mengelakkan saat canggung apabila harga anda lebih mahal.

Siapa pedagang rekod

Jika anda membina tempahan hotel sendiri, menjadi pedagang rekod bermakna mengambil tanggungjawab pembayaran, bayaran balik, pengendalian cukai dan sering lesen agensi pelancongan di setiap pasaran.

Pada Wink, hotel kekal sebagai pedagang rekod dan pembayaran dikutip untuk hotel, jadi integrator tidak mewarisi tanggungjawab itu. Susunan pedagang rekod tersedia pada integrasi API di mana rakan kongsi benar-benar perlu menerima pembayaran sendiri, dan laluan itu membawa keperluan pelesenan tersendiri.

Tiga tahap integrasi

Komponen web. Letakkan carian boleh tempah, senarai bilik atau checkout ke dalam halaman sedia ada. Tiada kerja backend; kawalan paling sedikit ke atas susun atur.
REST API. Kawalan penuh ke atas carian, kadar, penciptaan tempahan dan pengesahan, diautentikasi dengan OAuth2. Gunakan apabila aliran tempahan adalah sebahagian daripada pengalaman produk anda sendiri.
Pelayan MCP. Keupayaan yang sama didedahkan untuk ejen AI, supaya pembantu boleh mencari, menetapkan harga dan melengkapkan tempahan tanpa menyerahkan pengguna ke laman web.

Ketiga-tiga ini tidak eksklusif — produk biasanya menggunakan komponen untuk permukaan pemasaran dan API untuk aliran terasnya.

Apa yang perlu dibina dahulu

Carian dan harga untuk satu bandar dan satu julat tarikh. Dapatkan kadar sebenar mengalir sebelum mereka bentuk apa-apa.
Buat satu tempahan ujian dari awal hingga akhir, termasuk pembayaran dan pengesahan.
Langgan booking.create dan acara pembatalan sebelum anda membina sebarang UI di atasnya.
Tentukan model atribusi anda awal-awal — konteks sumber perlu dibawa bersama tempahan, atau laporan anda menjadi tekaan kemudian.
Urus kes kegagalan: ketersediaan hilang antara sebut harga dan tempahan, pembayaran ditolak, bayaran balik separa.

Harga yang perlu diketahui pembangun

API Consumer dan Booking Engine adalah percuma. API Partner termasuk elaun bulanan percuma sebanyak 10,000 malam hotel, kemudian dikenakan bayaran per unit. Tempahan yang disahkan membawa yuran platform hotel sebanyak 1.5% ditambah kos pemprosesan kad, dan komisen lalai 10% dikenakan apabila produk anda memacu tempahan — itulah cara integrator memperoleh pendapatan dan bukannya membayar.

Kesilapan biasa

Membina atas kadar yang disimpan dalam cache. Ia kelihatan baik semasa pembangunan tetapi gagal dalam produksi.
Meninggalkan pembayaran kepada pengalihan. Setiap penyerahan kehilangan tempahan.
Mengabaikan webhooks sehingga pelancaran. Penyelarasan menjadi kerja manual.
Menjadi pedagang rekod tanpa perlu. Ia adalah keputusan pelesenan dan tanggungjawab, bukan hanya teknikal.
Tidak menghantar konteks sumber. Atribusi tidak boleh dibina semula kemudian.

Bagaimana pembangun menambah tempahan hotel ke dalam produk?