Plus Channel Opening
ONDA가 OTA 계약을 대행하는 플러스 채널(channel_type=hub)의 오픈 신청 흐름입니다. 공급사가 HUB API를 통해 ONDA에 신청합니다.
플러스 채널은 직연동 채널과 달리 매핑·인증 단계 없이 신청만으로 오픈됩니다.
단계별 흐름
- 전체 채널 조회 —
GET /gds/vendor/channels - 숙소별 오픈 가능 채널 조회 —
GET .../properties/{vendor_property_id}/channels - 채널 오픈 신청 —
POST .../properties/{vendor_property_id}/channels/{channel_id} - 신청 상태 확인 —
GET .../properties/{vendor_property_id}/channels/{channel_id}
체크리스트
- 전체 채널 목록 + 이용안내 확인
- 숙소 기준 오픈 가능 채널 확인
- 오픈 신청 후 신청 상태·히스토리 추적
- 오픈 완료 후 요금재고 전송 선행 여부 확인
- 채널 오픈 조건(숙소·객실) 사전 충족 확인 — 미충족 시 자동 반려
- 숙소
settings.extra_adult_price가 플러스 채널 인원추가비용으로 반영되는지 확인
채널 오픈 조건 검증
오픈 신청 시 아래 숙소·객실 조건을 검증하며, 하나라도 충족되지 않으면 자동으로 반려(reject) 됩니다.
숙소 조건
| 검증 항목 | 내용 |
|---|---|
| 채널 오픈 여부 | 동일 채널 중복 오픈 방지 |
| 판매 상태 | ONDA Hub 판매 상태 및 공급사 판매 상태 모두 활성화 |
| 숙소 삭제 여부 | 삭제된 숙소 제외 |
| 숙소명 유효성 | null 또는 1자 등 비정상 값 제외 |
| 대표 이미지 | 3장 이상 보유 |
| 주소 | 정확한 주소 입력 여부 |
| 카테고리 | 1개 이상 지정 |
객실 조건
| 검증 항목 | 내용 |
|---|---|
| 판매 가능 객실 | 1개 이상 존재 |
| 객실명 유효성 | 비정상 값 제외 |
| 객실 이미지 | 3장 이상 보유 |
| 예약 가능 날짜 | 최근 30일 이내 예약 가능 날짜 1일 이상 (요금·재고·영업일 3가지 조건 모두 충족) |
오픈 신청 처리 방식 분기
채널 메타의 processing_mode 값에 따라 신청 처리 방식이 갈립니다.
processing_mode | 동작 |
|---|---|
auto_approve | 신청 즉시 활성화 — request_status: "confirm" |
external_review | 운영자 승인 대기 — request_status: "pending" → confirm 또는 reject |
external_review 채널은 주기적으로 신청 상태를 조회해 결과를 확인합니다.
엔드포인트
경로 prefix는 /gds/vendor 입니다.
| 메서드 | 경로 | 설명 |
|---|---|---|
GET | /channels | 전체 채널 메타 (channel_type, processing_mode, requires_cms_authorization) |
GET | /properties/{vendor_property_id}/channels | 숙소별 오픈 가능 채널·신청 상태 |
POST | /properties/{vendor_property_id}/channels/{channel_id} | 채널 ON 신청 (request_type: "on") |
GET | /properties/{vendor_property_id}/channels/{channel_id} | 신청 상태·히스토리 조회 |