호텔 예약 API 공급사, 프런트 데스크에서 판단하라

서비스 오픈 후 처음 들어오는 지원 문의는 검색 문제인 경우가 드뭅니다. 밤 열한 시, 휴대폰에 확정번호를 띄운 투숙객이 프런트 데스크에 서 있고, 직원은 번호를 두 번 입력해 본 뒤 그 이름으로는 예약이 없다고 말합니다. 투숙객은 결제했습니다. 여러분의 시스템은 예약이 확정됐다고 말합니다. 둘 다 사실이고, 바로 그 점이 문제입니다.
이 문의가 호텔 예약 API 공급사를 고른다는 일의 본질입니다. 대부분의 팀은 데모에서 보이는 것으로 선택합니다. 도시 하나에 숙소가 몇 개 나오는지, 재고 조회 엔드포인트가 얼마나 깔끔한지, SDK로 첫 결과까지 얼마나 빨리 가는지 같은 것들입니다. 중요한 항목이지만 어느 공급사나 거의 같고, 프런트 데스크에서 벌어질 일은 그 어느 것도 결정하지 않습니다.
보유 숙소 수가 첫 질문이 아닌 이유
호텔이 더 많이 나오는 검색은 더 좋은 API처럼 느껴집니다. 하지만 보여줄 수 있는 숙소와 호텔이 인정하는 예약은 서로 다른 약속이고, 공급사 안의 서로 다른 부서가 지킵니다. 앞의 것은 콘텐츠 피드에서 오고, 뒤의 것은 계약과 호텔 자체 시스템과의 연결, 그리고 토요일에도 사람이 앉아 있는 지원 데스크에서 옵니다.
공급사를 몇 곳이나 연결할지부터 정하는 중이라면 그 질문만 다룬 글이 따로 있고, 거기서 말하는 매핑 문제는 실제로 존재합니다. 이 글은 공급사를 고르는 단계를 전제로, 투숙객이 결제를 마친 뒤 그 예약 응답이 얼마의 가치가 있는지 묻습니다.
결제 이후에 드러나는 호텔 예약 API 공급사의 다섯 가지 속성
공급사 문서에서 돈이 움직인 뒤 사이트가 저장하게 될 응답만 남겨 보십시오. 검색 엔드포인트가 똑같은 두 공급사가 사실은 다른 상품임이 드러나는 항목들입니다.
| 속성 | 좋은 답의 모습 | 없을 때 치르는 비용 |
|---|---|---|
| 취소 조건 | 구조화된 값: 마감 시각, 위약금, 그리고 마감 시각이 따르는 시간대 | 사람이 읽어야 하는 자유 서술, 추측으로 정해지는 환불 |
| 누가 대금을 받는가 | 요금별로 명시: 귀사에 선결제인지 현장 결제인지, 판매 주체(merchant of record)는 누구인지 | 한 번은 귀사가, 한 번은 체크아웃 때 이중 청구된 투숙객 |
| 호텔 자체 확정번호 | 응답에 포함되거나, 문서화된 경로로 나중에 전달 | 공급사 참조번호뿐이라 프런트 데스크에서는 아무 의미가 없음 |
| 재고 조회와 예약 사이의 가격 변동 | 새 가격을 명시하거나 분명히 거절, 조용한 차이는 불가 | 노출 요금과 실제 예약 요금의 차이가 귀사 마진에서 빠져나감 |
| 도착 시 예약 기록이 없을 때 | 이름이 붙은 절차와 업무 시간 외에도 받는 연락처 | 투숙객이 로비에서 기다리는 동안 호텔에 전화를 거는 귀사 직원 |
표를 읽을 때는 공급사가 무엇을 지원한다고 적어 놓았는지가 아니라, 실제 응답 한 건에서 그 값이 어느 필드에 어떤 형식으로 들어 있는지를 보십시오. 문서에 적힌 기능과 응답에 담긴 값은 자주 다르고, 그 차이는 대개 결제가 끝난 뒤에야 드러납니다. 지원 담당자가 투숙객 앞에서 확인할 수 있는 것은 문서가 아니라 저장된 응답뿐입니다.
순서에는 이견이 있을 수 있습니다. 그러나 카드를 받는 사이트라면 다섯 행 모두에 답이 있어야 합니다.
취소는 데이터이거나, 아니면 부채다
첫 번째 행을 자세히 보십시오. 가장 조용하게 실패하는 항목입니다. 많은 응답이 취소 정책을 한 문장으로 담고 있습니다. 특정 날짜까지 무료 취소, 이후 첫날 숙박료 청구 같은 식입니다. 사람에게는 충분히 읽힙니다. 그러나 코드는 문장을 해석하지 않고서는 행동할 수 없고, 해석에서 실수가 운영 환경까지 올라옵니다.
물리는 부분은 시간대입니다. 자정 마감은 호텔이 있는 도시에서는 한 순간, 서버에서는 다른 순간, 투숙객의 휴대폰에서는 또 다른 순간입니다. 공급사가 어느 쪽인지 말해 주지 않으면 언젠가 사이트는 투숙객에게 아직 무료 취소가 된다고 안내하고, 환불해 주고, 호텔이 위약금을 어차피 청구한 것을 발견하게 됩니다. 오류는 한 줄도 나지 않았습니다. 돈만 빠져나갔습니다.
환불 불가 요금도 같은 수준으로 따져야 합니다. 요금 이름에만 적는 것이 아니라 별도의 필드로 분명히 표시하는 공급사는 그것을 파는 사이트를 생각한 곳입니다. 계약서에 서명하기 전에 두 종류 모두 실제 응답으로 보여 달라고 요청하십시오.
투숙객 카드 명세서에 누구의 이름이 찍히는가
두 번째 행은 회계 문제처럼 들리지만 실은 고객 응대 문제입니다. 선결제 요금이라면 투숙객이 귀사에 지불하고, 귀사 또는 공급사가 호텔에 지불하며, 호텔은 미니바나 프런트에서 걷는 도시세 같은 부대 비용 외에는 투숙객에게 청구하지 않아야 합니다. 현장 결제 요금이라면 사이트는 객실 요금을 전혀 받지 않고, 투숙객의 카드는 숙소가 보통 체크인이나 체크아웃 때 결제합니다.
두 방식 모두 작동합니다. 작동하지 않는 것은 둘을 구분하지 못하는 결제 화면입니다. 공급사가 두 종류의 요금을 같은 형태로 내려주고 결제 모델이 설명 문구 속에 묻혀 있다면, 사이트는 조만간 호텔이 다시 청구할 객실 요금을 투숙객에게 청구하게 됩니다. 투숙객은 명세서에서 두 줄을 보고 첫 줄에 적힌 이름, 즉 귀사로 전화합니다.
그래서 원하는 답은 요금별로, 필드로, 그리고 판매 주체(merchant of record)가 누구인지까지 포함해야 합니다. 마지막 항목이 카드에 어떤 상호가 찍히는지, 차지백을 누가 처리하는지를 결정합니다.
서명 전에 서면으로 던질 질문
데모는 순조로운 경로만 보여 줍니다. 서면 답변은 공급사가 다른 경로를 겪어 봤는지 보여 줍니다. 아래를 보내고 답을 보관하십시오.
- 환불 불가 요금의 예약 응답 하나와 무료 취소 마감이 있는 요금의 예약 응답 하나를 보여 주십시오.
- 그 마감은 어느 시간대로 표기되며, 응답의 어디에 그렇게 적혀 있습니까?
- 호텔 자체 확정번호는 언제 도착하며, 예약 호출 이후에 오는 경우 어떻게 받습니까?
- 현장 결제 요금에서 투숙객은 카드에 정확히 무엇이, 누구로부터, 언제 찍히는 것을 보게 됩니까?
- 투숙객이 도착했는데 호텔에 기록이 없을 때 투숙객이나 저희는 누구에게, 어느 시간대에 전화합니까?
마지막 질문에 절차로 답하는 공급사는 이미 겪어 본 곳입니다. 기능 이름으로 답하는 곳은 아닙니다. 항공 쪽도 마찬가지여서, API 뒤에 무엇이 있는지가 API 자체보다 중요합니다.
잘못 고르면 치르는 비용
실패는 하나하나 작고 반복됩니다. 마감 시각을 엉뚱한 시간대로 읽어 귀사 마진에서 나가는 환불. 현장 결제 요금이 결제 화면에서 선결제로 보여 이중 청구된 투숙객. 공급사가 호텔이 알아보는 번호를 끝내 주지 않아서 매주 초 호텔에 전화해 예약을 수작업으로 재확인하는 직원. 이 중 어느 것도 보유 숙소 수에는 나타나지 않지만, 실제 트래픽이 들어오는 첫 달 안에 모두 지원 문의함에 나타납니다.
이를 피하는 데 필요한 작업은 오후 한나절입니다. 위 표를 곁에 두고 예약 응답 다섯 건을 읽어 보십시오.
저희의 위치
Tekravel은 호텔과 항공 API를 제공합니다. 이용은 셀프서비스 키가 아니라 상담으로 시작하고, 서비스는 테넌트별로 켜지며, 공급사 콘텐츠는 일대일 계약이 아니라 공급사 그룹을 통해 테넌트에 전달됩니다. 이 페이지에 숙소 수는 게시하지 않으며, 숫자를 그대로 믿으시기보다 위 다섯 가지 질문을 저희에게 해 보시기를 권합니다. 그 단계에 계시다면 API 페이지에서 상담이 시작됩니다.