Ang apat na kakayahan na mahalaga
Section titled “Ang apat na kakayahan na mahalaga”| Kakayahan | Ano ang ibig sabihin | Bakit natitigil ang mga produkto kung wala ito |
|---|---|---|
| Live rates at availability | Kasalukuyang presyo at kung ano talaga ang maaaring i-book, bawat saklaw ng petsa | Nabibigo ang cached rates sa kumpirmasyon at nawawala ang tiwala |
| Paglikha ng booking | Gumawa ng totoong reserbasyon na matatanggap ng hotel | Kung wala ito, referral link ka lang, hindi produkto |
| Pagbabayad | Tumanggap ng pera bilang bahagi ng booking | Ang paglipat sa ibang site ang dahilan ng pagkamatay ng conversion |
| Kumpirmasyon at webhooks | Sabihan ang guest, hotel at iyong sistema kung ano ang nangyari | Suportahan ang load at maiwasan ang mga puwang sa reconciliation |
Karamihan sa mga “hotel API” na nakikita ng developer ay sumasaklaw sa una at minsan sa pangalawa. Ang transaksyon ang mahirap na bahagi, at ito ang nagdedesisyon kung mayroon kang produkto.
Kaninong supply ang iyong iniintegrate?
Section titled “Kaninong supply ang iyong iniintegrate?”Hinuhubog ng tanong na ito ang lahat ng susunod na proseso. Ang supply na nire-resell sa pamamagitan ng chain ay may markup sa rate, mas luma ang availability, at walang paraan pabalik sa hotel para sa tanong tungkol sa booking. Ang supply na direktang nanggagaling sa hotel ay may sariling rate ng hotel, live availability, at isang hotel na alam na may booking.
Para sa anumang bagay kung saan ikukumpara ng manlalakbay sa sariling website ng hotel — na karamihan sa mga bagay — iniiwasan ng hotel-controlled supply ang nakakahiya na sandali kapag mas mahal ang iyong presyo.
Sino ang merchant of record
Section titled “Sino ang merchant of record”Kung ikaw ang gagawa ng hotel booking, ang pagiging merchant of record ay nangangahulugang pagtanggap ng pananagutan sa pagbabayad, chargebacks, refund, paghawak ng buwis at madalas na lisensya bilang travel agency sa bawat merkado.
Sa Wink, ang hotel ang nananatiling merchant of record at kinokolekta ang bayad para sa hotel, kaya hindi mo kailangang akuin ang responsibilidad na iyon. Ang mga merchant-of-record na kasunduan ay available sa API integrations kung saan talagang kailangan ng partner na tumanggap ng bayad, at ang rutang iyon ay may sariling mga kinakailangan sa lisensya.
Tatlong antas ng integrasyon
Section titled “Tatlong antas ng integrasyon”- Web components. Maglagay ng bookable search, listahan ng kuwarto o checkout sa isang umiiral na pahina. Walang backend na trabaho; pinakamaliit na kontrol sa layout.
- REST API. Buong kontrol sa search, rates, paglikha ng booking at kumpirmasyon, na authenticated gamit ang OAuth2. Gamitin ito kapag bahagi ng karanasan ng iyong produkto ang booking flow.
- MCP server. Ang parehong kakayahan ay ipinapakita para sa mga AI agent, kaya ang assistant ay maaaring maghanap, magpresyo at makumpleto ang booking sa halip na ipasa ang user sa isang website.
Hindi eksklusibo ang tatlo — karaniwang gumagamit ang isang produkto ng components para sa marketing surface at API para sa core flow nito.
Ano ang unang itatayo
Section titled “Ano ang unang itatayo”- Maghanap at magpresyo para sa isang lungsod at isang saklaw ng petsa. Kumuha ng totoong rates bago magdisenyo ng kahit ano.
- Gumawa ng isang test booking mula simula hanggang dulo, kasama ang pagbabayad at kumpirmasyon.
- Mag-subscribe sa
booking.createat mga cancellation events bago gumawa ng anumang UI sa ibabaw. - Magdesisyon ng iyong attribution model nang maaga — kailangang sumama ang source context sa booking, o magiging hula-hula lang ang iyong reporting pagkatapos.
- Hawakan ang mga kaso ng pagkabigo: availability na nawala sa pagitan ng quote at book, payment na tinanggihan, partial refunds.
Presyong dapat malaman ng developer
Section titled “Presyong dapat malaman ng developer”Ang Consumer at Booking Engine APIs ay libre. Ang Partner API ay may libreng buwanang allowance na 10,000 hotel-nights, pagkatapos ay sisingilin kada unit. Ang mga kumpirmadong booking ay may 1.5% platform fee ng hotel kasama ang card processing sa cost, at may 10% default commission kapag ang iyong produkto ang nagdala ng booking — ito ang paraan ng integrator para kumita sa halip na magbayad.
Mga karaniwang pagkakamali
Section titled “Mga karaniwang pagkakamali”- Pagtayo gamit ang cached rates. Mukhang maayos sa development pero pumapalya sa production.
- Pag-iiwan ng pagbabayad sa redirect. Bawat paglipat ay nawawalan ng booking.
- Pagsuway sa webhooks hanggang sa launch. Nagiging manual ang reconciliation.
- Pagiging merchant of record nang hindi kailangan. Isang desisyon sa lisensya at pananagutan, hindi lang teknikal.
- Hindi pagpapasa ng source context. Hindi na maibabalik ang attribution pagkatapos.