본문으로 건너뛰기
블로그

항공권 가격 API: 화면의 숫자가 아직 운임이 아닌 이유

Tekravel 편집팀
AI의 도움을 받아 작성됨

데모는 잘 돌아갑니다. 개발자가 항공권 가격 API를 가장 싼 출발일 달력에 연결하면 표가 숫자로 채워지고, 회의실의 모두가 만족합니다. 그러다 첫 실제 고객이 날짜를 고르고, 결과 페이지의 금액이 결제 페이지보다 낮은 것을 보고, 스크린샷을 첨부해 고객지원에 문의합니다. 고장 난 것은 없습니다. API는 요청받은 대로 가격에 대한 질문에 답했을 뿐이고, 사이트가 그 답을 약속으로 받아들였을 뿐입니다.

가격은 기억이 짧은 제안이다

항공 운임은 좌석에 붙은 고정 라벨이 아닙니다. 좌석이 팔리면서 열리고 닫히는 운임 등급이며, 거기에 붙는 금액은 승객 구성, 정확한 항공편, 관련 공항의 세금, 견적에 쓰인 통화에 따라 달라집니다. 가격 응답은 그 모든 것의 스냅숏으로, 한 시점에 한 묶음의 입력값으로 찍힌 것입니다. 과거에 대한 사실로 다루면 올바른 것을 만들게 되지만, 현재에 대한 사실로 다루면 한 달을 환불 처리에 쓰게 됩니다.

그래서 개발자에게 유용한 질문은 단순히 가격이 얼마냐가 아닙니다. 이것이 어떤 종류의 가격이고, 얼마나 오래되었으며, 틀렸을 때 시스템이 무엇을 할 것인가입니다.

모두 가격이라 불리는 세 가지 숫자

대부분의 공급사는 문서 어딘가에서 세 가지를 모두 돌려주며, 필드 이름도 같은 경우가 많습니다. 첫날부터 자체 데이터 모델에서 이 셋을 분리해 두세요.

상태출처신선도판매 가능?표시할 내용
탐색용 가격캐시되었거나 집계된 검색, 속도와 범위를 위해 설계됨오래되었을 수 있고 해당 승객 기준으로 계산되지 않음불가„부터”라는 표현과 변동될 수 있다는 안내
산정된 제안정확한 여정, 승객 유형, 운임에 대한 실시간 요청호출 시점에 최신이며 만료 시각 또는 재산정 신호가 있음가능, 만료 전까지총액, 세금 내역, 운임 규정
발권 금액주문 시 항공사나 발권 시스템이 실제로 청구한 금액최종이미 판매됨영수증; 제안과 대조

탐색용 가격은 달력과 „최저가부터” 배지를 가능하게 하는 것이며, 만들 가치가 충분합니다. 다만 두 번째 행과 같은 대상이 아닙니다. 실수는 세 가지가 모두 흘러드는 price 필드 하나를 두는 것입니다.

실제로는 플래그가 달린 하나가 아니라 코드에 세 개의 별도 타입이나 테이블을 둔다는 뜻입니다. 탐색용 가격은 클릭을 유도할 뿐이므로 사소하게 틀려도 됩니다. 산정된 제안은 자기 이름으로 하게 될 약속이므로, 가져온 시각, 그 값을 만든 입력, 주문 시 공급사가 되돌려 달라고 할 식별자와 함께 저장합니다. 발권 금액은 회계입니다. 고객이 이메일에 있던 금액과 다른 금액을 냈다고 지원팀이 물을 때, 답은 행과 행 사이의 간극에 있고 세 가지를 모두 보관했을 때만 그 간극을 읽을 수 있습니다.

가격 응답이 담아야 하는 것

숫자 하나만으로는 결제 단계를 만들 수 없습니다. 공급사의 샘플 응답을 읽을 때 다음을 찾고, 자유 텍스트로 오는 것은 의심하세요.

  • 통화: 계정에서 추정하지 않고 응답에 명시된 것.
  • 기본 운임과 세금의 분리: 내역을 보여줄 수 있고 세금 변경이 운임 변경처럼 보이지 않도록.
  • 승객 유형: 가격이 계산된 기준. 성인 가격에 3을 곱한 것은 가족 운임이 아닙니다.
  • 운임 규정과 수하물: 구조화된 데이터로, 저렴한 옵션이 고객에게 실제로 더 싼지를 결정하기 때문입니다.
  • 만료 또는 재산정 신호: 타임스탬프, 또는 주문 전에 재산정해야 한다는 명시적 문구.

마지막 항목이 사람들이 건너뛰는 것입니다. 응답 어디에도 제안이 얼마나 유효한지 알려 주는 것이 없다면 추측하는 것이고, 그 추측은 운영 환경에서 이루어집니다.

주문 전에 재산정하라, 후가 아니라

가장 안전한 리듬에는 규칙이 들어 있습니다. 탐색을 위해 검색합니다. 고객이 여정을 고르면 바로 그 여정과 그 승객에 대한 실시간 산정 제안을 요청합니다. 그 총액을 고객에게 보여줍니다. 그다음에야 주문을 만듭니다. 실시간 가격이 결과 페이지와 다르면 고객이 결제한 뒤가 아니라 결제하기 전에 쉬운 말로 알려 줍니다.

