본문으로 건너뛰기

Vendor API 3.0 - 라이센스 제출 API 추가

숙소의 인허가 서류와 사업자등록증을 API로 제출하고 ONDA의 검수 결과를 확인할 수 있습니다. 플러스 채널을 신청하기 전에 두 서류가 모두 승인(confirm)됐는지 확인하세요.

주요 변경사항​

1. 신규 API 3개​

모든 경로는 /gds/vendor/properties로 시작합니다.

API메서드경로
라이센스 제출POST.../{vendor_property_id}/licenses
라이센스 제출 목록 조회GET.../{vendor_property_id}/licenses
라이센스 제출 상세 조회GET.../{vendor_property_id}/licenses/{request_id}

2. 제출 서류​

서류마다 요청을 하나씩 보내며, type으로 서류 종류를 지정합니다.

type서류
permit인허가 서류 (영업신고증, 관광사업 등록증, 농어촌민박사업자 신고확인증 등)
business사업자등록증
  • 파일은 base64 문자열로 인코딩해 data.file에 넣으세요. JPEG, PNG, GIF, WebP, PDF를 지원합니다. 파일은 1개당 최대 10MB이며, 이미지는 가로 450픽셀, 세로 200픽셀 이상이어야 합니다.
  • 사업자등록증의 사업자 구분이 법인(corporation)이면 상호·사업장 소재지·업태·종목도 필수입니다.

3. 검수 흐름​

ONDA는 요청을 pending으로 접수한 뒤, 검수를 마치면 confirm(승인) 또는 reject(반려)로 처리합니다. 반려 사유는 조회 응답의 reason에서 확인하세요. 같은 종류의 서류를 검수 중에 다시 제출하면 ONDA는 이전 요청을 자동으로 반려하고 새 요청을 검수합니다.

숙소에는 각 종류의 서류 중 가장 최근에 승인된 한 건이 적용됩니다. 새 서류가 승인될 때까지는 이전에 승인된 서류가 적용됩니다.

4. 가이드 업데이트​

  • 최초 판매 준비에서 숙소 생성 다음 단계에 라이센스 제출을 추가했습니다. 개요, 콘텐츠 생성, 라이센스 제출, 요금과 재고 전송을 각각의 페이지에서 확인할 수 있습니다.
  • 라이센스 제출 가이드에 서류별 필수 항목, 파일 규칙, 검수 상태, 인허가 유형 코드를 정리했습니다.
  • 플러스 채널 오픈 가이드에 두 서류의 승인 조건을 추가했습니다.

5. 최초 판매 준비 섹션 위치 변경​

기존 최초 판매 준비 페이지의 섹션이 아래 페이지로 옮겨졌습니다. 내용은 바뀌지 않았으며, 섹션 링크를 북마크해 두셨다면 새 위치로 바꿔 주세요.

섹션새 위치
단계별 흐름, 체크리스트최초 판매 준비 개요 (기존 주소 유지)
코드 카탈로그(meta) 활용, 한국어 외 언어 콘텐츠 전송, 요금제 모델 · 요금제 구조, 숙소 기본 추가 성인요금, 콘텐츠 엔드포인트콘텐츠 생성
요금·영업일(ARI) · 재고(Avails) 전송요금·재고 전송

문의​

API 연동 관련 문의는 techsupport@onda.me로 보내 주세요.