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로 보내 주세요.