플러스 채널 오픈

ONDA가 OTA 계약을 대행하는 플러스 채널(channel_type=hub)의 오픈 신청 흐름입니다. 공급사가 HUB API를 통해 ONDA에 신청합니다.

플러스 채널은 직연동 채널과 달리 매핑·인증 단계 없이 신청만으로 오픈됩니다.

단계별 흐름

1. 전체 채널 조회 — GET /gds/vendor/channels
2. 숙소별 오픈 가능 채널 조회 — GET .../properties/{vendor_property_id}/channels
3. 채널 오픈 신청 — POST .../properties/{vendor_property_id}/channels/{channel_id}
4. 신청 상태 확인 — 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}	신청 상태·히스토리 조회