본문으로 건너뛰기

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

숙소의 인허가 서류와 사업자등록증을 API로 제출하고, ONDA의 검수 결과를 조회할 수 있습니다. 플러스 채널은 인허가 서류와 사업자등록증이 모두 승인(confirm)된 숙소만 오픈할 수 있으므로, 플러스 채널을 판매하려면 채널 오픈 신청 전에 두 서류를 제출해 주세요.

주요 변경사항​

1. 신규 API 3개​

경로 prefix는 /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, 이미지는 450x200 픽셀 이상이어야 합니다.
  • 사업자등록증의 사업자 구분이 법인(corporation)이면 상호·사업장 소재지·업태·종목도 필수입니다.

3. 검수 흐름​

제출한 요청은 pending으로 접수되고, ONDA 검수 후 confirm(승인) 또는 reject(반려)로 바뀝니다. 반려 사유는 조회 API의 reason에서 확인할 수 있습니다. 같은 서류를 검수 중에 다시 제출하면 이전 요청은 자동으로 반려되고 새 요청이 검수 대상이 됩니다.

서류는 종류별로 1건만 반영됩니다. 같은 종류를 여러 번 제출해도 가장 최근에 승인된 1건만 현재 서류가 되며, 새 서류가 승인되기 전까지는 기존 승인 서류가 유지됩니다.

4. 가이드 업데이트​

  • 최초 판매 준비: 숙소 생성 다음 단계로 라이센스 제출을 추가했습니다. 분량이 늘어 개요 · 콘텐츠 생성 · 라이센스 제출 · 요금·재고 전송 4개 페이지로 나눴습니다.
  • 라이센스 제출: 서류별 필수 항목, 파일 규칙, 검수 상태, 인허가 유형 코드를 정리한 새 가이드입니다.
  • 플러스 채널 오픈: 인허가 서류와 사업자등록증 모두 승인돼야 한다는 선행 조건을 추가했습니다.

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

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

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

문의​

API 연동에 대해 궁금하신 사항이 있으시면 언제든지 문의해 주세요: