Skip to main content

Vendor API 3.0 - License Submission API

You can submit a property's permit and business registration certificate through the API and check their status. Before you request to open a Plus channel, check that ONDA has approved both documents (confirm).

Key Changes​

1. Three New APIs​

All paths start with /gds/vendor/properties.

APIMethodPath
Submit LicensePOST.../{vendor_property_id}/licenses
List License SubmissionsGET.../{vendor_property_id}/licenses
Get License SubmissionGET.../{vendor_property_id}/licenses/{request_id}

2. Documents​

Send one request per document, and set the document type with type.

typeDocument
permitLicense document (business report certificate, tourism business registration, rural homestay registration, etc.)
businessBusiness registration certificate
  • Encode the file as a base64 string and put it in data.file. The API accepts JPEG, PNG, GIF, WebP, and PDF files up to 10 MB each. Images must be at least 450 pixels wide and 200 pixels tall.
  • For a corporate business (corporation), the business name, address, industry, and business category are also required.

3. Review Flow​

ONDA sets new submissions to pending. After review, ONDA sets the status to confirm (approved) or reject (rejected). Check reason in the list or detail response if ONDA rejects a submission. If you resubmit a document of the same type during review, ONDA automatically rejects the earlier request and reviews the new one.

ONDA uses the most recently approved document of each type until it approves a replacement.

4. Guide Updates​

  • Initial Setup now includes license submission after property creation. Separate pages cover the overview, content creation, license submission, and sending rates and availability.
  • The new License Submission guide explains required fields, file rules, review status, and license type codes.
  • The Plus Channel Opening guide now includes the approval requirements for both documents.

5. Initial Setup Sections Moved​

Sections of the former Initial Setup page have moved to the pages below. Their content is unchanged; if you bookmarked a section link, update it to the new location.

SectionNew location
Step by step, ChecklistInitial Setup overview (same URL)
Using the code catalog (meta), Sending content in languages other than Korean, Rate plan model and rate plan structure, Property default extra adult charge, Content endpointsContent Creation
Pushing rates and business days (ARI) and availability (Avails)Rates & Availability Push

Contact​

For help with API integration, email techsupport@onda.me.