Empat kemampuan yang penting
Section titled “Empat kemampuan yang penting”| Kemampuan | Artinya | Mengapa produk terhenti tanpa ini |
|---|---|---|
| Tarif dan ketersediaan langsung | Harga saat ini dan apa yang benar-benar dapat dipesan, per rentang tanggal | Tarif yang di-cache gagal saat konfirmasi dan mengurangi kepercayaan |
| Pembuatan pemesanan | Membuat reservasi nyata yang diterima hotel | Tanpa ini Anda hanya tautan rujukan, bukan produk |
| Pembayaran | Menerima uang sebagai bagian dari pemesanan | Pengalihan ke situs lain adalah titik di mana konversi mati |
| Konfirmasi dan webhook | Memberi tahu tamu, hotel, dan sistem Anda apa yang terjadi | Mendukung beban dan mengisi celah rekonsiliasi |
Sebagian besar “API hotel” yang ditemukan pengembang mencakup yang pertama dan kadang kedua. Transaksi adalah bagian yang sulit, dan itu yang menentukan apakah Anda memiliki produk.
Pasokan siapa yang Anda integrasikan?
Section titled “Pasokan siapa yang Anda integrasikan?”Pertanyaan ini membentuk segalanya ke depan. Pasokan yang dijual kembali melalui rantai datang dengan markup di dalam tarif, ketersediaan yang lebih usang, dan tidak ada jalur kembali ke hotel untuk pertanyaan pemesanan. Pasokan yang berasal langsung dari hotel membawa tarif hotel sendiri, ketersediaan langsung, dan hotel yang mengetahui pemesanan tersebut ada.
Untuk apa pun di mana pelancong akan membandingkan dengan situs web hotel sendiri — yang merupakan sebagian besar kasus — pasokan yang dikontrol hotel menghindari momen canggung ketika harga Anda lebih buruk.
Siapa merchant of record
Section titled “Siapa merchant of record”Jika Anda membangun pemesanan hotel sendiri, menjadi merchant of record berarti mengambil tanggung jawab pembayaran, chargeback, pengembalian dana, penanganan pajak, dan seringkali lisensi agen perjalanan di setiap pasar.
Di Wink, hotel tetap menjadi merchant of record dan pembayaran dikumpulkan untuk hotel, sehingga integrator tidak mewarisi tanggung jawab tersebut. Pengaturan merchant-of-record tersedia pada integrasi API di mana mitra benar-benar perlu mengambil pembayaran sendiri, dan jalur itu membawa persyaratan lisensi tersendiri.
Tiga tingkat integrasi
Section titled “Tiga tingkat integrasi”- Komponen web. Menyisipkan pencarian yang dapat dipesan, daftar kamar, atau checkout ke halaman yang sudah ada. Tidak perlu kerja backend; kontrol tata letak paling sedikit.
- REST API. Kontrol penuh atas pencarian, tarif, pembuatan pemesanan, dan konfirmasi, diautentikasi dengan OAuth2. Gunakan saat alur pemesanan adalah bagian dari pengalaman produk Anda sendiri.
- Server MCP. Kemampuan yang sama disediakan untuk agen AI, sehingga asisten dapat mencari, memberi harga, dan menyelesaikan pemesanan daripada mengarahkan pengguna ke situs web.
Ketiganya tidak eksklusif — sebuah produk biasanya menggunakan komponen untuk permukaan pemasaran dan API untuk alur inti.
Apa yang harus dibangun terlebih dahulu
Section titled “Apa yang harus dibangun terlebih dahulu”- Cari dan beri harga untuk satu kota dan satu rentang tanggal. Dapatkan tarif nyata mengalir sebelum merancang apa pun.
- Buat satu pemesanan uji dari awal sampai akhir, termasuk pembayaran dan konfirmasi.
- Berlangganan ke
booking.createdan event pembatalan sebelum membangun UI apa pun di atasnya. - Tentukan model atribusi Anda sejak awal — konteks sumber harus ikut bersama pemesanan, atau pelaporan Anda nanti hanya tebakan.
- Tangani kasus kegagalan: ketersediaan hilang antara penawaran dan pemesanan, pembayaran ditolak, pengembalian dana sebagian.
Harga yang harus diketahui pengembang
Section titled “Harga yang harus diketahui pengembang”API Consumer dan Booking Engine gratis. API Partner mencakup kuota gratis 10.000 malam hotel per bulan, kemudian dikenakan biaya per unit. Pemesanan yang dikonfirmasi membawa biaya platform hotel sebesar 1,5% plus biaya pemrosesan kartu sesuai biaya, dan komisi default 10% berlaku ketika produk Anda mengarahkan pemesanan — inilah cara integrator mendapatkan penghasilan, bukan membayar.
Kesalahan umum
Section titled “Kesalahan umum”- Membangun berdasarkan tarif yang di-cache. Tarif tersebut terlihat baik saat pengembangan tapi gagal di produksi.
- Meninggalkan pembayaran ke pengalihan. Setiap pengalihan kehilangan pemesanan.
- Mengabaikan webhook sampai peluncuran. Rekonsiliasi menjadi pekerjaan manual.
- Menjadi merchant of record tanpa perlu. Ini adalah keputusan lisensi dan tanggung jawab, bukan hanya teknis.
- Tidak meneruskan konteks sumber. Atribusi tidak bisa direkonstruksi kemudian.