호텔·항공 예약 API: 여행 하나, 예약 둘

티켓에는 이렇게 적혀 있습니다. "항공 예약 흐름에 호텔을 추가할 것. 결제는 한 번, 총액도 하나." 프로덕트 매니저가 충분히 할 만한 요청이고, 하루면 끝날 일처럼 들립니다. 항공 검색은 이미 있고 결제 페이지도 이미 있으니까요. 그런데 3주 뒤 팀은 항공사는 확정했는데 호텔이 확정하지 않으면 어떻게 해야 하느냐를 두고 다투고 있습니다. 호텔·항공 예약 API는 결과가 두 종류인 하나의 연동이 아닙니다. 장바구니 하나를 함께 쓰는 두 개의 연동입니다.
코드가 그 사실을 빨리 인정할수록 다시 짜야 할 코드는 줄어듭니다. 아래 내용은 연동 가이드들이 건너뛰는 부분입니다. 두 쪽이 어떻게 다른지, 어느 쪽을 먼저 확정해야 하는지, 그리고 데이터 모델 안에서 여행이라는 것이 무엇이어야 하는지에 관한 이야기입니다.
두 쪽은 똑같이 움직이지 않습니다
둘 다 가격과 참조 번호가 담긴 JSON으로 돌아오기 때문에 통신 구간에서는 비슷해 보입니다. 하지만 참조 번호를 손에 쥔 뒤 각자가 약속하는 내용은 전혀 비슷하지 않습니다.
| 질문 | 항공 | 호텔 |
|---|---|---|
| 예약 후 손에 쥐는 것 | 아직 항공권이 아닌 예약(PNR) | 대개 이미 판매한 상품 그 자체인 확정서 |
| 가격이 유효한 기간 | 예약 시점에 운임을 다시 산정할 때까지이며, 검색 때와 다를 수 있음 | 요금이 만료될 때까지이며, 객실 조회와 예약 사이에 요금이 바뀔 수 있음 |
| 확정시키는 것 | 발권, 대개 시한이 걸려 있음 | 공급사의 확정, 즉시일 때도 있고 대기 상태일 때도 있음 |
| 되돌리는 방법 | 일찍 잡으면 보이드(void), 그 뒤에는 운임 규정에 따른 환불이며 위약금이 붙는 경우가 많음 | 해당 요금 자체의 정책에 따른 취소, 많은 요금에서 마감 시각 전까지 무료 |
| 막판에 숫자를 바꾸는 것 | 운임, 세금, 때로는 운임의 통화 | 현장에서 내는 세금과 수수료, 식사 조건, 실제로 배정된 객실 |
공급사마다 다르니 특정 행에는 이견이 있을 수 있습니다. 하지만 전체 모양에는 이견이 있기 어렵습니다. 한쪽에는 발권 단계가 있고 다른 쪽에는 취소 가능 기간이 있으며, 둘의 시간표는 맞물리지 않습니다. 항공 쪽 흐름은 항공 예약 API 연동에서, 호텔 쪽의 느린 공급사 문제는 호텔 객실 조회 API 클라이언트 설계에서 다뤘습니다. 이 글은 그 두 글이 끝나는 지점, 즉 둘이 만나는 이음매에서 시작합니다.
어느 쪽을 먼저 예약할까요?
이것이 설계 결정이라고 아무도 말해 주지 않습니다. 그런데 실패의 비용을 정하는 것이 바로 이 결정입니다.
고객이 같은 날짜로 항공과 호텔을 함께 산다고 해 봅시다. 예약 하나를 보내고 이어서 다른 하나를 보냅니다. 일어날 수 있는 일은 세 가지입니다. 둘 다 성공하거나, 하나가 실패하거나, 다른 하나가 성공한 뒤에 하나가 실패하는 것입니다. 첫 번째는 좋은 날입니다. 나머지 두 경우가 고객 지원 대기열의 길이를 결정합니다.
항공을 먼저 발권했는데 호텔이 거절하면, 어느 도시로 가는 좌석은 있지만 묵을 방은 없는 고객이 생깁니다. 이미 결제도 끝났고, 환불하려는 항공권에는 위약금이 붙어 있습니다. 호텔을 먼저 잡았는데 항공이 실패하면, 대개 무료로 취소할 수 있는 객실을 들고 있는 셈이니 수습 비용이 쌉니다. 반대 방향의 위험도 실제로 있습니다. 취소할 수 없는 호텔 요금은 들고 있기에 더 나쁜 물건이므로, 호텔을 먼저 보내기 전에 그 요금의 취소 조건부터 읽어야 합니다.
이것은 경험칙이지 법칙이 아닙니다. 요점은 순서를 의도적으로 고르라는 것입니다. 되돌리기 쉬운 쪽을 되돌리기 어려운 쪽보다 먼저 확정하고, 어느 쪽이든 확정하기 직전에 두 가격을 모두 다시 확인하고, 세 가지 결과 각각에 대해 무엇을 할지 문서로 남기십시오. 코드 리뷰어는 거의 묻지 않습니다. 고객은 반드시 알게 됩니다.
여행 하나, 예약 둘
오래 버티는 구조는 여행 레코드 하나가 예약 두 건을 소유하는 형태입니다. 각 예약은 자기 참조 번호, 자기 상태, 자기 조건을 따로 가집니다. 고객은 총액 하나를 봅니다. 데이터베이스에는 행이 두 개 있고, 총액은 여러분이 계산하는 합계일 뿐 공급사 쪽에 존재하는 무언가가 아닙니다.
두 상태를 분리해 두십시오. 호텔의 "확정"과 항공의 "발권 완료"는 같은 상태가 아닙니다. 둘을 하나로 뭉갠 상태 컬럼은 언젠가 절반만 예약된 여행 위에 "예약 완료"라고 표시하게 됩니다.
두 변경 조건도 따로 보관하고, 따로 보여 주십시오. 화면에 보이는 총액은 날짜 변경이 한쪽에서는 무료이고 다른 쪽에서는 수수료라는 사실을 가립니다. 프런트엔드에 "날짜 변경" 버튼이 하나뿐이라면, 한쪽만 옮길 수 있을 때 그 버튼이 무엇을 하는지 고객이 대신 알아내기 전에 정해 두어야 합니다. 마크업도 마찬가지입니다. 대부분의 판매자처럼 서비스별로 마크업을 붙인다면 여행 총액에는 마크업이 두 개 들어 있고, 한쪽을 환불할 때는 어느 마크업을 돌려주는지 알아야 합니다. 묶인 여행이 비싸지는 곳은 결국 돈입니다. 각 항목이 서로 다른 시간표로 정산되고, 항공 환불은 호텔 취소가 처리되는 시점에 맞춰 들어오지 않기 때문입니다.
이 플랫폼의 위치
솔직하게 말하면, 이 플랫폼은 항공 API와 호텔 API를 제공하며, 접근은 셀프서비스 키가 아니라 대화로 시작합니다. 서비스는 테넌트별로 켜지므로 호텔은 팔고 투어는 팔지 않는 테넌트는 투어 관련 기능을 떠안지 않습니다. 여기에는 두 쪽을 원자적으로 한 번에 예약하는 단일 호출을 약속하는 내용이 없으며, 그런 것이 있다고 가정하고 설계해서도 안 됩니다. 두 쪽을 있는 그대로 예약 두 건으로 다루고, 그 위에 여러분이 소유하는 여행을 두십시오.
실제 호출과 조건을 먼저 보고 그 위에 설계하고 싶다면 여행 API 페이지에서 시작하고, 어떤 순서로 예약할지에 대한 계획을 가져오십시오. 무료 접근으로 무엇을 얻는지 아직 따져 보는 중이라면 무료 호텔 예약 API가 "무료"의 종류를 정리해 두었습니다.
잘못했을 때 치르는 비용
가장 비싼 실패는 조용한 실패입니다. 고객은 어느 도시행 항공권을 받았는데 방은 없고, 여러분은 그 사실을 밤중에 공항에서 온 메시지로 처음 알게 됩니다. 그보다는 싸지만 여전히 실제로 일어나는 일들도 있습니다. 안심되는 총액 하나를 보여 주다가 가격 재확인 뒤에 고객이 동의한 적 없는 두 번째 숫자를 내미는 결제 화면, 항공은 환불하고 호텔은 잊어버린 환불, 공급사는 다르게 말하는데 "예약 완료"라고 표시하는 상태 값 같은 것들입니다.
이 가운데 영리한 해법이 필요한 것은 하나도 없습니다. 필요한 것은 여행을 실제 객체로 만드는 것, 예약 순서를 누군가 문서로 적어 둔 결정으로 만드는 것, 그리고 어느 쪽이든 확정되기 직전에 두 가격을 마지막으로 다시 확인하는 것입니다. 이것을 한 번 제대로 만들어 두면 결제 화면은 처음 티켓이 요구한 만큼 단순해 보여도 괜찮습니다.