자주 묻는 질문
ONDA API 연동, 요금, 보증금 충전에 대해 자주 묻는 질문들을 모았습니다. 원하는 답변을 찾지 못하셨다면 문의해주세요.
일반
ONDA API는 숙박 공급사와 판매 채널을 연결하는 통합 유통 플랫폼입니다. 약 54,000개의 숙소와 75개의 채널을 연동할 수 있으며, 개발자센터를 통해 셀프서비스로 API 키를 발급받고 연동할 수 있습니다.
Sandbox 환경에서 평균 2-3주 내에 연동을 완료할 수 있습니다. 계정 생성 후 즉시 Sandbox API 키를 발급받아 테스트를 시작할 수 있습니다.
네, Sandbox 환경을 무료로 제공합니다. Sandbox에서는 결제 없이 무제한으로 API를 테스트할 수 있으며, Mock 데이터로 응답합니다.
요금
호출당 과금 없이 단순합니다. 운영(Starter)은 월 구독료 ₩12,000(가입 후 3개월 무료)과 예약 입금가의 5% 단일 수수료로 구성됩니다. 보증금 ₩500,000을 충전해 잔액 범위 내에서 예약하며, 수수료는 예약이 확정될 때만 발생합니다. Sandbox는 무료입니다.
예약 입금가(ONDA 공급가)의 5%가 단일 수수료입니다. 등급별 차등이나 호출당 단가는 없습니다. 게스트 판매가는 파트너가 자유롭게 정하며 ONDA 정산과 무관합니다.
가용 잔액이 기준 아래로 떨어지면 단계별 알림이 발송되고, 일정 수준 미만이면 신규 예약이 자동으로 비활성화됩니다. Sandbox 환경은 영향 없이 계속 사용할 수 있습니다.
보증금 / 충전
최소 ₩500,000부터 ₩100,000 단위로 충전합니다. 개발자센터 콘솔에서 충전을 요청하면 가상계좌가 발급되고, 입금하면 잔액에 즉시 반영됩니다. 가상계좌 발급 수수료(건당 ₩400)는 ONDA가 부담합니다.
예약이 발생하면 입금가만큼 잔액이 홀드되고, 체크아웃 시 정산되어 ONDA 매출로 확정됩니다. 예약이 취소되면 홀드가 해제되어 잔액이 복원됩니다.
해지 시 미정산 금액을 차감한 후 남은 보증금 잔액을 전액 환불합니다.
기술
REST API이므로 HTTP 요청을 보낼 수 있는 모든 언어에서 사용 가능합니다. API 문서에서 cURL 예제를 제공하며, 개발자센터의 API 콘솔에서 직접 테스트할 수 있습니다.
Production(Starter) 환경에 Rate Limit이 적용됩니다. 한도를 초과하면 일시적으로 요청이 제한되며, 대량 트래픽이 필요한 경우 별도 문의로 조정할 수 있습니다.
네, 예약 생성(reservation.created), 취소(reservation.cancelled), 변경(reservation.modified) 이벤트를 Webhook으로 수신할 수 있습니다. 앱 설정에서 Webhook URL과 수신할 이벤트를 지정할 수 있습니다.