ONDA

채널 등급

ONDA 채널 등급 체계와 등급별 운영 조건을 안내합니다.

ONDA Platform Engineering 관리

채널 등급

ONDA는 개발/테스트용 Sandbox와 실제 서비스 운영용 Starter 2단계 등급 체계를 운영합니다. 수수료는 등급에 관계없이 입금가의 5% 단일 수수료로 동일하며, 등급은 환경(테스트/운영)과 운영 조건을 구분합니다.

등급 체계

Sandbox (샌드박스)

개발 및 테스트 전용 등급입니다. 과금 없이 무제한으로 API를 테스트할 수 있으며, Mock 데이터로 응답합니다. 실제 예약은 생성되지 않습니다.

Starter (스타터)

실제 서비스 운영 등급입니다. 보증금 충전 후 잔액 범위 내에서 실제 예약을 생성할 수 있습니다. 월 구독료와 예약 수수료가 발생합니다.

등급별 비교

전체 비교표

항목SandboxStarter
용도개발 및 테스트실제 서비스 운영
응답 데이터Mock 데이터실제 데이터
실제 예약 생성❌✅
수수료없음입금가의 5% (단일 수수료)
월 구독료없음₩12,000 / 월 (가입 후 3개월 무료)
보증금없음₩500,000 충전 후 운영 (₩100,000 단위)
가상계좌 발급-건당 ₩400 (ONDA 부담)
API Rate Limit60 req/min600 req/min

1. Sandbox (무료)

  • 무제한 API 호출
  • Mock 데이터 응답
  • 결제 없음
  • 실제 예약 생성 불가

Sandbox 환경은 과금이 전혀 없으며, 연동 개발과 테스트에 사용합니다. 계정 생성 후 즉시 Sandbox API 키를 발급받아 테스트를 시작할 수 있습니다.

2. Starter (실제 서비스 운영)

  • 월 구독료 ₩12,000 (가입 후 3개월 무료)
  • 보증금 ₩500,000 충전 후 운영 (₩100,000 단위)
  • 예약 입금가의 5% 단일 수수료
  • 잔액 범위 내 실시간 예약 (입금가만큼 잔액 홀드)
  • 잔액 부족 시 운영 환경 API 차단

Starter 환경은 보증금(이행 담보) 기반으로 운영됩니다. 예약 시 입금가만큼 잔액이 홀드되고, 체크아웃 후 주간 송금 배치로 정산됩니다 (송금 확인 시 홀드 해제, D+3 미입금 시 보증금 차감). 자세한 흐름은 정산 가이드를 참고하세요.

3. API Rate Limit

등급Rate Limit
Sandbox60 req/min
Starter (운영)600 req/min

Rate Limit 초과 시:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please retry after the specified time.",
    "details": {
      "retry_after_seconds": 45,
      "limit": 600
    }
  },
  "meta": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-02-13T10:35:00Z"
  }
}

Rate Limit은 채널 단위로 적용되며, 1분 단위로 리셋됩니다. 응답 헤더(X-RateLimit-Limit/Remaining/Reset)로 잔여량을 확인할 수 있습니다. 대량 사용이 필요한 경우 별도 협의를 통해 한도를 조정할 수 있습니다.

Sandbox에서 Starter로 전환

운영을 시작하려면 Sandbox에서 Starter로 전환합니다.

연동 개발 및 테스트

Sandbox 환경에서 API 연동을 완료하고 충분히 테스트합니다.

운영 신청

개발자센터 콘솔에서 운영(Production) 환경을 신청합니다.

보증금 충전

최소 ₩500,000(₩100,000 단위)을 충전 요청하면 가상계좌가 발급됩니다. 입금하면 잔액에 즉시 반영됩니다.

운영 시작

잔액 범위 내에서 실제 예약을 생성할 수 있습니다. 월 구독료는 가입 후 3개월간 무료입니다.

현재 등급 및 잔액 확인

대시보드

  1. 개발자 포털 로그인
  2. 대시보드에서 현재 환경(Sandbox/Starter) 확인
  3. Billing 메뉴에서 잔액 확인

API

import requests

headers = {"Authorization": f"Bearer {access_token}"}

response = requests.get(
    "https://api.tport.dev/channel/v1/channels/me",
    headers=headers
)

channel_info = response.json()["data"]
print(f"현재 등급: {channel_info['tier']}")
print(f"기본 통화: {channel_info['default_currency']}")

응답 예시:

{
  "data": {
    "id": "1f0e8400-e29b-41d4-a716-446655440000",
    "email": "dev@example.com",
    "name": "홍길동",
    "company": "ABC 트래블",
    "tier": "starter",
    "default_currency": "KRW",
    "bank_account": {
      "bank_name": "국민은행",
      "bank_code": "004",
      "account_number": "******1234",
      "account_holder": "ABC 트래블"
    }
  },
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2026-06-01T09:00:00.000Z"
  }
}

잔액과 Rate Limit 잔여량은 이 응답에 포함되지 않습니다. 잔액은 대시보드 > Billing에서, Rate Limit 잔여량은 응답 헤더(X-RateLimit-*)로 확인하세요.

등급 관련 FAQ

1. Sandbox와 Starter의 수수료 차이가 있나요?

Sandbox는 과금이 전혀 없습니다. Starter는 예약 입금가의 5% 단일 수수료가 발생하며, 등급에 따른 수수료 차등은 없습니다.

2. 운영 전환에 별도 심사가 있나요?

운영(Starter) 전환은 개발자센터 콘솔에서 신청합니다. 보증금 충전 후 잔액 범위 내에서 실제 예약을 생성할 수 있습니다.

3. 잔액이 부족하면 어떻게 되나요?

잔액이 예약 입금가보다 적으면 운영 환경의 Channel API 예약이 차단되며 INSUFFICIENT_BALANCE 오류가 반환됩니다. Sandbox 환경은 영향 없이 계속 사용할 수 있습니다.

4. 월 구독료는 언제부터 발생하나요?

월 구독료 ₩12,000은 가입 후 3개월간 무료이며, 이후 매월 부과됩니다.

5. 보증금은 환불되나요?

충전한 보증금은 해지 시 미정산 금액(예약 수수료 등)을 차감한 후 잔액 전액이 환불됩니다.

다음 단계