판매 채널 생성
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을 사용합니다. 파트너 센터에서 환경별로 발급받으세요.