Plus Channel Booking

플러스 채널 예약의 가예약·확정·변경·취소 흐름입니다. 각 단계마다 ONDA와 공급사가 각자 유효성 검사를 수행합니다.

예약 처리 엔드포인트는 모두 공급사 API(ONDA → 공급사)이므로, 공급사가 서버로 구현합니다.

단계별 흐름

1. 취소환불정책 사전 조회 — GET .../rateplans/{vendor_rateplan_id}/refund_policy
2. 가예약 생성 — POST /bookings (유효성 검사 후 재고 차감)
3. 예약 확정 — PUT /bookings/{vendor_booking_number}/confirm
4. 예약 변경 — PUT /bookings/{vendor_booking_number}/modify (Soft Change만 허용)
5. 예약 취소 — POST /bookings/{vendor_booking_number}/cancel
6. 재고 재전송 — POST .../ari/avails

체크리스트

• 가예약·확정·취소 각 단계 유효성 검사 (재고·요금·판매상태·영업일)
• 가예약 생성 후 15분 이내 confirm 미호출 시 가예약 자동 취소(재고 복원) 로직 구현
• 실제 공급사 예약은 gds_sub_booking_number 기준으로 생성
• 예약 직전 일자별 취소환불 정책 전달
• 확정 후 변경된 재고 재전송 (POST .../ari/avails)
• 예약 type은 overnight(숙박)만 사용
• modify는 Soft Change만 허용 — Hard Change 요청 수신 시 거부·예외 처리 규격 정의
• 예약 바우처(확정·취소) 숙소에 직접 발송

플러스 채널의 modify는 Soft Change만 허용

예약자·투숙자 정보 변경 같은 메타성 변경만 가능합니다. 투숙일 변경·예약 객실 변경 등 Hard Change는 플러스 채널에서 허용되지 않으며, 필요한 경우 취소 후 재예약으로 처리합니다. (직연동 채널은 Hard Change도 허용)

가예약 자동 취소 — 15분 타임아웃

가예약 생성 후 15분 이내에 예약 확정 호출이 없으면 해당 가예약은 자동으로 취소 처리되고 재고가 복원됩니다.

주요 필드

필드	엔드포인트	설명
payment_type	POST /bookings · confirm 응답	플러스 채널은 항상 prepayment(선결제) 입니다. paid_amount(결제 금액)는 제거됐습니다.
net_price	POST /bookings · modify 요청	수수료를 제외한 정산금액(입금예정액)
canceled_by	cancel 요청	취소 주체 — user / admin / channel / system
memo	cancel 요청	취소 사유·메모. 채널 관리자가 취소한 경우 canceled_by=channel과 함께 사유가 전달됩니다
type	POST /bookings 요청	overnight(숙박)만 사용합니다

플러스 채널에서 취급하지 않는 필드

스펙에는 있지만 플러스 채널 예약에서는 전달되지 않습니다. 구현 대상이 아닙니다.

• visit_type — 방문수단. 대실을 지원하는 일부 직연동 채널에서만 사용합니다
• secondary_channel — 2차 채널링 판매 경로. 이를 지원하는 일부 레거시 채널에서만 전달됩니다

예약 번호 구조는 공통 · 개요를 참고하세요. 공급사 예약은 반드시 gds_sub_booking_number 기준으로 생성합니다.

엔드포인트

모두 공급사 API(ONDA → 공급사)입니다.

메서드	경로	설명
GET	.../rateplans/{vendor_rateplan_id}/refund_policy	취소·환불 정책 사전 조회
POST	/bookings	가예약 생성 (재고 차감)
PUT	/bookings/{vendor_booking_number}/confirm	예약 확정
PUT	/bookings/{vendor_booking_number}/modify	예약 변경 (Soft Change만)
POST	/bookings/{vendor_booking_number}/cancel	예약 취소

공급사가 ONDA의 예약 데이터를 조회할 때는 HUB API인 GET /gds/vendor/bookinglist · GET /gds/vendor/booking/{vendor_booking_number}를 사용합니다.