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.
| API | Method | Path |
|---|---|---|
| Submit License | POST | .../{vendor_property_id}/licenses |
| List License Submissions | GET | .../{vendor_property_id}/licenses |
| Get License Submission | GET | .../{vendor_property_id}/licenses/{request_id} |
2. Documents
Send one request per document, and set the document type with type.
type | Document |
|---|---|
permit | License document (business report certificate, tourism business registration, rural homestay registration, etc.) |
business | Business 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.
| Section | New location |
|---|---|
| Step by step, Checklist | Initial 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 endpoints | Content Creation |
| Pushing rates and business days (ARI) and availability (Avails) | Rates & Availability Push |
Contact
For help with API integration, email techsupport@onda.me.