직연동 채널 예약
직연동 채널 예약의 가예약·확정·변경·취소 흐름입니다. 플러스 채널과 달리 유효성 검사 없이 모든 단계를 무조건 수용합니다.
플러스 채널과의 차이
| 항목 | 플러스 채널 | 직연동 채널 |
|---|---|---|
| 유효성 검사 | ONDA·공급사 각자 수행 | 없음 — 무조건 수용 |
| 예약 변경 | Soft Change만 | Soft · Hard Change 모두 |
예약 type | overnight | overnight (대실을 지원하는 채널은 dayuse 추가) |
단계별 흐름
- 가예약 생성 —
POST /bookings(검사 없이 수용, 재고 차감) - 예약 확정 —
PUT /bookings/{vendor_booking_number}/confirm - 예약 변경 —
PUT /bookings/{vendor_booking_number}/modify(Soft · Hard Change) - 예약 취소 —
POST /bookings/{vendor_booking_number}/cancel
예약 변경 유형
modify 요청은 변경 범위에 따라 구분합니다. 직연동 채널은 두 유형을 모두 허용합니다.
| 유형 | 범위 |
|---|---|
| Soft Change | 예약자·투숙자 정보 변경 (재고·일정에 영향 없는 메타성 변경) |
| Hard Change | 체크인·체크아웃(투숙일) 변경, 예약 객실 변경 등 (재고·요금·매핑에 영향) |
체크리스트
- 모든 예약 단계 무조건 수용 처리 (유효성 검사 없음)
- 예약
type처리 — 대실을 지원하는 채널은overnight+dayuse, 그 외 채널은overnight만 -
visit_type(방문수단car·walk) 수신·처리 - 실제 공급사 예약은
gds_sub_booking_number기준으로 생성 -
modify처리 흐름 구현 — Soft Change / Hard Change 구분 처리 - Hard Change 시 재고 차감·복원 및 요금 재계산 처리
- 예약 바우처(확정·취소) 숙소에 직접 발송
주요 필드
| 필드 | 엔드포인트 | 설명 |
|---|---|---|
payment_type | POST /bookings · confirm 응답 | 선결제(prepayment) / 후결제(postpayment) 구분. paid_amount(결제 금액)는 제거됐습니다. |
net_price | POST /bookings · modify 요청 | 수수료를 제외한 정산금액(입금예정액) |
canceled_by | cancel 요청 | 취소 주체 — user / admin / channel / system |
memo | cancel 요청 | 취소 사유·메모. 채널 관리자가 취소한 경우 canceled_by=channel과 함께 사유가 전달됩니다 |
type | POST /bookings 요청 | overnight(숙박). 대실을 지원하는 채널은 dayuse가 함께 전달됩니다 |
visit_type | POST /bookings 요청 | 투숙객 방문수단 — car(차량) / walk(도보). 대실을 지원하는 일부 채널에서만 전달됩니다 |
secondary_channel | POST /bookings 요청 | 2차 채널링으로 판매된 경우의 판매 경로(정보성). 이를 지원하는 일부 레거시 채널에서만 전달됩니다 |
예약 번호 구조는 공통 · 개요를 참고하세요.
엔드포인트
모두 공급사 API(ONDA → 공급사)입니다.
| 메서드 | 경로 | 설명 |
|---|---|---|
GET | .../rateplans/{vendor_rateplan_id}/refund_policy | 취소·환불 정책 사전 조회 |
POST | /bookings | 가예약 생성 (재고 차감) |
PUT | /bookings/{vendor_booking_number}/confirm | 예약 확정 |
PUT | /bookings/{vendor_booking_number}/modify | 예약 변경 (Soft · Hard Change) |
POST | /bookings/{vendor_booking_number}/cancel | 예약 취소 |