중간 단계를 건너뛰면 그 차이를 떠안게 됩니다. 고객이 본 것보다 더 청구해 결제 페이지에서 판매를 잃거나, 낮은 금액을 인정해 그 차이를 자기 마진에서 메우게 됩니다. 작은 에이전시는 몇 번은 감당할 수 있어도 설계로 감당할 수는 없습니다.

연동 전에 서면으로 물어볼 것

문서는 순탄한 경로를 설명합니다. 돈이 새는 동작은 짧은 질문 목록의 답에 있으며, 그 답은 통화보다 이메일로 받아 두는 편이 좋습니다.

  1. 검색 응답의 가격은 실시간인가 캐시인가, 그리고 응답 자체에 그렇게 명시되어 있는가?
  2. 정확한 여정에 대한 별도의 가격 산정 호출이 있으며, 주문 전에 필수인가?
  3. 주문 시 가격이 바뀌었다면 어떻게 되는가: 거절, 응답에 새 가격, 아니면 조용히 새 금액으로 발권?
  4. 세금과 항공사 부가요금은 어떻게 항목화되며, 산정과 발권 사이에 바뀔 수 있는가?
  5. 가격은 어느 통화로 계산되며, 고객이 다른 통화를 본다면 환산은 어디서 일어나는가?
  6. 산정된 제안은 얼마나 오래 유효하며, 어떻게 알 수 있는가?

이에 정확히 답하는 공급사는 결제 단계를 고민한 곳입니다. „항상 최신입니다”라고 답하는 곳은 검증할 수 있는 것을 하나도 말하지 않은 것입니다. 동작을 직접 시험할 수 없다면, 그에 맞춰 개발하기로 확정하기 전에 전체 구조를 다시 살펴보는 이유가 됩니다.

잘못하면 드는 비용

요란하게 실패하는 일은 드뭅니다. 아무도 가격 탓으로 돌리지 않는 결제 단계의 작은 이탈로, „가격이 바뀌었어요”로 시작하는 지원 티켓으로, 결과 페이지를 믿었다가 이제는 믿지 않는 고객으로 나타납니다. 직원들은 발권 전에 운임을 수작업으로 재확인하게 됩니다. 누군가는 안전하게 가격을 올림 처리하자고 제안하고, 그러면 사이트는 사람들이 비교하는 단 하나의 화면에서 비싸 보입니다. 이 모두는 처음에 올바르게 내리기 쉬웠던 결정에 붙는 세금입니다.

작게 시작해서 검증하는 순서

실제로 적용할 때는 한꺼번에 다 바꾸려 하지 않는 편이 낫습니다. 먼저 검색 결과 화면과 결제 화면이 같은 값을 읽고 있는지부터 확인하세요. 두 화면이 서로 다른 출처에서 금액을 가져온다면, 오차는 이미 구조 안에 들어 있는 것입니다. 그다음에는 산정된 제안을 저장하는 별도의 테이블을 만들고, 가져온 시각과 입력값을 함께 기록합니다. 이 두 가지만 갖춰도 고객이 „가격이 달라졌어요”라고 문의했을 때 무슨 일이 있었는지 추적할 수 있습니다.

그리고 재산정 단계에서 가격이 달라졌을 때 보여줄 문구를 미리 정해 두세요. 오류 메시지처럼 보이면 고객은 사이트를 의심합니다. 반대로 „요금이 변경되어 최신 금액을 알려 드립니다”처럼 차분하게 사실만 알리면, 고객은 그 변화를 사이트의 정직함으로 받아들입니다. 이 문구 하나가 이탈과 신뢰 사이의 차이를 만들기도 합니다. 마지막으로, 발권 금액과 제안 금액의 차이를 정기적으로 대조하는 작은 점검을 두면 문제가 커지기 전에 발견할 수 있습니다.

이 플랫폼의 위치

이 플랫폼은 테넌트별로 활성화되는 항공편 및 호텔 API를 제공합니다. 접근은 셀프서비스 키가 아니라 대화로 시작하므로 토큰과 요청 한도 표를 건네주는 가입 양식은 없습니다. 이 페이지는 지연 시간, 커버리지, 운임 건수를 공개하지 않는데, 시험하는 방법을 보여줄 수 없는 숫자는 인쇄할 가치가 없기 때문입니다. 위의 질문을 그 대화에 가져가 검색뿐 아니라 산정된 제안에 대한 응답을 보여 달라고 요청할 수 있습니다. 지금 그 단계라면 여행 API 페이지에서 시작됩니다.

Tekravel 편집팀

여행 기술 데스크

Tekravel 여행 기술 데스크는 업계 독자를 위해 씁니다. 여행사 대표, 콘솔리데이터, 그리고 이들을 연동하는 개발자입니다. 모든 기사는 공개 전에 해당 기사가 다루는 플랫폼에서 확인합니다.