콘텐츠로 이동
리소스

개발자는 어떻게 제품에 호텔 예약을 추가할까요?

섹션 제목: “개발자는 어떻게 제품에 호텔 예약을 추가할까요?”

검색과 요금은 쉬운 부분입니다. 제품이 진짜 예약을 생성하고 결제를 받고 여행자와 호텔에 예약이 완료되었음을 알릴 때 비로소 유용해집니다.

많은 API가 호텔 콘텐츠를 반환하지만, 거래를 완료할 수 있는 API는 훨씬 적습니다.

간단한 답변

필요한 것은 네 가지입니다: 실시간 요금 및 가용성, 예약 생성, 결제, 그리고 확인 및 웹훅. 읽기 전용 콘텐츠 API는 첫 번째까지만 지원합니다. Wink에서는 Consumer 및 Booking Engine API가 무료이며, 예약 생성은 OAuth2를 사용하는 REST로 진행되고, booking.create를 포함한 70개의 웹훅 이벤트가 있으며, 결제는 호텔을 위해 수집되어 호텔이 상인으로 남아 통합자가 상인이 될 필요가 없습니다. MCP 서버는 AI 에이전트에 동일한 기능을 제공하며, 웹 컴포넌트는 UI를 구축하지 않고 예약 경로가 필요한 경우를 지원합니다.

기능의미기능 없을 때 제품이 멈추는 이유
실시간 요금 및 가용성날짜별 현재 가격과 실제 예약 가능 여부캐시된 요금은 확인 시 실패하고 신뢰를 떨어뜨림
예약 생성호텔이 받는 실제 예약 생성없으면 추천 링크일 뿐 제품이 아님
결제예약 과정에서 금액 수취다른 사이트로 넘기면 전환이 사라짐
확인 및 웹훅고객, 호텔, 시스템에 예약 완료 알림그렇지 않으면 지원 부담과 조정 문제 발생

대부분 개발자가 찾는 “호텔 API”는 첫 번째와 때때로 두 번째 기능만 제공합니다. 거래가 어려운 부분이며, 제품 여부를 결정하는 부분입니다.

이 질문이 이후 모든 것을 결정합니다. 체인을 통해 재판매되는 공급은 요금에 마진이 포함되고, 가용성이 오래되며, 예약 문의를 호텔에 직접 할 수 없습니다. 호텔에서 직접 제공되는 공급은 호텔 자체 요금, 실시간 가용성, 예약 존재를 아는 호텔을 제공합니다.

여행자가 호텔 공식 웹사이트와 비교할 경우 — 대부분의 경우 — 호텔이 직접 관리하는 공급이 가격이 더 나쁠 때의 난처한 상황을 피할 수 있습니다.

직접 호텔 예약을 구축하면 상인이 된다는 것은 결제 책임, 청구 취소, 환불, 세금 처리 및 각 시장에서 여행사 라이선스 취득을 의미합니다.

Wink에서는 호텔이 상인으로 남아 결제가 호텔을 위해 수집되므로 통합자가 그 책임을 지지 않습니다. 상인 계약은 파트너가 실제로 결제를 직접 받아야 하는 API 통합에 제공되며, 해당 경로는 별도의 라이선스 요구사항이 있습니다.

  1. 웹 컴포넌트. 예약 가능한 검색, 객실 목록 또는 체크아웃을 기존 페이지에 삽입. 백엔드 작업 불필요; 레이아웃 제어는 가장 적음.
  2. REST API. 검색, 요금, 예약 생성 및 확인을 완전 제어, OAuth2 인증. 예약 흐름이 제품 자체 경험의 일부일 때 사용.
  3. MCP 서버. AI 에이전트에 동일 기능 제공, 어시스턴트가 사용자 대신 예약을 검색, 가격 책정 및 완료 가능.

세 가지는 상호 배타적이지 않으며, 제품은 마케팅 표면에 컴포넌트를, 핵심 흐름에 API를 사용하는 경우가 많습니다.

  • 한 도시, 한 날짜 범위에 대한 검색 및 가격 책정. 실제 요금이 흐르도록 먼저 구현.
  • 결제 및 확인을 포함한 테스트 예약 하나를 끝까지 생성.
  • UI를 구축하기 전에 booking.create 및 취소 이벤트 구독.
  • 초기부터 귀속 모델 결정 — 예약과 함께 출처 컨텍스트가 전달되어야 나중에 보고가 정확함.
  • 실패 사례 처리: 견적과 예약 사이 가용성 상실, 결제 거절, 부분 환불 등.

Consumer 및 Booking Engine API는 무료입니다. Partner API는 월 10,000 호텔-박 무료 할당량이 포함되며, 이후 단위별 과금됩니다. 확정 예약에는 호텔의 1.5% 플랫폼 수수료와 카드 처리 비용이 부과되며, 10% 기본 커미션이 적용되어 통합자가 비용을 지불하는 대신 수익을 얻습니다.

무료 할당량은 통합자별입니다. 여러 계정을 만들어 우회하는 것은 남용이며 즉각적이고 영구적인 차단 대상입니다. 자세한 내용은 Partner API 사용 및 제한을 참조하세요.

  • 캐시된 요금으로 구축하기. 개발 시에는 괜찮아 보이나 운영에서는 실패함.
  • 결제를 리디렉션에 맡기기. 모든 전환에서 예약이 사라짐.
  • 출시 전까지 웹훅 무시하기. 조정 작업이 수작업으로 전환됨.
  • 필요 없이 상인이 되기. 기술적 결정이 아니라 라이선스 및 책임 문제임.
  • 출처 컨텍스트 전달하지 않기. 귀속 정보를 나중에 재구성할 수 없음.

계속 탐색하기

호텔 예약 API FAQ

통합해야 할 것, 비용, 결제 책임자에 관한 질문과 답변.

호텔 예약 API가 지원해야 하는 것은 무엇인가요?
실시간 요금 및 가용성, 예약 생성, 결제, 웹훅을 통한 확인입니다. 읽기 전용 콘텐츠 API는 첫 번째만 지원하며 거래를 완료할 수 없습니다.
Wink API는 무료인가요?
Consumer 및 Booking Engine API는 무료입니다. Partner API는 월 10,000 호텔-박 무료 할당량이 포함되며 이후 단위별 과금됩니다.
제가 상인이 되어야 하나요?
아니요. 호텔이 상인으로 남아 결제가 호텔을 위해 수집됩니다. 결제를 직접 받아야 하는 API 통합에는 별도의 상인 계약과 라이선스 요구사항이 있습니다.
AI 에이전트도 동일한 기능으로 예약할 수 있나요?
네. MCP 서버는 에이전트에 검색, 가격 책정, 예약 기능을 제공하여 어시스턴트가 사용자 대신 예약을 완료할 수 있습니다.
통합자로서 어떻게 수익을 얻나요?
제품이 유도한 예약에 대해 10% 기본 커미션이 적용되며, 이는 호텔의 플랫폼 수수료와 카드 처리 비용 이후에 계산되고 클릭당 6개월간 귀속됩니다.
UI를 직접 만들어야 하나요?
반드시 그렇지는 않습니다. 웹 컴포넌트는 기존 페이지에 예약 가능한 검색, 객실 목록, 체크아웃을 삽입할 수 있고, 예약 흐름을 직접 제어하려면 REST API를 사용하세요.

실제로 예약할 수 있는 제품을 만드세요.

섹션 제목: “실제로 예약할 수 있는 제품을 만드세요.”

실시간 호텔 공급, REST 기반 예약 생성, 웹훅, 에이전트를 위한 MCP 서버, 그리고 직접 소유하지 않아도 되는 결제.