판매 채널 생성
ONDA 판매 채널을 생성하고 API 연동을 시작하세요.
판매 채널 생성
ONDA API를 사용하려면 먼저 판매 채널을 생성하고 API 자격 증명을 발급받아야 합니다.
사전 준비사항
판매 채널을 생성하기 전에 다음 사항을 준비해주세요:
- ONDA 계정 (아직 없다면 회원가입)
- 사업자등록증 (법인 또는 개인사업자)
- 정산 계좌 정보
- 서비스 URL 및 도메인 정보
채널 생성 단계
ONDA 파트너 센터 로그인
ONDA 파트너 센터에 로그인합니다.
판매 채널 생성
좌측 메뉴에서 설정 > 판매 채널을 선택하고 새 채널 만들기 버튼을 클릭합니다.
다음 정보를 입력하세요:
- 채널 이름 (예: "ABC 트래블 OTA")
- 채널 유형 (OTA, 메타서치, 여행사 등)
- 서비스 URL
- 연동 담당자 정보
API 자격 증명 발급
채널이 생성되면 API 설정 탭에서 자격 증명을 발급받을 수 있습니다.
- Client ID: 공개 식별자
- Client Secret: 비밀 키 (안전하게 보관하세요!)
- Redirect URI: OAuth Authorization Code 플로우 사용 시 필요
중요: Client Secret은 최초 1회만 표시됩니다. 안전한 곳에 저장하고 절대 외부에 노출하지 마세요.
환경 선택
개발/테스트용과 운영용 환경을 구분하여 사용하세요:
| 환경 | API Base URL | 용도 |
|---|---|---|
| Sandbox | https://sandbox.api.onda.me/v1 | 개발 및 테스트 |
| Production | https://api.onda.me/v1 | 실제 서비스 |
Sandbox 환경에서는 테스트 데이터를 사용하며 실제 예약이 발생하지 않습니다.
IP 화이트리스트 설정 (선택)
보안 강화를 위해 API 호출을 허용할 IP 주소를 등록할 수 있습니다.
API 설정 > 보안 > IP 화이트리스트에서 IP 주소를 추가하세요.
개발/운영 환경
Sandbox 환경
- 실제 데이터에 영향을 주지 않는 테스트 환경
- 테스트용 숙소 및 예약 데이터 제공
- 결제 처리 없이 예약 플로우 테스트 가능
- API 호출 제한 없음
Production 환경
- 실제 숙소 데이터 및 예약 처리
- 실제 결제 발생
- Rate limiting 적용 (분당 1000건)
- 모니터링 및 SLA 제공
다음 단계
판매 채널 생성이 완료되었다면:
- 첫 API 호출에서 OAuth 인증을 테스트하세요
- OAuth 2.0 인증에서 인증 체계를 자세히 알아보세요
- API 레퍼런스에서 사용 가능한 API를 확인하세요
자주 묻는 질문
Q. Client Secret을 분실했습니다. 어떻게 하나요? A. 파트너 센터의 API 설정에서 Secret 재발급 버튼을 클릭하세요. 기존 Secret은 즉시 무효화됩니다.
Q. 여러 개의 채널을 운영할 수 있나요? A. 네, 서비스별로 별도의 채널을 생성할 수 있습니다. 각 채널은 독립적인 API 자격 증명을 가집니다.
Q. Sandbox와 Production 환경의 자격 증명이 다른가요? A. 네, 각 환경은 별도의 Client ID/Secret을 사용합니다. 파트너 센터에서 환경별로 발급받으세요.